Zum Inhalt springen
Plugin kaufen

Anleitung

ChatGPT Ads Pixel in WooCommerce einrichten – Schritt für Schritt

ChatGPT Ads misst WooCommerce-Verkäufe über zwei OpenAI-Schnittstellen: das Measurement Pixel im Browser der Kundschaft und die Conversions API auf Ihrem Server. Für die Einrichtung holen Sie sich im Ads Manager eine Pixel-ID und einen API-Schlüssel und verbinden beides mit WooCommerce, sodass echte Produkt-, Warenkorb- und Bestell-Events gesendet werden. Diese Anleitung geht das mit dem Plugin Pixel for ChatGPT Ads durch und zeigt zum Schluss, wie Sie prüfen, ob alles funktioniert.

Aktualisiert

Auf dieser Seite

Kurz gesagt: sieben Schritte, im Kern eine einzige Einstellungsseite

Bevor Sie beginnen

Fünf Dinge, die Sie bereithalten sollten – und eines, das Sie entfernen sollten.

  • WordPress mit aktivem WooCommerce, ausgeliefert über HTTPS.
  • Administratorzugang zu WordPress, um ein Plugin hochzuladen und zu konfigurieren.
  • Zugriff auf Ihr ChatGPT-Ads-Konto im OpenAI Ads Manager.
  • Einen Pixel for ChatGPT Ads-Lizenzschlüssel. Sie erhalten ihn beim Kauf; die Tarife beginnen bei einer Website.
  • Einen Server, der ausgehende HTTPS-Anfragen senden darf. Manche Hoster und Firewalls blockieren solche Anfragen – der serverseitige Kauf ist aber auf sie angewiesen.

Bitte prüfen

Entfernen Sie andere Kopien des Pixels. Steckt das ChatGPT Ads Pixel bereits im Header des Themes, in einem Plugin für Header-Skripte oder in einem Container des Google Tag Manager, entfernen Sie es vor dem Livegang. Eine zweite Kopie feuert eigene Events ohne die Event-IDs des Plugins. OpenAI kann sie dann nicht als denselben Kauf erkennen, und Ihre Conversions werden womöglich doppelt gezählt.
1

Schritt 1 von 7

Pixel-ID anlegen

Die Pixel-ID teilt dem Measurement Pixel mit, zu welchem ChatGPT-Ads-Konto die Events gehören. Laut OpenAI-Dokumentation legen Sie eine neue Pixel-ID im Conversions-Tab des Ads Managers an (Dokumentation zum Measurement Pixel; alle verlinkten OpenAI-Dokumente sind auf Englisch).

Die Pixel-ID brauchen Sie auch für das serverseitige Tracking: Der Endpunkt der Conversions API wird über sie angesprochen.

Erwartetes Ergebnis

Eine Pixel-ID für Ihr ChatGPT-Ads-Konto, griffbereit zum Einfügen.

Häufiger Fehler

Im Browser und auf dem Server unterschiedliche Pixel-IDs verwenden. Beide Wege müssen dieselbe nutzen, sonst lassen sich Browser- und Server-Events nicht zuordnen.
2

Schritt 2 von 7

API-Schlüssel erstellen

Mit dem Conversions-API-Schlüssel darf Ihr Server Events senden. OpenAI stellt ihn an derselben Stelle bereit: Pixel-ID und Conversions-API-Schlüssel lassen sich laut Dokumentation beide im Conversions-Tab des Ads Managers erzeugen (Dokumentation zur Conversions API).

Behandeln Sie den API-Schlüssel wie ein Passwort

OpenAI stellt unmissverständlich klar, dass Server-Events ausschließlich von Ihrem Server gesendet werden sollen. Das Plugin speichert den Schlüssel für die serverseitige Nutzung und gibt ihn nicht in der Seite aus.

Erwartetes Ergebnis

Ein Conversions-API-Schlüssel, abgelegt ausschließlich dort, wo Sie auch Passwörter aufbewahren.

Häufiger Fehler

Den Schlüssel in eine Theme-Datei, einen Page Builder oder einen Tag Manager einfügen. Der Schlüssel darf niemals im Seitenquelltext auftauchen.
3

Schritt 3 von 7

