Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Available with Version

2.168 and up

Role

Order Manager - Fulfilment; Product Management

External Systems

The Trade Desk

Challenge

Do you You want to use our The Trade Desk integration and are looking need to understand know which ADvendio object represents what when booking corresponds to which element when placing an Order from The Trade Desk?

...

Solution

You will find mapping data on the high level, On the Buying Order , and Buying Item levels. A high-level overview of what in ADvendio represents on The Trade Desk is in the table below, 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

Buying Order

Campaign

Accounts

Advertiser

Buying Item

Flight

Buying Item

Ad Group

Not set directly in AdvendioADvendio, just included in the Advertiser

Delivery Profile

Network ID

Parter ID

...

ADvendio Object

ADvendio Field

Required

TTD Entity

TDD Field

Additional information

Buying Order

Channel

(tick)

Campaign

Channel

  • Display

  • Video

  • Audio

  • ATV/CTV

  • DooH

  • Programmatic Cinema

Buying Order

Advertiser

(tick)

Campaign

Advertiser / 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

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

(tick)

Campaign

CampaignType

  • Standard (Only option available for now)

Buying Order

Order Goal

(tick)

Campaign

Objective

The campaign objective. To set it, you must also specify the Primary ChannelObjective

  • 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

(tick)

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

Channel

-

Campaign

Primary Channel

  • Display

  • Video

  • Audio

  • TV

  • NativeDisplay

  • NativeVideo

  • DigitalOutOfHome

Buying Order

N/A

-

Campaign

Primary Goal (KPI)

ADvendio currently uses ‘Reach’ as the fixed default

Buying Order

Status

-

Campaign

Status

Available (

default

if nothing is selected)When order is updated the status is not changed in TTD UI

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

(tick)

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

Buying Order

Insertion Order ID

(tick)

Ad Group

Campaign ID

-

Buying Item

Line Item ID

Auto

Ad Group

Ad Group ID

-

Buying Item

Name

(tick)

Ad Group

Ad Group Name

-

N/A

N/A

Auto

Ad Group

Availability

ADvendio currently uses ‘Available’ as the fixed default

Buying Item

Status

-(tick)

Ad Group

Status

  • Paused

    • Default if nothing is selected

    • Named “Enabled” Disablein TTD

    Available

  • 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

(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

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)