Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Those URLs are valid for Facebook Ads and Instagram Ads
Level in which I put the URL templates
Ad level (all existing active Ads + new Ads) Instructions to be integrated in the trafficking process
Where is it located ?
Go to the edit window of the Facebook Ad
Go to the Website URL field
Edit the destination URL to include the URL parameter
What parameters should I use ?
loopcd (for all analytics platforms including Adobe, Google or Piano Analytics) using the utm_content parameter in substitution is possible (only for Google Analytics)
URL template
Just add the following string at the end of the destination URL &loopcd=SMf|{{ad.id}}
&loopcd=SMf|{{ad.id}}|{{placement}}
. If Adloop is the only tracking parameter: ?loopcd=SMf|{{ad.id}}
?loopcd=SMf|{{ad.id}}|{{placement}}
. If you opt for the utm_content , use this value : &utm_content=SMf|{{ad.id}}&utm_content=SMf|{{ad.id}}|{{placement}}
Shoud I use both adlcoid & utm_content ?
No, just chose one parameter and keep it consistent for all Facebook Ads Campaigns for now and the future
Search is the (default ) mode of URL templates for Google Ads. If you run Shopping or Display, Youtube, Performance Max or Discovery campaigns, don’t forget to follow the dedicated instructions below .
We need URL templates to activate ‘ Automatching ’ in Adloop.
Matching is a system that allows you marketer to link dimensions & metrics across Ad platforms / Analytics platforms & Attribution calculations.
Without Automatching, you need to associate things manually using our [[ Matching |Matching]] user interface.
With Automatching, all is done automatically.
So we strongly recommend to use our Automatching system by setting up the URL templates across platforms.
Find all of our tracking templates:
Level in which I put the URL templates
Campaign level
Where is it located ?
Go to your Shopping campaign > Settings > Campaign URL options
What parameters should I use ?
loopcd → (for all analytics platforms)
URL template
If Adloop is the only tracking template , just copy-paste the following {lpurl}?loopcd=COg|{device}|{network}|{product_id}|{adgroupid}
. If Adloop isn't the only tracking template, add the following to the existing template &loopcd=COg|{device}|{network}|{product_id}|{adgroupid}
Level in which I put the URL templates
Campaign level
Where is it located ?
Go to your Display campaign > Settings > Campaign URL options
What parameters should I use ?
loopcd → (for all analytics platforms)
URL template
If Adloop is the only tracking template , just copy-paste the following {lpurl}?loopcd=DIs|{device}|{network}|{creative}
. If Adloop isn't the only tracking template, add the following to the existing template &loopcd=DIs|{device}|{network}|{creative}
Level in which I put the URL templates
Video Ad level
Where is it located ?
Go to your Video campaign > Ad & Extensions Select the video ad, click on Edit and go to Ad URL options (advanced) There you can find the Tracking Template field Copy paste the URL template & Save changes
What parameters should I use ?
loopcd → (for all analytics platforms)
URL template
If Adloop is the only tracking template, just copy-paste the following {lpurl}?loopcd=DIy|{device}|{network}|{creative}
. If Adloop isn't the only tracking template, add the following to the existing template &loopcd=DIy|{device}|{network}|{creative}
Level in which I put the URL templates
Campaign level
Where is it located ?
Go to your Performance Max campaign > Settings > Campaign URL options
What parameters should I use ?
loopcd → (for all analytics platforms)
URL template
If Adloop is the only tracking template , just copy-paste the following {lpurl}?loopcd=COp|{device}|{network}|{campaignid}|{product_id}
If Adloop isn't the only tracking template, add the following to the existing template &loopcd=COp|{device}|{network}|{campaignid}|{product_id}
Level in which I put the URL templates
Campaign level
Where is it located ?
Go to your Discovery campaign > Settings > Campaign URL options
What parameters should I use ?
loopcd → (for all analytics platforms)
URL template
If Adloop is the only tracking template,just copy-paste the following {lpurl}?loopcd=DIc|{device}|{creative}
If Adloop isn't the only tracking template, add the following to the existing template &loopcd=DIc|{device}|{creative}
Level in which I put the URL templates
Account level
Where is it located ?
Go to "All campaigns" > "Settings" > "Account Settings" > Tracking
What parameters should I use ?
loopcd → (for all analytics platforms)
URL template
If Adloop is the only tracking template , just copy-paste the following {lpurl}?loopcd=SEg|{device}|{network}|{keyword}|{creative}|{matchtype}
. If Adloop isn't the only tracking template, add the following to the existing template &loopcd=SEg|{device}|{network}|{keyword}|{creative}|{matchtype}
Level in which I put the URL templates
Campaign level
Where is it located ?
For each campaign: Campaign settings > Advanced setting > campaign URL options
What parameters should I use ?
loopcd (for all analytics platforms including Adobe, Google or Piano Analytics)using the utm_content parameter in substitution is possible (only for Google Analytics)
URL template
If Adloop is the only tracking template , just copy-paste the following {lpurl}?loopcd=SEb|{Device}|{IfSearch:s}{IfContent:d}{IfNative:n}{IfPLA:m}||{AdId}|{MatchType}
. Just add the following string at the end of the destination URL &loopcd=SEb|{Device}|{IfSearch:s}{IfContent:d}{IfNative:n}{IfPLA:m}||{AdId}|{MatchType}
. If you opt for the utm_content , use this value : &utm_content=SEb|{Device}|{IfSearch:s}{IfContent:d}{IfNative:n}{IfPLA:m}||{AdId}|{MatchType}
Shoud I use both adlcoid & utm_content ?
No, just chose one parameter and keep it consistent for all Bing Campaigns for now and the future
Level in which I put the URL templates
Campaign level
Where is it located ?
For each campaign: Campaign settings > Advanced setting > campaign URL options
What parameters should I use ?
loopcd (for all analytics platforms including Adobe, Google or Piano Analytics)using the utm_content parameter in substitution is possible (only for Google Analytics)
URL template
If Adloop is the only tracking template , just copy-paste the following {lpurl}?loopcd=COb|{Device}|{IfSearch:s}{IfContent:d}{IfNative:n}{IfPLA:m}|{ProductId}
. Just add the following string at the end of the destination URL &loopcd=COb|{Device}|{IfSearch:s}{IfContent:d}{IfNative:n}{IfPLA:m}|{ProductId}
. If you opt for the utm_content , use this value : &utm_content=COb|{Device}|{IfSearch:s}{IfContent:d}{IfNative:n}{IfPLA:m}|{ProductId}
Shoud I use both adlcoid & utm_content ?
No, just chose one parameter and keep it consistent for all Bing Campaigns for now and the future
Level in which I put the URL templates
Account level
Where is it located ?
On the left menu : click on Setting > Account level options > Tracking template
What parameters should I use ?
loopcd (for all analytics platforms including Adobe, Google or Piano Analytics)using the utm_content parameter in substitution is possible (only for Google Analytics)
URL template
If Adloop is the only tracking template , just copy-paste the following `{lpurl}?loopcd=SEb|{Device}|{IfSearch:s}{IfContent:d}{IfNative:n}{IfPLA:m}
Shoud I use both adlcoid & utm_content ?
No, just chose one parameter and keep it consistent for all Bing Campaigns for now and the future
URL template
Twitter Ads does not allow dynamic tracking templates . You can use our native matching function . To use our automatic matching function, put exactly in the UTM parameters the names of the campaign, adgroup & ad with one element per parameter. Example : name of the campaign in the UTM campaign, name of the adgroup in the UTM keyword and name of the ad in UTM content.
Level in which I put the URL templates
Ad level
What parameters should I use ?
loopcd (for all analytics platforms including Adobe, Google or Piano Analytics)using the utm_content parameter in substitution is possible (only for Google Analytics)
URL template
TikTok Ads does not allow dynamic tracking templates .But, you can still use our native matching function . To use our automatic matching function, put exactly in the UTM parameters the names of the campaign, adgroup & ad with one element per parameter. Example : name of the campaign in the UTM campaign, name of the adgroup in the UTM keyword and name of the ad in UTM content. If you want automatic matching within Adloop, you can manually enter the ad ID as follows:Just add the following string at the end of the destination URL &loopcd=SMk|\{\{put the Ad ID here\}\}
. It should look like this: &loopcd=SMk|123456
. If Adloop is the only tracking template: ?loopcd=SMk|\{\{put the Ad ID here\}\}
. It should look like this: ?loopcd=SMk|123456
. If you opt for the utm_content , use this value : &utm_content=SMk|\{\{put the Ad ID here\}\}
. It should look like this: &utm_content=SMk|123456
Shoud I use both adlcoid & utm_content ?
No, just chose one parameter and keep it consistent.
Level in which I put the URL templates
Ad level
What parameters should I use ?
loopcd (for all analytics platforms including Adobe, Google or Piano Analytics)using the utm_content parameter in substitution is possible (only for Google Analytics)
URL template
Just add the following string at the end of the destination URL `&loopcd=SMp
Shoud I use both adlcoid & utm_content ?
No, just chose one parameter and keep it consistent for all Pinterest Campaigns for now and the future
What parameters should I use ?
loopcd (for all analytics platforms including Adobe, Google or Piano Analytics)using the utm_content parameter in substitution is possible (only for Google Analytics)
URL template
LinkedIn Ads does not allow dynamic tracking templates , so if you want automatic attribution matching, the Ad ID number must be hard coded in the URL parameters.You can use our native matching function . To use our automatic matching function, put exactly in the UTM parameters the names of the campaign, adgroup & ad with one element per parameter. Example : name of the campaign in the UTM campaign, name of the adgroup in the UTM keyword and name of the ad in UTM content.
Shoud I use both loopcd & utm_content ?
No, choose only one of those and stick to it.
IMPORTANT ADVICE Campaign Manager is sometimes used to agregate paid trafic & attribute conversions. In that case, some campaigns are double-tracked. Campaigns shouldn’t be double-tracked as this affects data collection & measurement. If this is the case, contact the Adloop support, but generally campaigns should only be tracked in GCM. Costs therefore should be integrated within GCM in order for Adloop to get them automatically.
Before using the reporting & trafficking API, you must
have access to a Campaign Manager account ; more about this here
this account must be set for API access. It is often the case, but if you are not sure, contact the Campaign Manager support.
you must have a profile to access this account. Ask your campaign manager admin to create a profile for you
Check the permissions of Campaign Manager UI users. Those permissions control who, among the users, has API access.
Level in which I put the URL templates | Ad level |
What parameters should I use ? | loopcd (for all analytics platforms including Adobe, Google or Piano Analytics)using the utm_content parameter in substitution is possible (only for Google Analytics) |
URL template | Just add the following string at the end of the destination URL |
Shoud I use both adlcoid & utm_content ? | No, just chose one parameter and keep it consistent for all Snapchat Campaigns for now and the future |
Level in which I put the URL templates
Campaign level (all existing active Campaigns + new Campaigns upon creation)
Where is it located ?
Go to the Campaign you want to track
Go to Properties ,
then go to the destination URL suffix
What parameters should I use ?
loopcd
URL template
If there is no suffix already, copy-paste the following &loopcd=DId|%ebuy!|%esid!|%epid!|%eaid!|%ecid!
If there is already a suffix, you have to add the same tracking template at the end of the existing suffix &loopcd=DId|%ebuy!|%esid!|%epid!|%eaid!|%ecid!
What parameters should I use ?
loopcd (for all analytics platforms including Adobe, Google or Piano Analytics)using the utm_content parameter in substitution is possible (only for Google Analytics)
URL template
Just add the following string at the end of the destination URL &loopcd=DIf|{put the creative ID here}
. If you opt for the utm_content , use this value : &utm_content=DIf|{put the creative ID here}
. Ad Form does not allow dynamic tracking templates , so if you want automatic attribution matching, the Creative ID number must be hard coded in the URL parameters.You can use our native matching function . To use our automatic matching function, put exactly in the UTM parameters the names of the campaign, adgroup & ad with one element per parameter. Example : name of the campaign in the UTM campaign, name of the adgroup in the UTM keyword and name of the ad in UTM content.
What parameters should I use ?
loopcd (for all analytics platforms including Adobe, Google or Piano Analytics)using the utm_content parameter in substitution is possible (only for Google Analytics)
URL template
Just add the following string at the end of the destination URL &loopcd=DIh|${HAWK_LINE_ID}
. If Adloop is the only tracking template : ?loopcd=DIh|${HAWK_LINE_ID}
. If you opt for the utm_content , use this value : &utm_content=DIh|${HAWK_LINE_ID}
Shoud I use both adlcoid & utm_content ?
No, choose one.
Level in which I put the URL templates
Campaign level
What parameters should I use ?
loopcd (for all analytics platforms including Adobe, Google or Piano Analytics)using the utm_content parameter in substitution is possible (only for Google Analytics)
URL template
Just add the following string at the end of the destination URL &loopcd=DIw|~INSERTION_ID~
. If Adloop is the only tracking template : ?&loopcd=DIw|~INSERTION_ID~
. If you opt for the utm_content , use this value : &utm_content=DIw|~INSERTION_ID~
Shoud I use both adlcoid & utm_content ?
No, just chose one parameter and keep it consistent for all Bing Campaigns for now and the future
Level in which I put the URL templates
Account or Affiliate level
Where is it located ?
To determine with your account manager
What parameters should I use ?
loopcd (for all analytics platforms including Adobe, Google or Piano Analytics)using the utm_content parameter in substitution is possible (only for Google Analytics)
URL template
Just add the following parameter at the end of the destination URLs &loopcd=AFa|{put_here_the_Affiliate_ID}
or put this value in the utm_content &utm_content=AFa|{put_here_the_Affiliate_ID}
. The parameter {put_here_the_Affiliate_ID}
should be filled by the ID of the affiliate as defined by the platform. When the user clicks on the link, it should look like this: &loopcd=AFa|01234
Shoud I use both adlcoid & utm_content ?
No, just chose one parameter and keep it consistent for all Affilae Campaigns for now and the future
What parameters should I use ?
loopcd (for all analytics platforms including Adobe, Google or Piano Analytics)using the utm_content parameter in substitution is possible (only for Google Analytics)
URL template
If Adloop is the only URL parameter add the following ?loopcd=DIp|${DetectedDomain}|${AdvID}|${CampID}|${CrID}
. If your URL already has other parameters (UTM), add this after: &loopcd=DIp|${DetectedDomain}|${AdvID}|${CampID}|${CrID}
. If you opt for the utm_content, use this value : &utm_content=DIp|${DetectedDomain}|${AdvID}|${CampID}|${CrID}
Shoud I use both adlcoid & utm_content ?
No, choose one.
Level in which I put the URL templates
Account or Affiliate level
Where is it located ?
To determine with your account manager
What parameters should I use ?
loopcd (for all analytics platforms including Adobe, Google or Piano Analytics)using the utm_content parameter in substitution is possible (only for Google Analytics)
URL template
Just add the following parameter at the end of the destination URLs &loopcd=AFj|{affiliate_id}
. If Adloop is the only tracking template: ?loopcd=AFj|{affiliate_id}
or put this value in the utm_content &utm_content=AFj|{affiliate_id}
. The parameter {affiliate_id}
should be filled by the ID of the affiliate as defined by the platform.When the user clicks on the link, it should look like this: `&loopcd=AFj|01234
Shoud I use both adlcoid & utm_content ?
No, just chose one parameter and keep it consistent for all CJ Campaigns for now and the future
Level in which I put the URL templates
Account or Affiliate level
Where is it located ?
To determine with your account manager
What parameters should I use ?
loopcd (for all analytics platforms including Adobe, Google or Piano Analytics)using the utm_content parameter in substitution is possible (only for Google Analytics)
URL template
Just add the following parameter at the end of the destination URLs &loopcd=AFr|{affiliate_id}
. If Adloop is the only tracking template: ?loopcd=AFr|{affiliate_id}
or put this value in the utm_content &utm_content=AFr|{affiliate_id}
. The parameter {affiliate_id}
should be filled by the ID of the affiliate as defined by the platform. When the user clicks on the link, it should look like this: &loopcd=AFr|01234
Shoud I use both adlcoid & utm_content ?
No, just chose one parameter and keep it consistent for all Rakuten Campaigns for now and the future
Level in which I put the URL templates
Account or Affiliate level
Where is it located ?
To determine with your account manager
What parameters should I use ?
loopcd (for all analytics platforms including Adobe, Google or Piano Analytics)using the utm_content parameter in substitution is possible (only for Google Analytics)
URL template
Just add the following parameter at the end of the destination URLs &loopcd=AFz|{affiliate_id}
. If Adloop is the only tracking template: ?loopcd=AFz|{affiliate_id}
or put this value in the utm_content &utm_content=AFz|{affiliate_id}
. The parameter {affiliate_id}
should be filled by the ID of the affiliate as defined by the platform. When the user clicks on the link, it should look like this: `&loopcd=AFz
Shoud I use both adlcoid & utm_content ?
No, just chose one parameter and keep it consistent for all Awin Campaigns for now and the future
Level in which I put the URL templates | Account or Affiliate level |
Where is it located ? | To determine with your account manager |
What parameters should I use ? | loopcd (for all analytics platforms including Adobe, Google or Piano Analytics)using the utm_content parameter in substitution is possible (only for Google Analytics) |
URL template | Just add the following parameter at the end of the destination URLs |
Shoud I use both adlcoid & utm_content ? | No, just chose one parameter and keep it consistent for all Effinity Campaigns for now and the future |
Level in which I put the URL templates | Account or Affiliate level |
Where is it located ? | To determine with your account manager |
What parameters should I use ? | loopcd (for all analytics platforms including Adobe, Google or Piano Analytics)using the utm_content parameter in substitution is possible (only for Google Analytics) |
URL template | Just add the following parameter at the end of the destination URLs |
Shoud I use both adlcoid & utm_content ? | No, just chose one parameter and keep it consistent for all TimeOne Campaigns for now and the future |
Level in which I put the URL templates
Account or Affiliate level
Where is it located ?
To determine with your account manager
What parameters should I use ?
loopcd (for all analytics platforms including Adobe, Google or Piano Analytics) using the utm_content parameter in substitution is possible (only for Google Analytics)
URL template
Just add the following parameter at the end of the destination URLs&loopcd=AFt|{affiliate_id}
If Adloop is the only tracking template: ?loopcd=AFt|{affiliate_id}
or put this value in the utm_content &utm_content=AFt|{affiliate_id}
The parameter {affiliate_id}
should be filled by the ID of the affiliate as defined by the platform. When the user clicks on the link, it should look like this: &loopcd=AFt|01234
Shoud I use both adlcoid & utm_content ?
No, just chose one parameter and keep it consistent for all Tradedoubler Campaigns for now and the future
Level in which I put the URL templates
Account or Affiliate level
Where is it located ?
To determine with your account manager
What parameters should I use ?
loopcd (for all analytics platforms including Adobe, Google or Piano Analytics) using the utm_content parameter in substitution is possible (only for Google Analytics)
URL template
Just add the following parameter at the end of the destination URLs`&loopcd=AFw
Shoud I use both adlcoid & utm_content ?
No, just chose one parameter and keep it consistent for all Webgains Campaigns for now and the future
Level in which I put the URL templates
Account or Affiliate level
Where is it located ?
To determine with your account manager
What parameters should I use ?
loopcd (for all analytics platforms including Adobe, Google or Piano Analytics)using the utm_content parameter in substitution is possible (only for Google Analytics)
URL template
Just add the following parameter at the end of the destination URLs &loopcd=AFn|{affiliate_id}
. If Adloop is the only tracking template: ?loopcd=AFn|{affiliate_id}
or put this value in the utm_content &utm_content=AFn|{affiliate_id}
. The parameter {affiliate_id}
should be filled by the ID of the affiliate as defined by the platform. When the user clicks on the link, it should look like this: `&loopcd=AFn|01234
Shoud I use both adlcoid & utm_content ?
No, just chose one parameter and keep it consistent for all Netaffiliation Campaigns for now and the future
URL template
RTB House does not allow dynamic tracking templates . You can use our native matching function . To use our automatic matching function, put exactly in the UTM parameter the name of the campaign. Example : name of the campaign in the UTM campaign.
URL template
Criteo does not allow dynamic tracking templates . You can use our native matching function . To use our automatic matching function, put exactly in the UTM parameter the name of the campaign. Example : name of the campaign in the UTM campaign.
The Adloop script is not exempt from users' consent.
Our tag falls under the Statistical category, just like your Analytics one.
With Google Analytics UAWe need you to create a custom dimension in Google Analytics, in which we will put the information gathered by our script.
Specifications of the custom dimension:
scope: session
name: Adloop Click
number of custom dimensions: if you have GA360, a custom dimension for every 75 000 daily sessions is needed ; if you don’t have GA360, a custom dimension for every 50 000 sessions is needed.
Also, you’ll need the list of excluded referrers (especially payment platforms) when doing the set-up in Adloop.
You’ll find this list in GA > Admin > Property > Tracking Info > Referral Exclusion List.
With Google Analytics 4
Go to "Configure"
Go to "Custom Definitions"
Create 2 custom dimensions dedicated to Adloop:
The first one:
Click on "Create custom dimensions"
Name it Adloop Click 1
Select "Event" as scope
Event parameter: adloop_click_1
Also, you’ll need the list of excluded referrers that you will find in GA4 under Data Streams > Configure Tag settings > All settings > List unwanted referrals
With PianoCreate two custom dimensions adl1 and adl1_meta
Type: String
The dimension does not contain personal data
Contener connection and selection
Go onto the Commanders Act platform
Choose the appropriate contener. It is essential that the tag is triggered on all landing pages.
Tags template selection
![Capture d'écran 2023-03-13 115313-20240111-152136.png](.gitbook/Capture d'écran 2023-03-13 115313-20240111-152136.png)
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 dimension configured in your Analytics tool
Subdomains that should be considered as a separate referrer
Referrers to be excluded (the list should be the same as the one in your Analytics tool), like payment platforms
![Capture d'écran 2024-01-11 141320-20240111-152202.png](.gitbook/Capture d'écran 2024-01-11 141320-20240111-152202.png)
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 contener 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) :
What parameters should I use ?
loopcd (for all analytics platforms including Adobe, Google or Piano Analytics)using the utm_content parameter in substitution is possible (only for Google Analytics)
URL template
Xandr does not allow dynamic tracking templates .You can use our native matching function. To use our automatic matching function, put exactly in the UTM parameters the names of the campaign, adgroup & ad with one element per parameter. Example : name of the campaign in the UTM campaign, name of the adgroup in the UTM keyword and name of the ad in UTM content.
With Google Analytics UA
Go to the "Variables" section
Make sure the Container ID is listed under the Build-In Variables
If not, click “Configure”, search for Container ID under “Utilities” and enable it
Create "User defined variables" following this scheme:
Type of variable: Data layer variable
Name of the data layer variable: indicate the value you set up in your custom dimension on GA4 in the event parameter field (ex: adloop_click_1).
And give it an adloop related name
Repeat these operations for all custom dimensions created in GA
Open the configuration of the "Google Analytics settings" variable,
In "More Settings -> Custom Dimensions, click on "Add Custom Dimension"
Fill in the following information:
Index: XX (where "XX" is the index of the dimension created on GA)
Dimension value: {{adloop_click_XX}} (Use the brick to choose the previously created variable)
Repeat these operations for all variables created in GTM
Go to the "Tags" section and add a new tag of type "Custom HTML", with the name "Adloop tag".
Copy and paste the content provided on the Adloop interface into the "HTML" field of the tag
Save the tag without trigger
Open the configuration of the Google Analytics tag with the largest trigger ("All pages" or “Pageviews” for example).
In the advanced settings of this tag, in "Tag sequencing", check "Trigger a tag before Google Analytics is triggered" and choose the "Adloop tag" previously created
*
Check if the script is working without error in the preview mode (find our documentation [[here|Checking-that-the-script-is-triggered]]), then deploy the new version.
Google Analytics 4
Make sure the Container ID is listed under the Build-In Variables
If not, click “Configure”, search for Container ID under “Utilities” and enable it
Go to the "Variables" section
According to the custom dimensions created earlier, create "User defined variables" following this scheme:
First one:
Type of variable: Data layer variable
Name of the data layer variable name : adloop_click_1
Give the variable an Adloop related name
Second one:
Type of variable: Data layer variable
Name of the data layer variable: adloop_click_1_meta
Give the variable an Adloop related name
Open the configuration of the GA4 Configuration tag (type: Google Tag)
In "Fields to Set”, click on "Add Row"
Fill in the following information:
Field Name: adloop_click_1
Value: Use the brick to choose the previously created variable (the 1st one)
Add another filed: adloop_click_1_meta
Value: Use the brick to choose the previously created variable (the 2nd one)
Go to the "Tags" section and add a new tag of type "Custom HTML", with the name "Adloop tag"
Copy and paste the content provided on the Adloop interface into the "HTML" field of the tag
Save the tag without trigger
Open the GA4 Configuration tag (type: Google Tag) that was opened in a previous step
In the advanced settings of this tag, in "Tag sequencing", check "Trigger a tag before this tag is triggered" and choose the "Adloop tag" previously created
For your GA4 events (purchase, add to cart, view item etc.) set-up on GTM, add the Adloop event parameters & values :
adloop_click_1 and for the value select the first user defined variable you created previously using the brick button
adloop_click_1_meta and for the value select the second user defined variable you created previously using the brick button
Note: the name of the value between {{ }} depends on how you named your user defined variable ; it might be different from the screenshot above.
Check that all your events (add to cart, purchase etc.) are triggered after the pageview is sent. Otherwise our script won’t be able to catch those events.
Deploy the new version
The script was correctly triggered in the preview? Great! But that is not the only thing you need to check when installing the Adloop script. You need to check that we are getting all the data from your site.
This verification step can only be done after the Adloop script has been installed for a full day ! If the script is installed on a Monday, you can do the checking only on Wednesday for Tuesday’s data. Also, if you have discrepancies, please keep in mind that Google Analytics data can change for the last 48 hours . If you have small discrepancies, especially on the revenue & transactions metrics, please check data that is more than 48 hours old, as it can explain most of the small discrepancies.
Checking with Google Analytics UAFor this verification, you need to go to your Google Analytics account, into the Custom Reports section.
There click on the New Custom Report button.
Give an Adloop related title to your report so you can identify it quickly, for example Adloop check.
Name the first report content tab “Adloop CD1”. You will need to create a tab for every custom dimension that you set up for Adloop.
Choose the Explorer type.
As metrics, choose: sessions, revenue (if applicable), page views, transactions (or your main conversion event) and new users.
As dimension drilldown, choose the Adloop custom dimension.
You need to repeat this step for every Adloop custom dimension, using the Duplicate this tab button. Just don’t forget to update the Adloop custom dimension for every report.
If you have two custom dimensions, you can name the second tab Adloop CD 2, if three the third can be named Adloop CD 3 and so on.
When you are finished, click on duplicate this tab once again.
Name this tab “source/medium” and as dimension drilldown choose source / medium.
You can now save the report.
Now we need to check that the Adloop script is gathering the same information as the Google Analytics one.
For that, you can open a table (Excel for example) and create the create a file like this one :
That you will fill out with the informations from the Google Analytics Custom Report we just created in the previous step for each line.
If you have several custom dimensions, create a Total Adloop CD line in which you will sum all the numbers from the different Adloop custom dimensions.
You can now create a line to calculate the percentage of difference between the data gathered in the Adloop custom dimension(s) and the data gathered in Google Analytics.
Use the following formula: (Adloop cell) / (GA cell) for every metrics.
Ideally, you have 100% everywhere, but that is that always the case!
For revenue and transactions, it is very important that we aim at a 100% score, meaning that we get all conversions.
But for sessions, pageviews and new users, our script, for some reason (including cookie consent), doesn’t get triggered. The discrepancy should be under 2-3% for those metrics.
Bigger discrepancies mean that the Adloop tag is not triggered as often as it should. Please check the trigger rule for the Adloop tag: it should be fired before the GA pageviews tag.
Checking with GA4Go to the Explore section to create a custom report
In the dimension, select:
the adloop_click_1 dimension
event name
In the events, select:
event count
event value
transactions
Filter on the event name to include only your purchase event :
The same check must be performing for all the events that you track: pageviews, add to cart, product page view etc. That way we are sure that our script is triggered as it should on every page.
Checking with PianoOpen the Data Query section of Piano
Lines : the Adloop custom dimension you created, Events
Columns: Events
Date: From the first full day of data-collection
Be careful to display N/A lines
Compare the number of events attached to an Adloop value to the global number of events on your website for each event. The amount of N/A for each event has to be very low.
The amounts should be very close - we allow a tolerance of 5%.
If you have discrepancies and need help, please contact our Customer Success team that will help you!
Create a new table report using the blank canvas.
The amount of events attached to a (not set) Adloop custom dimension must be very low. We allow a tolerance of 5%.
Before publishing the Adloop script, you need to check it is correctly triggered!
The verification of the script is very easy and will take only a couple of minutes.
On the GTM preview mode, access your website.
Click on the F12 button of your computer or right-click > Inspect to open the Console and go to the Network tab. In the filter box, type “collect?”
Then reload your page using CTRL+R, still with the Console being open.
Find the line with “pageview” in it and click on it to open it.
In the Payload tab, scroll down until you find the list of custom dimensions. They are indicated as cd1, cd2, cd3 etc. Find the custom dimension(s) that you created for Adloop.
Now, the custom dimension that you created should be filled with an Adloop code, that looks like this:
1ed2bf2f-1706-47ff-c3c8-1865373dcd9a:Ep0hc|DR|/
If you see the Adloop code, you can publish our script !
If your custom dimension is not filled with a value, then there is something wrong with the script. Check carefully once again that you followed every step of our Adloop script installation guide. You can also contact our Customer Success team that will be able to assist you with the script installation!
There is another alternative way to check if your script Is being triggered
This method only works when Google Analytics is used asynchronously
On your website:
Open web console > F12 or right-click and click on the inspect element.
A window like this will open up at the bottom of the page.
Click on console and type ga.q
In the ‘set’ section you can find our custom dimension, after clicking on the 1st line to open.
In addition to our data-driven attribution models, we also offer classical ones: first click, last click, linear etc.
Adloop data-driven attribution model is based on users' behaviour. We use all the micro-conversions available in your Analytics source, like key pageviews (product or category), click on a CTA, add to basket and so on.
The more micro-conversions you are tracking, the more detailled our data-driven model will be! So don't hesitate to track new actions on your website.
Then, for each micro-conversion, you have to indicate to Adloop how engaging this action is on the path to conversion. For that, we use commitment levels, from very low to very high.
By default we scale:
the pageview as very low commitment, as viewing a page is the most basic action you can do on a website
the new users as very high commitment, as it gives value to the upper-funnel channels bringing in new users
Some examples of scaling that could help you when setting up the data-driven attribution model:
view of a product page: low commitment
view of a category page: low commitment
displaying the details of a product: medium commitment
add to wishlist: high commitment
add to basket: very high commitment
subscribe to newsletter: very high commitment
store locator: medium commitment
demo booking: very high commitment
Those are just few examples, as every website is different, you are the best to judge how engaging the actions on your website are.
If you don't know which micro-conversions to use, just navigate on your website and put yourself in the shoes of a potential customer discovering your website for the first time and then purchasing!
We scale differently the different steps of the conversion funnel: delivery choice, delivery address, contact information, payment choice. Those are not to be included in the commitment scaling step.
Our algorithm will take into account the scaling of the micro-conversions when calculating attribution.
The more a user interacts with the website on a touchpoint, the more credit this touchpoint will get when calculating the attribution and contribution. This touchpoint will get a bigger fraction of the conversion and of the revenue.
Get the script from the attribution source setup.
You have to place it after initializing the GA script but before sending the pageview:
Example:
analytics.jsgtag.js
Now that you set-up your behavioural attribution model in Adloop, you see that you have new metrics in your reports : attributed conversions & revenue.
The attributed conversion/revenue is the amount of conversion/revenue that can be attributed to a traffic source or campaign . It is very useful in analyzing return on ad spend and determining the digital marketing budgets.
Adloop attributed conversions & revenue will differ from the one indicated by Google Analytics or by the Ad Platforms and it is normal : we use our own behavioural algorithm to calculate attribution. Our attribution is behaviour-based, meaning that it takes into account the actions that the users did on your website.
a- Cost per attributed conversion
Ad Spend / Attributed Conversions
b- Attributed return on ad spend
Attributed Revenue / Ad Spend
Use those two KPI, compare them to what the Ad Platforms say! Then you can start optimizing your digital marketing campaigns based on more reliable & more transparent metrics.
Optimizating your digital marketing only on conversions & revenue would mean that you leave out most of your campaigns. To answer this challenge, Adloop created the useful click .
Well, that’s up to you!
YOU decide what makes a click useful to your business. Is a click useful only if the user sees more than 2 pageviews? Or if he sees a product page?
When setting up the Adloop Tracking & Attribution data source, you will have to choose the useful click definition, using goals & events from your Analytics data source. You can combine several goals & events if you want, using logical connectors “or” & “and”.
Here for example, a click will be considered useful if:
there is at least 2 pageviews, or
at least one product search, or
at least one product view
noteTo create custom metric, visit [[our dedicated page|Calculated-metrics]]!
To create custom metric, visit our dedicated page!
To analyze your digital marketing, we advise you to create two KPI using the useful clicks:
a - Cost per useful click
Ad Spend / Useful Clicks
b - Useful click ratio
Useful Clicks / Adloop Clicks
Adding those two KPI to your report will enable you to highlight any elements not driving enough qualified traffic.
It is especially interesting to compare the cost per useful click with the Advertising CPC, to highlight the difference between the two.