> 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/documentation/documentation-nl/website-integraties/aangepast/voeg-het-aangepaste-user-data-script-toe-aan-je-website.md).
# Voeg het aangepaste User Data Script toe aan je website
Dit artikel legt uit hoe je het AdPage User Data Script toevoegt aan een aangepaste website of CMS. Dit script verzamelt marketing- en apparaatgegevens. Het pusht ook het trytagging\_user\_data-event naar de dataLayer.
{% hint style="info" %}
**Opmerking:** Gebruik dit script alleen wanneer de AdPage-plugin of app NIET **NIET** geïnstalleerd is. De AdPage-plugin of app regelt dit automatisch voor Shopify, WooCommerce, WordPress, Magento en Lightspeed.
{% endhint %}
### Wanneer moet je dit script gebruiken?
| Situatie | Script vereist? |
| ------------------------------------- | --------------- |
| Aangepast CMS zonder de AdPage-plugin | ✅ Ja |
| Maatwerkwebsite | ✅ Ja |
| Platform zonder AdPage-koppeling | ✅ Ja |
| Shopify met de AdPage-app | ❌ Nee |
| WooCommerce met de AdPage-plugin | ❌ Nee |
| WordPress met de AdPage-plugin | ❌ Nee |
| Magento met de AdPage-extensie | ❌ Nee |
| Lightspeed met de AdPage Pixel | ❌ Nee |
***
### Wat doet dit script?
Het User Data Script verzamelt automatisch:
* **Apparaatinformatie:** Browser, besturingssysteem en schermresolutie.
* **Marketinggegevens:** UTM-parameters, verwijzers, campagnedata en sessie-ID's.
* **Gebruikersidentificatie:** Client-ID, sessie-ID en sessietelling voor nauwkeurige attributie.
Deze gegevens worden beschikbaar in de dataLayer via `trytagging_user_data`. Dit event start alle andere tracking. Zonder dit wordt trackingdata niet correct verwerkt.
#### Waarom is de laadvolgorde belangrijk?
De `trytagging_user_data` event bevat belangrijke identificatiegegevens. Deze omvatten `client_id`, `session_id`en `session_count`. Alle volgende events gebruiken ze. Er ontstaan problemen als andere dataLayer-events, zoals `view_item` of `add_to_cart`, worden gepusht **vóór** dit script laadt:
* Google Tag mist vereiste configuratieparameters.
* Sessies kunnen niet correct worden toegewezen.
* Webhooks werken niet correct omdat marketinggegevens ontbreken.
* GA4 en advertentieplatforms ontvangen onvolledige gegevens of geen gegevens.
***
### Stap 1: Zoek je gekoppelde domein
Voordat je het script installeert, heb je je **gekoppelde domein**. Je kunt het op twee manieren vinden.
#### Optie A: Gebruik de installatiekoppeling
Als je van AdPage een installatiekoppeling hebt ontvangen, staan het domein in de instructies.
#### Optie B: Gebruik het Trytagging-dashboard
1. Ga naar de [adpage-platform](https://data.adpage.io/) en meld je aan.
2. Selecteer de juiste container.
3. Ga naar **Implementatie** → **Domeinnaam**.
4. Kopieer je gekoppelde domein, bijvoorbeeld `tagging.yourwebsite.com`.
{% hint style="info" %}
**Voorbeeld:** Als je gekoppelde domein is `tagging.webshop.nl`, gebruik `https://tagging.webshop.nl/user-data-minified.js` als de script-URL.
{% endhint %}
***
### Stap 2: Installeer het script
{% hint style="warning" %}
**Belangrijk: De laadvolgorde is cruciaal.**
Dit script **MOET** laden en uitvoeren **VOORDAT** andere dataLayer-events worden gepusht. Het `trytagging_user_data` event start je trackingconfiguratie. Zonder dit kan Google Tag Manager events zoals `view_item`, `add_to_cart`en `purchase` niet correct verwerken.
**Plaats dit script:**
* Zo vroeg mogelijk in de `` sectie.
* Vóór het Google Tag Manager-script.
* Vóór alle andere tracking-scripts.
{% endhint %}
Kopieer het volgende script. **Vervang** `[YOUR_LINKED_DOMAIN]` met het gekoppelde domein uit stap 1.
```html
```
#### Voorbeeld met een gekoppeld domein
Als je gekoppelde domein is `tagging.webshop.nl`, vervang regel 42:
```javascript
// Van:
loadScript('https://[YOUR_LINKED_DOMAIN]/user-data-minified.js')
// Naar:
loadScript('https://tagging.webshop.nl/user-data-minified.js')
```
***
### Stap 3: Controleer de installatie
Controleer na het toevoegen van het script of het correct werkt.
#### Controle 1: Browserconsole
1. Open je website in Chrome of Firefox.
2. Open Ontwikkelaarstools met `F12` of `Cmd` + `Optie` + `I`.
3. Selecteer het **Console** tabblad.
4. Controleer dat er geen rode fouten zijn met betrekking tot `tagging` of `user-data`.
#### Controle 2: Controleer de dataLayer
1. Voer `dataLayer` in de console.
2. Druk op Enter.
3. Zoek een object met `event: "trytagging_user_data"`.
4. Controleer de `marketing` en `device` objecten gegevens bevatten.
**Voorbeeld van juiste uitvoer:**
```javascript
{
event: "trytagging_user_data",
device: {
browser: "Chrome",
os: "Windows",
// ... meer apparaatinformatie
},
marketing: {
user_id: "abc123...",
session_id: "xyz789...",
// ... meer marketinginformatie
}
}
```
#### Controle 3: Netwerktabblad
1. Selecteer het **Netwerk** tabblad in Ontwikkelaarstools.
2. Vernieuw de pagina.
3. Filter op `user-data`.
4. Bevestigen `user-data-minified.js` succesvol geladen met status `200`.
***
### Stap 4: Configureer Google Tag Manager (optioneel)
Om het script via Google Tag Manager te beheren in plaats van via je broncode:
1. Maak een **Custom HTML-tag** in GTM.
2. Plak het volledige script, inclusief de `