Available with Version: | 2.146 |
|---|---|
Role | Order Manager - Fulfilment; System Administrator |
ADvendio Edition | Connections |
External Systems | Google Display & Video 360 |
Challenge
You are planning to use the ADvendio Media Buying features to purchase media via Google Display & Video 360.
Solution
This article covers the necessary fields and configurations for setting up Buying Orders and Buying Items with the Google Display & Video 360 Integration (further referred to as DV360).
Programmatic Buyer import
1. Buying Configuration
To begin the buying configuration process for successfully pushing Buying Orders/Items to DV360, follow these steps:
Access the App Launcher and search for "Buying Configurations."
Once in the "Buying Configuration" section, click on "New" to start
General Information
Select “DV360” as a connection and select the “Active” checkbox
The following image shows the recommended set of fields to add for the DV360 integration:
2. Buying Campaigns (OPTIONAL)
You can directly configure Buying Campaigns in ADvendio, they will equal Campaigns in Display & Video 360.
ADvendio Field | DV360 Settings | Additional information |
|---|---|---|
Advertiser | Select the advertiser for your campaign | |
Start / End Date | Sets the start and end date for your campaign. | |
Goal KPI | possible values:
| |
Goal KPI Amount | If the Goal KPI is ‘Other’ this will be ignored |
As of April 2024 the Buying Campaign created in ADvendio has to be considered as a placeholder, meaning that it’s not possible to submit a Buying Campaign to DV360.
The record created in this section can be linked in the Buying Order to have an immediate overview of the relationship between the Order and the Campaign.
We’re planning to enhance this feature in the next releases.
3. Buying Order
Buying Orders in ADvendio are used to configure your Insertion Orders for DV360. If you are not using the ADvendio Buying Campaigns, we will reuse some information to create a new campaign in DV360 automatically.
With version 2.170 DV360 orders support two different Budget Types:
Impression Budget
Revenue Budget
The values are selectable from the dropdown menu that appears when creating a new Buying Order, as shown in the image below:
Once a Budget Type is selected, it won’t be editable anymore
Important Note
The ADvendio org in use may not include these two picklist values by default. If they are missing, an error will appear when creating a new Buying Order:
To avoid this issue, ensure the following fields are added:
Impression Budget
Amount Budget
Begin by adding them to the Buying Order Budget Type picklist, then include them in the Xandr and DV360 Record Type picklist values as well.
The following images show an example of the fields added in the above-mentioned sections:
Required | ADvendio Field | Description | Comments |
|---|---|---|---|
| Advertiser | Select the advertiser for your buying order | |
Auto | Connection | It shows the connection , related to the Buying Order in a read only field. | |
| Start / End Date | Sets the start and end date for your order. | |
| Budget Amount | Sets the total amount to use as budget for your order. | This field is always required, but the value will be sent to DV360 only when the selected Budget Type is “Revenue Budget” |
| Budget Impressions | Sets the number of impressions to use as budget for your order. | This field will be enabled only if the selected budget type is “Impression Budget“ |
| Goal KPI | Sets a KPI to be used for your order, this does not directly influence the bidding in DV360, but can be used for reporting purposes. | possible values:
|
Only if Goal KPI is selected | Goal KPI Amount | In combination with the Goal KPI, sets a target value for your KPI. | If the Goal KPI is ‘Other’ this will be ignored |
Auto | Insertion Order ID | It will be assigned automatically after the Buying Order is successfully submitted | |
| Status | Allows to set the status of your order. | Possible values:
Paused and draft are both setting the order to a paused status If nothing is set in ADvendio we use paused as default |
4. Buying Item
Required | ADvendio Field | Description | Comments |
|---|---|---|---|
| Start / End Date | Sets the start and end date for your item | |
| Budget Amount | Sets the total amount to use as budget for your item. | The type of budget used for your Buying Item, needs to be the same as used for the Buying Order. This field is always required, but the value will be sent to DV360 only when the selected Budget Type is “Revenue Budget” |
| Budget Impressions | Sets the number of impressions to use as budget for your item. | The type of budget used for your Buying Item, needs to be the same as used for the Buying Order. |
| Bid Amount | Currently we only support the setting of fixed CPM bid, use this field to set your bid amount. | |
| Media Format | Select which media type to use. This information is required. | possible values:
|
Frequency Capping | Allows you to set up a frequency capping. | Please write down the setting in the following format 1 per 1 x while x can be one of the following units:
for example: 2 per 1 hour 1 per 2 day 10 per 1 lifetime | |
Status | Allows to set the status of your item. | possible values:
Paused and draft are both setting the order to a paused status If nothing is set in ADvendio we use paused as default |
Setup
Update Picklist Field Values:
It might be that you can’t find certain values for fields like Goal KPI in your ADvendio environment. In this case, you have to manually update those in your Salesforce Setup.
Please use the values listed in the table above. Make sure to match the terms here with the API value of your picklist values. If you want, you can change the label to your desired terms, as long as the API value matches those expected by ADvendio.
In order to change the picklist fields in Salesforce, you need to go to the setup and either edit the fields on the Buying Campaign, Buying Order and Buying Item object directly or you need to navigate to the Picklist Value Sets.
