Wat is de Snapchat Conversions API?
Met de Conversions API van Snap stuurt een server conversie-events van je website rechtstreeks naar Snapchat via een server-to-server-integratie, naast de events die de Snap Pixel vanuit de browser van de klant stuurt. Snap raadt adverteerders met een website aan de API naast de pixel te gebruiken.
Met WeProfit komt een Shopify-aankoop bij Snapchat binnen als PURCHASE, verstuurd vanaf de servers van WeProfit naar de Snap Pixel die je koppelt. Snapchat zit in elk abonnement van WeProfit, samen met Meta, Google, TikTok, Pinterest, X Ads, Microsoft (pilot), Reddit, LinkedIn en Taboola.
Snapchat koppelen in WeProfit
Koppel eerst je Shopify-webshop. Voor verzending naar Snapchat heb je twee waarden nodig: de ID van je Snap Pixel en een Conversions API-token. Alleen een Organization Admin van je Snapchat-bedrijf kan dat token aanmaken.
- Open in Snap Ads Manager het menu linksboven, kies ‘Events Manager’ en klik op je pixel. Kopieer de pixel-ID die bovenaan staat: een lange code met streepjes.
- Open voor het token het menu in Ads Manager en kies ‘Business Details’. Ga naar ‘Conversions API Tokens’, kies ‘Generate Token’ en kopieer het token.
- Gebruik dat Conversions API-token. Het toegangstoken dat Events Manager toont onder ‘Event Source Setup’, is een ander type token en werkt niet voor deze koppeling.
- Open in WeProfit ‘Advertentienetwerken > Snapchat’ en kies ‘Bestemming toevoegen’. Vul de Snap Pixel-ID en het Conversions API-token in. Een label is optioneel en handig als je meer dan één pixel koppelt.
- Laat ‘Voorwaarden’ leeg om elk in aanmerking komend event te versturen, of voeg voorwaarden toe, zoals land, event, bestelwaarde of campagne, om te beperken wat deze pixel ontvangt. Kies daarna ‘Snapchat koppelen’.
- Kies ‘Test verzenden’. WeProfit verstuurt een testevent naar het validatie-endpoint van Snap, dat controleert of een event goed is opgebouwd, en toont of Snap het heeft geaccepteerd. De Snapchat-bestemming van WeProfit heeft geen testeventcode, dus er is geen testmodus voor live events.
Aankopen en checkout-events die naar Snapchat gaan
Vanuit een Shopify-webshop stuurt WeProfit je aankopen naar Snapchat, plus twee checkoutstappen die de webpixel van WeProfit vastlegt: de gestarte checkout en het toevoegen van betaalgegevens. Aankopen komen uit de bestelwebhook van Shopify, en de aankoop van elke bestelling gaat hoogstens één keer naar elke gekoppelde pixel.
WeProfit stuurt een event alleen naar Snapchat als het minstens één van de matchsleutels bevat waar Snap om vraagt: een gehasht e-mailadres, een gehasht telefoonnummer, of zowel een IP-adres als een user-agent. Een PURCHASE gaat alleen mee met een waarde en een valuta. Events zonder die gegevens slaat WeProfit over, en een overgeslagen event krijgt geen regel in het verzendlog.
De lijst met standaardevents van Snap heeft geen lead-event, dus WeProfit slaat leads voor Snapchat over in plaats van ze onder een andere naam te versturen. Aangepaste events en terugbetalingen worden niet naar Snapchat gestuurd, en niets trekt een aankoop in die Snapchat al heeft ontvangen.
Elke aankoop bevat het totaalbedrag van de bestelling zoals Shopify het rapporteert, in de valuta van de bestelling, de producten met hun ID’s, aantallen en prijzen, het aantal artikelen en de bestel-ID van Shopify als order_id.
| Event in de webshop | Event bij Snapchat |
|---|---|
| Checkout started | START_CHECKOUT |
| Payment information added | ADD_BILLING |
| Purchase | PURCHASE |
Klantgegevens die met elke aankoop meegaan
Om Snapchat te helpen een aankoop aan een Snapchat-gebruiker te koppelen, stuurt WeProfit gegevens uit de Shopify-bestelling mee, gehasht met SHA-256: het e-mailadres en het telefoonnummer van de koper, en de voor- en achternaam, de plaats, de staat of provincie, de postcode en het land uit het verzendadres, of anders uit het factuuradres. Het IP-adres en de user-agent gaan ongehasht mee. Als WeProfit hem heeft, stuurt het ook een externe ID mee, een SHA-256-hash van de bezoekers-ID van WeProfit.
Als WeProfit ze heeft, bevat de aankoop ook de klik-ID en de cookie van Snapchat: de waarde ScCid die Snapchat aan de URL van je landingspagina toevoegt als iemand op je advertentie klikt, verstuurd als sc_click_id, en de cookie _scid van de Snap Pixel, verstuurd als sc_cookie1. WeProfit laadt de Snap Pixel niet, dus de cookie _scid bestaat alleen als je webshop die pixel draait.
Snap Pixel en Conversions API: voorkom dat je dubbel telt
Snap koppelt een event van de Snap Pixel aan een Conversions API-event voor dezelfde pixel-ID als de client_dedup_id van de pixel gelijk is aan de event_id van de server en de eventnamen overeenkomen, binnen 48 uur. Bij PURCHASE-events kan Snap ook de transaction_id van de pixel koppelen aan de order_id van het server-event, tot 30 dagen lang.
WeProfit laadt de Snap Pixel niet. Het stuurt de events voor Snapchat alleen vanaf zijn server, elk met een eigen event-ID. Een aankoop wordt verstuurd als pur_ gevolgd door een webshopcode en de bestel-ID van Shopify, zoals pur_a1b2c3d4-6012345678901, één keer per bestelling en pixel, en een nieuwe poging gebruikt die ID opnieuw. De order_id is de numerieke ID van de Shopify-bestelling, zoals 6012345678901, niet het bestelnummer dat je klanten zien.
Rapporteert een Snap Pixel ook aankopen voor dezelfde pixel-ID, bijvoorbeeld via een app of je themacode, dan zijn de event-ID’s daarvan niet gelijk aan die van WeProfit. Snap valt dan terug op de bestel-ID: het kan de twee kopieën alleen koppelen als de pixel dezelfde bestel-ID van Shopify als transaction_id rapporteert. Controleer hoe je pixel aankopen rapporteert, houd per Snap Pixel één verzender van aankopen, tenzij je hebt bevestigd dat de ID’s overeenkomen, en vergelijk een testaankoop in Snapchat Ads Manager met het verzendlog van WeProfit.
Controleer de verzending in het CAPI-verzendlog
Open in WeProfit ‘Advertentienetwerken > Snapchat’ en scrol naar het CAPI-verzendlog. Daarin staat elk server-side event dat naar Snapchat is gestuurd, met de kolommen ‘Aangemaakt’, ‘Event’, ‘Bestemming’, ‘Event-ID’, ‘Status’, ‘Pogingen’ en ‘Fout’, en je kunt filteren op bestemming, event en status. Het filter voor Purchase vindt ook PURCHASE-events.
Het log toont de eigen event-ID van WeProfit, zoals pur_6012345678901; Snapchat ontvangt die met de webshopcode, zoals pur_a1b2c3d4-6012345678901. Het log heeft geen kolom voor de waarde, dus controleer de waarde van een aankoop op de pagina ‘Events’ in WeProfit. De pagina ‘Bestellingen’ toont in de kolom ‘Netwerken’ de verzending van elke bestelling per gekoppeld netwerk.
De status ‘verzonden’ betekent dat Snapchat het event heeft geaccepteerd, niet dat Snapchat de bestelling aan een advertentie heeft toegeschreven. Weigert Snapchat het token, dan pauzeert WeProfit de koppeling en toont het een banner; een nieuw token of een geslaagde ‘Test verzenden’ zet de koppeling weer aan.
| Status | Wat het betekent |
|---|---|
| openstaand | In de wachtrij en nog niet verzonden. |
| verzonden | Snapchat heeft het event geaccepteerd. |
| mislukt | Een tijdelijk probleem. WeProfit doet een paar uur lang automatisch nieuwe pogingen, met dezelfde event-ID. |
| definitief mislukt | WeProfit is gestopt: Snapchat heeft het event geweigerd, met de melding in de kolom ‘Fout’, of de pogingen zijn op. |
| overgeslagen (uitgeschakeld) | De bestemming was uitgeschakeld of gepauzeerd toen het event aan de beurt was. Events die worden overgeslagen terwijl de bestemming uitstaat, worden later niet alsnog verstuurd. |
| overgeslagen (vóór installatie) | De aankoop van een bestelling die is geplaatst voordat WeProfit werd geïnstalleerd. Die wordt nooit verstuurd. |
Advertentie-uitgaven van Snapchat: handmatig, niet gesynchroniseerd
WeProfit heeft geen koppeling met Snapchat-advertentieaccounts, dus de uitgaven van Snapchat worden niet automatisch gesynchroniseerd. Je voegt ze op een van drie manieren toe: als handmatige invoer onder ‘Winst > Advertentie-uitgaven > Handmatige invoer’, met de datum, het bedrag, het netwerk, een optionele campagne-ID en een optionele notitie; als dagschema, dat elke dag hetzelfde bedrag boekt tot je het wijzigt; of via de developer-API.
Voeg de campagne-ID aan een invoer toe als je de winst per Snapchat-campagne wilt zien: ‘Attributie’ koppelt uitgaven op campagne-ID of campagnenaam aan toegeschreven bestellingen, en uitgaven zonder campagne tellen op kanaalniveau. Snapchat-campagnes tonen bij ‘Attributie’ meestal hun ID’s, omdat er geen koppeling met een Snapchat-advertentieaccount is om namen op te zoeken. Een handmatige invoer voor een dag gaat voor op een dagschema.
Campagnedetails uit je Snapchat-advertenties
WeProfit rekent een bezoek tot Snapchat Ads als het de klik-ID ScCid van Snapchat bevat, of utm_source=snapchat met een betaald medium. Met de Auto-UTMs van Snap leest WeProfit ook de campagne-ID en, waar aanwezig, de advertentie-ID. Voor de advertentieset voeg je de Snapchat-URL-template van WeProfit toe aan elke advertentie, na het vraagteken in de website-URL van de creative.
De macro’s zijn hoofdlettergevoelig: schrijf {{adSet.id}}, niet {{adset.id}}. Templates gelden alleen voor nieuwe klikken. In de eigen attributie van WeProfit telt een advertentieklik 30 dagen mee en wint de meest recente klik, wat werkt als laatste klik met een terugkijkperiode van 30 dagen voor advertentieklikken. Snapchat schrijft conversies toe volgens zijn eigen attributie-instellingen, dus de cijfers van Snapchat en die van WeProfit kunnen voor dezelfde bestellingen verschillen.
utm_source=snapchat&utm_medium=paid_social&utm_campaign={{campaign.name}}&utm_term={{adSet.name}}&utm_content={{creative.name}}&wpcid={{campaign.id}}&wpasid={{adSet.id}}&wpadid={{ad.id}}