Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


As soon as your customer has agreed on the proposal, you can submit your media campaigns, including all targeting settings, directly from ADvendio.com to your ad server without the need to log into your ad server separately.

...

titlePop-up Blocker

...

Role
Order Manager - Fulfilment
VersionAll Versions
External SystemsGoogle AdManager, Freewheel, Adswizz, Smart, Xandr

Challenge:


Once a proposal has been accepted by the customer and the configuration of Campaign Items is finalized, the Orders and items need to be submitted into external systems, like AdServers or SSPs. It needs to be ensured that the right configuration will be set up in that system and that any IDs returned will be matched to the right Campaign Items. For later stages there needs to be a way to identify which ADvendio Campaign Item belongs to which Line Item in the external system. 

This can be a time consuming processes and can also be error prone, when the configurations have to manually set in the external system. 


...

Solution:

1. Select Items and Submit

Navigate to the Campaign Item related list of your Media Campaign and open the View All to have the checkboxes available. Then select the items you like to submit.

Info

Tired of always having to open the related list, before you can select the Campaign Items to

...

submit? Have a look at our Campaign Item Related List component! You can simply embed it into your record pages and use many features, which will make working with Campaign Items more comfortable for you!


Image Added

Click the "Submit to ADserver" Button. You can submit items separately to your ad serverconnected system or you tick the checkbox next to Action and submit all items at once.

Warning

If you like to substitute products in your already submitted Media Campaign (add new line item and delete the old) make sure that you also have submitted the affected Campaign Items to the AdServer before deleting. Otherwise the Adserver Gateway will have no access to the order ID and you will create a new order (for DFP you will get an error message because the order has the same name as the old)

2. Result Page 

...

Image Removed

...

A new window will open, showing the progress and results of the submit.

Image Added

There are two sections shown, one for the Media Campaign information, which are used to create insertion orders and the second for the line items, created based on Campaign Items.

Each item is collapsed by default. The symbol on the right will show the result status. By clicking on the Name of a campaign or item, it can be expanded to show more details. In parallel a result mail will also be sent to the user that started the process, showing the same information.


Looking closer at the Campaign Items, there is a number added at the end of the name:

Image Added

ADvendio automatically adds the position number to the line item name, depending on whether you use packages or regular item this can look like '- 1' or '- 1.a'. This is done to ensure each item in a Media Campaign will have a unique name sent to the connected platform. Some AdServer require each item in an order to have a unique name and we prevent errors this way from occurring.


When the submission process is completed, the display shows success and error message information on the submitted items. The status is automatically updated if configured. See exeption for Freewheel below. 

Info
titleFreeWheel Status Updates

FreeWheel only

  • Version 2.101 and earlier: After submit to AdServer ADvendio automatically updates the status of the placement/line item in Freewheel,
  • Version 2.102 and up: Status update only happens using the update status button because you can't set placement/line item to active without creative in FreeWheel.

3. Possible Errors/Issues

3.1. „LineItemError.ALREADY_STARTED" when submitting to AdServer

This error happens because you have updated fields that affect delivery (i.e. targetings fields). There are fields like "notes" which don't affect the delivery numbers and you are be able to update those in your the line item without pausing. To be sure not to create problems, it is safer to always pause the line item (CampaignItem > AdServer Status), make the update and then activate the line item again.


...

3. Updates Information on your Campaign Items

Once the item has been submitted there are several information written back into the Campaign Item.

Image Added


  • Ad ID: contains the line item ID given by the connected system, this is later used to update the correct item from ADvendio and to get delivery data back into ADvendio
  • AdServer ID Order ID: contains the ID of the order of the line item in the connected system
  • Additional Ad IDs: Optional, contains additional line item IDs, if relevant for the connected system.
  • AdServer Proposal ID / Proposal Line Item ID: When using Programmatic Guaranteed for example, this stores the IDs of the programmatic proposal sent to the advertiser.
  • Last Booking Process: Shows when the last submit from ADvendio took place
  • Status submitted to AdServer: The status of the last submit process from ADvendio
  • Status message submitted to AdServer: In case there was an error or warning in the last submit, this message is saved here



4. Most common error messages

For the most common problems with submitting items, take a look at the following pages:

4.4.10 Why do I see this process is already running' and what does this mean for my usage of external systems from ADvendio (Check Availability, Submit, Transfer)

4.4.7 Why do I see communication to gateway failed and does this affect my usage of external systems from ADvendio (Check Availability, Submit, Transfer)

4.4.3 What are the most common error messages for our Google AdManager integration and how to fix them?

4.4.4 What are the most common error massages for our Freewheel integration and how to fix them?

4.4.5 What are the most common error massages for our Adswizz integration and how to fix them?

4.4.11 What are the most common error massages for our Xandr integration and how to fix them?

4.4.12 What are the most common error massages for our SMART integration and how to fix them?

Setup

Permission

To make sure users can access the submit feature, sufficient read and edit permissions are needed on the relevant objects and fields. More information can be found here: 7.3.1.2 Submit Prices to the AdServer

Also the button 'Submit to AdServer' needs to be included in the related list settings of the Campaign Item related list, within the Media Campaign page layouts. 

Re- Submitting to AdServer - or Update for Changes 

There is a checkbox on Campaign Item record "Submit to adserver" which the interface sets to false after the initial submission to the adserver. This will prevent unwanted updates of lineitems in the adserver, which might happen unintended. If you want to update/submit an item in/to the adserver again, please check the field and the click the button "Submit to adserver".

3.3. No Salesperson "XXXX" was found.

Please read here to set your sales person or teams. 3.5.10 Manage Teams, Ad Manager and Trafficker.

3.4. "CrossSellError.DISTRIBUTOR_RULE_VIOLATION_WARNING"

This warning from DFP can be suppressed if you like to avoid the cross selling warning from DFP. Mark the checkbox "skipCrossSellingRuleWarningChecks" on the line item to true to skip these warnings. These rules are applied to line items targeting inventory shared by a distributor partner for cross selling when performing any action on this line item. The default is false.

Image Removed

...

 

Image Added

In order to save manual work you can enable custom processes or lightning flows within your Salesforce environment, which will set the checkbox again after a Campaign Item has been submitted or if a certain optimization has been done, so the user does not have to manually change this.


This Media Campaign is being booked right now

Currently a booking process for this Media Campaign to the AdServer is running. Wait some time and see if Booking works again. Sometimes, when you encounter an error during the booking process, the system fails to reset the status of the Media Campaign. To check this go to your Media Campaign and look for a Checkbox called "Booking in Processing". If it is still set, please uncheck it and try again.

...


Automatically updating the line item status with the submit

It's also possible to change the order and line item status from ADvendio with the submit process. This way line items can be set to active or delivering (default setting is inactive or draft, depending on the connected system). In order to use these capabilities for your users, there is some configuration needed.

For Order / Campaign status:

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

For Line Item status:

7.3.13 Configure "Update Ad-Status in AdServer" for Campaign Items