OpenAI
Diese Seite wurde maschinell übersetzt. Den Originalartikel auf Englisch ansehen.

Fehlerbehebung beim Conversion-Tracking für ChatGPT Ads

Erfahre, was du als Nächstes tun kannst, wenn Ereignisse fehlen, Anfragen fehlschlagen oder Conversion-Berichte voneinander abweichen.

Aktualisiert: 6 days ago

Überblick

Nutze diese Anleitung, wenn Ereignisse fehlen, Anfragen fehlschlagen oder die Angaben in Ads Manager von deinen Geschäftsunterlagen abweichen. Beginne mit einem einzelnen abgeschlossenen Kauf, einem übermittelten Lead oder einer anderen Aktion. Notiere, was wann passiert ist, und wähle dann unten die passende Frage aus.

Ein Ereignis erfasst eine Aktion, etwa einen Kauf. Der Pixel sendet Ereignisse aus dem Browser der Person, die deine Website besucht. Die Conversions API (CAPI) sendet sie von deinem Server. Ads Manager sammelt diese Ereignisse in einer Datenquelle. Die Attribution bestimmt, welcher Anzeige eine Aktion zugerechnet wird. Ein Attributionsfenster legt fest, wie lange nach einer Anzeigeninteraktion eine Aktion noch zugerechnet werden kann.

Häufig gestellte Fragen

1. Womit sollte ich anfangen?

Kläre, welche Aktion du messen möchtest, wodurch sie übermittelt wird und welches Werbekonto und welche Pixel-ID verwendet werden. Deine Einrichtung kann den Pixel, CAPI, eine Partnerintegration oder eine Kombination daraus nutzen. CAPI benötigt eine Pixel-ID, auch wenn du den Browser-Pixel nicht installiert hast.

Informationen zur Ersteinrichtung findest du in den Anleitungen Conversion-Messung und Conversion-Tracking. Die für die Entwicklung zuständige Person kann die Anleitungen zu Pixel, CAPI und unterstützten Ereignissen nutzen. Führe CAPI-Anfragen nur auf deinem Server aus und bewahre die Schlüssel dort auf.

Wenn ein Partnerunternehmen deine Integration verwaltet, nutze die Einrichtungsanleitung für Messpartner oder die Einrichtungsanleitung für mobile Messpartner. Informationen zur HubSpot-Anbindung findest du in der Anleitung ChatGPT Ads in HubSpot einrichten.

Prüfe bei einer bestehenden Einrichtung jeden Schritt:

  • Wurde durch die Aktion eine Ereignisanfrage gesendet?

  • Hat die Anfrage einen Fehler zurückgegeben oder wurde sie akzeptiert?

  • Kannst du bestätigen, dass die richtige Datenquelle das Ereignis empfangen hat?

  • Wurde das Ereignis im Kampagnenbericht einer Anzeige zugerechnet?

2. Mein Pixel ist installiert. Warum sehe ich keine Käufe oder Leads?

Der Pixel kann geladen werden, ohne das benötigte Kauf- oder Lead-Ereignis zu senden. Bitte die für die Entwicklung zuständige Person, eine einzelne abgeschlossene Aktion zu prüfen:

  • Prüfe den Ereignisnamen, die Pixel-ID und die Seite oder den Callback, die das Ereignis senden. Ein Seitenaufruf ist kein abgeschlossener Kauf.

  • Stelle sicher, dass der Pixel vor dem Senden des Ereignisses initialisiert wird, auch wenn ein Tag-Manager ihn lädt.

  • Prüfe die Browserkonsole und die Netzwerkanfrage. Die Meldung „ausgelöst“ eines Tag-Managers allein bestätigt nicht, dass das Ereignis gesendet wurde. Der Debug-Modus des Pixels kann dabei helfen.

  • Prüfe, ob Einwilligungseinstellungen, Blockierungen durch den Browser oder die Sicherheitsrichtlinie deiner Website die Anfrage verhindert haben.

  • Prüfe Seiten, die eine Anmeldung erfordern, den Checkout, Buchungsseiten, Weiterleitungen und eingebettete Formulare. Ein funktionierender Pixel auf der Landingpage bestätigt nicht, dass das Tracking auch an anderer Stelle funktioniert.

