Available with Version	2.173 and up

Available with Version	2.173 and up
Role	Order Manager - Fulfilment; System Administrator
External Systems	Criteo Commerce Max

1 Buying Configuration
- 1.1 What fields to expect
2 Buying Order
3 Buying Item
- 3.1 Submit Buying Orders to adserver

Challenge

If you plan to use the ADvendio platform features to buy media via Criteo using ADvendio, this article will guide you through the necessary fields and configurations to set up your Buying Order and Items with Criteo Integration.

Buying Configuration

To begin the buying configuration process for successfully pushing Buying Orders/Items, follow these steps:

Access the App Launcher and search for "Buying Configuration."
Once in the "Buying Configuration" section, click on "New" to start
Select “CRITEODSP” connection and select the “Active” checkbox
All the required fields associated with the record type are already associated
- You can choose to add additional fields for any custom needs, if they are not associated with Criteo they won't work

What fields to expect

Buying Order Fields, the necessary fields (mandatory and optional) are already preselected:

Mandatory field	Advendio Name (label)	CRITEO Field

Mandatory field	Advendio Name (label)	CRITEO Field
✅	Advertiser	Account
✅	Buying Order Name	Campaign Name
✅	Order Type	Campaign Type
✅	Status	Status
✅	Order Pacing	Automated Daily Pacing
✅	Start Date	Start Date
-	End Date	End Date
✅	Budget amount	Budget amount
-	Unlimited Budget	Uncapped
-	Budget Amount (Monthly)	Budget Amount (Monthly)
-	Budget Amount (Daily)	Budget Amount (Daily)
✅	Post-Click Lookback	Post-Click Lookback
✅	Post-Click Product Match	Post-Click Product Match
✅	Post-View Lookback	Post-View Lookback
✅	Post-View Product Match	Post-View Product Match

Buying Item Fields, the necessary fields (mandatory and optional) are already preselected

Mandatory field	Advendio Name (label)	CRITEO Field

Mandatory field	Advendio Name (label)	CRITEO Field
✅
✅	Retailer	targetRetailerId
✅	Start Date	Start Date
-	End Date	End Date
✅	Not present but sent	Ad Schedule
-	Unlimited Budget	Capped/Uncapped
-	Budget Amount	Budget
-	Budget Amount (Monthly)	Monthly Pacing
-	Budget Amount (Daily)	Daily Pacing
✅	Pacing	Auto Daily Pacing

Buying Order

To initiate buying media through CRITEO DSP, you must define a Campaign using the ADvendio Buying Order or you can add them directly to a Media Campaign. Here are the steps:

Access the App Launcher and search for "Buying Orders"
Once in the "Buying Orders" section, click on "New" to begin
Choose the appropriate Source
1. Select the Record Type as "CRITEODSP"
2. Choose the previously created Connection
  (ALL THE ACTIVE CONNECTIONS WILL BE DISPLAYED HERE)
3. Click on "Save”
Add a name for the Buying Order
Complete all the required fields to determine your Criteo Campaign objective

When creating a new Buying Order, ensure the presence of the following fields:

Mandatory	ADvendio Field	Advendio Name (label)	Type	Value	CRITEO Field (as provided by API)	Comments

Mandatory	ADvendio Field	Advendio Name (label)	Type	Value	CRITEO Field (as provided by API)	Comments
✅	InsertionOrderID__c	Insertion Order ID	String	ID	ID (in domain)	Automatic after successful submit
✅	Advertiser__c	Advertiser	Lookup	Advertiser Account	AccountId
✅	Name	Buying Order Name	String	Text	Name
✅	OrderType__c	Order Type	Picklist	Auction Preferred	Campaign Type	API name is Auction for Sponsored Products campaign
✅	Status__c	Status	Picklist	Active Paused	Status
✅	OrderPacing__c	Order Pacing	Picklist	Automate Daily Pacing None	isAutoDailyPacing	Null is the default is left empty/unchecked
✅	StartDate__c	Start Date	Date	-	startDate
-	EndDate__c	End Date	Date	-	endDate
✅	BudgetAmount__c	Budget amount	Currency	Capped	Total Budget	If there is an amount present the option will be sent as “Capped”
-	UnlimitedBudget__c	Unlimited Budget	Checkbox	Uncapped	Total Budget	If selected will be Uncapped and the value present in the Budget amount field is NOT sent
	BudgetAmountMonthly__c	Budget Amount (Monthly)	Currency	Amount in number none (default)	Monthly Budget
	BudgetAmountDaily__c	Budget Amount (Daily)	Currency	Automated Amount in number None	Daily Budget
