OpenAI Ads Integration, die bezahlte ChatGPT-Klicks vom organischen Traffic trennt.
Wer aus ChatGPT im Shop landet, sieht in den meisten Auswertungen gleich aus: Anzeige und Empfehlung fallen in denselben Topf. DataFirst liest den Klick-Parameter oppref, den OpenAI nur an bezahlte Klicks hängt, und führt OpenAI Ads als eigenen Kanal. Die Bestellung geht danach server-seitig an die Conversions API zurück, ohne Code im Shop.
Zwei Schlüssel eintragen, im Testmodus prüfen, live gehen.
Am Shop ist nichts einzubauen. Die Klickerkennung läuft über das Tracking, das ohnehin schon steht.
Pixel-ID und Schlüssel hinterlegen
Pixel-ID und Conversions-API-Schlüssel im DataFirst-Backend eintragen. Der Advertiser-API-Schlüssel ist optional, er prüft die Verbindung und liest dein Attributionsfenster aus.
Klicks laufen ohne Zutun mit
Kommt ein Besucher mit oppref an, legt DataFirst den Klick auf den Kanal OpenAI Ads. Kein Tag im Theme, keine Klick-ID zum Kopieren.
Testmodus, dann scharf schalten
Ein Schalter sendet jede Bestellung mit validate_only. OpenAI prüft die Payload und antwortet, bucht aber keine Conversion. Passt das Bild, schaltest du den Testmodus ab.
ChatGPT Ads ist jung, und die Conversions API dahinter verhält sich anders als die von Meta oder Google. Was DataFirst daraus macht, steht hier vollständig, auch die Grenzen.
- oppref trennt bezahlt von organisch
- Der Parameter kommt nur an bezahlten Klicks vor. DataFirst legt ihn als Klick-ID ab und schreibt den Kanal OpenAI Ads. Der Feed-Parameter oppcref bleibt bewusst außen vor, der gehört zum organischen Weg und würde die Trennung wieder auflösen.
- order_created, server-seitig gemeldet
- Jede Bestellung, die OpenAI Ads in der Attribution gewonnen hat, geht als order_created-Event an die Conversions API. Mit Bestellwert in Minor Units, Währung, Artikeln mit SKU und Menge sowie der Landing-URL des Einstiegsklicks.
- Deduplizierung über die Event-ID
- Liefert dein Shop die event_id des Pixels mit, nutzt DataFirst dieselbe ID im API-Feld. Läuft im Shop zusätzlich das Pixel auf derselben Pixel-ID, führt OpenAI beide Signale zusammen und zählt einen Kauf statt zwei.
- Consent-Riegel vor dem Versand
- Ohne das Signal ad_user_data auf granted verlässt keine Bestellung das System. Der Riegel ist voreingestellt und greift pro Conversion, nicht als globaler Schalter.
- Sieben-Tage-Fenster, vorher geprüft
- Ältere Bestellungen lehnt OpenAI ab. DataFirst prüft das Alter vor dem Versand und verwirft sie gleich, statt sichere Fehlschläge in die Warteschlange zu schieben.
"id": "7f3a-c901-2b" "type": "order_created" "timestamp_ms": 1756903412000 "action_source": "web" "oppref": "op_9c41f2" "data.amount": 7850 (78,50 EUR) "data.currency": "EUR" "user.emails_sha256": "a1b2c3…" (sha-256)
Ein Event je Bestellung, mit dem Klick verknüpft.
Der Betrag reist in Minor Units, 78,50 EUR sind also 7850. Das Feld oppref hängt am Klick, der die Attribution gewonnen hat, und stellt für OpenAI die Verbindung zur Anzeige her. E-Mail und Name gehen nur als SHA-256-Digest raus. Land, PLZ, IP-Adresse und User-Agent gehen für den Abgleich ungehasht mit, so sieht es die Conversions API vor.
7f3a-c901-2b · order_created → OpenAIWas DataFirst absichtlich nicht an OpenAI schickt.
Ein Matching-Signal, das in der falschen Normalisierung ankommt, trifft nie und fällt trotzdem nicht auf. Solche Felder lassen wir lieber weg, als eine Trefferquote vorzutäuschen.
- Telefonnummern Unsere Connectoren hashen die Nummer im E.164-Format samt Pluszeichen, OpenAI erwartet reine Ziffern. Der Hash würde bei jeder Nummer daneben liegen.
- Ungehashte E-Mail-Adressen und Namen Liegt für E-Mail oder Name kein gültiger SHA-256-Digest vor, fliegt das Feld vor dem Versand raus.
- Der organische Feed-Weg Der Parameter oppcref gehört zu Produktempfehlungen in ChatGPT, nicht zu Anzeigen. Er landet deshalb nicht im Kanal OpenAI Ads.
- Mehr als drei Werte je Liste OpenAI wertet je Feld die ersten drei gültigen Einträge aus. DataFirst kürzt vorher, damit klar bleibt, welche Signale ankommen.
Häufige Fragen zu OpenAI Ads
Woran erkennt DataFirst einen bezahlten ChatGPT-Klick?
Am Klick-Parameter oppref. OpenAI hängt ihn nur an bezahlte Klicks, ein organischer Verweis aus ChatGPT trägt ihn nicht. DataFirst speichert oppref als Klick-ID und legt den Klick auf den Kanal OpenAI Ads. Ohne den Parameter bleibt der Besuch im Kanal ChatGPT, also organisch.
Zählt OpenAI die Bestellung doppelt, wenn im Shop zusätzlich das Pixel läuft?
Nein, solange beide Wege dieselbe Pixel-ID nutzen und dein Shop die event_id des Pixels mitliefert. DataFirst schickt die Bestellung dann mit derselben ID. OpenAI führt beide Signale darüber zusammen und zählt einen Kauf. Das ist dasselbe Muster wie bei der Meta Conversions API.
Was passiert, wenn ein Besucher das Cookie-Banner ablehnt?
Dann verlässt die Bestellung das System nicht. Vor jedem Versand prüft DataFirst das Consent-Signal ad_user_data. Steht es nicht auf granted, wird nichts an OpenAI gemeldet. Der Riegel ist voreingestellt, du musst ihn nicht erst einschalten.
Wie alt darf eine Bestellung sein, damit sie noch ankommt?
Die Conversions API nimmt Ereignisse bis sieben Tage rückwirkend an. DataFirst prüft das Alter vor dem Versand und verwirft zu alte Bestellungen, statt sie in die Warteschlange zu schieben und dort scheitern zu lassen. Nach vorn sind zehn Minuten Toleranz erlaubt, für Uhren, die leicht vorgehen.
OpenAI Ads angebunden, bevor der Kanal groß wird.
Kostenlos starten, zwei Schlüssel statt Pixel-Bastelei, jederzeit kündbar.