Integration · OpenAI Ads

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.

Pixel-ID und Conversions-API-Schlüssel einmal hinterlegen. Den Rest macht die API.

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.

01

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. Ein optionaler Schalter lädt zusätzlich das OpenAI-Pixel über das DataFirst-Template.

02

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.

03

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.

OpenAI-Ads-Tiefe

Ein Kanal, der eigene Regeln hat, und fünf Stellen, an denen das zählt.

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
Schaltest du das OpenAI-Pixel im DataFirst-Backend zu, meldet es den Kauf auf der Bestellseite mit derselben event_id wie die Conversions API. OpenAI führt beide Meldungen zusammen und zählt einen Kauf statt zwei. Bei einem eigenen Pixel im Shop übernimmt DataFirst die event_id, die dein Shop mitliefert.
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.
POST · bzr.openai.com/v1/events · order_created
"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.

Grenzen, offen benannt

Was 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.
Sinnvoll als Nächstes

Was bei OpenAI-Ads-Setups tatsächlich als Nächstes aufschlägt.

Automatische Deduplizierung Feature
Warum dieselbe Event-ID auf beiden Wegen der Unterschied zwischen einem gezählten Kauf und zweien ist.
Meta Ads Integration
Dieselbe Mechanik bei Meta: Conversions API, Event-ID-Deduplizierung, Consent-Gating.
Multi-Channel Attribution Lösung
Der größere Rahmen: OpenAI Ads gegen Google, Meta und Affiliate fair gerechnet, statt jeder Kanal für sich.
Server-Side Tracking Feature
Die Basis unter dem Versand: Conversions, die nicht davon abhängen, ob der Browser mitspielt.
DSGVO-konformes Tracking Wissen
Was das Consent-Signal ad_user_data rechtlich trägt und warum der Riegel vor dem Versand sitzt.
FAQ

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. Das Pixel, das DataFirst auf Wunsch ausliefert, meldet den Kauf mit derselben event_id wie die Conversions API, und OpenAI zählt einen Kauf. Bei einem eigenen Pixel im Shop gilt dasselbe, solange es dieselbe Pixel-ID nutzt und dein Shop die event_id mitliefert. Das ist dasselbe Muster wie bei der Meta Conversions API.

Brauche ich das OpenAI-Pixel im Shop?

Nein. Die Conversions API meldet Bestellungen auch ohne Pixel. Das Pixel ist ein optionaler Schalter im DataFirst-Backend. Eingeschaltet lädt es über das DataFirst-Template und meldet Seitenaufrufe, Produktansichten, Warenkorb und Checkout-Start, aber nur, wenn der Besucher in Werbung eingewilligt hat. Das Pixel erkennt Kundendaten in den Formularen deines Shops, das muss deine Datenschutzerklärung abdecken.

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.

Kostenlos testen