Wissen · Tracking

Pixel, oppref, CAPI und Deduplizierung

Tracking bei OpenAI Ads besteht aus drei Ebenen: dem Browser-Pixel, der serverseitigen Conversions API und der Reporting-Zuordnung. Diese Seite erklärt, wie sie zusammenspielen – auch ohne technisches Vorwissen.

Damit OpenAI Ads eine Conversion messen kann, müssen vier Dinge zusammenpassen: das gesendete Event bzw. die Data Source, die Conversion-Konfiguration der Kampagne, das Attribution Window und die verfügbaren Messsignale. Fehlt eines davon, kann ein Event technisch ankommen und trotzdem nicht im Kampagnenreport erscheinen.

Kurzfassung

  • Pixel ist der einfache Start.
  • Conversion Map definiert, welches Ereignis wann gesendet wird.
  • CAPI ergänzt serverseitige Verlässlichkeit.
  • event_id + oppref helfen bei Zuordnung und Deduplizierung.

Wie OpenAI eine Conversion zuordnet

Vom Klick bis zur berichteten Conversion durchläuft ein Ereignis sechs Stationen. Wichtig: Conversions erscheinen verzögert – für attributed Conversions sind 24–48 Stunden normal.

  1. 1.Nutzer klickt ChatGPT-Anzeige.

  2. 2.Landingpage erhält ggf. oppref.

  3. 3.Pixel speichert/verarbeitet verfügbare Signale.

  4. 4.Conversion-Event wird auf Danke-Seite oder serverseitig gesendet.

  5. 5.OpenAI prüft Kampagnen-Event, Zeitfenster und Messsignale.

  6. 6.Conversion erscheint später aggregiert im Reporting.

Pixel zuerst, API danach

Conversions können über das OpenAI Pixel, die Conversions API oder beide Methoden gemessen werden. Die Reihenfolge „Pixel zuerst" ist für die meisten Setups der pragmatischste Weg.

MethodeWo sie läuftStärkenGrenzen
PixelBrowserEinfach; gut für Landingpages und Danke-SeitenAbhängig von Consent und Browserbedingungen
Conversions APIServer, Backend, Shop oder CRMRobuster; gut für Käufe und CRM-QualifizierungBraucht Entwickler und Secret Key
Beide zusammenBrowser + ServerBeste Praxis bei wichtigen EventsGleiche event_id verwenden, sonst doppelte Zählung

Automatic Advanced Matching (AAM) kann unterstützte Kundendaten im Browser erkennen, normalisieren und SHA-256-hashen – rohe Kundendaten werden dabei nicht durch AAM gesendet. Sammle trotzdem nicht manuell zusätzliche Daten: Voraussetzung bleibt immer eine saubere Einwilligung und Rechtsgrundlage.

oppref richtig behandeln

oppref ist die OpenAI Click Reference und wird an Landingpage-URLs angehängt. Das Pixel kann oppref in einem First-Party-Cookie erfassen; wenn verfügbar, kann der Wert bei Conversions-API-Events mitgegeben werden.

  • URL-Parameter bei Redirects nicht verlieren (Weiterleitungen müssen Query-Parameter durchreichen).
  • oppref nicht selbst erfinden oder synthetisch erzeugen.
  • Bei Formularen und Checkout den Wert wenn möglich mit Session oder Order speichern.
  • Nur erlaubte First-Party-Daten verwenden – Consent und Datenschutz beachten.

Deduplizierung mit event_id

Wenn Pixel und Conversions API dasselbe Ereignis senden, muss für denselben Abschluss dieselbe event_id verwendet werden – nur so kann OpenAI die Dublette erkennen und deduplizieren.

deduplizierung-event-id.js
// Browser-Pixel und Server-API nutzen dieselbe ID für denselben Abschluss
const eventId = "order_12345";

oaiq("measure", "order_created", {
  type: "contents",
  amount: 12999,
  currency: "EUR"
}, {
  event_id: eventId
});

// Server-Event: dieselbe ID als id verwenden
{
  "id": "order_12345",
  "type": "order_created",
  "data": {
    "type": "contents",
    "amount": 12999,
    "currency": "EUR"
  }
}

Messqualität verbessern

  • Pixel auf relevanten Seiten installieren.
  • Events nur bei echter Aktion senden.
  • oppref durch Redirects erhalten.
  • Server-Events mit oppref senden, wenn verfügbar.
  • Pixel + API mit gleicher event_id nutzen.
  • Consent, Datenschutz und erlaubte Daten prüfen.
  • Conversion-Event in Kampagne korrekt konfigurieren.

Warum Zahlen abweichen können

Das OpenAI-Reporting wird fast nie exakt mit deinem Analytics-Tool oder Shop-Backend übereinstimmen. Typische Gründe:

  • Attribution: OpenAI ordnet Conversions anders zu als last-click Analytics.
  • Zeitfenster: Das Attribution Window der Kampagne entscheidet, was zählt.
  • Zeitzone: Reporting-Zeitzone vs. Shop-/Analytics-Zeitzone.
  • Consent: Ohne Marketing-Einwilligung fehlen Browser-Signale.
  • Browserbedingungen: Blocker, ITP, gelöschte Cookies.
  • Deduplizierung: Gleiche Events ohne gemeinsame event_id können doppelt oder gar nicht zählen.
  • Modellierte Messung: Aggregierte/modellierte Werte ersetzen fehlende Signale.
  • Falsches Kampagnen-Event: Das gemessene Event ist nicht das in der Kampagne konfigurierte Conversion-Event.

Events können im Ereignisstream technisch ankommen und trotzdem im Kampagnenreport bei 0 bleiben, wenn Event-Konfiguration oder Kampagnenverknüpfung nicht passen. Außerdem: „Main Conversions" sollte nicht blind mit View-through-Werten vermischt werden – Click-through und View-through sind unterschiedliche Zuordnungsarten.

Weiter im Tutorial

Häufige Fragen

Brauche ich Pixel und Conversions API gleichzeitig?

Für den Einstieg reicht das Browser-Pixel. Für wichtige Conversions (Käufe, qualifizierte Leads) empfiehlt sich beides zusammen – mit derselben event_id, damit OpenAI doppelte Ereignisse deduplizieren kann.

Was ist oppref?

oppref ist die OpenAI Click Reference: ein Parameter, der an Landingpage-URLs angehängt wird. Das Pixel kann oppref in einem First-Party-Cookie erfassen; serverseitige Conversions-API-Events können oppref mitgeben, wenn verfügbar.

Warum unterscheiden sich die Zahlen im OpenAI-Reporting von meinem Analytics-Tool?

Unterschiede entstehen durch Attribution, Zeitfenster, Zeitzone, Consent-Status, Browserbedingungen, Deduplizierung und modellierte Messung. Attributed Conversions können außerdem mit 24–48 Stunden Verzögerung erscheinen.

Quellen