OpenAI Ads Conversions API: WordPress Setup-Guide

Richte die OpenAI Ads Conversions API in WordPress ein: serverseitige Events, Pixel-Vergleich, Event-IDs, Deduplizierung, WooCommerce, Formulare und Debugging.

Zuletzt aktualisiert: 8. September 2026. Geschrieben von PixelBridge team.

In WordPress heißt das meist: ein Event senden, nachdem ein Formular, eine Buchung oder eine Bestellung bestätigt ist, statt nur auf ein Script im Browser zu setzen. PixelBridge ist dafür gebaut, diese Events zu senden und sie mit dem Browser-Pixel abzustimmen. Die Conversions API-Verbindung gehört zum geplanten Pro-Feature-Set und ist noch nicht öffentlich verfügbar.

Was die Conversions API ist

Die Conversions API ist ein Server-to-Server-Pfad. WordPress oder ein anderes Backend sendet ein unterstütztes Conversion-Event, nachdem es bereits weiß, dass die Aktion erfolgreich war. Der Browser muss nicht der einzige Bote sein.

Es ist kein zweites Werbekonto und kein Ersatz für Kampagnen-Setup. Es ist eine Delivery-Methode für Mess-Events. Offizielle Request-Felder, Authentifizierung und unterstützte Eventtypen gehören in die Developer-Dokumentation von OpenAI. Bestätige diese Details, bevor du einen eigenen Client baust.

PixelBridge ist unabhängig von OpenAI. Die Conversions API über das Plugin zu nutzen, erzeugt keine offizielle Partnerschaft.

Warum serverseitige Messung zählt

Browser-Pixel scheitern unter normalen Bedingungen:

• Der Besucher lehnt Measurement-Cookies ab
• Ein Browser oder eine Extension blockiert das Script
• Content Security Policy blockiert die SDK-Domain
• Der Kunde schließt die Thank-you-Seite, bevor der Pixel läuft
• Ein Page Builder oder Cache-Plugin ordnet Scripts um

Ein Server-Event kann die Conversion trotzdem erfassen, nachdem WordPress Formular, Buchung oder Bestellung gespeichert hat. Diese Robustheit ist der Grund, die Conversions API hinzuzufügen. Es ist kein Grund, den Pixel zu ignorieren. Page Views und Landingpage-Kontext kommen weiterhin aus dem Browser.

Serverseitige Zustellung umgeht Einwilligung nicht. Wenn Mess-Erlaubnis nötig ist, halte das Server-Event hinter derselben Erlaubnis. Siehe Einwilligung.

Pixel vs. Conversions API

Du kannst mit dem Pixel allein starten. Ergänze die Conversions API, wenn Browser-Zustellung nicht reicht, oder wenn Käufe und Buchungen ein bestätigtes Backend-Signal brauchen. Beides zu nutzen ist eine Robustheitsentscheidung, keine Ranking-Taktik.

Der Pixel-Installationsguide ist OpenAI Ads Pixel für WordPress. Produktdocs: Conversions API.

Deduplizierung

Wenn dieselbe Conversion aus dem Browser und vom Server gesendet wird, braucht Messung einen Weg, sie als eine Aktion zu behandeln. Dieser Mechanismus ist Deduplizierung.

Ohne sie kann ein erfolgreicher Checkout zu zwei Käufen werden. Mit ihr tragen beide Payloads dieselbe Event-ID, und das Werbemessungssystem kann das Paar zusammenführen.

Deduplizierung ist nur relevant, wenn beide Schichten dieselbe Conversion senden. Ein server-only Lead hat nichts zu mergen. Ein browser-only Page View sollte kein Server-Twin erfinden.

Event-IDs

Eine Event-ID ist der gemeinsame Schlüssel für eine einzelne Kundenaktion.

Das vorgesehene WordPress-Muster:

1. Am Success-Hook eine Event-ID erzeugen oder wiederverwenden.
2. Das Browser-Event mit dieser ID senden, wenn der Pixel laufen darf.
3. Das Server-Event mit derselben ID senden, wenn die Conversions API aktiv ist und Consent es erlaubt.
4. Genug von der ID in Logs oder Diagnostik speichern, um ein Mismatch später zu debuggen.

Wenn das Browser-Event eine ID nutzt und das Server-Event eine andere, bekommst du Duplikate. Wenn du einen fehlgeschlagenen Server-Call mit einer neuen ID retryest, während das Original-Browser-Event schon erfolgreich war, kannst du ebenfalls Duplikate bekommen. Halte die ID für diese Conversion stabil.

PixelBridge ist dafür gebaut, diese ID zu erzeugen oder wiederzuverwenden, damit das Paar dedupliziert werden kann.

WordPress-Umsetzung

