> For the complete documentation index, see [llms.txt](https://community.commandersact.com/adloop/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://community.commandersact.com/adloop/vii-adloop-tracking-and-attribution/b.-adloop-script-installation-and-checking/script-installation-on-gtm.md).

# Script installation on GTM

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

![image-20240222-100528.png](/files/Fm5J43ywJ9fNQSS3d9YM)

* 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

![](/files/Im5E016NhTX0y7HhIrkQ)

* 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

![](/files/GmuFm7xDM0oApAurtwmL)

* 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

![](/files/Gax6PJN4duxuyjXR7q0k)

* 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

![](/files/KJsyGl3S07RU9cEIOpjb) \*

* 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
  *

  ```
  ![](/files/eov6VBKoZHKLbJX7NTAs)
  ```

  * 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

![](/files/DB7GQLuN83dUp2T6Idp6)

* 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)

![](/files/j52SWnZoPSkm1vD9uN3Z)

* 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

![](/files/4SuL64LG38q5xWKV7muL)

* 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 :

![](/files/YB5BhzFiYu0rlLeTKs7j)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

![](/files/lFIdWV2OLHKXzSRrJPQS)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

![](/files/0eYhBdFOwJ0wx4l2aasU)