Tutorial · Schritt 10 von 12

OpenAI Pixel global installieren

OpenAI Measurement Pixel einmal zentral im HTML-Head oder App-Layout einbinden, Pixel-ID aus dem Ads Manager kopieren und auf allen relevanten Seiten laden.

Kurzfassung

Das OpenAI Measurement Pixel wird einmalig zentral eingebunden – im HTML-Head oder im zentralen Layout einer React-/Lovable-/Next-/Vite-App. Es lädt auf allen Seiten, sammelt aber noch keine einzelnen Conversion-Events. Die Einzel-Events und die Conversions API folgen in den nächsten Schritten.

Ziel

Ziel: Das OpenAI Measurement Pixel wird einmal zentral im HTML-Head bzw. App-Layout eingebunden, damit es auf allen Seiten geladen wird.

Wann dieser Schritt relevant ist

  • Nach Schritt 9, während der 5–7 Tage Prüfungsphase.
  • Wenn die Aufgabe „Optimiere deine Anzeigen mit Conversions“ in der Übersicht sichtbar ist.
  • Wenn im Conversions-Bereich noch keine Datenquelle existiert.
  • Bevor einzelne Conversion-Events oder die Conversions API eingerichtet werden.

Vorgehen

Im Ads Manager zu Tools > Conversions > Datenquelle gehen.

Eine neue Datenquelle erstellen oder eine bestehende Datenquelle öffnen.

Pixel-ID und Einrichtungs-Skript aus dem Ads Manager kopieren.

Das globale Pixel-Skript im <head> oder zentralen Layout der Website einbauen.

Pro Website nur ein Pixel-Einrichtungsskript verwenden.

Prüfen, dass das Pixel auf Landingpage, Verkaufsseite, Lead-Danke-Seite und Kauf-Danke-Seite grundsätzlich geladen wird.

Noch keine einzelnen Conversion-Events in diesem Schritt auslösen.

Conversions-Bereich im Ads Manager öffnen

Ads Manager Übersicht mit Aufgabe Optimiere deine Anzeigen mit Conversions
Übersicht im Ads Manager: Der rote Punkt markiert offene Aufgaben, darunter „Optimiere deine Anzeigen mit Conversions“.
  • Im Ads Manager zu Tools > Conversions > Datenquelle gehen.
  • Die Übersicht zeigt offene Aufgaben, darunter die Conversion-Einrichtung.

Datenquelle erstellen

Modal Neue Datenquelle erstellen mit Namensfeld und Conversion-Bedingungen
Dialog „Neue Datenquelle erstellen“: Name vergeben, mit „Erstellen“ werden die Conversion-Bedingungen akzeptiert.
  • In der Conversions-Übersicht auf „Datenquelle erstellen“ klicken oder eine bestehende Datenquelle öffnen.
  • Name der Datenquelle vergeben und die Conversion-Bedingungen akzeptieren.

Pixel-ID aus dem Ads Manager kopieren

Modal Datenquelle einrichten mit Pixel-ID und Einrichtungscode
Dialog „Datenquelle einrichten“ mit Pixel-ID und Einrichtungs-Skript zum Kopieren.
  • Die Pixel-ID und das Einrichtungs-Skript werden angezeigt.
  • Die Pixel-ID kopieren und [OPENAI_PIXEL_ID] im eigenen Code ersetzen.

Globales Pixel-Skript einbauen

Ads Manager Conversions mit Conversion Tracking Setup Panel
Conversions-Übersicht mit Setup-Panel: Die Datenquelle ist die Basis für das globale Pixel.
  • Das Skript möglichst weit oben im HTML-Head einfügen, damit es früh geladen wird.
  • Bei React-, Lovable-, Next- oder Vite-Projekten im zentralen Layout oder Head-Bereich einbauen, nicht auf jeder Seite einzeln.
  • Pro Website nur ein Pixel-Einrichtungsskript verwenden – mehrfache Initialisierungen können zu doppelten Aufrufen führen.
  • Das Skript lädt den OpenAI-SDK und initialisiert das Pixel mit deiner Pixel-ID.
HTML
<script>
  window.oaiq = window.oaiq || function () {
    (window.oaiq.q = window.oaiq.q || []).push(arguments);
  };
  oaiq("init", { pixelId: "[OPENAI_PIXEL_ID]" });
</script>
<script async src="https://bzrcdn.openai.com/sdk/oaiq.min.js"></script>

Prüfen, wo das Pixel lädt

  • Landingpage: Das Pixel muss auf der Zielseite der Kampagne geladen werden.
  • Verkaufsseite: Produkt- oder Angebotsseiten sollten das Pixel ebenfalls laden.
  • Lead-Danke-Seite: Seite nach Formularabschluss, Webinar-Anmeldung oder Anfrage.
  • Kauf-Danke-Seite: Seite nach erfolgreichem Kaufabschluss.
  • In diesem Schritt reicht es, dass das Pixel grundsätzlich geladen wird – einzelne Events folgen später.

Was als Nächstes kommt

  • Im nächsten Schritt werden einzelne Conversion-Events und danach die Conversions API eingerichtet.

Prüfpunkte

  • Pixel-ID wurde aus dem Ads Manager kopiert.
  • Pixel-Skript ist zentral eingebunden.
  • Pixel wird auf allen relevanten Seiten geladen.
  • Es wurde noch kein einzelnes Conversion Event eingebaut.
  • Consent/Cookie-Banner wurde berücksichtigt (Details in Schritt 12).
  • Pro Website wird nur ein Pixel-Einrichtungsskript verwendet.
  • Conversions API wird erst im nächsten separaten Schritt behandelt.

Häufige Fehler

  • Pixel nur auf der Danke-Seite eingebaut, aber nicht global im <head>.
  • Pixel-Skript auf jeder Seite einzeln kopiert statt zentral im Layout.
  • Mehrere Pixel-Initialisierungen auf derselben Seite.
  • [OPENAI_PIXEL_ID] nicht durch die eigene Pixel-ID ersetzt.
  • Bereits in diesem Schritt einzelne Conversion-Events auslösen wollen.
  • Consent-Logik komplett ignorieren.

Praxis-Hinweis

Praxis-Hinweis: Halte Schritt 10 bewusst klein – nur das globale Pixel laden, sonst nichts. Wenn das Pixel auf allen relevanten Seiten im Netzwerk-Tab oder im OpenAI-Ereignisstream als geladen erscheint, ist der technische Grundstein gelegt. Einzelne Events, Ereignisstream-Tests und Kampagnenverknüpfungen kommen danach.

Relevante Quellen

Bern · Schweiz

00:00

Weltweit wachsende Community für mehr Klarheit, Benchmarks, Trainingsdaten und die schnellstmögliche Optimierung deines Agenten