Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Expand
titleWith 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

image-20240222-100528.pngImage Added
  • Create "User defined variables" following this scheme:

    • Type of variable: Data layer variable

    • Name of the data layer variable: dimensionXX, where "XX" is the index of the dimension created on GA. For example, if the index of your dimension is 1, please indicate dimension1, if it’s 2, please indicate dimension2 and so on. 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), then deploy the new version.

Expand
titleGoogle 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

      : dimension1, where "1" is the index of the dimension created on GA
    • Repeat these steps for all custom dimensions created in GA

Image Removed
      • name : adloop_click_1

      • Give the variable an Adloop related name

    • Image Added
    • 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

Image Added

  • Open the configuration of the "Google Analytics: GA4 Configuration " variabletag (type: Google Tag)

  • In "Fields to Set”, click on "Add Row"

  • Fill in the following information:

    • Field Name: adloop_click_XX (where "XX" is the index of the dimension created on GA)Value: {{adloop_click_XX}} (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)

    • Repeat these operations for all variables created in GTM

Image RemovedImage Added

  • 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 Google Analytics tag configuration with the largest trigger ("All pages", for example)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 Google Analytics 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 :

Image Added

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

Image Added

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