Wenn keine Anfrage gesendet wurde, behebe zuerst diesen Schritt. Auf den Bericht zu warten, hilft hier nicht. Nutze die Anleitung zur Fehlerbehebung beim Pixel, bevor du eine weitere Integration hinzufügst.

3. Was sollte ich tun, wenn ein Ereignis abgelehnt wird, eine Zeitüberschreitung auftritt oder ein Serverfehler zurückgegeben wird?

Speichere den Antwortcode, den genauen Fehler, den Zeitpunkt der Anfrage und die Ereignis-ID. Bitte die für die Entwicklung zuständige Person, das Ereignisformat, die Pixel-ID und den Schlüssel zu prüfen. CAPI-Ereignisanfragen verwenden einen Schlüssel für die Conversions API, der zum selben Werbekonto gehört. Anfragen zur Einrichtung, Verwaltung und Berichterstellung verwenden den separaten Schlüssel für die Advertiser API. Sende keine API-Schlüssel an den Support.

Bei CAPI-Stapelanfragen kann ein einzelnes ungültiges Ereignis dazu führen, dass der gesamte Stapel fehlschlägt.

CAPI benötigt den ursprünglichen Zeitpunkt der Aktion als Unix-Zeitstempel in Millisekunden. Das Ereignis darf höchstens 7 Tage zurückliegen und nicht mehr als 10 Minuten in der Zukunft liegen. Diese zeitliche Grenze für die Übermittlung ist unabhängig vom Attributionsfenster. Ändere nicht den Zeitpunkt eines alten Ereignisses, damit es akzeptiert wird.

Bei einer Zeitüberschreitung oder einem Serverfehler kann unklar bleiben, ob das Ereignis angekommen ist. Prüfe die ursprüngliche Anfrage und alle vorhandenen Empfangsprotokolle. Wenn du dieselbe Aktion erneut übermittelst, behalte ihre ursprüngliche Ereignis-ID und ihren Zeitstempel bei. Mit einer neuen ID könnte sie als weitere Aktion erscheinen.

Gehe einer Ablehnung oder wiederholt fehlschlagenden Anfragen umgehend nach. Die geschätzten 24–48 Stunden bis zur Anzeige im Bericht gelten nicht für diese Fehler. Die Anforderungen an Anfragen findest du in der Anleitung zur Conversions API.

4. Ich sehe, dass das Ereignis akzeptiert wurde. Warum erscheint es nicht im Bericht?

Dass ein Ereignis akzeptiert wurde, bedeutet nicht, dass es einer Anzeige zugerechnet wurde. Prüfe, was die Antwort bestätigt und ob die Anfrage die richtige Datenquelle verwendet hat. Wenn validate_only in CAPI auf true gesetzt ist, werden die Ereignisse geprüft, aber nicht gespeichert.

Bei einem neuen Ereignis kann die für die Entwicklung zuständige Person die letzten Ereignisse prüfen, sofern verfügbar. Dort wird eine aktuelle Stichprobe angezeigt, kein vollständiger Verlauf und kein Attributionsergebnis.

Wenn du den Empfang nicht prüfen kannst, kontaktiere den Support und füge die ursprüngliche Antwort sowie ein Beispielereignis bei. Teile uns mit, welche Prüfungen du abgeschlossen hast. Du musst nicht erst die Ursache finden.

Wenn der Empfang bestätigt ist, fahre mit Frage 5 fort. Sende das Ereignis nicht mit neuen IDs erneut, nur weil sich der Kampagnenbericht noch nicht geändert hat.

Es kann etwa 24–48 Stunden dauern, bis zugerechnete Conversions erscheinen. Aktuelle Gesamtzahlen können sich während der Verarbeitung ändern. Das garantiert weder, dass jedes akzeptierte Ereignis erscheint, noch bestätigt es dessen Empfang. Siehe dazu Ergebnisse messen.

