Tools und kleine Helfer für OpenAI Ads

Verfügbare Helfer

Diese Seiten und Tools begleiten dich vom ersten Seiten-Inventar bis zum fertigen Tracking-Setup. Sie sind alle statisch im Projekt verfügbar und enthalten keine echten IDs oder Keys.

Workflow: Einzelnes Event

Für eine einzelne Conversion-Seite reicht oft ein kurzer Durchlauf. Du bestimmst die Ziel-URL, wählst den passenden Conversion-Typen und baust das passende Pixel-Event in die Danke-Seite oder Checkout-Bestätigung ein.

1. Ziel-URL bestimmen: Auf welcher Seite soll das Event ausgelöst werden? Beispiele: /danke, /checkout/confirmation, /webinar/danke.
2. Conversion-Typ wählen: Lead, Webinar, Meeting, Kauf, Abo, Trial oder Seitenaufruf.
3. Passenden Standard-Event-Namen wählen – siehe Tabelle unten.
4. Optional Betrag in Cent (EUR) angeben: 99,00 EUR = 9900 Cent. Nur wenn das Event monetär ist.
5. Code in Danke-Seite oder Checkout-Bestätigung einbauen.
6. Ereignisstream testen und auf Deduplizierung achten.

Tipp: Für Custom Events nutzt du immer den Eventnamen custom und übergibst custom_event_name als Option – nicht im Datenobjekt.

Workflow: Ganze Website als Conversion Map

Wenn du nicht nur einzelne Events, sondern das gesamte Website-Tracking strukturiert aufbauen willst, ist eine Conversion Map der richtige Ansatz.

Copy-Prompt 1: Seitenliste erstellen

Für den Anfang kopierst du diesen Prompt in Lovable, Claude oder ChatGPT. Er erzeugt eine strukturierte Seitenliste, die du anschließend in die Conversion Map überführst.

Analysiere meine Website und erstelle eine strukturierte Liste aller wichtigen Seiten für Conversion Tracking.

Bitte gib pro Seite diese Felder aus:
- URL
- Seitentitel
- Zusammenfassung in 3 kurzen Sätzen
- Haupt-CTA Beschreibung
- Haupt-CTA Link/Ziel
- Vermutete Conversion-Idee: page_view, lead, webinar_registration, meeting, sale, subscription, trial oder none
- Falls sale: geschätzter Betrag in EUR, falls auf der Seite erkennbar
- Unsicherheit: niedrig, mittel oder hoch
- Begründung in 1 Satz

Wichtig: Erfinde keine Preise oder URLs. Wenn etwas nicht klar ist, schreibe null oder "unklar".

Copy-Prompt 2: Conversion Map aus Seitenliste

Gib die zuvor erstellte Seitenliste als Kontext mit. Der Prompt liefert eine saubere JSON- Conversion Map mit Platzhalter-Event-IDs.

Du bekommst gleich eine Seitenliste meiner Website. Erstelle daraus eine Conversion Map für OpenAI Ads.

Regeln:
- Nutze Standard-Events, wenn möglich: page_viewed, contents_viewed, lead_created, appointment_scheduled, registration_completed, order_created, subscription_created, trial_started.
- Nutze custom nur, wenn kein Standard-Event passt.
- Beträge in EUR als Cent angeben: 99,00 EUR = 9900.
- Für kostenlose Webinare kein amount setzen.
- Für mehrere Webinare nutze registration_completed plus contents mit webinar id und name.
- Event IDs als Platzhalter definieren, z. B. lead_<id>, order_<id>, webinar_registration_<id>.
- Gib eine JSON-Liste aus.

Pro Mapping-Eintrag:
- route
- page_title
- trigger
- openai_event
- data_type
- amount_cents
- currency
- contents
- custom_event_name
- event_id_pattern
- send_pixel
- send_api_later
- consent_category
- notes

Copy-Prompt 3: Pixel-Basiscode einbauen

Dieser Prompt richtet sich an ein Entwickler-Tool oder einen KI-Assistenten. Wichtig: Er verwendet nur <PIXEL_ID> als Platzhalter und schreibt keine Secret Keys ins Frontend.

Bitte installiere das OpenAI Ads Measurement Pixel auf meiner Website.

Anforderungen:
- Pixel-Basisscript in den HTML-Head bzw. zentralen App-Root einbauen, sodass es auf allen Seiten verfügbar ist.
- Verwende als Platzhalter <PIXEL_ID> und ersetze ihn erst, wenn ich die echte Pixel ID liefere.
- Pixel nur laden/initialisieren, wenn Marketing-Consent aktiv ist.
- Eine zentrale Helper-Funktion erstellen, z. B. measureOpenAiEvent(eventName, data, options).
- custom_event_name muss bei Custom Events als Option/4. Parameter übergeben werden, nicht im Datenobjekt.
- Keine Secret Keys ins Frontend schreiben.
- Danach Beispiel für lead_created, registration_completed und order_created auf Danke-Seiten vorbereiten.
- Build und Browser-Konsole prüfen.

Was später automatisiert werden kann

Die Copy-Prompts sind der erste Schritt. Wenn ein Backend mit Secret Key verfügbar ist, lässt sich daraus ein richtiges Formular bauen:

• Textfeld für Seitenliste: Nutzer fügt die rohe Seitenliste oder sogar einen Sitemap-Export ein.
• Button „Map erstellen“: Das Backend ruft ein LLM auf und validiert das Ergebnis.
• Ergebnis als Conversion Map JSON: Inklusive route, trigger, openai_event, amount_cents, currency, contents und consent_category.
• Pixel/API-Code ausgeben: Für jede Zeile wird ein passendes Pixel-Snippet generiert.
• Wichtig: Der LLM-Aufruf und alle Secret Keys bleiben ausschließlich im Backend. Im Browser landen nur öffentliche Pixel-IDs und fertige Snippets.

Interne Links

• Event-Bibliothek
• Tracking-Wissen
• API-Überblick
• Reporting
• Conversion Map Tool
• Tutorial: Pixel einrichten
• Tutorial: Conversion Map
• Tutorial: Conversions API
• Tutorial: Insights API

Quellen

• OpenAI Ads: Supported Events
• OpenAI Ads: Measurement Pixel
• OpenAI Ads: Conversions API
• OpenAI Ads: Insights API Reference

Häufige Fragen