-	-	-	-	0.0 (Default is sent)	budgetSpent	This field is not present in Advendio
						Post-Click Settings
✅	PostClickLookback__c	Post-Click Lookback	Picklist	7 Days 14 Days 30 Days (Default)	clickAttributionWindow	Lookback Window
✅	PostClickProduct__c	Post-Click Product Match	Picklist	Same product Same product, same category (Default) Same product, same category, same brand	clickAttributionScope	Product Match
✅	PostViewLookback__C	Post-View Lookback	Picklist	1 Day (default) 7 Days 14 Days 30 Days	viewAttributionWindow	Lookback Window
✅	PostViewProduct__C	Post-View Product Match	Picklist	Same product (Default) Same product, same category Same product, same category, same brand	viewAttributionScope	Post-View Settings Post-view lookback and Post view Product Match can't exceed Post-click lookback and Post-Click Product Match values Ex. If I select 7 days on the post click I can't select 30 days on the Post view

Buying Item

Once you have created a Buying Order, you can proceed to configure individual Buying Items, which correspond to Line Items. These Buying Items allow you to manage your media spend by setting up details such as bidding strategy, goals, and automatic optimizations. You have the flexibility to create as many Buying Items as needed for your Buying Order.

Each Buying Item can have a different Retailer

Mandatory	ADvendio Field	Advendio Name (label)	Type	Value	CRITEO Field (as provided by API)	Comments

Mandatory	ADvendio Field	Advendio Name (label)	Type	Value	CRITEO Field (as provided by API)	Comments
✅	Name	Buying Item Name	String	Text	Name	Unique name validation is required upon creation
✅	LineItemID__c	Line Item ID	String	ID	campaignId (in domain)	Automatic after successful submit
✅	Retailer__c	Retailer	Lookup	Retailer Account	targetRetailerId	Only one can be selected Can’t be change after there is a valid Line Item ID present, the changes would not be aplied
✅	StartDate__c	Start Date		Dates	startDate	-
-	EndDate__c	End Date		Dates None	endDate	No dates means End date none
✅	AdSchedule__c	Ad Schedule	Not present	Run ads all the time (Default)	Ad Schedule (No reference in the API documentation its NOT added)	Run ads all the time only option for now “Run ads on a schedule” option would need more fields to be considered now.
-	UnlimitedBudget__c	Unlimited Budget	Picklist	None (Default) Uncapped	Capped/Uncapped	None: Only accepted if Budget amount has a value Uncapped: Doesnt send the currency Value, and send the “uncapped” value
-	BudgetAmount__c	Budget Amount	Currency	Currency	Budget	When selected needs to be sent as option “Capped”
-	BudgetAmountMonthly__c	Budget Amount (Monthly)	Currency	Currency None (Default)	monthlyPacing	If no Currency consider as “none”
-	BudgetAmountDaily__c	Budget Amount (Daily)	Currency	Currency None (Default)	dailyPacing	If no Currency consider as “none”
✅	Pacing__c	Pacing	Picklist	Automate Daily Pacing None (Default)	isAutoDailyPacing	If set to “active” one of these 2 conditions must be present: The Buying Item must hae an end date and Budget Monthly Pace needs to have a value If selected it also overwrites Budget Amount (Daily)/Daily pacing

Submit Buying Orders to adserver

Now you are ready to submit for the first time or update your changes

Go to the buying Order and click on the ‘Submit Buying Order to Adserver’
Select the Buying Items that need to be submitted to the external platform
- This also applies to Buying Items that need to be updated
After the process is successfully finished you will get a confirmation and the corresponding Buying Order and Buying Item IDs will be shown
Now you can go and check that everything is OK directly in the CRITEO platform.

ADvendio Knowledge Base

[Buying Orders & Buying Items] How to configure them in CRITEO DSP