Snapchat Conversions API via je servercontainer

De Conversions API van Snapchat neemt dezelfde events aan als de Snap-pixel, rechtstreeks van je server. Met allebei actief en ontdubbeld blijft Snapchat meten als de pixel geblokkeerd wordt, en matcht het op gehasht e-mailadres, telefoonnummer, IP-adres en de cookie _scid . Dit is de setup vanuit Measurebase.

Wat je nodig hebt

• Pixel-ID: Snapchat Ads Manager → Events Manager → je pixel.
• Conversions API-token: Business Manager → Business details → Conversions API tokens → Generate token.
• Je Measurebase-domein met het Enhanced script geïnstalleerd en GA4-events die binnenkomen.

Stap 1 · Voeg het toe aan je meetopzet

Open het domein in je dashboard, ga naar de pagina Settings en zoek Measurement setup. Vink de kaart van de bestemming aan en vul de ID's hieronder in. Tokens en API-sleutels worden versleuteld opgeslagen, buiten de setup zelf. De setup verstuurt zelf niets: het is de referentie waar de tracking audit en de templatebouwer van uitgaan, dus wat je hier invult is wat de audit in je containers verwacht te vinden.

Stap 2 · Genereer en importeer de containers

Ga naar Resources → GTM templates in het dashboard. Vink onder Destinations het platform aan (Google Analytics 4 en de e-commerce-events staan standaard aan; kies de Shopify-, WordPress- of Shopware-datalayer als je site een van onze plugins draait). Vul in de volgende stap dezelfde ID's in, kies Web + server onder Containers en download de twee JSON-bestanden.

Open in Google Tag Manager elke container, ga naar Admin → Import Container, kies het bijbehorende bestand, kies een nieuwe workspace en Merge. De import voegt alleen toe: nieuwe tags, triggers en variabelen met eigen namen, plus de galerijtemplates die ze nodig hebben. Controleer het resultaat in Preview en publiceer dan.

Stap 3 · Wat de import bevat

Webcontainer: de template Snap Pixel uit de galerij met Snap - _Config bij initialisatie en de events View Content, Add Cart en Purchase, een constante met je pixel-ID en de variabele Unique Event ID.

Servercontainer: de template Snapchat Conversion API uit de galerij met PAGE_VIEW, VIEW_CONTENT, ADD_CART, START_CHECKOUT en PURCHASE als servertags op de GA4-events, met waarde, valuta, gehasht e-mailadres en telefoonnummer, IP-adres en user agent.

Stap 4 · Eén event-ID voor browser en server

Een platform dat hetzelfde event van een browserpixel én van een servertag ontvangt, telt het dubbel, tenzij beide hetzelfde event-ID dragen. De import regelt dat: de variabele Unique Event ID maakt één ID per event in de webcontainer, de GA4-eventinstellingen sturen het naar je servercontainer als event_id, en zowel de pixeltag als de servertag sturen diezelfde waarde mee in hun ontdubbelingsveld. Het platform houdt één kopie en gooit de andere weg.

Met de Shopify-app, de WordPress-plugin of de Shopware-plugin draagt een aankoop die ook server-side wordt doorgestuurd het ordernummer mee als mb_event_id, zodat ook de twee aankoopkopieën aan elkaar gekoppeld kunnen worden.

Aan de Snap-kant heet het veld client_dedup_id; Snapchat houdt één kopie van events die hem delen.

Stap 5 · Toestemming

De geïmporteerde tags dragen de toestemmingsinstellingen van de referentiecontainers waaruit ze gekopieerd zijn. Controleer ze tegen je eigen toestemmingsopzet voordat je publiceert: een browserpixel hoort ad_storage te vereisen onder Aanvullende toestemmingscontroles of af te gaan op het event van je toestemmingstool, en de servertags horen alleen te sturen als de hit advertentietoestemming draagt. De toestemmingscontroles van de audit en de gids over tags die afgaan vóór toestemming laten zien hoe je allebei controleert.

Stap 6 · Testen

Events Manager toont per pixel de browser- en serverevents met hun ontdubbelingsstatus; de servertag heeft een testmodus zolang je controleert.

Open aan de Measurebase-kant de pagina Requestlogs: als je door je site klikt, zie je GA4-events met een groene 200 bij je servercontainer binnenkomen. Open de previewmodus van de servercontainer om de servertag op die events te zien afgaan, met het event-ID en de gebruikersgegevens die hij oppikte.

Cookies en click-ID's

Cookie Keeper houdt de first-party cookies van Snapchat in leven voorbij de 7-dagenlimiet van Safari. De click-ID van Snapchat (ScCid) zit nog niet in Click ID Restorer; de Conversions API matcht in plaats daarvan op de cookie en de gehashte klantgegevens.

Wat de tracking audit controleert

Elke nacht vergelijkt de tracking-audit je meetopzet met je live containers en je site. Voor elke bestemming controleert hij dat de tags bestaan in de container die je opzet verwacht, dat het ID in de container overeenkomt met dat in je opzet, dat een browserpixel en zijn servertag een event-ID delen, en welke cookies van het platform nog gezet worden nadat een bezoeker weigert. Bevindingen openen een melding de eerste keer dat ze verschijnen; wat de audit kan herstellen, stelt hij voor als wijziging in een aparte Measurebase-workspace in je container.

Veelgestelde vragen

Waarom zit er geen begin-checkout-tag in de webimport?

De referentiecontainer stuurt hem alleen vanaf de server; de browserkant dekt contentweergaven, add to cart en purchase. Wil je beide kopieën, voeg dan een webtag toe door de add-to-cart-tag te kopiëren.