GAM Integration

This page describes how to integrate Adnuntius Advertising with Google Ad Manager
Adnuntius Advertising allows you to request advertising inventory from your Google Ad Manager (GAM) account, and uses Machine Learning to choose the best floor price to maximise revenue.
This guide describes the required steps to enable this functionality in Adnuntius.
You must have your own GAM account to use this integration.

Step 1 : Create a Google External Demand Source in Adnuntius

An External Demand Source is required to tell Adnuntius how to connect with your GAM account.
The External Demand Source requires the following information:
  • "Google Ad Manager" must be chosen as the External Demand Source
  • Your GAM Network Code, specified in the "Publisher ID" field
  • The currency that is used in your GAM account
  • Bid Levels, which control how bids are converted to key-value targets for GAM (more deatils on this later is provided later in this guide)

Step 2 : Create a Google External Ad Unit

You create External Ad Units in Adnuntius to connect with your GAM Ad Units.
Each External Ad Unit requires:
  • The External Demand Source (created in step above)
  • The GAM Ad Unit ID
  • The size of the GAM Ad Unit

Step 3 : Create a Google Line Item (in Adnuntius)

You must create a Line Item in Adnuntius that competes in the Adnuntius auction and controls when the system will check for external inventory from GAM.
You can use all of the standard targeting and tiers etc within Adnuntius on the Line Item.
You should specify a CPM bid of 0, as the actual bidding will be dynamically adjusted by Adnuntius based upon the available demand from GAM.
The Creative for your Line Item must be configured with:
  • An "External" Creative Type
  • The Google External Demand Source (created in Step 1 above)
  • External Ad Unit Targeting to at least one of the GAM Ad Units (created in Step 2 above)

Step 4 : Create Google Line Items (in GAM)

The configuration described so far ensures that Adnuntius will request ads from GAM whenever it determines that the demand from Google will bid higher than the internal inventory. For this to work, however, you must have created line-items in GAM to handle the case when there are no ads returned from Google when Adnuntius makes a request.
The requests to GAM arriving from Adnuntius will include a key-value that specifies one of the Bid Levels (configured in step 1 above). The key name is adnFloor, and the value is numeric with two decimal places, e.g. 1.50. You must create multiple Google line-items which target each of the configured Bid Levels using the associated key-value. For example, if you have configured bid levels:
0.5, 1, 1.5, 2, 2.5, 3, 3.5, 4
then you must create eight line-items in GAM with one targeting adnFloor=0.50, another targeting adnFloor=1.00, another targeting adnFloor=1.50 and so on.
For each of the line-items, the bid on the line-item must match the specific targeting. So, for example, a line-item targeting adnFloor=3.50 must have a CPM bid of 3.50. This configuration ensures that if a request is received from Adnuntius at a bid-level of 3.50, that this line-item will match and it will require any bids from the exchange to bid higher than 3.50 in order to win the auction. If there are no bids from the exchange, then this line-item can handle returning a passback tag to Adnuntius.
It is CRITICAL that you specify the targeting like adnFloor=1.00 rather than adnFloor=1. The key-value targeting uses strings not numbers, so 1 and 1.00 do NOT represent the same thing.
In addition to including a passback tag to Adnuntius, the creative attached to each line-item must include the following pixel tag:
<iframe src="https://%%PATTERN:adnServer%%/d/f/%%PATTERN:adnToken%%" scrolling="no" frameborder="0" width="1" height="1" style="position:absolute;top:-10000px;left:-100000px;"></iframe>
This pixel is the secret to Adnuntius learning which requests do not return ads, and allows for the correct bid level to be dynamically chosen to optimise your revenue from Google.