Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Available with Version

2.169 and up

Role

Order Manager - Fulfilment; Product Management

External Systems

Google Ads

Challenge

Are you interested in using our Google Ads integration and seeking clarity on the ADvendio object that corresponds to each component when placing a Buying Order through Google Ads?


Solution

An overview of what ADvendio represents on Google Ads is reflected in the table below:

ADvendio Object

Google Ads

Additional Description

Buying Order

Campaign

 

Buying Item

Ad Group

 

Account

Ad Account

 

Connection

A user booking Ads on Google Ads

Each Connection configured in ADvendio will be for one single Google Ads User.

Info

If a customer uses multiple Google Ads accounts for ad booking, it will be necessary to create individual connections for each of them, or to specify a different Network ID.


Buying Order (Campaign in Google Ads)

ADvendio Object

ADvendio Field

Required

Google Ads Entity

Google Ads Field

Additional information

Buying Order

Advertiser

(tick)

Campaign

Advertiser ID

-

Buying Order

Name

(tick)

Campaign

Campaign Name

-

Buying Order

Insertion Order ID

Auto

Campaign

Campaign ID

It will be assigned after the Buying Order is submitted

Buying Order

Status

-

Campaign

Campaign status

  • Active(Enable in Google Ads)

  • Paused

  • Draft: Google Ads wont support this status via API

Tip

ADvendio currently uses ‘Active’ as the fixed default

Buying Order

Start Date

(tick)

Campaign

Start Date

-

Buying Order

End Date

(tick)

Campaign

End Date

-

Buying Order

Budget Name

(tick)

Campaign

Budget Name

This fields indicates the name of the budget the user defines for a campaign.

Buying Order

Budget Amount

(tick)

Campaign

Budget

Info

This field is mandatory, but it’s only present in ADvendio, it won’t be sent to Google as the platform only uses the Daily Budget. It can be still set equal to the Daily Budget.

Buying Order

Budget Amount Daily

(tick)

Campaign

Daily Budget

This value is mandatory and actually determines the budget used for the campaign.

Buying Order

Delivery Method

(tick)

Campaign

Budget Delivery Method

This value indicates the delivery method that determines the rate at which the campaign budget is spent.

Buying Order

Order Bid Strategy

(tick)

Campaign

Campaign Bidding Strategy

This field indicates the goal you would like to reach with your order.

Buying Order

Channel

(tick)

Campaign

Advertising Channel Type

This field indicates the primary serving target for ads within the campaign.
It’s required and should not be empty when creating new campaigns.

Buying Item (Ad Group in Google Ads)

ADvendio Object

ADvendio Field

Required

Google Ads Entity

Google Ads Field

Additional information

Buying Item

Line Item ID

Auto

Ad Group

Ad Group ID

-

Buying Item

Name

(tick)

Ad Group

Ad Group Name

-

Buying Item

Status

-

AdGroup

Ad Group status

  • Active (Enable in Google Ads)

  • Paused

  • Draft: Google Ads won't support this status via API

Tip

ADvendio currently uses ‘Active’ as the fixed default

Buying Item

Budget Amount

(tick)

-

-

Info

This field is mandatory, but it’s only present in ADvendio, it won’t be sent to Google as the platform only uses the Daily Budget. It can be still set equal to the Daily Budget

Buying Item

Budget Amount (Daily)

(tick)

Ad Group

DailyTargetInAdvertiserCurrency

In case of daily budget

Buying Item

Start Date & Start Time

(tick)

Ad Group

StartDateInclusiveUTC

-

Buying Item

End Date & End Time

(tick)

Ad Group

EndDateExclusiveUTC

-

Reporting

More specific information can be found on the following page https://advendio.atlassian.net/l/cp/gLrRHiRn

 

Advendio Metric

Google Ads Metric

Type

Definition

Buying Item

Ad Group

-

-

Impressions

Impressions

Most Common, Bids/Impressions

Total number of impressions won. For DOOH, this is the number of auctions won, which reveals how many times your ad played back. Also referred to as "spot play" or "served impression."

Clicks

Clicks

Most Common, Clicks

Total number of clicks

TotalConversions

Total Custom CPA Conversions

Conversion

Total conversions as calculated according to the custom CPA set for the campaign

Media Cost

Advertiser Cost (Adv. Currency, Partner Currency, USD)

Cost, Most Common

Partner cost + agency fees (if applied in the campaign's fees and rates)