NAV

RTB House

Intro

Brief explanation of some of the settings recommendations:

As first Origin Trial [FOT] will have a scale of realistically the traffic of ~50% of users with new Chrome Browser version(beta) and up to ~1% of users with Chrome Browser(stable), supporting Fledge - we recommend configurations that will help to reach this relatively small scale:


First: key-value pair creation

A key-value pair needs to be created in Google Ad Manager along with proper Line Item targeting

Enter GAM/DFP page

  1. Enter GAM/DFP page: https://admanager.google.com/

'Inventory' tab

  1. Go to the 'Inventory' tab 'Key-values' and hit the "New key-value" button.

Create a key

  1. Create a key, for example: "fledge" and value "true" and "false", set value type to "predefined".

Include values in reporting

  1. You can also select “Include values in reporting” if you wish to query this value in reports page later.
Fledge GAM settings - include values

Delivery > Orders > New Order

  1. Go to Delivery Orders, create a new order.

Create a new Line Item(s)

  1. Create a new Line Item/Line Items [for test we've set it as "Sponsorship type"]
    1. Set Customised targeting to previously created key - in the example it would be "fledge" and "is any of" "true"
    customised ad targeting
    1. Add "Expected creatives" and "Delivery Settings" - as you wish.
    2. The rest could be set as desired too.
      1. Just for testing purposes on test pages and to include prebid you might want to configure it like so [this allows both fledge and non-fledge ads] and we also "Adjust delivery -> Rotate creatives: 'Evenly'" :
    3. Customized targeting - fledge
    4. Save.

Activate the order

  1. Go back to Delivery->Orders, find your newly created Order with Line Items and Activate the order - so its status changes to "Ready".

Actions needed on the page itself

What needs to be done on the page itself

If using GAM directly

We need this code to be implemented on page before running googletag.enableServices():

OPTION 1

OPTION 1 - for publishers with one biggest domain or only integrating fledge for the main one.

How to generate your TOKEN_GOES_HERE:

Enter the url:https://developer.chrome.com/origintrials/#/trials/active

Click REGISTER button - next to “Privacy Sandbox Relevance and Measurement”:

You will then receive this form:

privacy sandbox registration privacy_sandbox_registration_2

You will then see this pop up, with the code of the generated token to replace the 'TOKEN_GOES_HERE' section in our script - omit the ' ' though.

OPTION 2

OPTION 2 - for ad networks with multiple domains.

The most important thing is to place it before “googletag.enableServices();” call, for example:

Then it is possible to check if key-value pairs are being sent:

console check

It is all - if you can see the fledge key - you will be able to see fledge in your reporting and also configure fledge only /non-fledge only targeting on your line items as you prefer.

If using GTM

Before starting:


Be sure you are not rendering the chosen ad slot directly on the webpage through Google Publisher Tags (GPT). Such a scenario will impose concurrency between GPT and GTM, thus, FLEDGE setup will most likely fail.

Custom tag template creation

The first step will be to generate a custom tag template - this will allow you to write custom tag code that can be reused later.

In order to do it, enter your GTM account, go to your Workspace > Templates and click on “New”

template_createion

You can then specify name and description for the template:

template editor

You will also want to specify some custom fields to be used during final tag creation:

custom fields

Note:

Slot id: the div id in which the ad will be rendered

Slot size: the supported ad size in the format [width]x[height]

Next, paste the following script on “Code” tab:

On “Permission” tab, you should also add parameters as follows:

template editor parameters

This will allow the template to work with googletag (GPT) and displayAdRTB (RTB House) functions. Notice that corresponding script URLs are also set as allowed.

You can then finally hit “Save”

Tag creation

As a final step, you will need to create and publish the tag responsible for serving the ad.

Navigate to “Tags” and click on “New”

tag creation 1

On tag configuration, choose the previously created template:

tag creation 2

You will also need to specify a value for Slot ID, Slot SIze and Adunit Path.

Then, on “Triggering” specify a trigger of your preference. In this case a custom trigger is being used and activated only if loaded URL contains a specific test parameter:

tag configuration

FAQ

  1. 29.03.2022: Chrome Dev Version and Chrome Canary Version on Windows - not working - not loading any pages inserted into the address bar.

    Solution: Try switching off one of those options in Chrome Settings-Other Google Services:

    faq 1
    1. Help improve Chrome's features and performance
    2. Make searches and browsing better
    3. Enhanced spell check

To be continued...

FLEDGE-Demo

RTB House FLEDGE system - demo

About

Instructions

Authentication

Emission code example

"publisherId" - to be changed to the RTB House generated and provided id.

"dc" - to be changed depending on the publisher main traffic source - “us”, “sin” or “ams”

Changelog

Version Date Comments Version Link
2.1 23.08.2022 Emmission code updated Latest version
2.0 02.06.2022 Emmission code updated, changelog added, styles improved See this version
1.0 30.05.2022 Document created See this version