ChatGPT Ads Pixel & Conversions API: Installation und Einrichtung

ChatGPT Ads Pixel & Conversions API

Mit dieser Erweiterung bindest du das ChatGPT Ads Pixel in deinen Shopware-Shop ein und überträgst die wichtigen Shop-Ereignisse zusätzlich serverseitig über die OpenAI Conversions API. So misst du deine Kampagnen in ChatGPT Ads zuverlässig, auch wenn ein Ad-Blocker das Pixel im Browser blockiert. Getrackt wird erst, wenn der Besucher dem Marketing-Tracking zugestimmt hat.

1. Clientseitiges ChatGPT Ads Pixel und serverseitige Conversions API
2. Deduplizierung von Browser- und Server-Ereignis über eine gemeinsame Event-ID
3. Standard-Ereignisse: page_viewed, contents_viewed, items_added, checkout_started und order_created
4. Enhanced Matching mit SHA-256-gehashten Kundendaten eingeloggter Kunden
5. Integration in den Shopware Cookie-Consent-Manager und sieben externe Consent-Tools
6. Eigene Pixel-ID und eigener Conversions-API-Schlüssel je Verkaufskanal

Voraussetzungen

• Ein Konto im ChatGPT Ads Manager mit eingerichtetem Pixel (Pixel-ID)
• Für die serverseitige Übertragung zusätzlich ein Conversions-API-Schlüssel aus dem ChatGPT Ads Manager
• Shopware 6.5, 6.6 oder 6.7
• Ein aktiver Cookie-Consent-Manager (Shopware-Standard oder eines der unterstützten Tools)
• Bei asynchronem Versand (Standard): ein laufender Worker für die Shopware Message Queue

Kompatibilität

Die Erweiterung gibt es für Shopware 6.5, 6.6 und 6.7. Das Pixel wird über das offizielle OpenAI-Skript geladen, die serverseitigen Ereignisse gehen direkt von deinem Shop an die OpenAI Conversions API. Weitere Erweiterungen von Drittanbietern brauchst du nicht.

Läuft dein Shop hinter einem Reverse Proxy, muss trusted_proxies korrekt eingerichtet sein. Sonst übermittelt der Shop die IP-Adresse des Proxys statt die des Besuchers.

Installation

1. Erweiterung im Shopware Store erwerben und in deinem Shop installieren.
2. Erweiterung unter Erweiterungen › Meine Erweiterungen aktivieren.
3. Konfiguration öffnen und Pixel-ID sowie optional den Conversions-API-Schlüssel eintragen (siehe „Einrichtung“).
4. Cache leeren, damit das Pixel in der Storefront ausgespielt wird.

Einrichtung

Öffne die Konfiguration unter Erweiterungen › Meine Erweiterungen beim Eintrag „ChatGPT Ads Pixel & Conversions API“ über das Drei-Punkte-Menü › Konfigurieren. Wähle oben den Verkaufskanal aus und trage im Bereich „ChatGPT Ads Pixel Konfiguration“ ein:

• Aktiv: schaltet das Tracking für den gewählten Verkaufskanal ein.
• ChatGPT Ads Pixel-ID: Du findest sie im ChatGPT Ads Manager unter „Conversions“ im Reiter „Datenquelle“ unter dem Namen des Pixels.

Für die serverseitige Übertragung brauchst du außerdem einen Conversions-API-Schlüssel. Du erzeugst ihn im ChatGPT Ads Manager unter „Conversions“ über das Schlüssel-Symbol oben rechts („Conversion-Schlüssel“). Der Schlüssel wird nur einmal angezeigt, kopiere ihn deshalb gleich. Er ist ein eigener Schlüssel und nicht der API-Schlüssel für Werbetreibende.

Unter Shopware 6.7 kannst du die Verbindung zur Conversions API in der Konfiguration über den Button „Verbindung testen“ prüfen.

1 · Erfasste Ereignisse

Ist das Tracking aktiv und hat der Besucher zugestimmt, meldet die Erweiterung diese Ereignisse an OpenAI:

• page_viewed: jeder Seitenaufruf (nur clientseitig)
• contents_viewed: Aufruf einer Produktdetailseite
• items_added: Artikel in den Warenkorb gelegt
• checkout_started: Aufruf der Bestellbestätigungsseite im Checkout
• order_created: abgeschlossene Bestellung mit Betrag, Währung und Artikeln

