Ogury Pixel

Integration Guide

Copyright © 2021 Ogury Ltd

So much
more than just a career

Ogury is a technology company like no other. We’ve demonstrated exceptional growth.  But there’s so much more to us than that.
Our team and our purpose, that’s what really makes us stand out.

Introduction to Ogury Pixel

Without visibility of what a user does once they land on your site after clicking on an Ogury ad, you are missing the full picture of the performance of your campaign. And most importantly there is no way for Ogury to optimize towards the events you care most about, such as Qualified Lands.


What is the Ogury Pixel and why should I add it to my site?

The Ogury Pixel is a piece of code you can implement on your site, using this integration guide, which allows you to:

  • Measure the results of your ads. Better understand the impact of your ads by measuring what happened as a direct result.
  • Optimize to the KPIs you care about most. Whether it clicks, scrolls, page views, or session duration, you can reach people who are more likely to engage with your content. 

The Ogury Pixel collects the post-click data it has been configured to collect (such as clicks, scrolls or page views), for the sole purpose of your campaign post-click KPIs’ measurement and optimization.

The Ogury Pixel is required for all campaigns with post-click KPIs, in order to achieve outstanding results. Without the Pixel, your campaign can’t be optimized to post-click KPIs.


Choose the Pixel that is right for you and start measuring and optimizing to post-click events. 

The Ogury Pixel is available as a Javascript (JS) Pixel or an Image Pixel. Choose the integration type that is right for you with your Ogury Customer Success Manager.

Javascript (JS) Pixel

Ogury JS Pixel is a javascript tag, which provides the quickest way to get started. With just one simple integration on a page, the JS Pixel will measure and optimize to:

▪  Page Views
▪  Clicks (all clicks on the page)
▪  Scrolls (at 50px)
 
If you wish to also measure and optimize to Session Duration or a bespoke conversion event you will need to add the Session Duration or Custom Image Pixel. 


Image Pixel

Ogury Image Pixel is a transparent 1-pixel image that you can add to your site to track specific events.
Create and integrate a separate Ogury Pixel for each event that you wish to measure on a page and optimize towards.
 
This enables the most precise measurement and optimization for your campaigns. For example, you choose which clicks, or what level of engagement with regards to scroll depth you wish to measure and optimize to.
 
Ogury Image Pixel is available for each of the following events: 

  • Page Views

  • Clicks

  • Scrolls

  • Session Duration

  • Custom (defined by you, for measurement only)


Please note that a Pixel only measures and optimizes to events happening on the page on which it is integrated. We recommend at least to implement Pixels on the campaign landing page and all connected pages in order to obtain the best results (especially Pixels measuring Page Views for No Bounce Rate optimization).


How to create Ogury Pixel

  1. Define which Ogury Pixel(s) you want to create depending on which post-click KPIs you want to measure and optimize towards, with the help of your Customer Success Manager. We recommend creating at least a Pixel measuring Page Views, for optimization towards No Bounce Rate and Landing Rate.
    You can combine pixels, but keep in mind not to mix JS Pixel and Image Pixel - Page Views. Otherwise page views will be counted twice.

  1. Your Ogury Customer Success Manager will generate your Pixel(s) and send them to you. For ease, we have added the Google Tag Manager {{Page URL}} macro within our Pixel. However, if you prefer to integrate directly in your website or via an alternative tag manager, please replace {{Page URL}} with the macro from your website or alternative tag manager.

    https://ads-engagement.presage.io/pixel?site=ogury.com&e=click&id=link_to_pricing_page&full_url={{Page URL}}

    Do not replace {{Page URL}} with the URL of your landing page. Simply leave the macro as it is if you integrate via Google Tag Manager or replace it with another macro depending on your integration type.

You are now ready to integrate your Ogury Pixel(s). Choose your integration type:

Please note that incremental improvements will be brought to this documentation. Any feedback to your Customer Success Manager is welcome.

If you don’t find the information or need additional support, please get in touch with your Ogury Customer Success Manager.

We are true to our words. We act in a reliable way within the values of Ogury. 

Together we execute fast to deliver value to customers, employees, and all stakeholders.

We passionately believe and relentlessly persevere to fulfill Ogury's purpose.

We think, decide and act based on our own rational analysis, without necessarily following trends.

We are proud and confident, but always keep an open mind to learn from others.