5. Ereignisse werden empfangen. Warum zeigt die Kampagne trotzdem null Conversions?

Prüfe Folgendes, bevor du die Integration änderst:

  • Ist die vorgesehene Datenquelle mit dem richtigen Konto verbunden?

  • Stimmt das gesendete Ereignis mit der Conversion-Einstellung der Kampagne überein? Prüfe bei benutzerdefinierten Ereignissen den benutzerdefinierten Typ und den genauen Ereignisnamen. Eine übereinstimmende angezeigte Bezeichnung reicht nicht aus.

  • War der Kampagne bereits vor der geprüften Aktivität die richtige Conversion zugeordnet?

  • Erfolgte die Aktion nach einem Anzeigenklick oder einer Anzeigenansicht, die gemäß den Attributionseinstellungen anrechenbar sind?

  • Hast du die richtige Kampagne, Ereignisspalte, Datumsangabe und Zeitbasis für den Bericht ausgewählt?

Abgleichsdaten helfen, ein Ereignis mit einer Anzeige zu verknüpfen, garantieren aber keine Zurechnung. Behalte die tatsächliche OpenAI-Klickreferenz oppref während des gesamten Besuchs bei und füge sie Server-Ereignissen hinzu, sofern sie verfügbar ist. Erfinde niemals eine Referenz und verwende nicht die einer anderen Person.

Prüfe Browser- und Server-Ereignisse getrennt. Eine Referenz oder ein Kundendatenfeld, die dem Pixel zur Verfügung stehen, können im Server-Ereignis fehlen.

Das ausgewählte Ziel einer conversionoptimierten Kampagne lässt sich nach ihrer Erstellung nicht mehr ändern. Erstelle eine neue Kampagne, um ein anderes Ziel zu verwenden. Benutzerdefinierte Ereignisse können nicht als Optimierungsziele verwendet werden. Siehe dazu Conversionoptimierte Kampagnen.

Prüfe nach dem Beheben einer Konfigurationsabweichung neue anrechenbare Aktivitäten. Gehe nicht davon aus, dass die Änderung frühere Berichte korrigiert. Die Regeln für den Abgleich findest du in der Anleitung zur Conversion-Messung.

6. Warum zeigen Ads Manager, unser Analysetool und unser CRM unterschiedliche Ergebnisse?

Vergleiche dieselben Aktionen anhand derselben Berichtsregeln. Dein CRM zählt möglicherweise jeden Kauf. Ein Anzeigenbericht zählt Käufe, die der jeweiligen Plattform zugerechnet werden. Verschiedene Plattformen können denselben Kauf unterschiedlich zurechnen.

In Ads Manager umfasst Conversions sowohl Click-through-Conversions als auch anrechenbare View-through-Conversions, wenn das View-through-Berichtsfenster auf 1 Tag eingestellt ist. Bei einem View-through-Fenster von 0 Tagen werden nur Click-through-Conversions gezählt. Verwende beim Vergleich von Berichten dieselbe Einstellung.

Beispielsweise klickt jemand auf eine Anzeige, kehrt später direkt zur Website zurück und kauft etwas. Ein Tool kennzeichnet den Besuch möglicherweise als „Direkt“, während ein anderes den Kauf der früheren Anzeige zurechnet. Dieser Unterschied allein bedeutet nicht, dass der Kauf doppelt gezählt wurde.

Wenn die Bezeichnungen der Traffic-Quellen abweichen, prüfe die beim Besuch verwendete Ziel-URL und die Tracking-Parameter. Die aktuellen Kampagneneinstellungen können von den früher verwendeten abweichen.