Die Bestellung zählt erst auf der Abschlussseite als Conversion. Wer den Checkout abbricht, erzeugt deshalb keine Conversion. Beträge gehen so an OpenAI, wie die API sie erwartet: als ganze Zahl in der kleinsten Währungseinheit (8900 entspricht 89,00 EUR).

Das eCommerce-Tracking kannst du im Bereich „Tracking-Optionen“ separat ein- und ausschalten.

2 · Conversions API & Enhanced Matching

Zusätzlich zum Pixel im Browser sendet die Erweiterung die Ereignisse serverseitig direkt an die OpenAI Conversions API. Browser- und Server-Ereignis bekommen dieselbe Event-ID, OpenAI zählt jedes Ereignis dadurch nur einmal. Weil der Server-Aufruf nicht im Browser läuft, kommen die Conversions auch bei Ad-Blockern und Tracking-Schutz im Browser an.

Mit Enhanced Matching überträgt die Erweiterung bei eingeloggten Kunden zusätzlich gehashte Daten (E-Mail, Telefonnummer, Vor- und Nachname, Kundennummer) sowie Stadt, PLZ und Land. Gehasht wird per SHA-256 im Shop, die Klartextdaten verlassen deinen Shop also nicht. So kann OpenAI Conversions besser zuordnen.

Im Bereich „Serverseitiges Tracking (OpenAI Conversions API)“ stehen dir diese Optionen zur Verfügung:

• Serverseitiges Tracking aktivieren: schaltet die Übertragung an die Conversions API ein.
• Conversions-API-Schlüssel: der Schlüssel aus dem ChatGPT Ads Manager.
• Enhanced Matching aktivieren: sendet die gehashten Kundendaten mit.
• Asynchron senden: übergibt die Aufrufe an die Shopware Message Queue, damit die Storefront schnell bleibt. Diese Option ist standardmäßig aktiv und empfohlen.
• Protokollierung: schreibt die Aufrufe zur Fehlersuche in die Shopware-Logs.
• Testmodus: OpenAI prüft die Daten, speichert die Ereignisse aber nicht. Im Live-Betrieb ausschalten.

3 · Cookie-Einwilligung & Datenschutz

Das Pixel wird erst geladen, wenn der Besucher der Kategorie „Marketing“ zugestimmt hat. Widerruft er die Einwilligung, stoppt das Tracking und die Erweiterung entfernt die OpenAI-Cookies __oppref und __obref.

Unterstützt werden der Shopware Cookie-Consent-Manager und diese Consent-Tools:

• Cookiebot
• CookieFirst
• Usercentrics
• ACRIS EU Cookie Richtlinie Pro
• CCM19
• CMP (consentmanager)
• CookieYes

Auch die serverseitigen Ereignisse sendet die Erweiterung nur mit Einwilligung. Bei einem Consent-Tool, das sie nicht kennt, sendet sie serverseitig gar nichts. Im Feld „Expertenmodus für den ausgewählten Consent-Manager“ kannst du die Kategorie anpassen, die dein Consent-Tool erwartet.

Die serverseitige Einwilligungsprüfung lässt sich abschalten. Davon raten wir ab, denn die Verantwortung für die Einwilligung liegt dann bei dir als Shopbetreiber.

Hinweis zum Datenschutz: OpenAI ist ein Anbieter aus den USA. Die Conversions API erhält neben den Ereignissen auch IP-Adresse und User-Agent des Besuchers. Weise in deiner Datenschutzerklärung auf die Datenübermittlung an OpenAI hin.

4 · Verkaufskanäle & weitere Optionen

• Mehrere Verkaufskanäle: Wähle oben in der Konfiguration den Verkaufskanal und hinterlege je Kanal eine eigene Pixel-ID und einen eigenen Schlüssel.
• Brutto/Netto: Lege fest, ob Beträge brutto oder netto übertragen werden.
• Bestellpreis: Übertrage den Bestellwert mit oder ohne Versandkosten.
• Kundengruppen ausschließen: Unter „Tracking für folgende Kundengruppen deaktivieren“ nimmst du einzelne Kundengruppen vom Tracking aus.
• Eigene Ereignisse: Im Bereich „Eigene Ereignisse“ legst du zusätzliche Ereignisse an, ein Eintrag pro Zeile im Format route_name = event_name. Ohne Route (nur event_name) wird das Ereignis auf jeder Seite ausgelöst. Zeilen mit # werden ignoriert. Eigene Ereignisse werden nur clientseitig gesendet.

FAQs