We are true to our words. We act in a reliable way within the values of Ogury. 

Together we execute fast to deliver value to customers, employees, and all stakeholders.

We passionately believe and relentlessly persevere to fulfill Ogury's purpose.

We think, decide and act based on our own rational analysis, without necessarily following trends.

We are proud and confident, but always keep an open mind to learn from others.

Google Tag Manager integration

Sizmek integration

Test your integration

Image Pixel 

1. Create your Tags

  • Create a new Tag for each event that you wish to measure 
  • Select Custom Image Tag as the tag type
  • Copy and paste your Ogury pixel into the Image URL

● To ensure your Tag is fired as soon as possible, you need to specify a load priority
  
● Click ‘Advanced Settings’ then set ‘100’ (for example) in ‘Tag firing priority’ 

2. Set up Triggering

2.1 Page View Event

  • Page View is a standard trigger type in Google Tag Manager, select ‘All Pages’ so the Ogury Pixel fires on each page the user visits
  • To ensure your Tag is fired as soon as possible, you need to specify a load priority
  •  Click ‘Advanced Settings’ then set ‘100’ (for example) in ‘Tag firing priority’

2.2 Click Event

  • Choose the Click trigger type and select ‘Just Links’
  • Save your Click trigger and configure it on the click event Ogury Pixel

2.3 Scroll Event

  • Select the Scroll Depth trigger type
  • Select the depth you wish to measure to, either in percentage or Pixels
  • Save your Scroll trigger and configure it on the scroll event Ogury Pixel

2.4 Session Event

  • Select the Timer trigger type
  • Set up the timings for the session length you wish to measure
  • Save your Scroll trigger and configure the trigger on the session duration Ogury Pixel

2.5 Custom Event

  • The custom event Ogury Pixel enables you to measure custom conversion events such as a newsletter sign up or purchase. Choose the Custom Event trigger, set up the event you want to measure and configure the trigger on the custom Ogury Pixel.

JS Pixel

1. Create your Tag

  • Create a new Tag  
  • Select Custom HTML Tag as the tag type 
  • Copy and paste your Ogury pixel into the Image URL
  • To ensure your Tag is fired as soon as possible, you need to specify a load priority
  • Click ‘Advanced Settings’ then set ‘100’ (for example) in ‘Tag firing priority’


2. Set up Triggering

  • Set up the Page View Trigger to fire on all pages
  • To integrate an Ogury Pixel as a third party tag in Sizmek Adserver,  you have to navigate in the Advertisers tab, select Tags, then Conversion Tags
  • Select New, then Third Party Tracking Tag

In the new pop windows, select the Conversion Tag where you want to add the Ogury Pixel 

● Enter the name of the Ogury Pixel in the Third Party Tag Name field

● Change to status to Enable

● Copy/Paste the Ogury Pixel in the Third-Party Tag field, then Save

●  To check your Ogury Pixels are well fired visit your site and access the Browser Developer tools

●  To access these in Chrome choose in the top-right of your browser window. Then select Tools -> Developer Tools

●  Within the Developer Tools select ‘Network Panel’

●  Load pages where the Pixel is supposed to fire

●  Trigger the event(s) by interacting with the web page (click, scroll...)

●  In the search field, write « presage ».

●  One or several lines must be displayed in the list (dependent on how many events have been triggered). If you get no results, please check your tag implementation.
  
●  For click event Pixels, ensure that you check the ‘Preserve log’ box so the page doesn’t re-load and you can accurately test that the Pixel is firing correctly.

Campaign Manager Floodlight integration

Create a Floodlight Activity Group in Campaign Manager 360

● Before creating a Floodlight in Campaign Manager, you must have at least one Activity Group enabled.

● An Activity Group is a container for Floodlights; each of them must be assigned to one Activity Group. 

● You can create one Activity Group per type of floodlight, or by functions.

● Select the ‘Advertiser’ in the list.

● Select ‘Floodlight activity groups’ tab, and click on ‘New’.

● Select the Group Tag ‘Type’ you want to add. For counting tags like the Ogury Pixel, select ‘Counter'.

● Enter the Group ‘Tag string’. This unique identifier is used by Campaign Manager to identify the Activity Group.

● Don't forget to ‘Save’ your changes before leaving the page.

Create a Floodlight in Campaign Manager 360

