Artikelen over: Diversen
Dit artikel is ook beschikbaar in:

Trytagging user data script toevoegen voor maatwerk websites

DataLayer Script Installatie - AdPage Data Assistant Tag

Overzicht

Dit artikel legt uit hoe je een DataLayer script toevoegt aan je website om verschillende datapunten te verzamelen. Dit script is essentieel voor het correct functioneren van de Data Assistant Tag van AdPage en zorgt ervoor dat gebruikersdata automatisch wordt verzameld en beschikbaar gemaakt voor je marketing tools.


Wanneer heb je dit script nodig?

Dit DataLayer script is alleen nodig voor websites/webshops waarbij de AdPage plugin of app NIET is geïnstalleerd.



AdPage plugin/app beschikbaar voor:

  • Shopify: AdPage App via Shopify App Store
  • WooCommerce: AdPage Plugin voor WordPress/WooCommerce
  • WordPress: AdPage Plugin via WordPress Plugin Directory
  • Magento: AdPage Extension voor Magento
  • Lightspeed: AdPage App via Lightspeed App Store



Gebruik dit DataLayer script wanneer:

  • Je een custom website hebt (niet gebouwd op bovenstaande platforms)
  • Je de AdPage plugin/app nog niet hebt geïnstalleerd
  • Je een platform gebruikt dat nog geen AdPage integratie heeft
  • Je handmatige controle wilt over de data verzameling

Let op: Als je wel de AdPage plugin/app gebruikt, is dit script NIET nodig. De plugin/app verzorgt automatisch de juiste data verzameling.



Wat doet dit script?

Het DataLayer script verzamelt automatisch:

  • Apparaatinformatie: Browser, besturingssysteem, schermresolutie
  • Marketing data: UTM parameters, referrers, campagne informatie
  • Gebruikersgedrag: Sessie informatie en interacties

Deze gegevens worden vervolgens beschikbaar gemaakt via de dataLayer voor gebruik door Google Tag Manager, AdPage tags en andere tracking tools.


Ideaal voor AdPage MCP Integratie

Dit DataLayer script is perfect geschikt voor de AdPage MCP (Model Context Protocol) integratie. Na het laden van het script worden alle dataLayer events die na het trytagging_user_data event plaatsvinden automatisch opgeslagen en gemonitord.

Voordelen voor MCP:

  • Automatische event monitoring: Alle dataLayer pushes worden vastgelegd
  • Volledige gebruikersreis: Van eerste bezoek tot conversie
  • Real-time data analyse: Events worden direct beschikbaar voor analyse
  • Custom event tracking: Ook je eigen events worden meegenomen


Belangrijk: Voor optimale MCP functionaliteit moet de Data Assistant Tag correct zijn ingesteld. Volg hiervoor de instructies in: Het instellen van de AdPage Data Assistant Monitoring Tag



Installatie

Stap 1: Vervang de domeinnaam

BELANGRIJK: Voor het script correct werkt, moet je jouwdomeinnaam.nl vervangen door je eigen domeinnaam.

Voorbeeld:




Stap 2: Plaats het script in je website

Voeg het volgende script toe aan de <head> sectie van je website, vóór andere tracking scripts zoals Google Tag Manager of stel het in als HTML tag in Google Tag Manager. 

<script>
(function() {
  // Function to load external script with defer
  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);
    });
  }
  
  // Function to check if taggingHelpers is available
  function checkTaggingHelpers(timeout) {
    timeout = timeout || 10000;
    var startTime = Date.now();
    return new Promise(function(resolve, reject) {
      function check() {
        // Check if helpers exist and have required methods
        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();
    });
  }
  
  // Function to collect data from taggingHelpers
  function collectData() {
    try {
      return {
        event: 'trytagging_user_data',
        device: window.taggingHelpers.getDeviceInfo() || {},
        marketing: window.taggingHelpers.getMarketingObject() || {}
      };
    } catch (error) {
      console.error('Error collecting tagging data:', error);
      return null;
    }
  }
  
  // Function to push to dataLayer
  function pushToDataLayer(data) {
    if (!data) return;
    
    window.dataLayer = window.dataLayer || [];
    window.dataLayer.push(data);
  }
  
  // Main execution
  function init() {
    loadScript('https://tagging.jouwdomeinnaam.nl/user-data-minified.js')
      .then(function() {
        return checkTaggingHelpers();
      })
      .then(function() {
        var data = collectData();
        pushToDataLayer(data);
      })
      .catch(function(error) {
        console.error('Error in tagging initialization:', error);
      });
  }
  
  // Start initialization when DOM is ready
  if (document.readyState !== 'loading') {
    init();
  } else {
    document.addEventListener('DOMContentLoaded', init);
  }
})();
</script>


Stap 3: Verificatie

Na installatie kun je controleren of het script correct werkt:

  1. Browser Console: Open de ontwikkelaarstools (F12) en controleer of er geen errors zijn
  2. DataLayer Check: Type dataLayer in de console om te zien of data wordt toegevoegd
  3. Network Tab: Controleer of het script user-data-minified.js succesvol wordt geladen




Troubleshooting

Script laadt niet

Geen data in dataLayer

  • Controleer browser console op error berichten
  • Zorg dat het script vóór andere tracking scripts staat

Data Assistant Tag werkt niet

  • Controleer of het DataLayer script correct geladen is
  • Verificeer of de trytagging_user_data event wordt verzonden

Support

Voor verdere ondersteuning bij de implementatie van dit DataLayer script en de Data Assistant Tag, neem contact op met het AdPage support team.



Bijgewerkt op: 31/07/2025

Was dit artikel nuttig?

Deel uw feedback

Annuleer

Dankuwel!