Mobile Web
Search…
Google Ad Manager
Integration of the Thumbnail format using Google Ad Manager as Ad Server

Step 1: Creative creation

Please connect to your Google Ad Manager console, select Delivery tab and then click on creative inside the dropdown menu

A) Create a new Creative

  • Select Third Party as standard creative
  • Creative type should be display
'Third Party' Creative type

B) Configuration required inside Creative Settings Page

  • Select 1x1 as Target ad unit size
  • Select the Standard radio button as Code Type
  • Copy/paste the below snippet into Snippet field
1
<script type='text/javascript'>
2
window.top.OG_ad_units = window.top.OG_ad_units || [];
3
window.top.OG_ad_units.push({
4
ad_unit_id: '$OGURY_AD_UNIT',
5
asset_key: '$OGURY_ASSET_KEY',
6
click_url: '%%CLICK_URL_UNESC%%',
7
params:{
8
max_width: 180,
9
max_height: 180,
10
}
11
});
12
</script>
13
<script type="text/javascript" src="https://mwtw.presage.io/v1/tag.js"></script>
Copied!
You need to replace $OGURY_AD_UNIT and $OGURY_ASSET_KEY by your own values. Please contact your publisher manager to get theses values.
You can replace max_width and max_height by the values you want. It corresponds to the dimension in pixels the ad may take on your page. We recommend to put 180 for both values to improve the readability of the content of the Thumbnail Ad.
%%CLICK_URL_UNESC%% is a Google Ad Manager macro. It will be automatically replaced. It allows you to track clicks in Google Ad Manager.
  • Uncheck Serve into a SafeFrame checkbox
For more information regarding Configuration Parameters Details, please refer to the Additional Configuration.

Step 2: Link your creative and your Line Item

After the setup of your creative, you need to link it with the corresponding line item.
In Creative Associations tab, you can configure a specific Line Item that you want to target with your creative.
On line item creatives tab, you should see the creative that you have just linked.

Step 3: Ad Unit Creation

In order to generate a Google tag, you need to create an Ad Unit.

Configuration required

  • Define a Name and a code (that will be used for your reporting)
  • Target 1x1 size
  • Uncheck the Maximize revenue of unsold inventory with AdSense option

Step 4: Link your line item with your Ad Unit

On line-item setting, you need to add the created Ad Unit as target inventory.

Step 5: Google Tag generation

A) Select a tag type

  • Select Google Publisher Tag option on tag type drop-down list
  • Click on CONTINUE

B) Tag Configuration

  1. 1.
    Uncheck Passback tag option
  2. 2.
    Check Enable Single request
  3. 3.
    Uncheck Enable Out Of Page creative option
  4. 4.
    Uncheck Live traffic option
  5. 5.
    Add 1x1 as size Targeting

C) Tag integration

  • Copy code generated in Tag results
  • Paste it into your web page
Well done ! You finished the configuration required to integrate the Ogury Exclusive Demand Tag through Google Ad Manager.

Step 6: Update your ads.txt

Make sure to add your Ogury ID to your ads.txt file.

Troubleshoot impression reports

There could be impression count discrepancies between impression reporting in Google Ad Manager and in your Ogury's Exclusive Demand dashboard. This is related to an Ad Manager limitation for third-party creatives reporting. This is explained in Ad Manager's documentation (Third-party creative rendering latency section): https://support.google.com/admanager/answer/6123466?hl=en
Please refer to your OED dashboard or adapt your analytics tool to check the rendered impressions on your website.

Optional : Configure GAM Passback

To configure a passback in case of no fill, modify the tag of Step 2 B) by adding an onNoAdCallback function calling your GAM passback tag.
passback is the GAM generated adunit passback tag script. You'll need to backslash \ the closing script tag </script> with <\/script> in order to avoid any browser parsing issue.
Call the onNoAdCallback function in the on_no_ad event (line 29 in the example below).
1
<script type='text/javascript'>
2
function onNoAdCallback() {
3
// GAM generated passback ad unit tag script
4
var passback = `<script async src="https://securepubads.g.doubleclick.net/tag/js/gpt.js"><\/script>
5
<div id="gpt-passback">
6
<script>
7
window.googletag = window.googletag || {cmd: []};
8
googletag.cmd.push(function() {
9
googletag.defineSlot('$GAM_PASSBACK_AD_UNIT', [1, 1], 'gpt-passback').addService(googletag.pubads());
10
googletag.enableServices();
11
googletag.display('gpt-passback');
12
});
13
<\/script>
14
<\/div>`
15
document.write(passback);
16
}
17
18
// standard tag script
19
window.top.OG_ad_units = window.top.OG_ad_units || [];
20
window.top.OG_ad_units.push({
21
ad_unit_id: '$OGURY_AD_UNIT',
22
asset_key: '$OGURY_ASSET_KEY',
23
click_url: '%%CLICK_URL_UNESC%%',
24
params:{
25
max_width: 180,
26
max_height: 180,
27
},
28
callbacks: {
29
on_no_ad: onNoAdCallback // calling the function in case of no fill
30
}
31
});
32
</script>
33
<script type="text/javascript" src="https://mwtw.presage.io/v1/tag.js"></script>
Copied!

Using a GAM passback to increase your Fillrate with a second Ad Unit

In order to optimize both your monetization and your fill rate, it is possible to implement a client side waterfall using a GAM passback. Particularly, you may setup a sequence of Ogury Exclusive Demand Tag configurations to chain ad requests for distinct Ogury ad units.
A typical usage is to target an Ogury ad unit with a high price and another one afterwards with a lower price.
To give you ideas about possible GAM integrations with two ad units, we have summarized the most common options:
  1. 1.
    If you already use the Thumbnail you can simply create a new line item with the second tag targeting the same GAM ad unit as the first tag to avoid that both Thumbnails are called at the same time. Ask your Publisher Manager for the IDs for the second tag or log into the Publisher Cloud to create them by yourself.
    Optionally you can update the higher priced tag with a GAM Passback, if you're not already using one.
  2. 2.
    If you don't use the Thumbnail yet, you can choose any of the scenario above, but you'll have to create the IDs for both tags.
  3. 3.
    You can also choose the one tag solution of the Direct Integration and optionally add another passback after the lower priced ad unit. Like this you'll only need to create one line item.
  4. 4.
    If you use two line items you can also add your passback of choice to the lower priced Thumbnail Ad Unit.
Last modified 1mo ago