Versions Compared

Key

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

Context

Enhance our Xandr Integration for

Context

  • vCPM, CPC and CPCv based bookings to can work with guaranteed outcomes instead of impressions, this way users in ADvendio can set up Campaigns based on a target number of viewable impressions; clicks, or completed views and book these settings directly to Xandr. Creating a more seamless transition of the data between the two systems and less effort adjusting bookings manually in Xandr.



1. When setting Outcomes on an ALI (Augmented Line Item) Campaign Item

...

First, you need to

...

Note

Attention:

When you select seamless as feature for Xandr, all Media Campaigns/Insertion Orders will be pushed as seamless. You can only either use the standard IOs (legacy IO) or seamless IOs.

Not all line item types will work with Seamless Insertion Orders, please check which line items you use before activating the feature and test accordingly.

2. Insertion Order Budget Types (2.151.1 and up)

Starting with version 2.151.1, a new field has been added to ADvendio at the level of Media Campaign: Budget Type (ADvendio__BudgetType__c). That allows users to choose the desired budget type associated with their seamless Insertion Order: none (default: Revenue), Revenue, and Flexible.

Image Removed

  • If Budget Type is none, then the Media Campaign will be submitted as an Insertion Order with budget type Revenue.

  • If Budget Type Revenue is used at the Media Campaign level, then the Xandr Insertion Order will receive a lifetime revenue budget and all Augmented Line Items will use a revenue budget, not an impression / clicks budget. We set the Budget on Insertion Order level to unlimited (one budget interval).

  • If Budget Type Flexible is used at the Media Campaign level, then the Xandr Insertion Order will be restricted to a single budget interval, and no budget can be set on the IO level. Once configured, the user may associate both revenue and impression-based Line Items to the same Insertion Order.

3. Setup:

...

You may need to add to Media Campaign Page Layout the Budget Type field (ADvendio__BudgetType__c)

...

Double-check if the Budget Type field is available to the relevant users

Double-check if the picklist field values exist in the Budget Type field. For that, access from Org Settings Picklist Value Sets and adjust accordingly Budget Type global value set:

...

Revenue (Value and API Name)

...

set up the following specifics:

  1. On the AdType:

    1. Product Type → Video

    2. AdType → Augmented (ALI)

    3. Plus the necessary extra fields you required

  2. On the Adspec:

    1. Create an AdPrice indicating your Billing category of choice

      1. The following billing categories are accepted in Ad Price or Campaign Item Level

        1. CPM = Impressions

        2. vCPM = Viewable Impressions

        3. CPCv = Completed Video Views

      2. The “quantity” of each billing category is selected also at a Campaign Item Level

  3. On the Media Campaign

    1. Select one of the Budget Types

      1. Revenue :(Fixed Revenue in Xandr)

      2. Impression :(Fixed Revenue in Xandr)

      3. Flexible :(Flexible Revenue in Xandr)

        image-20240110-185515.pngImage Added


  4. On your Campaign Item(s)

    1. Select one of the Ad Types Delivery Types options

      1. Exclusive

      2. Impressions

        image-20240110-185327.pngImage Added


  5. ⚠️ IMPORTANT: The Media Campaign ‘Budget Type’ needs to go in accord with the Billing category selected in the AdPrice

    1. Revenue or Impression only works with the following Billing Category:

      1. CPM

      2. vCPM (Viewable CPM)

      3. CPCv

    2. Flexible works with the following Billing Category:

      1. Dynamic CPM

      2. Cost Plus

  6. The desired Outcomes are properly configured, if everything else is done the Items must be submitted to Xandr


...

2. When setting Outcomes on a GDALI Line Item

First, you need to set up the following specifics:

  1. On the AdType:

    1. Product Type → Video

    2. AdType → GDALI (Guaranteed Augmented)
      ⚠️ Only on this option you can opt to have ‘Budget → Complete' in Xandr UI (Available from version 2.170) ⚠️

      image-20240416-211040.pngImage Added

    3. Plus the necessary extra fields you required

  2. On the Adspec

    1. Create an AdPrice indicating your Billing category of choice

      1. The following billing categories are accepted in Ad Price or Campaign Item Level

        1. CPM = Impressions

        2. vCPM = Viewable Impressions

        3. CPCv = Completed Video Views

      2. The “quantity” of each billing category is selected also at a Campaign Item Level

  3. On the Media Campaign

    1. Select one of the Budget Types

      1. Revenue :(Fixed Revenue in Xandr)

      2. Impression :(Fixed Revenue in Xandr)

      3. Flexible :(Flexible Revenue in Xandr)

  4. On your Campaign Item(s)

    1. Select one of the Ad Types Budget Types options for your Campaign Item(s)
      ⚠️ DELIVERY TYPE ALWAYS NEED TO HAVE AN OPTION SELECTED ⚠️

      1. Revenue (Fixed Revenue in Xandr)

      2. Impression (Fixed Revenue in Xandr)

      3. Flexible (Flexible Revenue in Xandr)

  5. IMPORTANT: The Media Campaign ‘Budget Type’ needs to go in accord with the Billing category selected in the AdPrice

    1. Revenue or Impression only works with the following Billing Category:

      1. CPM

      2. vCPM (Viewable CPM)

      3. CPCv

    2. Flexible works with the following Billing Category:

      1. Dynamic CPM

      2. Cost Plus

  6. The desired Outcomes are properly configured, if everything else is done the Items must be submitted to Xandr