[Buying Campaigns, Buying Orders & Buying Items] How to set up your bookings for Google DV360 in ADvendio

[Buying Campaigns, Buying Orders & Buying Items] How to set up your bookings for Google DV360 in ADvendio

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

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:

  • CPM

  • CPC

  • CPA

  • CPIAVC

  • CTR

  • VIEWABILITY

  • CPV

  • MAXIMUM_PACING

  • CVR

  • IMPRESSION_CVR

  • VCPM

  • VTR

  • AUDIO_COMPLETION_RATE

  • VIDEO_COMPLETION_RATE

  • CPCL

  • CPCV

  • TOS10

  • OTHER

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:

Screenshot 2024-03-11 at 22.12.05.png

Once a Budget Type is selected, it won’t be editable anymore

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.

 

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:

  • Fixed Bid

  • Maximize Clicks

  • Maximize Completed In-Views Audible

  • Maximize Conversions

  • Maximize Viewable Impressions

  • Maximize Viewable Impressions For At Least 10 Seconds

 

 

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:

  • CPM

  • CPC

  • CPV

  • CPIAVC

  • CTR

  • VIEWABILITY

  • CPA

  • Other

  • MAXIMUM_PACING

  • Cost Per Youtube View (CPV)

  • Click Conversion Rate (CVR)

  • Impression Conversion Rate

  • vCPM

  • Youtube View Rate (VTR)

  • Audio Completion Rate

  • Video Completion Rate

  • CPCL

  • CPCV

  • Time on Screen +10 Seconds (TOS10)

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:

  • MAXIMUM_PACING

  • CPIAVC

  • CPCL

  • CPA

  • CPM

  • CPC

  • CPV

  • VCPM

  • CPCV

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:

  • CTR

  • Impression Conversion Rate

  • Click Conversion Rate

  • Completion Rate (Video)

  • Completion Rate (Audio)

  • YouTube View Rate

  • Viewability

  • TOS10

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

Order Pacing

Defines a pacing setting for your buying order.

Posible values:

  • Daily ASAP

  • Daily Even

  • Flight Ahead

  • Flight Even

 

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

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

 

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

ENVIRONMENT_WEB_OPTIMIZED = the default Web environment in DV360

ENVIRONMENT_WEB_NOT_OPTIMIZED is an additional setting to also target not optimized web inventory, and can only be selected in combination with: ENVIRONMENT_WEB_OPTIMIZED

possible values:

Environment Web Optimized

Environment Web Not Optimized

Environment App

 

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

 

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:

Screenshot 2024-10-25 at 19.07.59.png
Cannot set properties of undefined (setting 'label')

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:

Screenshot 2024-10-25 at 17.59.25.png
Screenshot 2024-10-25 at 18.01.10.png

 

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