Versions Compared

Version Old Version 5 New Version Current
Changes made by

Former user

Former user

Saved on

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

indvidual

individual connections for each of them, or to specify a different Network ID.

...

Buying Order (Campaign in Google Ads)

ADvendio Object

ADvendio Field

Required

TikTok

Google Ads Entity

TikTok

Google Ads Field

Additional information

Buying Order

Order Goal

(tick)

Campaign

Advertising Goal

Values in Advendio:

Traffic
Note

IMPORTANT

  • Once the order Goal is submitted it cannot be changed

Buying Order

  • Lead Generation

  • Post Engagement (Engagement on TikTok)

  • Conversions (Web Conversions on TikTok)

    • 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

    Operation

    Campaign status

    • Active(Enable in

    TikTok

    • Google Ads)

    • Paused

    (Disable in TikTok)

    • Draft:

    Tiktok

    • Google Ads wont support this status via API

    Tip

    ADvendio currently uses ‘Active’ as the fixed default

    Buying Order

    Start Date

    -

    (tick)

    Campaign

    StartDate

    Start Date

    -

    Buying Order

    End Date

    -

    (tick)

    Campaign

    EndDate

    End Date

    -

    N/A

    N/A

    AUTOAUTO

    Buying Order

    Budget Name

    (tick)

    Campaign

    CampaignType

    ADvendio currently uses ‘REGULAR_CAMPAIGN’ as the fixed default

    N/A

    N/A

    Budget Name

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

    Buying Order

    Budget Amount

    (tick)

    Campaign

    Budget

    Mode

    ADvendio currently uses:

    • BUDGET_MODE_TOTAL for Budget amount

    • BUDGET_MODE_DAY for Budget Amount Daily

    Buying Order

    Budget Amount

    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

    In the case of campaigns that have multiple flights, this value will be determined using specified Flight values and may not be modified-

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

    Buying Order

    Budget Amount Daily

    Order Bid Strategy

    (tick)

    Campaign

    Daily Budget

    Only to be set if the flag is true, then no budget will be set on individual line item level

    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

    TikTok

    Google Ads Entity

    TikTok

    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

    Operation

    Ad Group status

    • Active (Enable in

    TikTok

    • Google Ads)

    • Paused

    (Disable in TikTok)

    • Draft:

    Tiktok wont

    • Google Ads won't support this status via API

    Tip

    ADvendio currently uses ‘Active’ as the fixed default

    N/A

    N/A

    Auto

    Ad Group

    Placement Type

    ADvendio currently uses ‘PLACEMENT_TYPE_NORMAL’ as the fixed default

    N/A

    N/A

    Auto

    Ad Group

    Placement

    ADvendio currently uses ‘PLACEMENT_TIKTOK’ as the fixed default

     

     

     

     

     

    Landing Page views
    https://business-api.tiktok.com/portal/docs?id=1739361474981889

    N/A

    N/A

    Auto

    Ad Group

    Promotion Target Type

    ADvendio currently uses ‘INSTANT_PAGE’ as the fixed default

    Buying Item

    Selected Targeting

    -

    Ad Group

    Channel ID

    -

    Buying Item

    Bid Amount

    (tick)

    Ad Group

    Minimum Bid + Currency Code

    This would be the Min Bid amount equivalent

    Buying Item

    Max Bid

    (tick)

    Ad Group

    Max Bid + Currency Code

    -

    Buying Item

    Budget Amount

    (tick)

    Campaign Flight

    BudgetInAdvertiserCurrency

    -

    Buying Item

    Budget Impressions

    -

    Campaign Flight

    BudgetInImpressions

    -

    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)

    Campaign Flight

    Ad Group

    DailyTargetInAdvertiserCurrency

    In case of daily budget

    Buying Item

    Budget Impressions (Daily)

    -

    Campaign Flight

    DailyTargetInImpressions

    -

    Buying Item

    Start Date & Start Time

    (tick)

    Campaign Flight

    Ad Group

    StartDateInclusiveUTC

    -

    Buying Item

    End Date & End Time

    (tick)

    Campaign Flight

    Ad Group

    EndDateExclusiveUTC

    -

    Reporting

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

     

    Advendio Metric

    TikTok

    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

    Video Views

    Player Views

    Player

    Number of times that a video ad was viewed

    CompleteVideoViews

    Player Completed Views

    Player

    Number of video ads watched through to completion

    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)