> For the complete documentation index, see [llms.txt](https://docs.adpage.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.adpage.io/integrations-websites/custom/add-the-custom-user-data-script-to-your-website.md).
# Add the custom User Data Script to your website
This article explains how to add the AdPage User Data Script to a custom website or CMS. This script collects marketing and device data. It also pushes the trytagging\_user\_data event to the dataLayer.
{% hint style="info" %}
**Note:** Only use this script when the AdPage plugin or app is **NOT** installed. The AdPage plugin or app handles this automatically for Shopify, WooCommerce, WordPress, Magento, and Lightspeed.
{% endhint %}
### When should you use this script?
| Situation | Script required? |
| -------------------------------------- | ---------------- |
| Custom CMS without the AdPage plugin | ✅ Yes |
| Custom-built website | ✅ Yes |
| Platform without an AdPage integration | ✅ Yes |
| Shopify with the AdPage App | ❌ No |
| WooCommerce with the AdPage Plugin | ❌ No |
| WordPress with the AdPage Plugin | ❌ No |
| Magento with the AdPage Extension | ❌ No |
| Lightspeed with the AdPage Pixel | ❌ No |
***
### What does this script do?
The User Data Script automatically collects:
* **Device information:** Browser, operating system, and screen resolution.
* **Marketing data:** UTM parameters, referrers, campaign data, and session IDs.
* **User identification:** Client ID, session ID, and session count for accurate attribution.
This data becomes available in the dataLayer through `trytagging_user_data`. This event starts all other tracking. Without it, tracking data is not processed correctly.
#### Why is the load order important?
The `trytagging_user_data` event contains key identifiers. These include `client_id`, `session_id`, and `session_count`. All following events use them. Problems occur if other dataLayer events, such as `view_item` or `add_to_cart`, are pushed **before** this script loads:
* Google Tag misses required configuration parameters.
* Sessions cannot be attributed correctly.
* Webhooks do not work correctly because marketing data is missing.
* GA4 and advertising platforms receive incomplete data, or no data.
***
### Step 1: Find your linked domain
Before installing the script, you need your **linked domain**. You can find it in two ways.
#### Option A: Use the installation link
If you received an installation link from AdPage, the instructions include the domain.
#### Option B: Use the Trytagging dashboard
1. Go to the [adpage platform](https://data.adpage.io/) and sign in.
2. Select the correct container.
3. Go to **Implementation** → **Domain name**.
4. Copy your linked domain, for example `tagging.yourwebsite.com`.
{% hint style="info" %}
**Example:** If your linked domain is `tagging.webshop.nl`, use `https://tagging.webshop.nl/user-data-minified.js` as the script URL.
{% endhint %}
***
### Step 2: Install the script
{% hint style="warning" %}
**Important: The load order is critical.**
This script **MUST** load and run **BEFORE** other dataLayer events are pushed. The `trytagging_user_data` event starts your tracking setup. Without it, Google Tag Manager cannot process events such as `view_item`, `add_to_cart`, and `purchase` correctly.
**Place this script:**
* As early as possible in the `` section.
* Before the Google Tag Manager script.
* Before any other tracking scripts.
{% endhint %}
Copy the following script. **Replace** `[YOUR_LINKED_DOMAIN]` with the linked domain from Step 1.
```html
```
#### Example with a linked domain
If your linked domain is `tagging.webshop.nl`, replace line 42:
```javascript
// From:
loadScript('https://[YOUR_LINKED_DOMAIN]/user-data-minified.js')
// To:
loadScript('https://tagging.webshop.nl/user-data-minified.js')
```
***
### Step 3: Verify the installation
After adding the script, verify that it works correctly.
#### Check 1: Browser console
1. Open your website in Chrome or Firefox.
2. Open Developer Tools with `F12` or `Cmd` + `Option` + `I`.
3. Select the **Console** tab.
4. Confirm there are no red errors related to `tagging` or `user-data`.
#### Check 2: Verify the dataLayer
1. Enter `dataLayer` in the console.
2. Press Enter.
3. Find an object with `event: "trytagging_user_data"`.
4. Confirm the `marketing` and `device` objects contain data.
**Example of correct output:**
```javascript
{
event: "trytagging_user_data",
device: {
browser: "Chrome",
os: "Windows",
// ... more device information
},
marketing: {
user_id: "abc123...",
session_id: "xyz789...",
// ... more marketing information
}
}
```
#### Check 3: Network tab
1. Select the **Network** tab in Developer Tools.
2. Refresh the page.
3. Filter for `user-data`.
4. Confirm `user-data-minified.js` loaded successfully with status `200`.
***
### Step 4: Configure Google Tag Manager (optional)
To manage the script through Google Tag Manager instead of your source code:
1. Create a **Custom HTML Tag** in GTM.
2. Paste the complete script, including the `