Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 5 Next »

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.

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


Buying Order (Campaign in Google Ads)

ADvendio Object

ADvendio Field

Required

TikTok Entity

TikTok Field

Additional information

Buying Order

Order Goal

(tick)

Campaign

Advertising Goal

Values in Advendio:

  • Traffic

  • Lead Generation

  • Post Engagement (Engagement on TikTok)

  • Conversions (Web Conversions on TikTok)

IMPORTANT

  • Once the order Goal is submitted it cannot be changed

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

Operation status

  • Active (Enable in TikTok)

  • Paused (Disable in TikTok)

  • Draft: Tiktok wont support this status via API

ADvendio currently uses ‘Active’ as the fixed default

Buying Order

Start Date

-

Campaign

StartDate

-

Buying Order

End Date

-

Campaign

EndDate

-

N/A

N/A

AUTO

Campaign

CampaignType

ADvendio currently uses ‘REGULAR_CAMPAIGN’ as the fixed default

N/A

N/A

AUTO

Campaign

Budget Mode

ADvendio currently uses:

  • BUDGET_MODE_TOTAL for Budget amount

  • BUDGET_MODE_DAY for Budget Amount Daily

Buying Order

Budget Amount

(tick)

Campaign

Budget

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

Buying Order

Budget Amount Daily

-

Campaign

Daily Budget

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

Buying Item (Ad Group and Flight in TikTok)

ADvendio Object

ADvendio Field

Required

TikTok Entity

TikTok 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 status

  • Active (Enable in TikTok)

  • Paused (Disable in TikTok)

  • Draft: Tiktok wont support this status via API

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 (Daily)

-

Campaign Flight

DailyTargetInAdvertiserCurrency

In case of daily budget

Buying Item

Budget Impressions (Daily)

-

Campaign Flight

DailyTargetInImpressions

-

Buying Item

Start Date & Start Time

(tick)

Campaign Flight

StartDateInclusiveUTC

-

Buying Item

End Date & End Time

(tick)

Campaign Flight

EndDateExclusiveUTC

-

Reporting

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

 

Advendio Metric

TikTok 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)

  • No labels