Plugin installieren

  1. 1Laden Sie die Plugin-ZIP aus Ihrer Kaufbestätigung herunter oder mit Ihrem Lizenzschlüssel über die Download-Seite (auf Englisch).
  2. 2Gehen Sie in WordPress auf Plugins → Plugin hinzufügen → Plugin hochladen (in älteren WordPress-Versionen heißt der Menüpunkt „Neu hinzufügen“), wählen Sie über „Datei auswählen“ die ZIP-Datei aus und klicken Sie auf „Jetzt installieren“.
  3. 3Aktivieren Sie das Plugin mit „Plugin aktivieren“.

Erwartetes Ergebnis

Pixel for ChatGPT Ads erscheint unter „Installierte Plugins“ als aktiv.
4

Schritt 4 von 7

Lizenz aktivieren

Öffnen Sie im Plugin den Tab Licence, fügen Sie Ihren Lizenzschlüssel ein und aktivieren Sie ihn. Solange die Lizenz nicht aktiv ist, werden keine Events gesendet.

Erwartetes Ergebnis

Der Tab Licence zeigt den Status Active an, zusammen mit Ihrem Tarif und den verbleibenden Aktivierungen.

Häufiger Fehler

Zuerst auf einer Staging-Kopie aktivieren. Staging belegt eine eigene Aktivierung – testen Sie dort also nur, wenn Ihr Tarif eine übrig hat.
5

Schritt 5 von 7

Zugangsdaten verbinden

Im Tab Settings des Plugins:

  • Fügen Sie Ihre Pixel-ID in das Feld OpenAI Pixel ID ein.
  • Fügen Sie Ihren Schlüssel in das Feld Conversions API key ein.
  • Lassen Sie das Browser-Tracking eingeschaltet, damit Produktaufrufe, Warenkorb-Aktionen, der Aufruf der Kasse und Käufe von der Seite gesendet werden.
  • Lassen Sie das serverseitige Tracking eingeschaltet, damit jede bezahlte Bestellung über die Conversions API gesendet wird.
  • Setzt Ihr Cookie-Banner die WordPress Consent API um, schalten Sie die Consent-Steuerung ein. Dann wartet das Pixel auf die Marketing-Einwilligung.

Die Verbindungseinstellungen des Plugins in WordPress (englische Oberfläche).

  1. 1OpenAI Pixel ID – aus Schritt 1.
  2. 2Conversions API key – aus Schritt 2.
  3. 3Schalter für Browser- und serverseitiges Tracking – beide eingeschaltet lassen.

Erwartetes Ergebnis

Beide Zugangsdaten gespeichert, Browser- und serverseitiges Tracking eingeschaltet.

Bitte prüfen

Nutzt Ihr Shop einen Full-Page-Cache, leeren Sie ihn nach dem Speichern. Sonst bekommen Besucher eine zwischengespeicherte Seite aus der Zeit vor der Pixel-Konfiguration ausgeliefert.
6

Schritt 6 von 7

Browser-Events prüfen

  1. 1Öffnen Sie den Shop in einem privaten Fenster und akzeptieren Sie Marketing-Cookies, falls ein Banner erscheint.
  2. 2Öffnen Sie die Entwicklertools Ihres Browsers und wechseln Sie in den Tab „Netzwerk“.
  3. 3Filtern Sie die Anfragen nach openai. Das Skript des Measurement Pixel sollte von einem openai.com-Host geladen werden.
  4. 4Sehen Sie ein Produkt an, legen Sie es in den Warenkorb und gehen Sie zur Kasse – dabei sollten neue Anfragen erscheinen.

Erwartetes Ergebnis

Anfragen an einen openai.com-Host, sobald Sie ein Produkt ansehen, es in den Warenkorb legen und die Kasse aufrufen.

Häufiger Fehler

Überhaupt keine Anfragen – meist ist das Browser-Tracking aus, die Pixel-ID fehlt, die Einwilligung wurde nicht erteilt oder es wird eine zwischengespeicherte Seite ausgeliefert.
7

Schritt 7 von 7

Bezahlte Bestellung prüfen

Schließen Sie eine Bestellung ab, die einen bezahlten Status erreicht (etwa „In Bearbeitung“) – eine echte Bestellung mit kleinem Betrag oder über ein Test-Gateway, das Bestellungen als bezahlt markiert. Öffnen Sie dann im Plugin den Tab Diagnostics und suchen Sie die Bestellung.

