OpenAI Conversions API in WooCommerce: Käufe serverseitig übertragen

Im Browser sendet das Measurement Pixel Produktaufrufe, Warenkorb-Aktionen, den Aufruf der Kasse und den Kauf. Bestätigt WooCommerce eine bezahlte Bestellung, wird der Kauf zusätzlich von Ihrem Server über die OpenAI Conversions API gesendet – mit derselben Event-ID, damit OpenAI ihn nur einmal zählt.

Das Measurement Pixel läuft im Browser der Kundschaft. Nur dort lassen sich Produktaufrufe und Warenkorb-Aktionen beobachten – es bedeutet aber auch, dass ein Event verloren geht, sobald Seite oder Skript nicht vollständig ausgeführt werden:

• Content-Blocker oder Privacy-Tools verhindern, dass das Pixel-Skript lädt.
• Der Kunde schließt den Tab nach dem Bezahlen, bevor die Bestellbestätigung geladen ist.
• Eine Zahlung wird erst später bestätigt – per Überweisung oder bei manchen Gateways mit Weiterleitung –, wenn der Kunde die Website längst verlassen hat.
• Ein langsamer oder abgebrochener Seitenaufruf lässt die Anfrage ins Leere laufen.

In jedem dieser Fälle verbucht WooCommerce die Bestellung trotzdem. Ein serverseitiges Kauf-Event geht von genau dieser Bestellung aus – keiner dieser Fälle verhindert also, dass es gesendet wird.

Ihr Server stellt eine authentifizierte HTTPS-Anfrage mit einem oder mehreren Events an OpenAI. Adressiert wird die Anfrage über Ihre Pixel-ID, autorisiert über einen Conversions-API-Schlüssel; beides wird im Conversions-Tab des Ads Managers erzeugt (Dokumentation zur OpenAI Conversions API, wie alle hier verlinkten OpenAI-Dokumente auf Englisch).

Senden Sie ihn, wenn WooCommerce die Bestellung in einen bezahlten Status versetzt – nicht, wenn die Bestellbestätigung angezeigt wird. Wird das Event an den Bestellstatus statt an einen Seitenaufruf geknüpft, heißt das:

• Es feuert einmal pro Bestellung, egal wie oft die Danke-Seite neu geladen wird.
• Bei verzögerten Zahlungsarten wird der Kauf gesendet, wenn die Zahlung tatsächlich bestätigt ist.
• Unbezahlte, fehlgeschlagene oder abgebrochene Bestellungen werden nicht als Kauf gemeldet.

1. Bezahlvorgang abgeschlossen

   Bestellung in WooCommerce angelegt

2. Zahlung bestätigt

   Bestellung erreicht einen bezahlten Status

3. Kauf gesendet

   order_created von Ihrem Server

4. Ergebnis protokolliert

   Angenommen, wiederholt oder fehlgeschlagen

Wird ein Kauf aus dem Browser und vom Server gesendet, muss OpenAI erkennen können, dass es sich um einen einzigen Kauf handelt. Laut OpenAI-Dokumentation erfolgt die Deduplizierung anhand von Pixel-ID, event_name und id: Bei übereinstimmendem Schlüssel zählt das zuerst eingegangene Event, spätere Duplikate werden ignoriert.

Die Event-ID muss also auf beiden Wegen identisch sein. In WooCommerce gelingt das zuverlässig, wenn sie aus der Bestellung abgeleitet wird – die kennen sowohl die Bestellbestätigung als auch der Server. Eine zufällige ID, die der Browser erzeugt und der Server nie erfährt, funktioniert nicht. Wie beide Wege zusammenspielen, erklärt der Vergleich von Pixel und Conversions API.

OpenAI lehnt Events außerhalb eines Zeitfensters ab: Laut Dokumentation darf der Zeitstempel höchstens 7 Tage in der Vergangenheit und höchstens 10 Minuten in der Zukunft liegen. Für einen Shop folgt daraus zweierlei:

• Senden Sie den ursprünglichen Kaufzeitpunkt, nicht den Zeitpunkt des Versuchs – sonst behauptet ein wiederholtes Event, der Kauf sei später erfolgt als tatsächlich.
• Beheben Sie fehlgeschlagene Zustellungen zügig. Liegt der Kaufzeitpunkt einer Bestellung mehr als 7 Tage zurück, lässt sie sich nicht mehr senden.

Die API nimmt außerdem Batches mit bis zu 1.000 Events an. Schlägt laut Dokumentation ein Event im Batch fehl, scheitert der gesamte Batch – eine einzige fehlerhafte Bestellung kann also andere blockieren, wenn eine Implementierung unbedacht bündelt.

Laut OpenAI-Dokumentation verwenden Sie dieselbe ID erneut, wenn Sie eine Conversion wiederholt oder über eine weitere Integration senden. Einen Zeitplan für Wiederholungen veröffentlicht OpenAI nicht – die Strategie liegt also bei der Implementierung. Eine sinnvolle Strategie unterscheidet:

Wie auch immer die Strategie aussieht: Ein Fehler muss irgendwo sichtbar sein. Ohne Protokoll pro Bestellung sieht eine defekte Integration genauso aus wie eine ruhige Verkaufswoche.

Serverseitige Übertragung ist kein Weg, die Einwilligung zu umgehen. Das Pixel selbst sendet keine Mess-Pings, wenn die Einwilligung auf false steht (Dokumentation zum Measurement Pixel), und ein serverseitiger Kauf sollte den Einwilligungsstatus respektieren, der für die Bestellung gespeichert wurde. In WordPress ist die WordPress Consent API der übliche Weg, über den ein Cookie-Banner diesen Status mit anderen Plugins teilt.

Pixel for ChatGPT Ads ist ein WooCommerce-Plugin, das ausschließlich den Kauf serverseitig sendet. So verhält es sich an den oben beschriebenen Punkten:

Vergrößern (Screenshot)

Schließen

Produktaufrufe, Warenkorb und Aufruf der Kasse bleiben Browser-Events. Die Übersicht ChatGPT Pixel für WooCommerce listet jedes Event auf und woher es gesendet wird.