Pinterest CAPI Delivery - Troubleshooting Guide

Bewerkt

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:

  1. Open je container in TryTagging

  2. Ga naar Tags β†’ Pinterest CAPI

  3. Controleer het veld Event ID

  4. 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:

  1. Ga naar Pinterest Business Hub (business.pinterest.com)

  2. Klik op Apps in het menu

  3. Selecteer je app of maak een nieuwe

  4. Ga naar API Access

  5. Genereer een nieuwe Conversions API Access Token

  6. 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:

  1. API app heeft geen toegang tot dit Ad Account

    • De app is niet gekoppeld aan het juiste Ad Account

  2. Ad Account ID is incorrect

    • Verkeerd ID ingevoerd in de tag

  3. Account restricties

    • Ad Account is geschorst of beperkt

Oplossing:

  1. Ga naar Pinterest Ads Manager

  2. Noteer het correcte Ad Account ID (numeriek, bijv. 549761133982)

  3. Verifieer in Business Hub dat je app toegang heeft tot dit account

  4. 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:

  1. Ga naar TryTagging β†’ Tags β†’ Pinterest CAPI

  2. Controleer het veld Ad Account ID

  3. Verwijder alle niet-numerieke karakters

  4. 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 web zijn voor website events

Standaard in tag

Event Name Mapping

Pinterest gebruikt specifieke event namen:

GA4 Event

Pinterest Event

page_view

page_visit

view_item

view_category

add_to_cart

add_to_cart

begin_checkout

checkout

purchase

checkout (met value)

search

search

lead

lead

signup

signup


User Data voor Betere Matching

Pinterest gebruikt user data voor betere attributie. Stuur zoveel mogelijk mee:

Aanbevolen velden

Veld

Beschrijving

Hashing

em

Email (lowercase)

SHA-256

ph

Telefoon (E.164 format)

SHA-256

fn

Voornaam (lowercase)

SHA-256

ln

Achternaam (lowercase)

SHA-256

ct

Stad (lowercase, geen spaties)

SHA-256

st

Staat/Provincie (2-letter code)

SHA-256

zp

Postcode

SHA-256

country

Land (2-letter ISO code)

SHA-256

external_id

Klant ID

SHA-256

Click IDs (niet gehashed)

Parameter

Beschrijving

click_id

Pinterest click ID (epik)

partner_id

Partner ID indien beschikbaar


Debugging Tips

1. Check in TryTagging Monitoring

  1. Ga naar je container β†’ Monitoring

  2. Filter op platform = Pinterest

  3. Bekijk de error responses

2. Pinterest Events Manager

  1. Ga naar Pinterest Ads Manager

  2. Klik op Events β†’ Events Manager

  3. Controleer of events binnenkomen

  4. Bekijk de Event Match Quality score

3. Test Mode

Pinterest heeft geen officiΓ«le test mode, maar je kunt:

  1. Een test aankoop doen

  2. De event in TryTagging monitoring checken

  3. 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


Was dit artikel nuttig?

Onze excuses! Zou je ons meer willen vertellen?

Bedankt voor de feedback!

Er is een probleem opgetreden bij het verzenden van uw feedback
Controleer uw verbinding en probeer het opnieuw.