● To create a Floodlight in Campaign Manager, you have to navigate in the ‘Advertisers’ tab on the top of of the home screen.

● Select the ‘Advertiser’ in the list.

● Select the ‘Floodlight activities’ tab, and click on ‘New’.

● Enter the name of your new floodlight in the ‘Name’ field, and the URL where the Floodlight is supposed to be implemented. It's an important step to find the Floodlight later.

● Select ‘Counter’ for the type of Floodlight.

● Select the ‘Activity Group’ for the new Floodlight.

● Select the ‘Counting method’ of the Counter Floodlight: 

  • Standart: count 1 user conversion each time the tracking fire

  • Unique: count 1 unique user conversion per 24 hours, depending on your Campaign Manager timezone

  • Per session: count 1 conversion per user session, the session length is set by the site where the Floodlight is implemented

● Before adding an Ogury Pixel, be sure that the ‘Dynamic’ tag is enabled for the Advertiser. You can check it in the ‘Floodlight Configuration’ tab. 

Add the Ogury Pixel in a Floodlight

● To add the Ogury Pixel in a Floodlight, you have to navigate in the ‘Advertisers’ tab on the top of the home screen.

● Select the ‘Advertiser’ in the list.

● Select the Floodlight which must contain the Ogury Pixel, in the ‘Floodlight activities’ list.

● Scroll down to the ‘Dynamic tag’ section.

● Select ‘Publisher tag’ for the type of Dynamic tag.

● Click on ‘New Tag’.

● Select the Ogury ‘Site’ and Copy/paste the Ogury Pixel in the ‘Code’ field. Be sure to put the full tag syntax, with <img src="...", or <script></script> around the tag URL.

● To modify a Floodlight attribution windows in Campaign Manager, you have to navigate in the ‘Advertisers’ tab on the top of the home screen.

Modify a Floodlight Attribution windows (Post View / Post-Click)

● Select the ‘Advertiser’ in the list.

● Select the Floodlight which needs to be modified in the ‘Floodlight activities’ list.

● Select the ‘Floodlight configuration’ tab.

● In the ‘Lookback windows’ section, you can now modify the values of the Floodlight Attribution windows.

● Don't forget to ‘Save’ your changes before leaving the page.

Implement a Floodlight in a website page (Hardcode process)

● The first step is to gather the Floodlight code in Campaign Manager. Navigate to the ‘Floodlight Tag Preview’ section, and copy the full Floodlight code.

● This code must be implemented between the <body> and </body> of your page, as close of the top of the page as possible.

Link a Floodlight from Campaign Manager to Google Tag Manager (GTM)

● To push a Campaign Manager Floodlight to Google Manager (GTM), the first step is to link the two platforms.

● Go to ‘Advertisers’ tab.

● Select the ‘Advertiser’ in the list.

● Select the Floodlight and navigate to the ‘Floodlight Activity’ tab.

● Scroll down until the ‘Google Tag Manager’ section.

● If your container is already linked to Campaign Manager, click on it to send the request to GTM.

● If not, click on ‘Link your Floodlight configuration’ and enter your GTM Container ID. 

● A request will be sent to GTM.

● Approve it to validate the link between Campaign Manager and GTM. 

● Navigate to your GTM container, ‘Approval Queue’ then ‘Tags’ section to check the request.

● Once the Floodlight is published in GTM, be sure to check all the variables inside the tag (i.e. change the macro if necessary).

Manually add a Floodlight in Google Tag Manager (GTM)

● To manually add a Floodlight in GTM, navigate to the ‘Tags’ section and select the type of Floodlight you want to add (‘Counter’), then click on ‘Continue’.

● Once in the Floodlight configuration tab, enter manually the ‘Advertiser ID’, ‘Group Tag String’ and ‘Activity Tag String’ of the Floodlight. You can find it on the Campaign Manager interface, or directly on the Floodlight code.

<iframe src="http://1234567.fls.doubleclick.net/activityi;src=1234567;type=abcde123;cat=fghij456;u1=[sample01];u2=[sample02];ord=[Random Number]?" width="1" height="1" frameborder="0" style="display:none"></iframe>

  • The ‘Advertiser’ is in the src= parameter

  • The ‘Group Tag String’ is in the type= parameter

  • The ‘Activity Tag String’ is in the cat= parameter