Was ist oppref? Die ChatGPT-Ads-Klick-ID einfach erklaert
Wenn jemand auf deine ChatGPT-Anzeige klickt, haengt OpenAI einen kleinen Code an die URL deiner Landingpage. Dieser Code heisst oppref. Er ist die eine Information, mit der OpenAI einen Klick mit einem Kauf oder einer Anfrage verbinden kann. Geht er verloren, werden deine Conversions als “aus dem Nichts” gezaehlt, und dein ChatGPT-Ads-Reporting ist blind.
Dieser Artikel erklaert in einfacher Sprache, was oppref ist, wie es erfasst wird, warum die Conversions API es ignoriert, solange du nichts dagegen tust, und welche drei Fehler das Tracking still und leise zerstoeren. Es ist eine kurze Referenz, gedacht zum Lesen, bevor du dein vollstaendiges Conversion-Setup baust.
Wichtigste Erkenntnisse
- oppref ist die Klick-ID von ChatGPT Ads. Es ist OpenAIs Version von Googles
gclidoder Metasfbclid: ein Code, der an deine Landingpage-URL gehaengt wird und sagt "dieser Besuch kam von diesem Anzeigenklick". - Der Browser-Pixel erfasst es fuer dich. Sobald der OpenAI-Pixel laedt, liest er
opprefaus der URL und speichert es in einem First-Party-Cookie namens__oppref(laut Praktiker-Quellen rund 30 Tage Lebensdauer). - Die Conversions API tut das NICHT. Server-seitige Events erfassen
opprefnicht automatisch. Du musst es selbst auslesen und an jedes Event anhaengen, sonst passen deine Offline- und CRM-Conversions nicht mehr zur Anzeige. - Die meisten Tracking-Pannen sind oppref-Pannen. Weiterleitungen, die die URL kappen, ein Cookie, das nie gesetzt wird, und der fehlende Wert auf Server-Events sind die drei ueblichen Verdaechtigen.
Diese Erklaerung fliesst in die vollstaendige Setup-Arbeit ein, die wir unter Tracking und Measurement uebernehmen. Den groesseren Datenschutz-Rahmen findest du in unserem Artikel zu ChatGPT Ads und der DSGVO.
oppref in einem Satz
oppref ist eine datenschutzfreundliche Klick-Kennung, die OpenAI an deine Landingpage-URL haengt, damit es weiss, welcher Anzeigenklick zu welcher Conversion gefuehrt hat.
Stell es dir wie eine nummerierte Garderobenmarke vor. Du gibst deinen Mantel ab und bekommst eine Marke. Spaeter gibst du die Marke zurueck, und der Mitarbeiter holt genau deinen Mantel. Die Marke selbst verraet nichts ueber dich. Sie ist nur eine Referenznummer. oppref funktioniert genauso: Es ist eine Referenz, mit der OpenAI “den Klick” und “die Conversion” zusammenbringt, ohne zu verraten, wer der Nutzer ist.
Wer schon Google Ads geschaltet hat, kennt dieses Prinzip unter einem anderen Namen. Google haengt gclid (Google Click ID) an einen Link, damit es weiss, welcher Klick zu einem Kauf gefuehrt hat. Meta haengt fbclid an. OpenAIs Version heisst oppref. Gleiche Aufgabe, andere Plattform.
| Plattform | Klick-Kennung | Was sie tut |
|---|---|---|
| Google Ads | gclid | Verbindet einen Klick mit einer Conversion in Google Ads |
| Meta Ads | fbclid | Verbindet einen Klick mit einer Conversion in Meta |
| ChatGPT Ads | oppref | Verbindet einen Klick mit einer Conversion in OpenAI Ads |
Wenn du also “oppref” liest, uebersetz es im Kopf einfach mit “die ChatGPT-Ads-Version von gclid”. Mehr ist es nicht.
Wie der Pixel oppref erfasst
Die gute Nachricht: Wenn du den OpenAI-Measurement-Pixel installierst, musst du an oppref meistens gar nicht denken. Der Pixel erledigt das.
So laeuft es Schritt fuer Schritt ab:
- Ein Nutzer klickt auf deine ChatGPT-Anzeige. OpenAI schickt ihn auf deine Landingpage und haengt
opprefan die URL, sodass die Adresse etwa so aussieht:deine-seite.de/angebot?oppref=AbC123.... - Deine Seite laedt den OpenAI-Pixel. Der Pixel ist eine kleine JavaScript-Datei (
oaiq.min.js), die von OpenAIs Servern geladen und ueber die Funktionoaiq()ausgeloest wird, genau so, wie Googles Tag uebergtag()feuert. - Der Pixel liest
opprefaus der URL. Das passiert automatisch. Du schreibst dafuer keinen Code. - Der Pixel speichert den Wert in einem First-Party-Cookie namens
__oppref. “First-Party” heisst: Das Cookie gehoert zu deiner eigenen Domain, nicht zu einem Dritten, und es ueberlebt deshalb die modernen Browser-Datenschutzregeln besser. Praktiker-Quellen berichten von rund 30 Tagen Lebensdauer fuer dieses Cookie. - Bei jedem spaeteren Seitenaufruf nutzt der Pixel das Cookie wieder. Selbst wenn der Nutzer auf deiner Seite herumklickt und
opprefaus der URL verschwindet, kennt der Pixel den urspruenglichen Klick weiterhin, weil der Wert im__oppref-Cookie liegt.
Der letzte Punkt ist der Grund, warum das Cookie zaehlt. Ein Klick und die Conversion, die darauf folgt, passieren selten auf derselben Seite. Jemand landet auf deiner Angebotsseite (oppref steht in der URL), klickt sich dann drei Seiten weiter zu einem Formular (oppref ist laengst aus der URL verschwunden). Das __oppref-Cookie traegt den Wert ueber diese Seitenaufrufe hinweg.
oppref nicht selbst an deine Links haengen. Anders als einen UTM-Parameter, den du in eine URL einbaust, fuegt OpenAI oppref beim Klick hinzu. Deine Aufgabe ist nur, es nicht zu verlieren: den Pixel installieren und die weiter unten beschriebenen Fehler mit Weiterleitungen und Cookies vermeiden.
Warum die Conversions API oppref NICHT automatisch erfasst
Das ist der wichtigste Punkt auf dieser Seite, und der Teil, der fast jeden erwischt.
Der Browser-Pixel und die Conversions API sind zwei verschiedene Wege, Conversions an OpenAI zu senden:
- Der Browser-Pixel laeuft im Browser des Besuchers. Er sieht die URL und die Cookies und erfasst
opprefdeshalb kostenlos. - Die Conversions API (CAPI) laeuft auf deinem Server oder in einem server-seitigen Google Tag Manager. Sie sendet Events direkt aus deinem Backend an OpenAI. CAPI nutzt du fuer Conversions, die nicht im Browser passieren: ein CRM markiert einen Lead als qualifiziert, ein Telefonverkauf, eine Erstattung, eine Vertragsverlaengerung.
Hier ist der Haken: Ein Server weiss von einem Browser-Cookie nichts automatisch. Deshalb erfasst die Conversions API oppref nicht von selbst. Sendest du eine server-seitige Conversion, ohne oppref manuell anzuhaengen, erhaelt OpenAI ein Event, das es keinem Anzeigenklick zuordnen kann. Die Conversion ist passiert, aber sie haengt in der Luft. Sie taucht nicht bei deiner Kampagne auf.
oppref werde mit uebernommen. Wird es nicht. Jedes CAPI-Event braucht den oppref-Wert, den du selbst anhaengst. Laesst du das weg, werden deine Offline-Conversions still nicht zugeordnet, und ChatGPT Ads sieht schlechter aus, als es ist.
Die Loesung ist ein Staffellauf. Der Browser erfasst oppref, gibt es an deinen Server weiter, und dein Server haengt es an das CAPI-Event. Wie du diese Uebergabe einrichtest, sehen wir als Naechstes.
oppref im GTM erfassen (URL zu Cookie zu Server-Event)
Wenn du Google Tag Manager nutzt, ist das Erfassen und Persistieren von oppref ein sauberes Muster in drei Schritten. Das Prinzip ist dasselbe, ob du den Code von Hand schreibst oder ein fertiges Tag verwendest.
opprefaus der URL lesen. Leg im GTM eine URL-Variable (Query-Parameter) an, dieopprefaus der Seitenadresse liest. Damit faengst du den Wert auf der Landingpage ein.- In ein First-Party-Cookie schreiben. Setz ein First-Party-Cookie (du kannst den Namen
__opprefbehalten oder einen eigenen verwenden), damit der Wert ueber Seitenaufrufe hinweg und zurueck in deine CRM-Reise ueberlebt. Das spiegelt genau das, was der Pixel tut, nur dass jetzt dein eigenes Tracking eine Kopie besitzt. - An das Server-Event anhaengen. Wenn du eine server-seitige Conversion ueber die Conversions API feuerst, lies das Cookie und leg
opprefin die Event-Daten. Jetzt traegt auch die Offline- oder verzoegerte Conversion ihre Klick-ID mit.
Du musst das nicht von Grund auf bauen. Das quelloffene server-seitige GTM-Tag von TAGGRS erfasst den oppref-Query-Parameter, speichert ihn in einem First-Party-Cookie, sendet Standard- und Custom-Events und hasht E-Mail und Telefonnummer fuer besseres Matching. Es steht unter Apache 2.0, ist also frei einsehbar und nutzbar. Ein Blick darauf, wie es oppref behandelt, ist eine gute Abkuerzung, um das Muster zu verstehen.
Der vollstaendige server-seitige Aufbau (Endpoint, Authentifizierung, Event-Mapping, Deduplizierung) steckt in unserem Guide zur Conversions API mit server-seitigem GTM und gehoert zu dem, was wir unter Tracking und Measurement einrichten.
oppref-Erfassung trotzdem schon jetzt bauen und testen. EU-Teams sollten den Pixel zusaetzlich hinter eine Einwilligung legen, denn das Browser-Tag darf das __oppref-Cookie erst setzen, nachdem der Nutzer zugestimmt hat.
oppref und Deduplizierung
Sobald du Pixel und CAPI parallel betreibst, taucht eine neue Frage auf: Wird dieselbe Conversion doppelt gezaehlt, einmal vom Browser und einmal von deinem Server?
OpenAI loest das mit Deduplizierung. Pixel und Conversions API dedupizieren ueber eine Event-ID. Du gibst jeder Conversion eine eindeutige id (der Pixel nennt sie event_id, die API nennt sie id) und nutzt denselben Wert auf beiden Kanaelen fuer dieselbe Conversion. Erhaelt OpenAI zwei Events mit derselben id, verwirft es das Duplikat, und die server-seitigen Daten werden in der Regel bevorzugt.
oppref und die Event-id machen also zwei verschiedene Dinge, und du brauchst beide:
| Feld | Aufgabe | Analogie |
|---|---|---|
oppref | Sagt, zu welchem Anzeigenklick diese Conversion gehoert | Die Garderobenmarke |
Event-id | Sagt, welche einzelne Conversion das ist, damit sie nur einmal zaehlt | Die Belegnummer |
Stimmt oppref, weiss OpenAI, dass die Conversion von deiner Anzeige kam. Stimmt die Event-id, zaehlt OpenAI sie genau einmal, auch wenn sowohl Pixel als auch CAPI sie melden. Zu den Lead-Gen-Events, die du ueblicherweise sendest, gehoeren lead_created, registration_completed und appointment_scheduled, im E-Commerce order_created.
Haeufige Fehler, die das oppref-Tracking zerstoeren
Fast jedes “ChatGPT Ads trackt keine Conversions”-Problem laesst sich auf einen dieser drei Fehler zurueckfuehren.
- Eine Weiterleitung kappt die URL. Zeigt deine ChatGPT-Anzeige auf einen Link, der ueber eine Weiterleitung springt (ein Kurzlink, eine alte Vanity-URL, ein Affiliate-Hop), kann die Weiterleitung den Query-String fallen lassen, und
opprefverschwindet, bevor dein Pixel es je sieht. Lass Anzeigen auf die finale Landingpage zeigen, oder stell sicher, dass jede Weiterleitung in der Kette den vollstaendigen Query-String erhaelt. - Das Cookie wird nie gesetzt. Feuert der Pixel auf der Landingpage nicht (eine Einwilligung hat ihn blockiert, ein Trigger im Tag-Manager ist falsch, das Skript laedt nicht), gibt es kein
__oppref-Cookie. Dann hat die Conversion auf einer spaeteren Seite nichts, woran sie sich haengen kann. Pruef, dass der Pixel auf der Einstiegsseite feuert, nicht nur auf einer Dankeseite. - CAPI-Events gehen ohne oppref raus. Oben behandelt, und es lohnt sich zu wiederholen, weil es der haeufigste server-seitige Fehler ist. Die Conversions API erfasst
opprefnicht von selbst. Tragen deine Server-Events es nicht mit, werden deine Offline- und CRM-Conversions nicht zugeordnet.
__oppref-Cookie mit einem Wert, funktioniert die Browser-Seite. Fehlt es, reparier das, bevor du die Conversions API anfasst. Es bringt nichts, Server-Events zu senden, die keine Klick-ID zu tragen haben.
Wie ChatGPT-Ads-Conversions ueber Kanaele hinweg laufen und warum Last-Click-Reporting diesen Kanal unterzaehlt, liest du in unserem Artikel zum Conversion-Tracking fuer Lead-Generierung.
Haeufige Fragen
Ist oppref dasselbe wie gclid?
Es macht dieselbe Aufgabe. gclid ist Googles Klick-Kennung, fbclid ist Metas, und oppref ist die von ChatGPT Ads. Alle drei sind ein Code, der an deine Landingpage-URL gehaengt wird und der Plattform sagt, welcher Anzeigenklick zu einer Conversion gefuehrt hat. Format und Plattform unterscheiden sich, der Zweck ist identisch: einen Klick mit einem Kauf oder einer Anfrage verbinden.
Wie lange haelt das __oppref-Cookie?
Praktiker-Quellen berichten von rund 30 Tagen Lebensdauer fuer das First-Party-Cookie __oppref, das der Pixel setzt. OpenAIs eigene Doku ist die verbindliche Quelle fuer das aktuelle Verhalten, pruef sie also, wenn du baust. Ein 30-Tage-Fenster bedeutet: Ein Klick und eine Conversion, die bis zu rund einem Monat auseinanderliegen, koennen noch zugeordnet werden. Das zaehlt fuer ueberlegte Kaeufe und laengere Lead-Zyklen.
Brauche ich oppref noch, wenn ich schon UTM-Parameter nutze?
Ja. Das sind nicht dieselben Werkzeuge. UTM-Parameter (wie utm_source=chatgpt) helfen deiner Analyse, etwa GA4, den Traffic als von ChatGPT kommend zu kennzeichnen. oppref ist das, was OpenAIs eigenes Reporting und die Conversions API nutzen, um die Conversion einem bestimmten Anzeigenklick zuzuordnen. Nutze UTMs fuer dein GA4-Kanal-Reporting und oppref fuer die Conversion-Zuordnung auf OpenAI-Seite. Sie arbeiten zusammen, nicht gegeneinander.
Erfasst die Conversions API oppref automatisch?
Nein. Der Browser-Pixel erfasst oppref automatisch aus der URL in das __oppref-Cookie. Die Conversions API, die auf deinem Server laeuft, tut das nicht. Du musst oppref selbst auslesen (meist aus dem Cookie, das der Pixel gesetzt hat) und an jedes server-seitige Event anhaengen, sonst passen diese Conversions zu keinem Anzeigenklick.
Wo finde ich oppref zum Debuggen?
An zwei Stellen. Erstens: Schau bei einem frischen Anzeigenklick in der Landingpage-URL nach einem oppref=-Parameter. Zweitens: Oeffne, nachdem der Pixel gefeuert hat, die Entwicklertools deines Browsers, geh zu den Cookies fuer deine Domain und such nach __oppref. Sind beide da, funktioniert die Erfassung. Steht es in der URL, aber nicht im Cookie, feuert dein Pixel auf dieser Seite nicht.
Bring oppref in Ordnung, bevor du das Budget hochfaehrst
oppref ist eine kleine Sache, die darueber entscheidet, ob deine gesamte ChatGPT-Ads-Messung funktioniert. Der Browser-Pixel erfasst es kostenlos, die Conversions API braucht dich, um es von Hand weiterzugeben, und drei vermeidbare Fehler (Weiterleitungen, fehlende Cookies und nackte Server-Events) erklaeren die meisten Pannen. Richte es einmal sauber ein, teste es mit einem echten Klick, und deine Conversion-Daten halten zusammen, waehrend du waechst.
Wenn du das lieber fuer dich bauen und pruefen lassen willst, ist genau das unsere Arbeit unter Tracking und Measurement und als Teil unseres ChatGPT-Ads-Service. Wer parallel Google Ads sauber messen will, findet die gleiche Disziplin in unserem Google-Ads-Service. Der schnellste Weg, um herauszufinden, ob dein aktuelles Setup oppref korrekt erfasst oder still Conversions verliert, ist ein kurzer Blick auf deine Cookies, wie oben beschrieben.
Quellen & Referenzen
- OpenAI Ads: Conversions API (oppref-Verhalten, Deduplizierung, Hashing) - developers.openai.com
- OpenAI Ads: Measurement Pixel (oaiq-Pixel, __oppref-Cookie, Standard-Events) - developers.openai.com
- TAGGRS server-seitiges GTM-Conversions-API-Tag (oppref-Erfassung, First-Party-Cookie) - GitHub
- ChatGPT-Ads-Tracking-Guide (__oppref 30-Tage-Cookie, Reporting-Hinweise) - Focal