UTM-parameters vastleggen

Deze aangepaste JavaScript-variabele haalt UTM-parameters uit de huidige URL. UTM-parameters zijn tags die je toevoegt aan een URL en die vaak worden gebruikt in marketing om de effectiviteit van campagnes en verkeersbronnen bij te houden. De meest voorkomende UTM-parameters zijn utm_source, utm_medium, utm_campaign, utm_term en utm_content.

Usecase

Deze aangepaste JavaScript-variabele wordt meestal gebruikt voor traceringsdoeleinden, zodat je kunt zien waar je verkeer vandaan komt. Als je bijvoorbeeld een e-mailcampagne voert en UTM-parameters opneemt in de koppelingen in je e-mail, kun je deze aangepaste JavaScript-variabele gebruiken om die UTM-parameters vast te leggen wanneer gebruikers op die koppelingen klikken en op je website terechtkomen. Dit kan je inzicht geven in hoe goed je e-mailcampagne verkeer naar je website leidt.

Instructies

Om deze aangepaste JavaScript-variabele in GTM te implementeren, kun je de volgende code gebruiken:

function() {
  var utmParameters = {};
  var queryParams = location.search.substring(1).split('&');

  for (var i = 0; i < queryParams.length; i++) {
    var param = queryParams[i].split('=');

    if (param[0].startsWith('utm_')) {
      utmParameters[param[0]] = decodeURIComponent(param[1]);
    }
  }
  
  return utmParameters;
}

Deze JavaScript-functie werkt door eerst de querystring van de huidige URL op te vragen met location.search. Het verwijdert het initiële “?” teken, splitst de querystring op in individuele parameters en itereert over deze parameters. Voor elke parameter wordt gecontroleerd of de parameternaam begint met “utm_” en zo ja, wordt de parameterwaarde gedecodeerd en toegevoegd aan het utmParameters object. De functie retourneert vervolgens het utmParameters object, dat alle UTM parameters bevat die in de URL zijn gevonden.

Vergeet niet om deze variabele te testen om er zeker van te zijn dat hij correct werkt. Het is ook vermeldenswaard dat UTM-parameters moeten worden gebruikt in overeenstemming met best practices om zinvolle en bruikbare gegevensverzameling te garanderen.

Als de URL van de pagina bijvoorbeeld is:

https://www.example.com/?utm_source=google&utm_medium=cpc&utm_campaign=spring_sale&utm_content=ad_version_1&utm_term=running+shoes

De uitvoer van de functie zou zijn:

{
  "utm_source": "google",
  "utm_medium": "cpc",
  "utm_campaign": "spring_sale",
  "utm_content": "ad_version_1",
  "utm_term": "running shoes"
}

Elke eigenschap in het object vertegenwoordigt een UTM parameter in de URL, waarbij de naam van de eigenschap de UTM parameternaam is en de waarde van de eigenschap de gedecodeerde waarde van de UTM parameter.

Als de URL geen UTM-parameters heeft, retourneert de functie een leeg object {}.

Onthoud dat dit een JavaScript-object is, dus je kunt individuele eigenschappen benaderen met puntnotatie. Als je bijvoorbeeld een variabele in GTM hebt die deze functie gebruikt en js.utm_parameters heet, kun je {{js.utm_parameters.utm_source}} in GTM gebruiken om de waarde van utm_source te krijgen.

Is dit niet de macro die je zocht? Bekijk hieronder verwante macro’s of vraag er een aan.