[Buying Orders & Buying Items] How to configure them in Google Display & Video 360. Supported settings

Available with Version:

2.146

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."

  1. 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:

Screenshot 2024-03-11 at 18.14.53.png

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

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:

  • CPM

  • CPC

  • CPV

  • CPIAVC

  • CTR

  • VIEWABILITY

  • CPA

  • Other

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. (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:

 

Required

ADvendio Field

Description

Comments

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:

  • CPM

  • CPC

  • CPV

  • CPIAVC

  • CTR

  • VIEWABILITY

  • CPA

  • Other

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:

  • active

  • paused

  • draft

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

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.
This field will be enabled only if the selected budget type is “Impression Budget“

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:

  • Display

  • Video

  • Audio

 

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:

  • Minute

  • Hour

  • Day

  • Week

  • Month

  • Lifetime

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:

  • active

  • paused

  • draft

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.