4.8.5 How to update the status of my Insertions Orders / Campaigns in the AdServer/SSP and approve Orders in Google AdManager?

Challenge:

You manage your insertion orders and line items, which are running in an external system like an AdServer, from ADvendio. To set your positions live and have them delivered, you might need to first change the status of your Insertion Order or Campaign in the other system. For Google AdManager for example, an order needs to be approved, before the items start delivering.


Solution: 

To transmit the status of your campaigns to the AdServer you can use the AdServer Status field in the Media Campaign object. Set the field to your desired status and with the next click on submit to AdServer, the status will be transferred to the external system.


This will update the Insertion Order Stage (for Freewheel) or the Insertion Order Status (Xandr & Equativ).

Please make sure not to mix this up with the AdServer Status on the Campaign Item: 7.3.13 Configure "Update Ad-Status in AdServer" for Campaign.Items


Approve Orders in Google AdManager - Available with Version 2.135

To approve an Order in Google AdManager, which is needed to activate line items and start delivering, please set the AdServer Status field to active. 

Once this is done, with the next submission, the order will be approved in Google AdManager. 

Currently we only approve orders from ADvendio. If you set the field to inactive will not change the status of the Order in Google again. The order approval is needed as a step to put Campaign Items live, so that they can start delivering, it should still be possible to modify order and line items like before. If for some reason you still need to remove the approved status from an order, you will need to do this directly in Google AdManager.


Setup:

To use this feature you need to make sure your users have read and edit permissions to the following field on Media Campaign Object:

  • ADvendio__AdserverStatus__c

You might need to manually update the available picklist values for the field or, if you are using Media Campaign record types, make sure that the picklist values are assigned to the right record types.

These are the possible picklist values and for which systems they apply:

ADvendio

AdServer Status

Google Ad Manager

FreeWheel Stage of Insertion Order

Xandr Status

Equativ Status

ADvendio

AdServer Status

Google Ad Manager

FreeWheel Stage of Insertion Order

Xandr Status

Equativ Status

active

approve order

booked

active

N/A

inactive

not approved

not booked

inactive

N/A

proposal

N/A

proposal

N/A

N/A

draft

N/A

N/A

N/A

draft

prebooked

N/A

N/A

N/A

prebooked

booked

N/A

N/A

N/A

booked

sold

N/A

N/A

N/A

sold

cancel

N/A

N/A

N/A

cancel

In order to set an Insertion Order to the stage booked in Freewheel, you need to make sure that all Placements of that Insertion Order have the needed information. They need to have at least one Ad Unit and the Content Targeting needs to be set (Videos, Video Groups, Video Series, Sites, Site Sections and/or Site Groups).