Google Ad Manager

Integration of Ogury Ad Formats 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

Create a new Creative

Select Third Party as standard creative
Creative type should be display

Configuration required inside Creative Settings Page

Select your preferred size:

Since most of Ogury's ad formats don't have IAB standard sizes, choose a size that would be convenient for your setup and that is available on your website.
Select the Standard radio button as Code Type

Copy/paste the Ogury Tag of your choice into Snippet field

If you don't can or want to create the tags by yourself, Ogury might provide you with a so called Custom Code Snippet. This means that all configuration is done in the Ogury Interface and you don't need to worry about anything. A custom code would look like the tag below and you can use it like any other agency script:

<script type="text/javascript" data-ccid="CC-SOME-ID" src="https://mwtw.presage.io/v1/tag.js"></script>

<script type='text/javascript'>
   window.top.OG_ad_units = window.top.OG_ad_units || [];
   window.top.OG_ad_units.push({
       ad_unit_id: '$OGURY_AD_UNIT',
       asset_key: '$OGURY_ASSET_KEY',
       click_url: '%%CLICK_URL_UNESC%%',
   });
</script>
<script type="text/javascript" src="https://mwtw.presage.io/v1/tag.js"></script>

Replace the $OGURY_AD_UNIT and $OGURY_ASSET_KEY by your own values. Please contact your publisher manager to get theses values if you don't have access to the Ogury publisher dashboard.

%%CLICK_URL_UNESC%% is a Google Ad Manager macro. It will be automatically replaced and allows you to track clicks in your ad server. Ogury currently doesn't support the cache buster Macro.

For more customisation options, please refer to the common configuration section as well as the implementation documentation for each format:

Uncheck Serve into a SafeFrame checkbox (unless standard banners are used)

Should you encounter any warnings, such as GAM not recognizing our script, you can ignore them.

However, if you use the out of page format, you might need to insert the view pixel macro.

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 - Optional

In order to generate a Google tag, you need to create an Ad Unit. This is optional as you can also use existing ad units, if this is your preferred way of integration.

Configuration required

Define a Name and a code (that will be used for your reporting)

Target your preferred 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 - Optional

This is only needed, if you decided to create a new GAM ad unit.

Select a tag type

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

Tag Configuration

Uncheck Passback tag option
Check Enable Single request
Uncheck Enable Out Of Page creative option
Uncheck Live traffic option
Make sure you target the right creative sizes

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.

Troubleshooting your integration

Discrepancies

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.

Testing

If you want to test or troubleshoot your integration, make sure to have a look at the troubleshooting section. Whenever you make a change on the ad server configuration and you are working with preview links, don't forget to generate a new creative preview to reflect the new setup.

Configure GAM Passback - Optional

To configure a passback in case of no fill, modify the tag of Step 1 by adding an onNoAdCallback function calling your GAM passback tag.

passback is the GAM generated ad unit 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).

<script type='text/javascript'>
  function onNoAdCallback() {
     // GAM generated passback ad unit tag script
     var passback = `<script async src="https://securepubads.g.doubleclick.net/tag/js/gpt.js"><\/script>
  <div id="gpt-passback">
    <script>
      window.googletag = window.googletag || {cmd: []};
      googletag.cmd.push(function() {
      googletag.defineSlot('$GAM_PASSBACK_AD_UNIT', [1, 1], 'gpt-passback').addService(googletag.pubads());
      googletag.enableServices();
      googletag.display('gpt-passback');
      });
    <\/script>
  <\/div>`
    document.write(passback);
  } 
   
   // standard script tag  
   window.top.OG_ad_units = window.top.OG_ad_units || [];
   window.top.OG_ad_units.push({
       ad_unit_id: '$OGURY_AD_UNIT',
       asset_key: '$OGURY_ASSET_KEY',
       click_url: '%%CLICK_URL_UNESC%%',
       callbacks: {
            on_no_ad: onNoAdCallback // calling the function in case of no fill
       }
   });
</script>
<script type="text/javascript" src="https://mwtw.presage.io/v1/tag.js"></script>

Last updated 5 months ago

Was this helpful?