[Programmatic Module] - Guaranteed Deal Media Campaign and Line Item Creation & Mapping

External Systems	Freewheel
Version	From version 2.173

Context

The programmatic Guaranteed Deal feature allows configuring certain fields to create a Deal with all the required elements.

Creating a PG Deal

Before starting the deal creation

Import via “Transfer to Advendio” the Programmatic Buyers
1. Global Agency is displayed but not selectable at the moment
Any additional Targeting needed to be able to select them later on in the Buying Campaign Targeting
1. What import is supported by Freewheel
2. More info about how to do this here 3.5.3.1 [Transfer to ADvendio] How to automate the sync of audiences and videos between ADvendio and external platforms?

Creating the Deal

An important structure fact to understand is that Freewheel Deals are only deals with no parents, for that reason Advendio’s Media Campaigns and Campaign Items as such won't be submitted to FW

1.- Create a Media Campaign

Before starting the process be sure to add the Field Programmatic Buyer if it is missing in your current layout
- Check that the proper association with a Programmatic Buyer has been done
Create a new Media Campaign
The most important option for PG is to consider choosing the Adserver Order Type ‘Proposal’ to start creating a Deal in Freewheel
Here you can find the remaining Fields that need to be present:

Mandatory	Advendio Object	ADvendio Field	Freewheel Field	Values	Comments
	Media Campaign	Name	-	-	Only for internal order in ADvendio
	Media Campaign	Programmatic Buyer *	Bidder Name	Programmatic Buyer	Assign one Programmatic Buyer and it will become the buyer seat for all the Deals Only if there are NO buyer seats targeted
	Media Campaign	Adserver Order Type	Deal Type	Proposal
-	Media Campaign	Programmatic Buyer	-	-	It will become all of the Campaign Items Buyers
	Media Campaign	Campaign Start Date		Any date in the present or future
	Media Campaign	Campaign End Date		NO end date
-	Media Campaign	Description		Optional	Currently NOT mapped

Campaign Item

When creating a Campaign Item we are also creating the Deal at the same time in one seamless process.
When a PG Campaign Item is submitted will create an individual Deal in Freewheel for each Campaign Item that it contains, each one with its corresponding Deal ID
Here are the mandatory requirements to create a successful deal that need to be associated with a Campaign Item (Ad Type and Ad Price too) all the other fields are optional:

Mandatory	Advendio Object	ADvendio Field	Values	Freewheel Field	Comments
	Ad Type	AdType	Programmatic Guaranteed	-	⚠️ This option can also be selected on the “AdType” of a Campaign Item object
	Ad Type	Size	-	Deal/Ad Unit	The current default is used if nothing is selected
-		Roadblock	None Partial		‘None’ / empty value means roadblocking will be disabled ‘Partial’ means roadblocking will be enabled ‘Normal’ currently not accepted in Xandr ‘ExactMatch’ currently not accepted in Xandr
	Ad Price	Billing Category	Fixed Price (only option accepted)	Pricing	⚠️ These options can also be selected on the Billing Category of a Campaign Item object
	Campaign Item	Name	80 Char. max	Deal name	This will be the Campaign Item and the Deal name
	Campaign Item	AdServer Proposal Line Item ID	AUTO	Deal ID	An automatically generated external deal ID is returned when a deal is created.
	Campaign Item	Campaign Start Date		Deal Start date
	Campaign Item	Campaign End Date		Deal End date
-	Campaign Item	Quantity		Booked impressions
	Campaign Item	Budget Type	Impressions	Impression
	Campaign Item	Targeting → Content Targeting	-	Targeting	Content targeting is mandatory It supports the same targeting used for the current placements Consider EXISTING TARGETINGS requirements
	Campaign Item	Targeting → Accounts Targeting	Buyers *	Buyers	The limit of buyers allowed per Campaign Item is 100 By default, all of the Campaign Items will have assigned the programmatic Buyers selected at a Media Campaign level When a CI has one or more buyers selected these will be the buyers assigned and NOT the one in the Media Campaign If I have more CI in the same Media Campaign and they DONT have a Buyer as a targeting then they will preserve the Programmatic buyer from the Media Campaign
	Campaign Item	Targeting → Yield Optimization	Look at the options here	Yield Optimization	Import needs to be done before being able to select them

IMPORTANT about Programmatic Buyers *

Programmatic Buyer at a Media Campaign level
- Select a Programmatic Buyer if you want all of the Campaign Items to have assigned the programmatic Buyers selected at a Media Campaign level
- If I have more CI in the same Media Campaign and they don’t have Buyers as targeting then they will preserve the Programmatic buyer from the Media Campaign
Programmatic Buyer at a Campaign Item Level
- If you want individual Buyers to be selected on a Campaign Item level they need to be chosen as targeting on each item, and when a CI has one or more buyers selected these will be the buyers assigned and NOT the ones chosen as Programmatic Buyer in the Media Campaign

Now you are ready to submit and check the newly created/updated deal in Freewheel UI
Check availability can be performed