Pinterest, Tag und Conversions API

Server-Side-Conversion-Tracking via Pinterest Conversions API. Pinterest-Tag-ID kombiniert mit Conversion-Access-Token. Optional Hybrid-Modus mit Browser-Tag für First-Party-Cookies, dedupliziert über event_id.

Voraussetzungen

• Pinterest-Business-Account mit Admin-Zugriff auf den Ad-Account.
• Existierender Pinterest-Tag oder Berechtigung, einen anzulegen.
• Etwa 5 Minuten.

1. Pinterest-Tag-ID finden oder anlegen

• Pinterest Ads Manager öffnen (ads.pinterest.com).
• Ads → Conversions → Conversion-Quellen.
• Pinterest-Tag für diese Domain auswählen oder via Conversion-Quelle hinzufügen → Pinterest-Tag neu anlegen.
• Tag-ID (13-stellige Zahl, manchmal "TID" genannt) steht auf der Tag-Detail-Seite. Kopieren.

2. Conversion-Access-Token generieren

• Auf derselben Tag-Detail-Seite zu Conversion-Token generieren scrollen (oder API-Zugriff, das Wording wechselt zwischen Pinterest-UI-Versionen).
• Klick Token generieren. Der Token wird nur EINMAL angezeigt, sofort kopieren. Es gibt keinen Weg, ihn später abzurufen, du müsstest revoken und neu generieren.
• Der Token ist an den Tag gebunden, hat den Scope ads:write und läuft nicht ab.

3. Credentials in Beaconry eintragen

WordPress-Admin → Beaconry → Tracking → Pinterest. Tag-ID und Conversion-Access-Token einfügen, speichern.

Der Token wird mit AES-256-GCM verschlüsselt gespeichert (gekoppelt an deine WordPress-Auth-Salts). Konstanten-Variante: BCNR_PINTEREST_TAG_ID und BCNR_PINTEREST_ACCESS_TOKEN in wp-config.php.

4. (Optional) Test-Event-Code setzen

Pinterests CAPI akzeptiert ein optionales test_event_code-Feld pro Event. In Ads Manager → Conversions → Events-History → Test-Events generieren und in Beaconry einfügen. Solange gesetzt, landen alle Events im Test-Events-Tab statt live zu gehen. Code vor dem Kampagnen-Start entfernen.

5. Test-Event versenden

Klick Pinterest-Test-Event senden auf dem Tracking-Tab. Beaconry feuert ein synchrones page_visit via CAPI und meldet die Antwort inline.

HTTP 200 mit num_events_received: 1 heißt: Credentials passen. Mit Test-Event-Code landet das Event innerhalb von Sekunden in Conversions → Events-History → Test-Events. Ohne Code aggregiert Pinterest mit bis zu 30 Minuten Latenz, bevor das Event im Reporting auftaucht.

Hybrid-Modus, Pinterest-Tag

Server-Side-CAPI allein deckt 100 Prozent der zustimmenden Besucher. Hybrid-Modus lädt den Browser-Pinterest-Tag (s.pinimg.com/ct/core.js) parallel, damit Pinterest das First-Party-_pinterest_ct-Cookie sieht. Beaconry sendet dieselbe Per-Event-event_id von beiden Seiten, Pinterest dedupliziert gegen Doppel-Counting.

Aktivieren in Beaconry → Tracking → Pinterest → Hybrid-Modus. Bessere Match-Rate, etwas mehr Bytes für den Besucher. Standardmäßig aus.

Was automatisch versendet wird

Beaconry mappt GA4-kanonische Event-Namen auf Pinterests Standard-Event-Vokabular:

Alle Payloads tragen gehashte PII (em, ph, ge, ln, fn, ct, st, zp, country) plus First-Party-Identifier (Pinterests _pinterest_ct, sobald verfügbar, IP und User-Agent).

Troubleshooting

• "Invalid access token": Token revoked oder unter einem anderen Tag generiert. Auf der Tag-Detail-Seite neu generieren und in Beaconry austauschen.
• "num_events_received: 0": Tag-ID und Token gehören zu unterschiedlichen Tags. Pinterest bindet Tokens pro Tag, ein vermischtes Paar liefert ein stilles HTTP 200 mit null gebuchten Events.
• Events kommen an, aber ROAS-Spalten bleiben leer: Pinterest braucht die Catalog-Product-Group-ID in content_ids für Dynamic Product Ads. Beaconry setzt WooCommerce-Produkt-IDs als Standard. Wenn dein Katalog andere IDs nutzt (Merchant-Center-IDs, SKUs), Override in Forms & Commerce → Product-ID-Quelle eintragen.
• Counter springt nach Aktivieren des Hybrid-Modus: Dedup-Mismatch. Im Beaconry-Log (Server) und im Pinterest-Tag-Debugger (Browser) prüfen, dass dieselbe event_id für dieselbe Visitor-Session geloggt ist.