Content Comparison

Contener connection and selection

• Go onto the Commanders Act platform

• Choose the appropriate contenercontainer. It is essential that the tag is triggered on all landing pages.

Tags template selection

• Go to the step of choosing tag templates

• Search for “Adloop” in the search bar

• Choose the “Adloop Tracking and Attribution” template. You’ll be redirected to the editing step.

Template edition

Fill in the 3 following fields:

• The custom(s) dimension(s) configured in your Analytics tool

  • If several, they should be separated by a comma ( , )

• Subdomains that should be considered as a separate referrer

  • Example: blog.website.com is not be considered as internal but as a referrer

• Referrers to be excluded (the list should be the same as the one in your Analytics tool), like payment platforms

Image Removed

Image Added

Consent

• Set the consent for the Adloop tag (Analytics/Measurement category)

Publishing

• Place the Adloop tag between the initialization of your Analytics solution and the pageview event being sent

• Proceed with the container generation and make sure there are no error during the auto-test step

• Publish the contener

In the case of the a single tag for initialization

If you use a single tag for initializing your analytics solution and for sending the page view event, then simply place the Adloop tag before your Analytics tag and modify your Analytics tag to include the code for populating the custom dimension. Below is an example of how you can implement it with Google Analytics 4 (add line 2 and 6 in your GA4 code) :

Image Removed

• Install the new “Adloop Tracking & Attribution” tag and place it in first position. There is no need to add some triggers (except Container loaded)

Image Added

There are two ways to set up the custom dimensions:

1. Using a function just before the page_view event

There is function that you can call anywhere you want. This function automatically fills the custom dimensions when using GTAG, GA or PA analytics objects.
It is mandatory to call this function just before the page view event and any other event (add_to_cart, purchase etc.)

if(typeof window._ADLOOP_SET_CUSTOM_DIMENSIONS != "undefined"){
          window._ADLOOP_SET_CUSTOM_DIMENSIONS(true);
}

2. Using the stored value

In case of a specific setup, it is also possible to set the custom dimensions manually (if the usual method doesn’t work, most probably because of the execution order of the Adloop tag).
It is mandatory to write this code just before the page view event and any other event.

a. For Piano Analaytics

The Adloop dimensions values are stored in a variable called (you write this in the console debugger of your browser if you want to see what’s inside) :

window.__ADLOOP_VALUES__

For example (in this case, the example implements the queue system of Piano, ‘paq’) : 

if(typeof(__ADLOOP_VALUES__) != "undefined" {
  var adloopValues = window.__ADLOOP_VALUES__
  window._paq.push(['setProperty', adloopValues.clickDimension, adloopValues.clickCode])
  window._paq.push(['setProperty', adloopValues.clickDimensionMeta, adloopValues.clickCodeMeta])
}

Notes for debugging:

There are some debugging logs for this new feature, that you can access in the console debugger of your browser.

For you to be able to see it, you need to create a new cookie for the website that you are setting up (using a browser extension, like Cookie Master)

Image Added

The cookie must be named “tCdebugLib” and can have any value (1, for example).

With this cookie, you will see that kind of logs : 

Image Added

b. With GA4

In the pageview tag, add after the params var definition, add the following code:

params[window.__ADLOOP_VALUES__['clickDimension']] = window.__ADLOOP_VALUES__['clickCode'];
params[window.__ADLOOP_VALUES__['clickDimensionMeta']] = window.__ADLOOP_VALUES__['clickCodeMeta'];