Versions Compared

Version Old Version 3 New Version Current
Changes made by

Daniel Yañez

Former user

Saved on

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

A high-level overview of what in ADvendio represents on The Trade Desk is in the table belowOn 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

Buying Order

Campaign

Buying Order

Accounts

Advertiser

Buying

Order

Seeds

Audience

Rails (Bid Lists)

Targeting

Deals/Contracts

Contracts

Delivery Profile

Advertiser

Item

Flight

Buying Item

Ad Group

Buying Item

Not set directly in ADvendio, just included in the Advertiser

Delivery Profile

Network ID

Parter ID

...

Buying Order (Campaign in TTD)

TTD Entity

ADvendio Object

TDD

ADvendio Field

Required

ADvendio Object

TTD Entity

ADvendio

TDD Field

Additional information

Campaign

Buying Order

Channel

(tick)

Order

Campaign

Channel

  • Display

,

  • Video

,

  • Audio

,

  • ATV/CTV

,

  • DooH

, Advertiser

  • Programmatic Cinema

Buying Order

Advertiser

(tick)

Campaign

Advertiser / Advertiser ID

-

(tick)

BuyingOrder__c

Name

Buying Order

Name

(tick)

Campaign

Campaign Name

-

(tick)

BuyingOrder__c

Buying Order

Insertion Order ID

Auto

Campaign

Campaign

Id

Auto

BuyingOrder__c

Insertion Order IDBuyingOrder__c

ID

It will be assigned after the Buying Order is submitted

N/A

N/A

Auto

Campaign

StartDate

-

Availability

ADvendio currently uses ‘Available’ as the fixed default

Buying Order

Start Date

-

Campaign

EndDate

StartDate

-

BuyingOrder__c

Buying Order

End Date

-

Campaign

CampaignTypeBuyingOrder__c

EndDate

(tick)

-

Buying Order

OrderType

  • Standard

ProgrammaticGuaranteed

(tick)

Campaign

Objective

(tick)

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

Channel and at least the Primary Goal for the campaign.

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

(tick)

Campaign

Budget (Amount + Currency Code)

(tick)

Order

Budget Amount

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

Campaign

Buying Order

Budget Amount Daily

Budget

-

Order

Campaign

Daily Budget

Amount Daily

only

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

Campaign

Primary Channel

-

Order

Selected Targeting

  • Display

  • Video

  • Audio

  • TV

  • NativeDisplay

  • NativeVideo

  • DigitalOutOfHome

Buying Order

N/A

-

Campaign

Primary Goal

-

Order

Fixed: MaximizeReach

Campaign

What is the Default??

Order

Status

Campaign

Budget Impressions

Order

(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.

Campaign

Buying Order

Budget

Impressions

Impression Daily

-

Order

Campaign

Budget

Impression

Impressions Daily

It also can be selected at a Buying Item level

Campaign

TimeZone

Fixed:

Buying Order

Start Date

-

Campaign

TimeZone

Get the timezone from the item zone.

Buying Order

N/A

(tick)

Campaign

Pacing

Order

  • ADvendio currently uses Off

Off

  • The campaign will aim to pace to the specified daily spend cap.

PaceToEndOfFlight The campaign will aim to spend the allotted budgets evenly throughout the flight dates.
PaceAhead The campaign will aim to spend 20% above the allotted budget on a day-to-day basis.

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 “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

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