Vergleiche:

  • Konto, Kampagne, Ereignistyp, Filter und Berichtsebene.

  • Datumsbereich, Zeitzone und ob sich die Datumsangaben auf die Anzeigeninteraktion oder die Conversion selbst beziehen.

  • Click-through- und View-through-Einstellungen sowie die genau ausgewählte Kennzahl oder Spalte.

  • Aktuelle Verarbeitungsverzögerungen, Umgang mit Duplikaten, Einwilligung und verfügbare Abgleichsdaten.

  • Modellierte Conversions, sofern verfügbar, die von direkt erfassten Transaktionen abweichen können.

  • Bei Werten: Währung, Einheiten und ob der Vergleich die gesamte Bestellung oder einzelne Artikel berücksichtigt.

Vergleiche beim Umsatz Steuern, Versandkosten, Rabatte und Gebühren. Prüfe, ob die Browser- und Server-Kopien denselben Bestellwert übermitteln. Umsatz aus erstellten Bestellungen und ROAS aus erstellten Bestellungen berücksichtigen nur zugerechnete order_created-Ereignisse.

Importierte GA4-Aktivitäten umfassen Ereignisse aus allen Traffic-Quellen der ausgewählten Property. Diese Gesamtzahlen sind keine kampagnenbezogen zugerechneten Conversions. Siehe dazu Google Analytics 4 mit OpenAI Ads Manager verbinden.

Notiere für API-Vergleiche den Endpunkt und lege die Berichtsoptionen ausdrücklich fest. Eine nicht angegebene Einstellung stimmt möglicherweise nicht mit Ads Manager überein. Berichte können auch unterschiedliche Ereignisse enthalten: Manche erfassen Kampagnenziele, aber keine anderen nachverfolgten Aktionen. Wenn ein Ereignis in einem Bericht fehlt, beweist das nicht, dass es nie empfangen wurde.

Verwende für einen CSV-Vergleich dieselben Einstellungen und bewahre die unveränderten Exporte auf. Informationen zu den Ansichten in Ads Manager findest du in Ergebnisse messen, Informationen zu API-Optionen in Berichterstellung.

7. Wird ein Kauf doppelt gezählt, wenn ich den Pixel und CAPI nutze?

Damit dieselbe Aktion nicht doppelt gezählt wird, verwende in der Browser- und Server-Kopie dieselbe Pixel-ID, denselben Ereignisnamen und dieselbe Ereignis-ID. Das Feld für die Ereignis-ID heißt in CAPI id und im Pixel event_id. Verwende auch auf beiden Seiten denselben benutzerdefinierten Ereignisnamen.

Behalte beim erneuten Übermitteln einer Aktion dieselbe ID bei. Verwende für jede andere Aktion eine neue ID. Prüfe, ob doppelte Tags, wiederholte Seitenladevorgänge oder Callback-Aufrufe vorliegen und ob Partnerintegrationen das Ereignis möglicherweise bereits senden.

Sende kein Duplikat, um den Wert oder die Abgleichsdaten des ursprünglichen Ereignisses zu ändern. Prüfe das dokumentierte Verhalten, bevor du eine Korrektur versuchst. Siehe dazu die Anleitung zur Deduplizierung von Browser- und Server-Ereignissen.

8. Wir nutzen Shopify. Brauchen wir eine weitere Integration?

Prüfe deine Shopify-Anbindung, bevor du eine weitere Integration hinzufügst. Prüfe das verbundene Werbekonto und den Pixel. Prüfe anschließend, welche Ereignisse die App für deinen Shop sendet.

Wenn du außerdem benutzerdefinierte Tags, Checkout-Code oder eine serverseitige Übermittlung nutzt, prüfe, ob darüber dieselben Ereignisse gesendet werden. Shopify-Einrichtungen können Browser- und Server-Tracking unterschiedlich kombinieren. Siehe dazu ChatGPT Ads für Shopify einrichten.

9. Wie sollten wir mit Einwilligungen und Tests umgehen?

Sende nur Daten, die du weitergeben darfst, und respektiere die Einwilligungsentscheidungen der Personen, die deine Website besuchen. Die für die Entwicklung zuständige Person sollte die Vorgaben der Integration zu Einwilligungen und unterstützten Abgleichsdaten befolgen, einschließlich erforderlicher Normalisierung und Hashing. Entferne keine Einwilligungskontrollen, um die Zahl der gemeldeten Conversions zu erhöhen oder einen Bewertungswert zu verbessern.

