[Mapping] Which ADvendio Objects represent what in The Trade Desk mapping and Connection configuration

Available with Version	2.168 and up

Available with Version	2.168 and up
Role	Order Manager - Fulfilment; Product Management
External Systems	The Trade Desk

Challenge

You want to use The Trade Desk integration and need to know which ADvendio object corresponds to which element when placing an Order from The Trade Desk?

Solution

On the Buying Order and Buying Item levels, you can access detailed mapping data. The following table provides a brief overview of how ADvendio corresponds to The Trade Desk:

ADvendio Object	The Trade Desk

ADvendio Object	The Trade Desk
Buying Order	Campaign
Accounts	Advertiser
Buying Item	Flight
Buying Item	Ad Group
Not set directly in ADvendio, just included in the Advertiser	Delivery Profile
Network ID	Parter ID

Buying Order (Campaign in TTD)

ADvendio Object	ADvendio Field	Required	TTD Entity	TDD Field	Additional information

ADvendio Object	ADvendio Field	Required	TTD Entity	TDD Field	Additional information
Buying Order	Channel		Campaign	Channel	Display Video Audio ATV/CTV DooH Programmatic Cinema
Buying Order	Advertiser		Campaign	Advertiser / 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
N/A	N/A	Auto	Campaign	Availability	ADvendio currently uses ‘Available’ as the fixed default
Buying Order	Start Date	-	Campaign	StartDate	-
Buying Order	End Date	-	Campaign	EndDate	-
Buying Order	OrderType		Campaign	CampaignType	Standard (Only option available for now)
Buying Order	Order Goal		Campaign	Objective	The campaign objective. To set it, you must also specify the Primary Objective Awareness Discover qualified leads to increase brand knowledge and reach a specific audience. Consideration Reach new customers and influence them to become prospective customers. Conversion Maximize conversions by driving prospects to take a specific action.
Buying Order	Budget Amount		Campaign	Budget (Amount + Currency Code)	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 Order	N/A	-	Campaign	Primary Goal (KPI)	ADvendio currently uses ‘Reach’ as the fixed default
Buying Order	Budget Impressions	-	Campaign	Budget Impressions	In the case of campaigns that have multiple flights, this value will be determined using specified Flight values and may not be modified. Otherwise, it must be specified at creation time.
Buying Order	Budget Impression Daily	-	Campaign	Budget Impressions Daily	It also can be selected at a Buying Item level
Buying Order	Start Date	-	Campaign	TimeZone	Get the timezone from the item zone.
Buying Order	N/A		Campaign	Pacing	ADvendio currently uses Off The campaign will aim to pace to the specified daily spend cap.

Buying Item (Ad Group and Flight in TTD)

ADvendio Object	ADvendio Name	Required	TDD Entity	TDD Field	Additional information

ADvendio Object	ADvendio Name	Required	TDD Entity	TDD Field	Additional information
Buying Order	Insertion Order ID		Ad Group	Campaign ID	-
Buying Item	Line Item ID	Auto	Ad Group	Ad Group ID	-
Buying Item	Name		Ad Group	Ad Group Name	-
N/A	N/A	Auto	Ad Group	Availability	ADvendio currently uses ‘Available’ as the fixed default
Buying Item	Status		Ad Group	Status	Paused Default if nothing is selected Named “Disable” in TTD Active Named “Enabled” in TTD When order is updated with the Paused value if the status is “Available” in TTD is not changed in the UI Draft = DO NOT SELECT, could show an error
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	TTD Metric	Type	Definition

Advendio Metric	TTD 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)

[Mapping] Which ADvendio Objects represent what in The Trade Desk mapping and Connection configuration

Challenge

Solution

Buying Order (Campaign in TTD)

ADvendio Object

ADvendio Field

TTD Entity

TDD Field

Additional information