7.3.12.8 [Integration Overview] of Xandr
- 1 Mapping
- 2 Accounts / Advertiser Management
- 3 Inventory
- 4 Media Campaign
- 4.1 AdServer Status
- 4.2 Campaign Items
- 4.3 Xandr Login Record
- 4.4 Create a Connection for Xandr
- 4.5 Comments on Line Items
- 4.6 KeyValue/Audience Segments
- 4.7 Delivery Data Import
- 4.8 Profiles in Xandr
- 4.9 Budget Types in Xandr
- 4.10 Xandr Limitations
- 4.10.1 Xandr Start Date Update Logic
- 4.10.2 Xandr Geo-Targeting
More Xandr Features related pages:
- [Configure Ad Type Formats] for Xandr products
- Transfer Offer number and External Code to Xandr
- Important migration step for Xandr users upgrading to 2.109 or higher
- How to configure the time zone used for Xandr Delivery Reports. Why are my Xandr monthly delivery data not matching the overall item performance?
- How to submit custom reporting labels with your Xandr Item or Order?
- [Creative Upload] How to setup the features for Xandr
- [Special features] Xandr
- [Error messages] Xandr
- [Deprecation] Xandr Standard Line Items API Deprecation: Impact on Customers and Migration Steps
Mapping
Accounts / Advertiser Management
According to our Integration logic, ADvendio is able to create new Advertisers in Xandr, based on your Account Data, or match them with existing ones. 2.1.4.5 How ADvendio matches your Salesforce Accounts with Advertisers, Agencies or Buyers in an external System?
For Xandr we have certain specific settings regarding the Advertisers:
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 :
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’
Setting Legal Entity Names: Following the Digital Services Act, Xandr added a Legal Entity Name to Advertisers. If you create a new Advertiser Account in ADvendio and then submit it to Adserver, ADvendio will create a new Advertiser in Xandr. In this process we will set the Account Name as Advertiser Name as well as Legal Entity Name. This only affects new Accounts. If an Advertiser has already been pushed to Xandr, we will not change the Legal Entity Name further. This change will be available starting version 2.173 and up.
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 |
---|---|
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 |
---|---|---|---|
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 7.3.1.1 Which Login User do I use to create Login records
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 Seamless Insertion Orders and Budget Types in Xandr.
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.