> ## Documentation Index > Fetch the complete documentation index at: https://docs.dreizack-medien.de/llms.txt > Use this file to discover all available pages before exploring further. # ChatGPT Ads (Beta) > Conversion-Tracking für Anzeigen in ChatGPT – mit dem OpenAI Ads Pixel im Browser und auf Wunsch zusätzlich vom Server über die Conversions API Seit August 2026 läuft Werbung in ChatGPT auch in Deutschland. Mit dem Modul **ChatGPT Ads** misst du, ob deine Anzeigen in ChatGPT zu Käufen führen. Agentic Plus meldet dazu Produktansichten, Warenkorb, Checkout, Käufe und Registrierungen an OpenAI. Im Ads Manager siehst du dann, welche Kampagnen Umsatz bringen, und OpenAI kann die Ausspielung daran optimieren. > [!NOTE] > > Verfügbar ab **Agentic Plus 1.1.0**, benötigt **DZM Resources & Health ab 1.13.0**. Das Modul ist standardmäßig aus. > [!NOTE] > > **Beta:** Die Anbindung an ChatGPT Ads ist neu. Wir haben sie mit einem echten OpenAI-Konto getestet: Pixel und Conversions API liefern die Ereignisse, Einwilligung und Widerruf greifen. Mit einer laufenden Kampagne konnten wir sie noch nicht prüfen. Wenn du bei ChatGPT Ads wirbst, sag uns, wie es läuft: [support@dreizack-medien.de](mailto:support@dreizack-medien.de). Deine Rückmeldung fließt direkt in die nächste Version. ## So funktioniert es * **Im Browser:** Hat der Besucher dem Dienst **OpenAI Ads Pixel** zugestimmt, lädt Agentic Plus das Pixel von OpenAI und meldet die Ereignisse aus dem Tracking von DZM Resources. Vorher wird nichts geladen. * **Vom Server (optional):** Käufe gehen zusätzlich direkt vom Server deines Shops an OpenAI, über die **Conversions API**. So kommen auch Käufe an, die der Browser nicht überträgt, etwa wegen eines Adblockers oder weil der Käufer nach einer externen Zahlung nicht in den Shop zurückkehrt. * **Kein doppelter Kauf:** Pixel und Server senden einen Kauf mit derselben Event-ID. OpenAI erkennt daran, dass es derselbe Kauf ist, und zählt ihn nur einmal. | Ereignis im Shop | Ereignis bei OpenAI | | - | - | | Produktansicht | `contents_viewed` | | In den Warenkorb | `items_added` | | Checkout gestartet | `checkout_started` | | Kauf | `order_created` | | Registrierung | `registration_completed` | ## Einrichtung ### Im OpenAI Ads Manager **1. Datenquelle anlegen und Pixel-ID kopieren** Lege im Ads Manager im Tab **Conversions** eine Datenquelle für deinen Shop an und kopiere die **Pixel-ID**. **2. Conversions-API-Key erzeugen (optional)** Nur wenn du Käufe auch vom Server melden willst: Erzeuge im selben Tab einen **Conversions-API-Key**. **3. Conversion-Einstellung anlegen** Lege eine Conversion-Einstellung für Käufe an (Ereignis **Order Created**) und wähle sie bei deinen Kampagnen aus. Ohne diese Einstellung kommen die Ereignisse zwar an, zählen aber nicht als Conversions deiner Kampagnen. ### In Agentic Plus **1. Modul einschalten** Öffne im Plugin den Menüpunkt **ChatGPT Ads (Beta)**, schalte „Modul aktiv“ ein, trage die Pixel-ID ein und speichere. **2. Einwilligung prüfen** Mit dem Consent-Banner von JTL bzw. NIU Plus erscheint der Dienst **OpenAI Ads Pixel** automatisch im Banner. Nutzt du **EU Cookie** von Webstollen, musst du den Dienst dort selbst verknüpfen, siehe [Einwilligung mit EU Cookie](#einwilligung-mit-eu-cookie). ![Der Dienst OpenAI Ads Pixel in den Cookie-Einstellungen des Shops](https://mintcdn.com/dzm/_RGQNbhSZ-koTtlK/images/dzm-agentic-plus-chatgpt-ads-einwilligung.png?fit=max\&auto=format\&n=_RGQNbhSZ-koTtlK\&q=85\&s=66a3e5b8aec7ffe3a88375a0d1a0d691) **3. Käufe vom Server melden (optional)** Schalte „Käufe zusätzlich vom Server melden“ ein, füge den Conversions-API-Key ein und klicke **direkt neben dem Feld** auf **Speichern**. Für den ersten Test kannst du „Nur prüfen“ einschalten, siehe [Testen](#testen). **4. Datenschutzerklärung ergänzen** Ergänze deine Datenschutzerklärung um das OpenAI Ads Pixel. Einen Textvorschlag findest du weiter unten unter **Datenschutzerklärung**. ## Einstellungen ![Einstellungsseite ChatGPT Ads (Beta) in Agentic Plus](https://mintcdn.com/dzm/_RGQNbhSZ-koTtlK/images/dzm-agentic-plus-chatgpt-ads-einstellungen.png?fit=max\&auto=format\&n=_RGQNbhSZ-koTtlK\&q=85\&s=fae6df8ceefbcfb8f834b9b64fd9d7f0) **Modul aktiv** `boolean` Hauptschalter. Ist er aus, lädt Agentic Plus kein Pixel, zeigt keinen Eintrag im Consent-Banner und meldet nichts vom Server. Standard: aus. **Pixel-ID** `string` Die Pixel-ID deiner Datenquelle aus dem Tab „Conversions“ im Ads Manager. Browser und Server nutzen dieselbe ID. Ohne Pixel-ID bleibt das Modul wirkungslos. **Käufe zusätzlich vom Server melden** `boolean` Meldet Käufe zusätzlich über die Conversions API. Gesendet wird nur, wenn der Käufer bei der Bestellung dem Dienst OpenAI Ads Pixel zugestimmt hatte. Standard: aus. **Conversions-API-Key** `string` Der Key aus dem Ads Manager. Er wird verschlüsselt gespeichert und nie wieder angezeigt. Das Feld zeigt nur den Zustand: **Nicht gesetzt**, **Gespeichert**, **Per Konstante gesetzt** oder **Nicht lesbar – bitte neu eintragen**. Der Button „Speichern“ neben dem Feld speichert sofort, unabhängig vom Speichern der Seite. **Nur prüfen (validate\_only)** `boolean` OpenAI prüft die Käufe vom Server (Format, Pflichtfelder, Key, Pixel-ID), speichert und zählt sie aber nicht. Nur für die Einrichtung – im Livebetrieb ausschalten. Standard: aus. **Kundendaten gehasht mitsenden** `boolean` Gilt nur für die Meldung vom Server. Sendet zusätzlich E-Mail, Vor- und Nachname (mit SHA-256 gehasht) sowie das Land. Das verbessert die Zuordnung, ist aber datenschutzrelevant: Ergänze deine Datenschutzerklärung. PLZ, Ort und Telefon werden nie gesendet. Standard: aus. ### Zugangsdaten per Konstante Statt den Key im Backend einzutragen, kannst du ihn als Konstante in der `config.JTL-Shop.ini.php` deines Shops hinterlegen. Die Konstante hat Vorrang, das Feld zeigt dann **Per Konstante gesetzt**. ```php config.JTL-Shop.ini.php theme={null} define('DZM_TRACKING_OPENAI_CAPI_KEY', 'dein-conversions-api-key'); ``` ## Was übertragen wird **Im Browser** meldet das Pixel die Ereignisse aus der Tabelle oben mit Artikeln, Preisen und Währung. Beim Start auf jeder Seite meldet es sich außerdem bei OpenAI an. Es setzt die Cookies `__oppref` (Klick-Kennung aus der Anzeige, 30 Tage) und `__obref` (Browser-Kennung, 365 Tage). **Vom Server** geht nur der Kauf an OpenAI: | Daten | Gesendet | | - | - | | Artikel, Mengen, Preise und Währung der Bestellung | immer | | Klick-Kennung aus der Anzeige (`oppref`) und Cookie-Kennungen des Pixels | immer, soweit vorhanden | | IP-Adresse und Browserkennung des Käufers | immer | | Adresse (URL) der Shopseite | immer | | Kundennummer, gehasht | immer | | E-Mail, Vor- und Nachname (gehasht), Land | nur mit „Kundendaten gehasht mitsenden“ | Stornos und Retouren gehen nicht an OpenAI, dafür gibt es bei OpenAI kein Ereignis. ## Einwilligung und Widerruf * Das Pixel lädt erst nach der Einwilligung in den Dienst **OpenAI Ads Pixel**. * Widerruft der Besucher, löscht das Pixel seine Cookies und sendet nichts mehr. * Vom Server geht ein Kauf nur, wenn der Käufer bei der Bestellung eingewilligt hatte. Bei eingeschalteter Server-Meldung ergänzt Agentic Plus die Beschreibung im Banner um einen Hinweis darauf. Die Texte im Banner (Name, Beschreibung, Zweck, Anbieter, Link zur Datenschutzerklärung) kannst du im JTL-Backend unter den Sprachvariablen des Plugins anpassen. ### Einwilligung mit EU Cookie Nutzt du **EU Cookie** von Webstollen, ersetzt dessen Banner den JTL-Banner. Verknüpfe dann einen Dienst mit dem JTL-Eintrag `dzm_chatgpt_ads`, sonst bleibt der Dienst ohne Einwilligung, und es wird nichts gesendet. **1. Dienst anlegen oder öffnen** Lege in EU Cookie einen Dienst „OpenAI Ads Pixel“ in der Kategorie **Marketing** an. **2. JTL-Eintrag verbinden** Aktiviere die **JTL Consent Manager Integration für diesen Dienst** und füge unter **Verknüpfte JTL Consent Manager Einträge** den Eintrag `dzm_chatgpt_ads` hinzu. Mehr zu EU Cookie unter [Webstollen EU Cookie](https://docs.dreizack-medien.de/NIU-Plus/consent.md#webstollen-eu-cookie-ws5). ## Testen > [!TIP] > > Die Meldung vom Server lässt sich nur mit dem **Test-Link** aus DZM Resources testen, der globale Testmodus wirkt dort nicht. Nimm am besten eine Zahlart, bei der die Bestellung vor der Zahlung angelegt wird, z. B. Vorkasse oder Rechnung. Details unter [Test-Modi](https://docs.dreizack-medien.de/Resources-and-Health/tracking.md#test-modi). * **Browser:** Stimme im Banner dem OpenAI Ads Pixel zu und klicke dich bis zum Kauf durch. Die Ereignisse erscheinen nach kurzer Zeit im Ads Manager bei deiner Datenquelle. * **Server:** Die Käufe verschickt der Cronjob „DZM Resources: Server-Side-Tracking senden“ **stündlich**. Status und Meldung jedes Versands siehst du in **DZM Resources → Tracking**, siehe [Server-Side-Tracking](https://docs.dreizack-medien.de/Resources-and-Health/tracking.md#server-side-tracking). Ein angenommener Kauf steht dort als „ChatGPT Ads: angenommen“. * **Nur prüfen:** Mit eingeschaltetem „Nur prüfen“ steht dort „ChatGPT Ads: geprüft (validate\_only) – nicht gespeichert, zählt nicht“. Diese Käufe erscheinen nicht im Ads Manager und werden später auch nicht nachgeschickt. > [!WARNING] > > Schalte „Nur prüfen“ für den Livebetrieb aus. Solange es an ist, zählt OpenAI keinen Kauf, der vom Server kommt. ## Shop-Statistik Die Statistik in DZM Resources zeigt Besuche über eine Anzeige in ChatGPT als eigene Quelle **ChatGPT (Anzeige)**, mit Käufen und Umsatz. Erkannt wird das an der Klick-Kennung, die OpenAI an den Link hängt. Die Quelle wird beim Beginn eines Besuchs festgelegt. Organische Links aus ChatGPT erscheinen meist als „chatgpt.com“. ## Datenschutzerklärung > [!WARNING] > > Der folgende Text ist ein Vorschlag ohne Gewähr und keine Rechtsberatung. Passe ihn an deinen Shop und deine Einstellungen an und lass ihn im Zweifel prüfen. > **Textvorschlag: OpenAI Ads Pixel (Conversion-Tracking)** > > **OpenAI Ads Pixel (Conversion-Tracking)** > > Wir nutzen auf unserer Website das OpenAI Ads Pixel, einen Dienst der OpenAI Ireland Limited, 1st Floor, The Liffey Trust Centre, 117–126 Sheriff Street Upper, Dublin 1, D01 YC43, Irland. > > **Zweck der Verarbeitung** > > Das OpenAI Ads Pixel ermöglicht uns, die Wirksamkeit unserer Werbeanzeigen innerhalb von ChatGPT zu messen. Insbesondere können wir auswerten, ob Nutzer nach einer Interaktion mit unseren Anzeigen bestimmte Aktionen auf unserer Website durchführen, beispielsweise Produktansichten, Warenkorb-Aktionen, Registrierungen oder Käufe. > > Die gewonnenen Informationen dienen der Analyse des Werbeerfolgs und der Optimierung unserer Werbemaßnahmen. > > **Verarbeitete Daten** > > Abhängig von der technischen Konfiguration können insbesondere folgende Daten verarbeitet werden: > > * Informationen über Seitenaufrufe und Conversion-Ereignisse > * Produktinformationen, Transaktionswerte und Währungen > * Klick- und Browser-Kennungen von OpenAI > * IP-Adresse, Browserkennung (User-Agent) und die Adresse der aufgerufenen Seite > * Kundennummer in gehashter Form, sofern Käufe auch von unserem Server gemeldet werden > * E-Mail-Adresse, Vor- und Nachname (jeweils SHA-256-gehasht) sowie Land, sofern der Abgleich von Kundendaten aktiviert ist > > Hierzu kann OpenAI Cookies einsetzen, insbesondere `__oppref` mit einer Speicherdauer von bis zu 30 Tagen und `__obref` mit einer Speicherdauer von bis zu 365 Tagen. > > **Übermittlung von Käufen durch unseren Server** > > Sofern aktiviert, melden wir abgeschlossene Käufe zusätzlich direkt von unserem Server an OpenAI (Conversions API). Das geschieht nur, wenn Du bei der Bestellung in das OpenAI Ads Pixel eingewilligt hast. Übermittelt werden die Artikel, Mengen, Preise und die Währung der Bestellung, die Klick- und Browser-Kennungen von OpenAI, Deine IP-Adresse, die Browserkennung, die Adresse der Seite und Deine Kundennummer in gehashter Form, je nach Einstellung auch die oben genannten gehashten Kundendaten. Browser und Server verwenden dieselbe Kennung, damit OpenAI einen Kauf nur einmal zählt. > > **Rechtsgrundlage und Einwilligung** > > Die Datenverarbeitung erfolgt ausschließlich nach Deiner ausdrücklichen Einwilligung auf Grundlage von Art. 6 Abs. 1 lit. a DSGVO. Soweit Informationen auf Deinem Endgerät gespeichert oder ausgelesen werden, erfolgt dies auf Grundlage von § 25 Abs. 1 TDDDG. > > Du kannst Deine Einwilligung jederzeit über unsere Cookie-Einstellungen mit Wirkung für die Zukunft widerrufen. > > **Empfänger und Drittlandübermittlung** > > Empfänger der Daten ist OpenAI Ireland Limited. Im Rahmen der Verarbeitung können weitere mit OpenAI verbundene Unternehmen sowie Dienstleister einbezogen werden. Eine Verarbeitung personenbezogener Daten in Drittländern, insbesondere in den USA, ist möglich. > > OpenAI sieht für entsprechende internationale Datenübermittlungen geeignete Übermittlungsmechanismen vor, darunter gegebenenfalls Standardvertragsklauseln der Europäischen Kommission. > > **Weitere Informationen** > > Weitere Informationen zur Datenverarbeitung durch OpenAI findest Du unter [https://openai.com/de-DE/policies/eu-privacy-policy/](https://openai.com/de-DE/policies/eu-privacy-policy/). Datenschutzkontakt von OpenAI: [privacy@openai.com](mailto:privacy@openai.com). ## Native App Läuft dein Shop zusätzlich in einer nativen iOS-App, gilt das Pixel dort als Werbe-Tracking. Apple verlangt dafür eine Abfrage nach App Tracking Transparency (ATT), bevor das Pixel laden darf. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.