Ein WordPress Conversions API-Setup ist ein Backend-Job:

1. Speichere API-Credentials in Plugin-Einstellungen oder Environment-Konfiguration, nicht in einer öffentlichen JavaScript-Datei.
2. Höre auf bestätigte WordPress-Hooks, nicht auf Button-Klicks.
3. Baue ein Payload, das zur aktuellen offiziellen Event-Spec passt.
4. Nimm die Event-ID auf, die das Browser-Event genutzt hat.
5. Respektiere Einwilligung, bevor die Anfrage den Server verlässt.
6. Erfasse Erfolg und Fehler, statt blind zu retrien.

Typische Quellen:

• Ein bestätigter Formular-Success-Hook
• Ein Buchungsbestätigungs-Hook
• Ein WooCommerce-Bestellstatus, der bedeutet, dass der Kauf echt ist

Sende keine Server-Events aus wp_footer auf jeder Seite. Das reproduziert die schlechtesten Teile eines Pixels ohne den Page-View-Wert.

Die WordPress-Dokumentation behandelt Hooks und Plugin-Architektur. Sie definiert keine OpenAI-Eventfelder.

WooCommerce

WooCommerce ist eine natürliche Conversions API-Quelle, weil die Bestellung auf dem Server existiert, auch wenn der Kunde den Thank-you-Pixel nie sieht.

Wenn Kauftracking erscheint, sollte das Event:

• Auf dem Bestellstatus feuern, den du als Conversion behandelst
• Eine Bestell-ID enthalten
• Einen Conversion-Wert enthalten, wo erlaubt
• Eine Event-ID mit jedem Browser-purchase-Event teilen

Die WooCommerce-Integration kommt noch. Sie ist nicht veröffentlicht. Erwarte nicht, dass Bestellungen OpenAI Ads-Events senden, bis dieser Connector existiert oder du selbst einen Custom-Hook baust.

Formularabsendungen

Formulare sind die andere häufige serverseitige Quelle. Ein PHP-Success-Hook kann lead_created senden, nachdem die Nachricht gespeichert ist, was zuverlässiger ist als ein JavaScript-Listener auf dem Submit-Button.

Geplante Formular-Connectoren (Elementor Forms, Contact Form 7, WPForms, Gravity Forms, Fluent Forms) kommen noch. Bis dahin sollte eine Custom-Umsetzung einmal pro erfolgreicher Absendung feuern und Validierungsfehler überspringen.

Wenn das Formular auch ein Browser-Event auslöst, nutze dieselbe Event-ID auf beiden.

Debugging

Debugge Browser und Server als Paar.

1. Bestätige, dass der Pixel-Pfad noch funktioniert. Ein kaputter Pixel plus eine kaputte API sieht aus wie „CAPI ist down“, wenn das echte Problem Consent oder eine Pixel-ID-Mismatch ist.
2. Löse eine Conversion aus.
3. Prüfe, ob ein Browser-Event gesendet wurde.
4. Prüfe, ob ein Server-Event gesendet wurde.
5. Vergleiche Event-IDs.
6. Sieh dir die Serverantwort an. Halte Fehler sichtbar.

Die Diagnostik von PixelBridge soll den Conversions API-Verbindungsstatus und den Sendestatus letzter Events zeigen. Eine geplante Warnung ist „Browser-Event gesendet, Server-Event fehlgeschlagen“. Dieser Check ist geplant, nicht als ausgeliefert beansprucht. Siehe Diagnostik und Fehlerbehebung.

Häufige Fehler

Eventnamen und Pflichtfelder können sich ändern. Wenn ein Payload abgelehnt wird, prüfe die offizielle OpenAI-Dokumentation, bevor du WordPress-Hooks änderst.

PixelBridge-Setup

PixelBridge ist dafür gebaut, Conversions API-Events aus WordPress zu senden und sie mit Browser-Events abzustimmen. Dieses Setup ist geplant, nicht gestartet.

Vorgesehene Konfiguration, sobald Pro verfügbar ist:

1. Pixel ID eintragen und Browser-Messung zuerst fertig machen.
2. Conversions API-Credentials in den Plugin-Einstellungen hinzufügen.
3. Nur die Conversions aktivieren, denen du im Browser schon traust, oder die nur auf dem Server existieren.
4. Bestätige in der Diagnostik eine Verbindung und einen einzelnen Send pro Testaktion.

Bis zum Launch: Early Access über die Startseite. Lies Funktionen und Preise für die geplante Aufteilung Free, Pro und Agency. Pro ist die geplante Heimat für Conversions API, Deduplizierung, WooCommerce und Booking-Integrationen.

Für das breitere Messmodell weiter mit OpenAI Ads Conversion-Tracking.