Serverside tagging
Serverside tagging wordt toegepast om de website performance te verbeteren en meer controle te hebben over de data die naar externe connecties wordt gestuurd. Als verschillende tools inhaken op de website en niet iedere tool persoonlijke data hoeft te ontvangen, kan deze tagging een goede manier zijn om grip te houden op je data. Wanneer we het in dit artikel over serverside tagging hebben, doelen we op het versturen van events via de server naar het Spotler Activate platform.
Hoewel het allemaal dicht bij elkaar ligt, is dit niet te verwarren met first-party cookies en heeft het ook niet te maken met het blokkeren van het Spotler Activate script door Ad-blockers, hoewel daar ook mooie optimalisaties voor zijn. We zullen deze kort toelichten later in dit artikel.
Hoe verschilt serverside tagging van clientside tagging?
Client side tagging is wat het meest gebruikelijk is. Hierbij stuur je vanaf de website events naar verschillende platformen, waaronder Spotler Activate, maar ook bijvoorbeeld third-parties, zoals Meta, Criteo en Google. De front-end vuurt deze events af en dit zijn verzoeken die je bijvoorbeeld terug vindt in de Netwerk-tab van de developer tools van je browser.
Als er veel partijen worden gekoppeld aan de website voor al je opvolging, kan dit voor vertraging zorgen van je website. Ook zijn deze vaak overal en nergens in te richten, waardoor je het overzicht kan kwijtraken van welke partij, welke data krijgt. Dit laatste is al wat te beperken door veel in te richten via Google Tag Manager.
Wanneer je serverside wilt taggen, gaat de data eerst naar een centraal punt (je server) welke het vervolgens weer uitstuurt naar al deze partijen. Dit gebeurt allemaal op de achtergrond (back-end) en zal je dus op de website (front-end) niet meer terugzien. https://support.google.com/tagmanager/answer/13387731?hl=nl
Wat als ik serverside tagging wil toevoegen aan Spotler Activate?
Serverside taggen kan met Spotler Activate, hier zijn een aantal zaken waar je rekening mee moet houden
Script Spotler Activate
Het script van Spotler Activate zal nog steeds geladen moeten worden op de website. Dit script zorgt er niet alleen voor dat je makkelijk events naar ons kan sturen, maar ook dat we het first-party cookie kunnen plaatsen, profielen kunnen matchen door een link vanuit de e-mail en personalisaties kunnen tonen. Dit script zal automatisch nog 1 front-end event sturen, namelijk de SessionStart. Dit is een event zonder data, waardoor dit zowel voor gevoelige data als snelheid minimale impact heeft. Wel is deze front-end SessionStart ook essentieel voor Spotler Activate en Serverside tagging. Deze zorgt er namelijk ook voor dat er een profiel wordt aangemaakt voor het cookie van je bezoeker. Dit is belangrijk voor de volgende stap.
Events vanuit de server
Hieronder volgt een uitleg van de API, bekijk altijd onze API documentatie voor de meest recente base url en authenticatie. Bij veranderingen wordt de API documentatie altijd eerder aangepast dan deze pagina: https://app.squeezely.tech/documentation#backend-api
Voor het versturen van Events naar Spotler Activate gebruik je onze API voor backend tracking https://app.squeezely.tech/documentation#backend-tracking
Je doet een POST richting https://api.Spotler Activate.tech/v1/track
Voor de authenticatie hebben we twee headers nodig: X-AUTH-ACCOUNT & X-AUTH-APIKEY De waarden van deze twee headers zijn terug te vinden in de Settings van jouw Spotler Activate Merchant. Per merchant zijn er aparte credentials, houdt daar rekening mee als je meerdere merchants in Spotler Activate hebt.
Vervolgens kan je de benodigde events richting Spotler Activate sturen. Bekijk deze pagina in onze handleiding voor de meest voorkomende events en hun data: .
Wat belangrijk is als je alleen maar serverside gaat sturen is de identifier. In Spotler Activate kun je de volgende identifiers toepassen (op volgorde van prioritering): userID, email en cookie. Wanneer een bezoeker net op de website landt, dan zal je nog niet direct een userID of email hebben, dus dan zullen we de bezoeker volgen met een cookie. In de API kan je sqzly_cookie meesturen om de juiste bezoeker te volgen. In tegenstelling tot een userID of e-mailadres kan een profiel niet aangemaakt worden met enkel een cookie in de API. Vandaar dat ons script met de SessionStart op de front-end zo belangrijk zijn. Het cookie die benodigd is kan je vinden als sqzllocal in de cookies, zie ook en .
Een payload voor een ViewContent zou er ongeveer zo uit moeten zien:
{
"events": [
{
"event": "ViewContent",
"sqzly_cookie": "sqzl6548db2900000340e093",
"products": [
{
"id": "833",
"name": "Product 1"
}
],
"custom_field": "jouw custom waarde"
}
]
}Ratelimit
Via de API kan je 250 calls per minuut doen, wel kan je 250 events tegelijk sturen indien nodig. De ratelimit wordt gereset op 00 seconden van de minuut. Heb je veel events, kijk dan welke echt noodzakelijk zijn om via de server te versturen, omdat ze de meeste impact hebben of persoonlijke data. Een hybride versie van serverside tagging samen met de ‘normale’ front-end tracking is zeker mogelijk.
Maar hoe zit dat nu met serverside cookies?
De cookies die wij zetten, worden door het Spotler Activate Javascript gezet. Ondanks dat dit cookie een first-party cookie is, worden de regels steeds strenger en worden cookies die door Javascript worden gezet sneller verwijderd (door Safari zelfs al na 7 dagen). Op het moment dat het cookie vervolgens wordt gezet/ overschreven door de server volgens de browsers (vooralsnog) de einddatum die je er zelf aan geeft. Hoe je het Spotler Activate cookie overschrijft kan je hier vinden in onze handleiding:
Hoewel het ook op serverniveau wordt gedaan, is dit niet gerelateerd of noodzakelijk voor serverside tracking. Als je veel bezoekers op Safari hebt, is dit zeker aan te raden.
Omzeil ik Adblockers met Serverside tagging?
Hoewel veel via de backend wordt gestuurd en dat kan schelen, heb je nog steeds het Spotler Activate script en het Spotler Activate cookie nodig om het profiel aan te maken. Wel kan je ons script via een subdomein van jouw site inladen via de zogenaamde CNAME cloaking. Hiermee kan je niet alle maar zeker wel veel adblockers omzeilen. Wat dit precies inhoudt en hoe je het inregelt in Spotler Activate kan je hier vinden: