Meta Conversions API - Troubleshooting Guide

De Meta Conversions API Check analyseert of je events correct worden doorgestuurd naar Meta (Facebook/Instagram) via de server-side Conversions API. Dit is essentieel voor:

• Accurate conversie tracking ondanks iOS privacy beperkingen

• Betere Event Match Quality score

• Verbeterde campagne optimalisatie door Meta's algoritme

Dit is de #1 Meta CAPI error! (~30% van alle errors)

HTTP Status: 400 Bad Request

Error Code: Geen specifieke code, maar herkenbaar aan de melding

Oorzaken:

1. Pixel ID is incorrect

   • Typfout in het Pixel ID

   • Verkeerde Pixel gebruikt (test vs productie)

2. Geen permissions voor dit Pixel

   • De System User of App heeft geen toegang

   • Business Manager koppeling ontbreekt

3. Access Token hoort bij andere Business Manager

   • Token gegenereerd in verkeerde account

Oplossing:

1. Verifieer Pixel ID:

   • Ga naar Meta Events Manager

   • Klik op Data Sources → Pixels

   • Kopieer het exacte Pixel ID (15-16 cijfers)

   • Update in TryTagging: Tags → Meta CAPI → Pixel ID

2. Check permissions:

   • Meta Business Suite → Business Settings

   • Data Sources → Pixels

   • Controleer dat je System User toegang heeft

3. Regenereer Access Token:

   • Gebruik dezelfde Business Manager als waar het Pixel in zit

   • Genereer een System User Access Token

HTTP Status: 400 Bad Request

Error Subcode: 2804007

Oorzaak: Het IP-adres formaat wordt niet geaccepteerd.

Veelvoorkomende fouten:

❌ IP gehashed: "a1b2c3d4e5..."
❌ IP geanonimiseerd: "192.168.xxx.xxx"
❌ IP leeg: ""
❌ Ongeldig formaat: "192.168.1"

Correct formaat:

✅ IPv4: "192.168.1.100"
✅ IPv6: "2001:0db8:85a3:0000:0000:8a2e:0370:7334"

Oplossing in TryTagging:

1. Tags → Meta CAPI → User Data

2. Controleer het veld Client IP Address

3. Zorg dat het originele, niet-gehashte IP wordt gebruikt

4. Als je privacy-compliant wilt zijn, stuur het IP NIET mee (beter dan incorrect)

HTTP Status: 400 Bad Request

Error Subcode: 2804010, 2804023

Oorzaak: Ecommerce events (Purchase, AddToCart) met een value maar zonder currency.

Fout voorbeeld:

{
  "event_name": "Purchase",
  "custom_data": {
    "value": 99.95
    // ❌ currency ontbreekt!
  }
}

Correct voorbeeld:

{
  "event_name": "Purchase",
  "custom_data": {
    "value": 99.95,
    "currency": "EUR"  // ✅
  }
}

Oplossing in TryTagging:

1. Tags → Meta CAPI → Ecommerce Data

2. Controleer dat Currency is ingesteld

3. Hardcode EUR of gebruik een variable: {{currency}}

Ondersteunde currencies: EUR, USD, GBP, etc. (ISO 4217 codes)

HTTP Status: 400 of 401

Oorzaak: Access Token is verlopen, ongeldig, of heeft verkeerde permissions.

Types tokens:

Oplossing - System User Token genereren:

1. Ga naar Meta Business Suite → Business Settings

2. Klik op Users → System Users

3. Maak een nieuwe System User aan (of selecteer bestaande)

4. Klik op Generate New Token

5. Selecteer de App die je gebruikt

6. Selecteer permissions:

   • ads_management (voor conversie tracking)

   • business_management (voor pixel access)

7. Stel token expiry in op Never

8. Kopieer de token naar TryTagging

⚠️ Belangrijk: Bewaar de token veilig! Je kunt deze niet opnieuw bekijken.

HTTP Status: 400 Bad Request

Oorzaak: De event payload bevat ongeldige of onverwachte parameters.

Veelvoorkomende issues:

1. Verkeerde data types

   // ❌ Fout: value als string
   "value": "99.95"
   
   // ✅ Correct: value als number
   "value": 99.95
   

2. Ongeldige event namen

   // ❌ Fout: custom event naam met spaties
   "event_name": "Add To Cart"
   
   // ✅ Correct: Meta standaard event
   "event_name": "AddToCart"
   

3. Ontbrekende verplichte velden

   • event_name is verplicht

   • event_time is verplicht (Unix timestamp)

   • action_source is verplicht (website, app, etc.)

Oorzaak: De event_time timestamp ligt in de toekomst.

Mogelijke redenen:

• Server tijd niet gesynchroniseerd

• Tijdzone issues

• Client-side timestamp gebruikt i.p.v. server-side

Oplossing:

1. Gebruik altijd server-side timestamps

2. Controleer NTP synchronisatie op je server

3. Gebruik UTC timestamps

Meta verwacht specifieke event namen. Mapping:

Meta's Event Match Quality (EMQ) score verbetert met meer user data:

1. Ga naar Meta Events Manager

2. Selecteer je Pixel

3. Bekijk de Event Match Quality score per event

1. Stuur altijd mee:

   • Email (gehashed)

   • fbp cookie

   • fbc cookie (indien aanwezig)

   • IP adres

   • User Agent

2. Bij aankopen ook:

   • Telefoon (gehashed)

   • Naam (gehashed)

   • Adres data (gehashed)

3. Technisch:

   • Gebruik correcte hashing (SHA-256)

   • Lowercase voor email, naam, stad

   • E.164 formaat voor telefoon (+31612345678)

1. Ga naar Events Manager → je Pixel

2. Klik op Test Events tab

3. Voer een test conversie uit op je site

4. Bekijk of events correct binnenkomen

1. Container → Monitoring

2. Filter: platform = Facebook

3. Bekijk request/response details

4. Check error messages in raw_response

Test je API calls direct:

1. Ga naar Graph API Explorer

2. Selecteer je App

3. Test een event POST naar /{pixel_id}/events

Meta deprecates oude API versies regelmatig.

• [ ] Pixel ID correct (15-16 cijfers)

• [ ] System User Access Token (verloopt niet)

• [ ] API versie v20.0 of hoger

• [ ] action_source = "website"

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

• [ ] fbp cookie wordt meegestuurd

• [ ] fbc cookie (indien aanwezig)

• [ ] IP adres (niet gehashed!)

• [ ] User Agent

• [ ] Currency bij Purchase/AddToCart

• [ ] Value als number (niet string)

• [ ] Content IDs correct formaat