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 advertiserAdvertiser

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

    Paused (

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