Available with Version | 2.169 and up |
|---|---|
Role | Order Manager - Fulfilment; Product Management |
External Systems | Google AdsAmazon DSP Pilot |
Challenge
Are you interested in using our Google Ads Amazon DSP Pilot integration and seeking clarity need clarification 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 belowwhich ADvendio objects align with each component in Amazon DSP for our DSP Pilot integration?
...
Solution
General Mapping
Below is a list of ADvendio Objects and their corresponding entities in the Amazon DSP:
ADvendio Object |
|---|
Amazon DSP |
|---|
Description |
|---|
Buying Order |
Order |
|
Buying Item |
Line Item |
|
Account |
Advertiser |
|
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
...
...
Campaign
...
Advertising Goal
...
Values in Advendio:
Traffic
Lead Generation
Post Engagement (Engagement on TikTok)
Conversions (Web Conversions on TikTok)
| Note |
|---|
IMPORTANT
|
...
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
...
Operation status
...
Active (Enable in TikTok)
Paused (Disable in TikTok)
Draft: Tiktok wont support this status via API
| Tip |
|---|
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
...
...
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
...
...
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
| 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
...
...
Ad Group
...
Minimum Bid + Currency Code
...
This would be the Min Bid amount equivalent
...
Buying Item
...
Max Bid
...
...
Ad Group
...
Max Bid + Currency Code
...
-
...
Buying Item
...
Budget Amount
...
...
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
...
...
Campaign Flight
...
StartDateInclusiveUTC
...
-
...
Buying Item
...
End Date & End Time
...
...
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
-
Agency |
| |||
Connection ID | Advertiser IDs |
|
Reporting Mapping
You can find more detailed information by visiting page https://advendio.atlassian.net/wiki/spaces/SO/pages/622730?atlOrigin=eyJpIjoiZTlhMGM0ODA4YzViNGJlOWExOWQ3Yzc3NWNiZDU1MWUiLCJwIjoiYyJ9
Supported reporting metrics are based on the Buying items/ Line items in Amazon. The following types of reports are supported:
Total Buying Report
Monthly Buying Report
Daily Buying Report
ADvendio Metric | Amazon DSP Metric | Type | Definition |
|---|---|---|---|
Total Conversions | Combined Purchases | Conversion | Total conversions as calculated according to the custom CPA set for the campaign |
Impressions | Impressions | Most Common, Bids/Impressions | Total number of impressions won. |
Clicks | Off Amazon Clicks | Most Common, Clicks | Total number of clicks |
Completed Views |
Player Views
Player
Number of times that a video ad was viewed
CompleteVideoViews
Video Completed Views | Video Player | Number of video ads watched through to completion |
TotalConversions
Total Custom CPA Conversions
Conversion
Media Cost |
Total Cost | Cost, Most Common |
Total cost incurred for the campaign, including both the partner cost and agency fees (if applied in the campaign's fees and rates) |