> 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/integraties-websites/aangepast/gebruikersdatascript-toevoegen.md).

# Gebruikersdatascript toevoegen

In dit artikel wordt uitgelegd hoe je het AdPage User Data Script toevoegt aan een aangepaste website of CMS. Dit script verzamelt marketing- en apparaatgegevens. Het pusht ook de trytagging\_user\_data-gebeurtenis naar de dataLayer.

{% hint style="info" %}
**Opmerking:** Gebruik dit script alleen wanneer de AdPage-plugin of -app **NIET** geïnstalleerd is. De AdPage-plugin of -app regelt dit automatisch voor Shopify, WooCommerce, WordPress, Magento en Lightspeed.
{% endhint %}

### Wanneer moet u dit script gebruiken?

| Situatie                               | Script vereist? |
| -------------------------------------- | --------------- |
| Aangepaste CMS zonder de AdPage-plugin | ✅ Ja            |
| Maatwerkwebsite                        | ✅ Ja            |
| Platform zonder een AdPage-integratie  | ✅ 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, verwijzende sites, campagnegegevens 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`. Deze gebeurtenis start alle andere tracking. Zonder dit worden trackinggegevens niet correct verwerkt.

#### Waarom is de laadvolgorde belangrijk?

De `trytagging_user_data` gebeurtenis bevat belangrijke identificatiegegevens. Deze omvatten `client_id`, `session_id`, en `session_count`. Alle volgende gebeurtenissen gebruiken deze. Er ontstaan problemen als andere dataLayer-gebeurtenissen, zoals `view_item` of `add_to_cart`, worden gepusht **voordat** dit script wordt geladen:

* Google Tag mist vereiste configuratieparameters.
* Sessies kunnen niet correct worden toegeschreven.
* Webhooks werken niet correct omdat marketinggegevens ontbreken.
* GA4 en advertentieplatforms ontvangen onvolledige gegevens, of geen gegevens.

***

### Stap 1: Vind uw gekoppelde domein

Voordat u het script installeert, heeft u uw **gekoppelde domein**. U kunt het op twee manieren vinden.

#### Optie A: Gebruik de installatielink

Als u een installatielink van AdPage hebt ontvangen, bevat de instructie het domein.

#### Optie B: Gebruik het Trytagging-dashboard

1. Ga naar het [AdPage-platform](https://data.adpage.io/) en meld u aan.
2. Selecteer de juiste container.
3. Ga naar **Implementatie** → **Domeinnaam**.
4. Kopieer uw gekoppelde domein, bijvoorbeeld `tagging.yourwebsite.com`.

{% hint style="info" %}
**Voorbeeld:** Als uw gekoppelde domein `tagging.webshop.nl`is, gebruik `https://tagging.webshop.nl/user-data-minified.js` als de script-URL.
{% endhint %}

***

### Stap 2: Installeer het script via Google Tag Manager (optioneel)

{% hint style="warning" %}
**Belangrijk: De laadvolgorde in GTM.**

De `trytagging_user_data` gebeurtenis start uw trackinginstelling. Zonder dit kan Google Tag Manager gebeurtenissen zoals `view_item`, `add_to_cart`, en `purchase` niet correct verwerken.

**Plaats dit script:**

* Plaats dit script in Google Tag Manager
  {% endhint %}

Om het script via Google Tag Manager te beheren in plaats van via uw broncode:

1. Maak een **Aangepaste HTML-tag** aan in GTM.
2. Plak het volledige script, inclusief de `<script>` tags.
3. Stel de trigger in op **Alle pagina's** of **DOM Ready**.
4. Zorg ervoor dat deze tag als **eerste**afgaat. Gebruik indien nodig Tag Sequencing.

{% hint style="info" %}
**Belangrijk:** Pusht `trytagging_user_data` vóór alle andere e-commercegebeurtenissen. Configureer andere tags om te triggeren **na** deze gebeurtenis.
{% endhint %}

**Tagconfiguratie**

<figure><img src="https://2136026570-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA65KwL1NwewlJbtCXsXd%2Fuploads%2Fw5cGIHvSDDLrTC8KoHf5%2Fimage.png?alt=media&amp;token=70c02990-52db-4a06-8eb7-0fbeaf108226" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2136026570-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FA65KwL1NwewlJbtCXsXd%2Fuploads%2FcFKfaZxHjKkt5BI0zkjr%2Fimage.png?alt=media&amp;token=57f2997d-d5c2-4de0-a2ab-dd86507e73e5" alt=""><figcaption></figcaption></figure>

Kopieer het volgende script. **Vervang** `[YOUR_LINKED_DOMAIN]` door het gekoppelde domein uit Stap 1.