Die Einwilligung zur Messung und opt_out dienen unterschiedlichen Zwecken. Die Option opt_out betrifft die Personalisierung. Sie unterbindet nicht alle Messanfragen. Bitte die für die Entwicklung zuständige Person, die Handhabung von Einwilligungen sowohl in Browser- als auch in Server-Integrationen zu prüfen.

Notiere Zeitpunkt, Namen und ID einer einzelnen Testaktion. Prüfe, ob sie gesendet, validiert und empfangen wurde. Ein erfolgreicher Implementierungstest zeigt nicht, dass eine Aktion einer Anzeige zugerechnet werden kann.

Die CAPI-Option validate_only prüft Ereignisse, ohne sie zu speichern. Der Debug-Modus des Pixels protokolliert Aktivitäten, schließt Testereignisse aber nicht aus Berichten aus. Kennzeichne Tests in deinen Aufzeichnungen. Erfinde keine Käufe und ändere keine Ereigniszeitpunkte, um ein Ergebnis zu erzwingen.

10. Bedeutet ein niedriger oder nicht verfügbarer Ereignisqualitätswert, dass das Tracking nicht funktioniert?

Nicht allein deswegen. Die Ereignisqualität bewertet die Informationen, die von einer Datenquelle empfangen wurden. Sie sagt nicht aus, wie viele Conversions einer Anzeige zugerechnet wurden. Ein niedriger oder nicht verfügbarer Wert allein zeigt nicht, ob das Tracking funktioniert.

Prüfe, ob aktuelle tatsächliche Aktionen korrekt erfasst werden, und gehe dann der Warnung nach. Sende keine zusätzlichen Ereignisse oder erfundenen Kennungen, um den Wert zu erhöhen. Informationen zu Prüfungen und Aktualisierungsintervallen findest du in Ereignisqualität verstehen und verbessern.

11. Welche Angaben sollte ich machen, wenn ich den Support kontaktiere?

Beschreibe, was du erwartet hast, was passiert ist, wann es angefangen hat und was du geprüft hast. Füge die Angaben aus dieser Liste hinzu, die dir vorliegen:

  • Werbekonto-ID, Pixel-ID oder Datenquelle sowie die Kennungen der betroffenen Kampagnen und Anzeigen.

  • Integrationstyp und genauer Ereignisname, gegebenenfalls einschließlich des benutzerdefinierten Ereignisnamens.

  • Ein oder zwei vorhandene Ereignis-IDs als Beispiele und die Zeitstempel der Aktionen mit Zeitzone.

  • Bei fehlgeschlagenen Anfragen oder unklarem Empfang: Antwortcode, genauer Fehler, Zeitpunkt der Anfrage, gegebenenfalls zurückgegebene Anfrage-ID oder CF-Ray sowie eine Payload oder ein Protokollauszug mit geschwärzten vertraulichen Angaben.

  • Bei Abweichungen in Berichten: Datumsbereich, Zeitbasis des Berichts, Attributionseinstellungen, ausgewählte Spalten, CSV-Export und ein Vergleich mit demselben Umfang.

  • Relevante Screenshots und kürzlich vorgenommene Änderungen an der Einrichtung, einschließlich eines separaten Checkouts oder einer Partnerintegration.

Teile uns mit, ob du bestätigt hast, dass das Ereignis gesendet, akzeptiert oder empfangen wurde, oder ob du nur den Bericht geprüft hast. Du kannst auch dann um Hilfe bitten, wenn du diese Prüfungen nicht abschließen kannst.

Entferne API-Schlüssel, Autorisierungsheader, Passwörter, Cookies und nicht benötigte Kundendaten aus den Anhängen. Melde Fehler oder den plötzlichen Ausfall einer zuvor funktionierenden Integration umgehend. Warte nicht, bis die übliche Zeit bis zur Anzeige im Bericht verstrichen ist.

War dieser Artikel hilfreich?