De user dataLayer legt bij elke paginaweergave gegevens vast over de specifieke gebruiker. Denk aan de inlogstatus, de herkomst van het verkeer en de koppeling tussen een user_id en een bekend customer_id in bijvoorbeeld een CRM. In dit artikel lees je wanneer de user dataLayer wordt afgevuurd, waarom dat belangrijk is en welke variabelen je meegeeft.
Voorwaarde: de user dataLayer is een van de geïmplementeerde dataLayers binnen Datamotive. Wil je eerst weten wat een dataLayer is en hoe deze in de datastroom past? Raadpleeg dan de handleiding [Wat is een DataLayer en hoe werkt deze binnen Datamotive?]
Wanneer wordt de user dataLayer afgevuurd?
De user dataLayer moet zo snel mogelijk worden afgevuurd wanneer een gebruiker een nieuwe pagina op het platform bezoekt. Bij elke nieuwe paginaweergave wordt deze dataLayer opnieuw afgeschoten.
Let op: plaats deze dataLayer altijd bóven de Google Tag Manager (GTM) code in de
<head>van de website. Zo is de gebruikersinformatie beschikbaar voordat GTM wordt geladen.
Waarom is de user dataLayer belangrijk?
De user dataLayer wordt gebruikt om gegevens van de specifieke gebruiker te achterhalen. Zo wordt bijvoorbeeld vastgelegd of de gebruiker is in- of uitgelogd, waar de gebruiker vandaan komt en welk user_id gekoppeld kan worden aan een bekend customer_id in bijvoorbeeld een CRM. Hierdoor kunnen sessies en gebruikers beter worden herkend en gekoppeld aan bestaande klantgegevens.
Voorbeeldcode
Hieronder zie je een voorbeeldcode om de user dataLayer aan de website toe te voegen. Zoals vermeld hoort deze code boven de GTM-code in de <head> sectie van de website:
Variabelen van de user dataLayer
De user dataLayer bevat de volgende variabelen.
user_id (String)
Het unieke gebruikers-id dat correspondeert met de sessie.
user_login (String)
De loginstatus van een gebruiker. Geef bij geen status logged_out mee, anders logged_in. Mogelijke waarden:
- logged_in – de gebruiker is ingelogd.
- logged_out – de gebruiker is niet ingelogd.
customer_id (String)
Het klant-id dat overeenkomt met het CRM en correspondeert met het inlog-id indien bekend. Zolang er geen mijn-omgeving is, wordt hiervoor het unieke sessie-id gebruikt.
customer_group (String)
De klantgroep die overeenkomt met het CRM, bijvoorbeeld business of private.
country_code (String)
De code van het land van de gebruiker, bijvoorbeeld nl-NL, de-DE of nl-BE.
country_language (String)
De taal van de browser van de gebruiker, bijvoorbeeld nl-NL, de-DE of nl-BE.
source/medium (String)
Geeft via UTM aan waar het verkeer vandaan komt (de source, zoals een specifieke website, zoekmachine of nieuwsbrief) en via welk medium het verkeer naar de website is gekomen. Mogelijke waarden zijn onder andere:
- (direct) / (none)
- google / organic
- google / cpc
- facebook / social
- linkedin / social
- (referral) / (referral)
- (direct) / (not set)
- (referral) / social
- (direct) / (organic)
gclid (String)
De click-id van de betreffende source/medium.
Let op: in de variabelenlijst worden de velden
mediumenclidgenoemd, terwijl de codesource/mediumengclidgebruikt. Bepaal welke veldnamen leidend zijn en houd deze consistent aan bij de implementatie, zodat alle metingen op dezelfde manier worden vastgelegd.
Overzicht variabelen
| Variabele | Type | Keuzemogelijkheden | Verplicht |
|---|---|---|---|
| user_id | String | Vrije waarde (uniek id) | Ja |
| user_login | String | logged_in, logged_out | Ja |
| customer_id | String | Vrije waarde (klant-id of sessie-id) | Ja |
| customer_group | String | business, private, etc. | Ja |
| country_code | String | nl-NL, de-DE, nl-BE, etc. | Ja |
| country_language | String | nl-NL, de-DE, nl-BE, etc. | Ja |
| source/medium | String | (direct)/(none), google/organic, google/cpc, facebook/social, linkedin/social, (referral)/(referral), (direct)/(not set), (referral)/social, (direct)/(organic) | Ja |
| gclid | String | Vrije waarde (click-id) | Ja |