Snapchat Conversions API - Troubleshooting Guide

De Snapchat Conversions API Check analyseert of je events correct worden doorgestuurd naar Snapchat via de server-side Conversions API. Dit is essentieel voor:

• Accurate conversie tracking ondanks privacy beperkingen

• Betere campagne optimalisatie door Snapchat's algoritme

• Verbeterde ROAS berekening met betrouwbare data

Dit is de #1 Snapchat error!

HTTP Status: 400 Bad Request

Response:

{
  "status": "FAILED",
  "reason": "All records failed",
  "error_records": [{
    "reason": "Unrecognized event type",
    "record_indexes": [1]
  }]
}

Oorzaak: De event naam wordt niet herkend door Snapchat.

Snapchat verwacht specifieke event namen:

Oplossing:

1. Controleer event mapping in TryTagging:

   • Tags → Snapchat CAPI

   • Verifieer dat event namen correct gemapped zijn

2. Gebruik UPPERCASE:

   ❌ page_view, PageView, Page_View
   ✅ PAGE_VIEW
   

3. Custom events:

   • Snapchat ondersteunt ook custom event namen

   • Maar de standaard events hierboven werken het beste

HTTP Status: 401 Unauthorized

Oorzaak: De Access Token is verlopen of ongeldig.

Snapchat Token Details:

• Tokens kunnen verlopen (check expiry in Snapchat Ads Manager)

• Tokens zijn gekoppeld aan specifieke Pixels

Oplossing:

1. Ga naar Snapchat Ads Manager

2. Events Manager → je Pixel

3. Settings → Access Tokens

4. Genereer nieuwe token of check de huidige

5. Update in TryTagging:

   • Tags → Snapchat CAPI → Access Token

HTTP Status: 400 Bad Request

Oorzaak: De Pixel ID is incorrect of je hebt geen toegang.

Pixel ID formaat: UUID formaat, bijv. a6d8970a-4725-4cba-b424-49689d2ed742

Oplossing:

1. Ga naar Snapchat Ads Manager

2. Events Manager → selecteer je Pixel

3. Kopieer de Pixel ID (te vinden in de URL of settings)

4. Update in TryTagging:

   • Tags → Snapchat CAPI → Pixel ID

Snapchat gebruikt verschillende API versies:

Aanbeveling: Gebruik altijd v3 endpoint voor nieuwe implementaties.

De sc_click_id parameter is essentieel voor ad attributie.

• URL parameter toegevoegd door Snapchat Ads

• Koppelt click aan conversie

• Formaat: ScCid=XXXXXXXXXXXXXX

https://jouw-site.nl/product?ScCid=eyJhbGciO...

1. Behoud ScCid in URL - strip hem niet

2. Pass naar server - zorg dat backend hem ontvangt

3. Stuur mee in CAPI - als sc_click_id parameter

De Snap Cookie verbetert matching.

1. Snapchat Pixel zet _scid cookie bij eerste bezoek

2. Server-side code leest cookie uit

3. Stuur mee als sc_cookie1 in CAPI request

_scid=xxxxxxxxxxxxx

1. Ga naar Snapchat Ads Manager

2. Events → selecteer je Pixel

3. Bekijk Event History

4. Filter op tijdstip van je test

1. Container → Monitoring

2. Filter: request_url LIKE '%snapchat%'

3. Bekijk request/response details

4. Check error messages

1. Doe een test aankoop op je site

2. Check binnen 5 minuten in Events Manager

3. Controleer of alle parameters correct zijn

{
  "pixel_id": "a6d8970a-4725-4cba-b424-49689d2ed742",
  "event_type": "PURCHASE",
  "event_conversion_type": "WEB",
  "timestamp": "1702656000000",
  "hashed_email": "e3b0c44298fc1c149afbf4c8996fb924...",
  "hashed_phone_number": "5e884898da28047d1065d...",
  "user_agent": "Mozilla/5.0...",
  "hashed_ip_address": "a1b2c3d4...",
  "price": "99.95",
  "currency": "EUR",
  "transaction_id": "ORD-12345",
  "item_ids": ["SKU-001", "SKU-002"],
  "number_items": "2"
}

• [ ] Pixel ID correct (UUID formaat)

• [ ] Access Token gegenereerd

• [ ] API versie v3 gebruikt

• [ ] Event namen in UPPERCASE

• [ ] Email gehashed (SHA-256, lowercase)

• [ ] Telefoon gehashed (SHA-256, E.164)

• [ ] IP gehashed (SHA-256)

• [ ] User Agent (niet gehashed)

• [ ] sc_click_id (indien aanwezig)

• [ ] Currency bij PURCHASE

• [ ] Price correct formaat

• [ ] Transaction ID voor deduplicatie

• [ ] Item IDs als array

• [ ] Test event in Events Manager zichtbaar

• [ ] Success rate > 90%

• [ ] Geen "Unrecognized event type" errors

De belangrijkste: PAGE_VIEW, VIEW_CONTENT, ADD_CART, START_CHECKOUT, PURCHASE, SEARCH, SIGN_UP.

Let op: UPPERCASE is verplicht!

Ja. Snapchat verwacht een gehashte IP (SHA-256), anders dan Meta en TikTok.

Dit varieert. Check de expiry date in Snapchat Ads Manager → Events → Access Tokens.

Dit betekent dat alle events in de batch zijn afgewezen. Meestal door:

1. Verkeerde event naam (niet UPPERCASE)

2. Ongeldige Pixel ID

3. Verlopen Access Token