Pinterest CAPI Delivery - Troubleshooting Guide
Wat checkt deze validatie?
De Pinterest CAPI Delivery Check analyseert of je events correct worden doorgestuurd naar Pinterest via de Conversions API. Dit is essentieel voor:
Accurate conversie tracking in Pinterest Ads
Betere campagne optimalisatie door Pinterest's algoritme
Hogere match rates door server-side data
Severity Levels
Status | Criteria | Impact |
|---|---|---|
π΄ CRITICAL | <70% success rate OF token verlopen | Conversies komen niet aan |
π΄ CRITICAL | >10% missing event_id errors | Events worden afgewezen |
β οΈ WARNING | 70-90% success rate | Gedeeltelijk dataverlies |
β οΈ WARNING | Permission errors (403) | Geen toegang tot Ad Account |
β SUCCESS | >90% success rate | Tracking werkt correct |
Veelvoorkomende Problemen
π΄ Error: "'event_id' is a required property"
Dit is de #1 Pinterest error! (>60% van alle Pinterest errors)
HTTP Status: 400 Bad Request
Oorzaak: Pinterest vereist een uniek event_id voor elke request. Dit wordt gebruikt voor deduplicatie tussen browser en server events.
Oplossing in TryTagging:
Open je container in TryTagging
Ga naar Tags β Pinterest CAPI
Controleer het veld Event ID
Zorg dat dit een unieke waarde genereert, bijvoorbeeld:
{{Event ID}}of
{{Timestamp}}_{{Random Number}}
Technische vereisten:
Event ID moet uniek zijn per event
Maximaal 100 karakters
Alleen alfanumerieke karakters en underscores
π΄ Error: "Authentication failed" (401)
HTTP Status: 401 Unauthorized
Oorzaak: Pinterest Access Token is:
Verlopen
Incorrect gekopieerd
Ingetrokken
β οΈ Belangrijk: Pinterest tokens kunnen verlopen! Anders dan Meta System User tokens.
Oplossing:
Ga naar Pinterest Business Hub (business.pinterest.com)
Klik op Apps in het menu
Selecteer je app of maak een nieuwe
Ga naar API Access
Genereer een nieuwe Conversions API Access Token
Kopieer de token naar TryTagging:
Container β Tags β Pinterest CAPI β Access Token
Pro tip: Stel een kalender reminder in om de token periodiek te vernieuwen (bijv. elke 3 maanden).
π΄ Error: "You are not permitted to access that resource" (403)
HTTP Status: 403 Forbidden
Oorzaken:
API app heeft geen toegang tot dit Ad Account
De app is niet gekoppeld aan het juiste Ad Account
Ad Account ID is incorrect
Verkeerd ID ingevoerd in de tag
Account restricties
Ad Account is geschorst of beperkt
Oplossing:
Ga naar Pinterest Ads Manager
Noteer het correcte Ad Account ID (numeriek, bijv.
549761133982)Verifieer in Business Hub dat je app toegang heeft tot dit account
Update het Ad Account ID in TryTagging
π΄ Error: "Advertiser ID must be numeric"
HTTP Status: 400 Bad Request
Oorzaak: Het Ad Account ID bevat niet-numerieke karakters.
Fout voorbeeld:
pinterest_549761133982
PIN-549761133982
Correct voorbeeld:
549761133982
Oplossing:
Ga naar TryTagging β Tags β Pinterest CAPI
Controleer het veld Ad Account ID
Verwijder alle niet-numerieke karakters
Gebruik alleen het cijfer-deel
Pinterest CAPI Configuratie Checklist
Vereiste Parameters
Parameter | Beschrijving | Waar te vinden |
|---|---|---|
Ad Account ID | Numeriek account ID | Ads Manager β Account settings |
Access Token | API conversions token | Business Hub β Apps β API access |
Event ID | Verplicht uniek ID per event | Automatisch genereren in tag |
Event Name | Pinterest event naam | Zie mapping hieronder |
Action Source | Moet | Standaard in tag |
Event Name Mapping
Pinterest gebruikt specifieke event namen:
GA4 Event | Pinterest Event |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
User Data voor Betere Matching
Pinterest gebruikt user data voor betere attributie. Stuur zoveel mogelijk mee:
Aanbevolen velden
Veld | Beschrijving | Hashing |
|---|---|---|
| Email (lowercase) | SHA-256 |
| Telefoon (E.164 format) | SHA-256 |
| Voornaam (lowercase) | SHA-256 |
| Achternaam (lowercase) | SHA-256 |
| Stad (lowercase, geen spaties) | SHA-256 |
| Staat/Provincie (2-letter code) | SHA-256 |
| Postcode | SHA-256 |
| Land (2-letter ISO code) | SHA-256 |
| Klant ID | SHA-256 |
Click IDs (niet gehashed)
Parameter | Beschrijving |
|---|---|
| Pinterest click ID (epik) |
| Partner ID indien beschikbaar |
Debugging Tips
1. Check in TryTagging Monitoring
Ga naar je container β Monitoring
Filter op platform = Pinterest
Bekijk de error responses
2. Pinterest Events Manager
Ga naar Pinterest Ads Manager
Klik op Events β Events Manager
Controleer of events binnenkomen
Bekijk de Event Match Quality score
3. Test Mode
Pinterest heeft geen officiΓ«le test mode, maar je kunt:
Een test aankoop doen
De event in TryTagging monitoring checken
Na 30-60 minuten in Pinterest Events Manager controleren
Error Code Reference
Code | HTTP | Betekenis | Actie |
|---|---|---|---|
1 | 400 | Invalid request | Check payload, vaak event_id |
2 | 401 | Auth failed | Nieuwe token genereren |
29 | 403 | Permission denied | Check Ad Account access |
12 | 500 | Server error | Pinterest issue, retry |
