7.3.12.8 [Integration Overview] of Xandr

More Xandr Features related pages: 


Accounts / Advertiser Management

According to our Integration logic ADvendio is able to create new Advertisers in Xandr, based upon your Account Data or match them with existing. https://advendio.atlassian.net/wiki/spaces/SO/pages/256508067

For Xandr we have certain specific settings regarding the Advertisers:

  1. ADvendio sets in Xandr the Advertiser Name and the Billing Name, please note the Billing Name is limited to 50 characters. In case your Salesforce Account name is longer, you can use a dedicated field called ‘Advertiser Name’ to set a specific name for Xandr, which considers the limitations :

    Bildschirmfoto 2024-02-26 um 14.02.45.png
  2. Xandr offers to set up Advertisers with either a 12-hour-time scheme or a 24-hour-time scheme. Default from ADvendio is the 12 hour scheme, but you can change this on your Xandr Connection record. In the field Connection Features, you need to enable the option ‘24-hour Format’. In case this option is not shown to you, you will need to manually add this to the picklist field in the Salesforce Setup. To do so, go to the Object Manager → Connections (AdServer_Login__c) and edit the field Connection Features (AdServerFeatures__c) to add a new picklist value, with the exact name: ‘24-hour Format’

    Bildschirmfoto 2024-02-26 um 13.50.25.png

Inventory

Read here about how to set up your inventory Ad Types for Xandr: 3.1.5.4 How to configure formats for your Xandr-related products (Ad Type)

Billing Categories

For Xandr we support the following Billing Categories which are mapped to a slightly different value on the AdServer:

ADvendio

Xandr

ADvendio

Xandr

CPM

CPM

vCPM*

Viewable CPM / vCPM 

CPC

CPC

CPD**, All In, CPL, CPM Sec, CPO, CPX, CPW, CPMo, CPY

Fixed Fee (Cost per day)

CPCV

CPCV (Cost per Completed View)

Fixed Price***

Fixed Fee (One time allocation) 

The allocation date will be set to one day after the Campaign Item end date.

currently not supported

Cost Plus

currently not supported

CPA



* Viewable CPM is only supported for Line Items of type Guaranteed or Augmented. Keep in mind, that if you are using Viewable CPM the goal (budget) of your Line Item automatically changes to viewable Impressions instead of Ad Impressions.

** Make sure that, if you are using CPD (Fixed Fee Cost per Day), your Line Item starts at 12:00:00 AM and ends at 11:59:59 AM (do run only FULL days) otherwise you receive an "Invalid Start Date / Invalid End Date error"

*** Make sure that, if you are using Fixed Price (Fixed Fee, One Time allocation), your Line Item has a runtime of 31 days or fewer. Fixed Fee Items can only run for a month in Xandr, otherwise you receive an "Invalid Start Date / Invalid End Date error"

Media Campaign

AdServer Status

Xandr uses the status field ADvendio__AdserverStatus__c on the media campaign which you need to add to your layout to edit or view for relevant users (AdOps/Sales). The users can then select the status for the campaign and its campaign items which then will be sent to the AdServer. Please also consider the following chapter and make sure that the mapping in the custom setting is correct: 7.3.14.1 Configure "Update Ad-Status in AdServer"

Campaign Items

Also, configure the following fields on the object. Some of these fields were not in use by the Xandr integration before, so you might have to change your Salesforce configuration accordingly, see below the table:

ADvendio Object

ADvendio Field

Xandr Setting

Additional Information

ADvendio Object

ADvendio Field

Xandr Setting

Additional Information

Campaign Item

Quantity

Will be used as the lifetime custom budget



Campaign Item

Secondary 

Will be used ad the daily custom budget

This field is required, if you want to use a daily custom budget

Xandr Login Record

The Adserver Login is used to store your Xandr credentials. For the fields and details needed, access https://advendio.atlassian.net/wiki/spaces/SO/pages/162758663

Create a Connection for Xandr

 

Comments on Line Items

You can use the ADvendio field Internal Comment on the Campaign Item level to push information to the comment field of the campaign item in Xandr. When you submit the Media Campaign to Xandr the field value will be transmitted.


KeyValue/Audience Segments

KeyValue/Audience Segments

If you set a Key Value or Audience Segment in ADvendio to "not equals" it will be submitted as "excluded" to Xandr.

Delivery Data Import

The Campaign Item status will be synced each time the delivery data import is running (AdServer →  ADvendio). The status of the media campaign (see above) will be kept in sync with the campaign item. This happens initially when you create the item on the AdServer while pushing it to the server and secondly when you update manually using the button "update status" or run the delivery import. 

Profiles in Xandr

Please note that Xandr offers to target profiles to determine individual targeting. The 4.3.4 Targeting Options you choose for your Campaign Item will be saved to such a profile and transferred to Xandr.

From version 2.106 and up we only connect these profiles to Line Items and not to the Insertion Order anymore.

This makes it possible to control the targeting settings on each Campaign Item separately.

Budget Types in Xandr

Starting with 2.151.1, we can configure the Budget Type (ADvendio__BudgetType__c) of your seamless Insertion Order. To find out more about the Xandr Seamless Connection and Budget Type, see https://advendio.atlassian.net/wiki/spaces/SO/pages/3047849995.

Xandr Limitations

Xandr Start Date Update Logic

Important Note:

When using Xandr Campaign Items, if you set a Start Date in the past, you cannot modify it later, even if the item is still in draft mode and hasn't been launched yet.

Xandr Geo-Targeting

In a Xandr campaign item when you are navigating to Targeting > Geo:

  • if you choose to include options, you can only continue adding options to include and NOT exclude any.

  • if you choose to exclude options, you can only continue excluding options and NOT include any.