Was der Zustellstatus einer Bestellung bedeutet
ZustellstatusBedeutungWas zu tun ist
AcceptedOpenAI hat den Kauf angenommen.Nichts. Das Tracking funktioniert.
PendingIn der Warteschlange oder wartet auf den nächsten Versuch.Kurz abwarten und erneut nachsehen.
Not sentDer Kauf wurde nicht gesendet – meist fehlt für diese Bestellung die Marketing-Einwilligung.Den Grund in der Bestellung nachlesen.
FailedDer letzte Versuch wurde nicht abgeschlossen.HTTP-Status lesen, Ursache beheben, berechtigte Bestellung erneut senden.

Unter Diagnostics stehen die bezahlten Bestellungen und was mit dem jeweiligen Kauf-Event passiert ist.

  1. 1Suchen Sie Ihre Testbestellung anhand der Bestellnummer.
  2. 2Die Event-ID ist die, die Browser-Kauf und Server-Kauf gemeinsam haben.

Erwartetes Ergebnis

Die Bestellung zeigt unter Diagnostics den Status Accepted.

Bitte prüfen

Eine Bestellung, die noch auf Zahlung wartet, wurde noch nicht gesendet – der Kauf wird erst gesendet, wenn WooCommerce sie als bezahlt markiert.

Fehlerbehebung

Häufige Fehler

Die meisten Probleme bei der Einrichtung gehen auf eine dieser fünf Ursachen zurück.

Häufige Fehler bei der Einrichtung des ChatGPT Ads Pixels in WooCommerce
SymptomWahrscheinliche UrsacheLösung
Conversions erscheinen doppeltDas Pixel ist zusätzlich im Theme oder in einem Tag Manager eingebunden.Die andere Kopie entfernen.
Failed mit HTTP 401Der Conversions-API-Schlüssel wurde abgelehnt.Gültigen Schlüssel eintragen, dann unter Diagnostics erneut senden.
Bleibt auf Pending, wird wiederholtDer Server erreicht die API nicht.Ausgehendes HTTPS, Firewall- und Proxy-Regeln prüfen.
Keine Browser-EventsKeine Einwilligung, Tracking aus oder veraltete Seite im Cache.Einwilligung erteilen, Einstellungen prüfen, Cache leeren.
Bestellungen als Not sent markiertFür diese Bestellungen ist keine Marketing-Einwilligung gespeichert.Bei aktiver Consent-Steuerung so vorgesehen.

Weitere Fälle behandelt der Abschnitt Fehlerbehebung in der Dokumentation.

Ohne Plugin

Alternativ: die manuelle Einbindung

Sie können das Pixel auch ohne Plugin einbinden. In WooCommerce ist das Snippet allerdings erst der Anfang.

Laut OpenAI fügen Sie dafür das Snippet in den <head> jeder Seite ein, auf der Sie Conversions erfassen möchten. Danach gilt:

  • Jedes Event – Produktaufruf, Warenkorb, Kasse, Kauf – muss mit WooCommerce-Werten programmiert werden.
  • Das Kauf-Event sollte einmal pro Bestellung feuern, nicht bei jedem Laden der Bestellbestätigung.
  • Ein serverseitiger Kauf braucht einen eigenen API-Client, ausgelöst durch den bezahlten Status.
  • Browser- und Server-Kauf brauchen dieselbe Event-ID, damit sie dedupliziert werden können.
  • Fehler brauchen Wiederholungen und einen Ort, an dem sie sichtbar werden.

Die Anleitung zur OpenAI Conversions API in WooCommerce behandelt die serverseitige Hälfte im Detail.

Fragen

Brauche ich sowohl die Pixel-ID als auch den API-Schlüssel?

Die Pixel-ID brauchen Sie für alles, den API-Schlüssel für den serverseitigen Kauf. Browser- und serverseitiges Tracking lassen sich jeweils abschalten. Laufen aber beide, hat der Kauf einen zweiten Weg, der nicht vom Browser abhängt.

Braucht das Plugin den Google Tag Manager?

Nein. Es lädt das Pixel und bildet die Events direkt aus WooCommerce.

Legt ein Theme-Wechsel das Tracking lahm?

Nein. Es werden keine Templates angepasst, ein Theme-Wechsel entfernt das Pixel also nicht. Stark angepasste Checkouts sollten Sie danach aber mit einer Bestellung erneut testen.

Funktioniert es mit HPOS?

Ja. WooCommerce High-Performance Order Storage und die klassische Bestellspeicherung werden beide unterstützt.

Bereit für die Installation?

Pixel for ChatGPT Ads gibt es als Jahreslizenz für 1, 5 oder 25 Websites – mit gleichem Funktionsumfang in jedem Tarif.

Zu den PreisenWas das Plugin sendet

Passende Anleitungen