Dokumentation

Conversions API

Nutze die Conversions API, wenn Browser-Events nicht reichen, und teile Event-IDs, damit dieselbe Conversion nicht zweimal zählt.

Zuletzt aktualisiert: 2026-09-08. Geschrieben von PixelBridge team.

Die OpenAI Ads Conversions API ist ein serverseitiger Weg, unterstützte Conversion-Events an die Werbemessung von OpenAI zu senden. PixelBridge ist dafür gebaut, diese Events aus WordPress zu senden und sie mit Browser-Events abzustimmen.

Warum es serverseitige Messung gibt

Browser-Pixel können durch Consent-Entscheidungen, Browser, Extensions oder Content-Security-Policy-Regeln blockiert werden. Ein Server-Event kann eine unterstützte Conversion trotzdem erfassen, nachdem WordPress die Aktion bestätigt hat.

Serverseitige Messung ist kein Weg, Einwilligung zu umgehen. Wenn Einwilligung zur Messung nötig ist, folgt das Server-Event derselben Erlaubnis.

Pixel vs. Conversions API

SchichtStärkeGrenze
Browser PixelSchnelle Page Views und Client-KontextKann im Browser blockiert werden
Conversions APILäuft, nachdem WordPress die Aktion bestätigtBraucht Credentials, Event-IDs und Fehlerbehandlung

Beides zu nutzen kann robuster sein. Es ist nicht für jede Website Pflicht.

Event-IDs

Wenn dieselbe Conversion zweimal gesendet wird, sollten beide Payloads eine Event-ID teilen. PixelBridge ist dafür gebaut, diese ID zu erzeugen oder wiederzuverwenden, damit OpenAI Ads-Messung das Paar deduplizieren kann.

Umsetzung in WordPress

Typische Server-Events kommen von:

  1. Einem bestätigten Formular-Success-Hook.
  2. Einem Buchungsbestätigungs-Hook.
  3. Einem WooCommerce-Bestellstatus, der bedeutet, dass der Kauf echt ist.

Die Conversions API-Verbindung im Plugin gehört zum geplanten Pro-Feature-Set und ist noch nicht öffentlich verfügbar.

Debugging

Prüfe in der Diagnostik den Verbindungsstatus und dann die letzten Events. Wenn ein Browser-Event klappt und das Server-Event fehlschlägt, lass den Fehler sichtbar, statt blind zu retrien. Siehe Fehlerbehebung und den Conversions API-Guide.