```html
<script>
(function() {
  // Functie om extern script met defer te laden
  function loadScript(url) {
    return new Promise(function(resolve, reject) {
      var script = document.createElement('script');
      script.defer = true;
      script.src = url;
      script.onload = resolve;
      script.onerror = reject;
      document.head.appendChild(script);
    });
  }
  
  // Functie om te controleren of taggingHelpers beschikbaar is
  function checkTaggingHelpers(timeout) {
    timeout = timeout || 10000;
    var startTime = Date.now();
    return new Promise(function(resolve, reject) {
      function check() {
        if (window.taggingHelpers && 
            typeof window.taggingHelpers.getMarketingObject === 'function' && 
            typeof window.taggingHelpers.getDeviceInfo === 'function') {
          resolve();
        } else if (Date.now() - startTime > timeout) {
          reject(new Error('Timeout waiting for taggingHelpers'));
        } else {
          setTimeout(check, 50);
        }
      }
      check();
    });
  }
  
  // Functie om gegevens uit taggingHelpers te verzamelen
  function collectData() {
    try {
      return {
        event: 'trytagging_user_data',
        device: window.taggingHelpers.getDeviceInfo() || {},
        marketing: window.taggingHelpers.getMarketingObject() || {}
      };
    } catch (error) {
      console.error('Fout bij het verzamelen van tagging-gegevens:', error);
      return null;
    }
  }
  
  // Functie om naar dataLayer te pushen
  function pushToDataLayer(data) {
    if (!data) return;
    
    window.dataLayer = window.dataLayer || [];
    window.dataLayer.push(data);
  }
  
  // Hoofduitvoering
  function init() {
    loadScript('https://[YOUR_LINKED_DOMAIN]/user-data-minified.js')
      .then(function() {
        return checkTaggingHelpers();
      })
      .then(function() {
        var data = collectData();
        pushToDataLayer(data);
      })
      .catch(function(error) {
        console.error('Fout in tagging-initialisatie:', error);
      });
  }
  
  // Start de initialisatie wanneer de DOM gereed is
  if (document.readyState !== 'loading') {
    init();
  } else {
    document.addEventListener('DOMContentLoaded', init);
  }
})();
</script>
```

#### Voorbeeld met een gekoppeld domein

Als uw gekoppelde domein `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 uw website in Chrome of Firefox.
2. Open Developer Tools met `F12` of `Cmd` + `Option` + `I`.
3. Selecteer het tabblad **Console** .
4. Controleer of er geen rode fouten zijn met betrekking tot `tagging` of `user-data`.

#### Controle 2: Controleer de dataLayer

1. Voer `dataLayer` in in de console.
2. Druk op Enter.
3. Zoek een object met `event: "trytagging_user_data"`.
4. Controleer of de `marketing` en `device` objecten gegevens bevatten.

**Voorbeeld van correcte output:**

```javascript
{
  event: "trytagging_user_data",
  device: {
    browser: "Chrome",
    os: "Windows",
    // ... meer apparaatinformatie
  },
  marketing: {
    user_id: "abc123...",
    session_id: "xyz789...",
    // ... meer marketinginformatie
  }
}
```

#### Controle 3: Netwerk-tabblad

1. Selecteer het tabblad **Netwerk** tabblad in Developer Tools.
2. Ververs de pagina.
3. Filter op `user-data`.
4. Bevestig `user-data-minified.js` is succesvol geladen met status `200`.

***

### Problemen oplossen

#### Het script wordt niet geladen

**Mogelijke oorzaken:**

* De domeinnaam is onjuist.
* Het gekoppelde domein is niet actief in Trytagging.
* De URL bevat een typefout.

**Oplossing:**

1. Bevestig dat u het juiste domein uit Trytagging hebt gekopieerd.
2. Test `https://[your-domain]/user-data-minified.js` rechtstreeks in uw browser.
3. Neem contact op met de ondersteuning van AdPage als u een `404` foutmelding

#### Geen gegevens in de dataLayer

**Mogelijke oorzaken:**

* Het script verschijnt na andere tracking-scripts.
* Er treedt een JavaScript-fout op op de pagina.
* Een advertentieblokker blokkeert het script.

**Oplossing:**

1. Verplaats het script naar het begin van de `<head>` sectie.
2. Controleer de console op JavaScript-fouten.
3. Test in een incognitovenster zonder extensies.

#### `taggingHelpers` is niet gedefinieerd

**Mogelijke oorzaken:**

* Het externe script is nog niet geladen.
* Er is een netwerkprobleem opgetreden.

**Oplossing:** Het script wacht tot 10 seconden op laden. Controleer als het probleem aanhoudt:

1. Of de URL correct is.
2. Of de console CORS-fouten toont.
3. Of een firewall het script blokkeert.

#### Consolefout: `Timeout waiting for taggingHelpers`

Dit betekent dat het script na 10 seconden nog steeds niet beschikbaar was.

**Oplossing:**

1. Controleer uw internetverbinding.
2. Bevestig dat de script-URL bereikbaar is.
3. Verhoog indien nodig de timeoutwaarde: `timeout = timeout || 10000;` op regel 11.

***

### Veelgestelde vragen

#### Kan ik dit combineren met de volledige aangepaste dataLayer?

Ja. Dit script levert alleen de `trytagging_user_data` gebeurtenis.

#### Moet ik het script op elke pagina toevoegen?

Ja. Het script moet op **elke pagina** van uw website staan. Push `trytagging_user_data` op elke pagina voordat andere trackinggebeurtenissen plaatsvinden.

#### Werkt dit script met Consent Mode?

Ja. Het script ondersteunt Google Consent Mode. Wanneer u een CMP gebruikt, worden gegevens alleen verzameld nadat de bezoeker toestemming heeft gegeven.

#### Heb ik dit script nodig voor Data Assistant?

Ja. De Data Assistant-tag vereist `trytagging_user_data` als startgebeurtenis. Zonder dit script werkt Data Assistant niet correct.

#### Wat als ik meerdere domeinen heb?

Elk domein heeft een apart gekoppeld domein nodig in Trytagging. Werk het script voor elk domein bij met de juiste URL.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.adpage.io/documentation/documentation-nl/integraties-websites/aangepast/gebruikersdatascript-toevoegen.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
