[Buying Campaigns, Buying Orders & Buying Items] How to set up your bookings for Google DV360 in ADvendio
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. This can be done during the creation of Buying Orders OR you can assign to already existing Buying Campaigns in ADvendio. For more information check: 10.1.7 Buying Campaign Creation
ADvendio Field | DV360 Settings | Additional information |
|---|---|---|
Advertiser | Select the advertiser for your campaign |
|
Buying Campaign Name Long | Campaign Name | The standard Name field is limited to 80 characters, to set longer names for your DV360 Campaigns, you can use this field. |
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 |
Creating Buying Campaign records is OPTIONAL in ADvendio. However if you do not use a Buying Campaign in ADvendio, our Integration will always attach Orders to newly created Campaigns in Google DV360 using the Insertion Order Advertiser, Name, Start and End Date.
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
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. |
|
Auto | Auto | Order Objective in DV360 is defaulted to “Order without Objective” |
|
| 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“ | |
Set Optimization Order Level |
|
| |
| Order Bid Strategy |
| possible values:
|
| Avg. Goal CPM |
|
|
| Priority |
| possible values:
|
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. If any on these values are set on the Goal KPI then a Goal KPI amount is required:
|
Only if Goal KPI is selected | Goal KPI Percent | In combination with the Goal KPI, sets a target percentage for your KPI. | If any of these values are set on the Goal KPI then a Goal KPI percent is required:
|
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 | |
Order Pacing | Defines a pacing setting for your buying order. | Posible values:
| |
| Pacing Value | Set’s a pacing amount, if daily order pacing is selected. | *Only required if Daily order pacing is selected |
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:
| |
| Target Platform | Allows to set which Environment/Platform you want to target. If you do not set a selection in ADvendio, we will use Web & App as default
| 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 |
| Selected Targeting | Contains the technical targeting information as set by ADvendio. | [Targeting] DV360 Supported Targeting (Campaign Item + Buying Item) |
Setup
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. (No need to add them to other Record Types, as DV360 and Xandr are the only integrations supporting this selection).
The following images show an example of the fields added in the above-mentioned sections:
Update Picklist Field Values:
It might be that you can’t find certain values for fields like Goal KPI or Bid Strategy 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.
Object: Buying Order Field: Goal KPI Picklist Values:
Add these exactly (API value must match):
CPM
CPC
CPA
CPV
CPIAVC
CTR
VIEWABILITY
MAXIMUM_PACING
CVR Click
CVR Impression
vCPM
VTR
Completion Rate Audio
Completion Rate Video
CPCL
CPCV
TOS10
Other
Object: Buying Order Field: Order Bid Strategy Picklist Values:
Fixed Bid
Maximize Clicks
Maximize Conversions
Maximize Viewable Impressions
Maximize Completed In-Views Audible
Maximize Viewable Impressions For At Least 10 Seconds
Object: Buying Order & Buying Item Field: Priority Picklist Values:
Prioritize Deals
Prioritize equally
Object: Buying Item Field: Bid Strategy Picklist Values:
Fixed Bid
Maximize Clicks
Maximize Clicks (Target)
Maximize Conversions
Maximize Conversions (Target)
Maximize Viewable Impressions
Maximize Completed In-Views Audible
Maximize Viewable Impressions For At Least 10 Seconds
Object: Buying Item Field: Target Platform Picklist Values:
Environment Web Optimized
Environment Web Not Optimized
Environment App