[Mapping] Which ADvendio Objects represent what in Google Ads and Connection configuration

Available with Version

2.169 and up

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

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.

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

Campaign

Advertiser ID

-

Buying Order

Name

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

ADvendio currently uses ‘Active’ as the fixed default

Buying Order

Start Date

Campaign

Start Date

-

Buying Order

End Date

Campaign

End Date

-

Buying Order

Budget Name

Campaign

Budget Name

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

Buying Order

Budget Amount

Campaign

Budget

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

Campaign

Daily Budget

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

Buying Order

Delivery Method

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

Campaign

Campaign Bidding Strategy

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

Buying Order

Channel

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

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

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

Buying Item

Budget Amount

-

-

Buying Item

Budget Amount (Daily)

Ad Group

DailyTargetInAdvertiserCurrency

In case of daily budget

Buying Item

Start Date & Start Time

Ad Group

StartDateInclusiveUTC

-

Buying Item

End Date & End Time

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

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)