Fehlerbehebung

Die Verwaltung von Conversions erfordert eine komplexe Integration, die oft mehrere voneinander abhängige Tools und Prozesse umfasst. In diesem Leitfaden finden Sie eine detaillierte Anleitung zur Fehlerbehebung bei Problemen, z. B. wenn Sie Fehlermeldungen von der API erhalten, die Sie nicht verstehen, oder wenn Sie sich über die Messwerte oder Diagnosen in der Benutzeroberfläche wundern.

Messwerte in der Google Ads-Benutzeroberfläche lesen

In der Google Ads-Benutzeroberfläche werden Conversion-Messwerte nicht nach Importdatum sortiert. Daher kann es irreführend sein, die Berichte in der Benutzeroberfläche zu verwenden, um die Import-Ergebnisse zu überprüfen. Wenn Sie den Importstatus überprüfen möchten, beginnen Sie mit der Offline-Diagnose. Weitere Informationen zur Diagnose in der Google Ads-Benutzeroberfläche für erweiterte Conversions für Leads und erweiterte Conversions für das Web.

Probleme mit erweiterten Conversions für Leads

In diesem Abschnitt werden häufige Probleme beim Importieren erweiterter Conversions für Leads behandelt.

Häufige Fehler

Fehler
NO_CONVERSION_ACTION_FOUND

Die angegebene Conversion-Aktion ist entweder nicht aktiviert oder kann nicht vom Client konto aufgerufen werden, das im Feld `client_id` der Anfrage angegeben ist. Prüfen Sie, ob die Conversion-Aktion in Ihrem Upload aktiviert ist und dem Kunden gehört, der die Uploadanfrage sendet.

Dieser Fehler kann auch auftreten, wenn die GCLID in der Anfrage zu einem Kundenkonto gehört, das keinen Zugriff auf die in der Anfrage angegebene Conversion-Aktion hat. Sie können prüfen, ob eine GCLID zu einem Kundenkonto gehört, indem Sie die click_view Ressource abfragen und nach click_view.gclid und segments.date filtern. Das Datum ist das Datum, an dem der Klick erfolgt ist.

INVALID_CONVERSION_ACTION_TYPE Die angegebene Conversion-Aktion hat einen Typ, der für erweiterte Conversions für Leads nicht gültig ist. Prüfen Sie, ob die ConversionAction in Ihrer Uploadanfrage den Typ UPLOAD_CLICKS hat.
CUSTOMER_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS Prüfen Sie, ob Sie in den Conversion-Einstellungen erweiterte Conversions für Leads aktiviert haben. Eine Anleitung dazu finden Sie im Leitfaden zu den Voraussetzungen.
DUPLICATE_ORDER_ID Die importierten Ereignisse umfassen mehrere Conversions mit derselben Bestell-ID und wurden nicht verarbeitet. Vergewissern Sie sich, dass die Bestell-IDs eindeutig sind, und versuchen Sie es noch einmal.
CLICK_NOT_FOUND Es wurde kein Klick gefunden, der mit den angegebenen Nutzer-IDs übereinstimmt. Die Google Ads API gibt diesen Fehler nur zurück, wenn debug_enabled auf true in der UploadClickConversionsRequest gesetzt ist.

Wenn bei einer Conversion diese Warnung auftritt, wird sie von der Google Ads API in die successful_event_count der Offlinedaten-Diagnose aufgenommen. Die Google Ads API enthält einen Eintrag für CLICK_NOT_FOUND in der alerts Sammlung, damit Sie die Häufigkeit dieser Warnung im Blick behalten können.

Dieser Fehler ist zu erwarten, wenn der Klick nicht aus einer Google Ads-Kampagne stammt. Er kann beispielsweise aus SA360 oder DV360 stammen. Weitere mögliche Ursachen:

In seltenen Fällen, in denen der Kunde, der den Upload durchführt, nicht derselbe ist wie der Google Ads Conversion-Kunde, kann dieser Fehler bedeuten, dass der Kunde, der den Upload durchführt, die Nutzungsbedingungen für Kundendaten akzeptiert hat, der Conversion-Kunde jedoch nicht.

Sie können feststellen, ob ein Konto die Nutzungsbedingungen für Kundendaten akzeptiert hat, indem Sie die customer Ressource abfragen und das customer.offline_conversion_tracking_info.accepted_customer_data_terms Feld prüfen.

Abweichungen bei Messwerten

Beachten Sie die folgenden häufigen Probleme:

  • Conversions können aus verschiedenen Gründen von unserer Verarbeitungspipeline verworfen werden. Solche Conversions können nicht wiederhergestellt werden. Weitere Informationen finden Sie im Artikel Datenabweichungen nach erfolgreichem Upload.

  • Prüfen Sie, ob das Google-Tag auf Ihrer Webseite richtig eingerichtet ist und bei der Übermittlung von Lead-Formularen ausgelöst wird. Wenn Ihr Tag bei der Übermittlung von Formularen nicht ausgelöst wird oder falsche Daten sendet, werden bei hochgeladenen Conversions wahrscheinlich nur wenige oder gar keine Zuordnungen angezeigt. Weitere Informationen finden Sie in unseren Hilfeartikeln zum Konfigurieren des Google-Tags und zum Konfigurieren von Google Tag Manager für erweiterte Conversions für Leads.

  • Wenn Sie erweiterte Conversions für Leads ohne das Google-Tag auf Ihrer Webseite verwenden, müssen Sie die GCLID in Ihre Conversion-Importe einbeziehen, indem Sie das Feld ClickConversion.gclid für jede Conversion festlegen.

  • Prüfen Sie, ob Sie in Ihren Uploads die Einwilligung richtig angeben. Dazu können Sie dies tun, indem Sie entweder die Standardeinstellungen für die Einwilligung für Ihr Konto festlegen (klicken Sie in der Google Ads-Benutzeroberfläche auf Tools -> Datenverwaltung -> Einstellungen für die Einwilligung) oder das Feld ClickConversion.consent für jede hochgeladene Conversion festlegen.

Probleme mit der Kampagnenleistung

Wenn Sie keine technischen Probleme beim Hochladen Ihrer Conversions haben und mit den präsentierten Messwerten zufrieden sind, aber nach der Implementierung erweiterter Conversions für Leads nicht die erwarteten Verbesserungen der Kampagnenleistung oder den erwarteten Lift sehen, wenden Sie sich an den Google Ads-Produktsupport.

Probleme mit erweiterten Conversions für das Web

In diesem Abschnitt werden häufige Probleme beim Importieren erweiterter Conversions für das Web behandelt.

Häufige Fehler

Fehler
CONVERSION_NOT_FOUND Für die angegebene Conversion-Aktion und Conversion-ID oder order_id wurde keine Conversion gefunden. Prüfen Sie, ob es sich um eine Google Ads-Conversion für den Google Ads-Conversion-Kunden handelt, der in der customer_id der Anfrage angegeben ist.
Prüfen Sie außerdem, ob die Conversion nicht für einen Klick erfolgt ist, bei dem anstelle von gclid die Parameter gbraid oder wbraid verwendet wurden. Google Ads unterstützt für diese Conversions keine erweiterten Conversions für das Web.
CUSTOMER_NOT_ACCEPTED_CUSTOMER_DATA_TERMS Die Nutzungsbedingungen für Kundendaten wurden für die customer_id der Anfrage nicht akzeptiert. Eine Anleitung dazu finden Sie im Leitfaden zu den Voraussetzungen.
CONVERSION_ALREADY_ENHANCED Für diese Conversion wurde mit den angegebenen order_id und conversion_action bereits eine Anpassung vorgenommen. Geben Sie für jede Conversion eine eindeutige order_id an.
CONVERSION_ACTION_NOT_ELIGIBLE_FOR_ENHANCEMENT Das angegebene conversion_action ist für erweiterte Conversions für das Web nicht geeignet. Prüfen Sie in der Google Ads-Benutzeroberfläche, ob das Kästchen Turn on erweiterte Conversions für die Conversion-Aktion angeklickt ist, auf die in Ihrer Anfrage verwiesen wird. Eine Anleitung dazu finden Sie in der Google Ads-Hilfe.

Allgemeine Probleme bei der Conversion-Verwaltung

Beachten Sie die folgenden häufigen Probleme:

  • Wenn Sie versuchen, ein Enum-Feld auf UNKNOWN zu setzen, wird der Fehler RequestError.INVALID_ENUM_VALUE ausgegeben. Dies ist ein häufiges Problem, wenn Sie consent angeben, der Werbetreibende aber möglicherweise nicht weiß, ob eine Einwilligung erteilt wurde. Wenn der Status von consent unbekannt ist, sollte er auf DENIED gesetzt werden.

  • Wenn Sie eine Conversion-Aktion für App-Conversions oder Firebase und App-Analysetools von Drittanbieternerstellen, können Sie das Feld app_id nur beim Erstellen ändern. Nachdem die Conversion-Aktion erstellt wurde, kann dieses Feld nicht mehr geändert werden.

  • Beim Erstellen einer Conversion-Aktion können Sie das ConversionAction.attribution_model_settings.attribution_model Feld nur auf GOOGLE_ADS_LAST_CLICK oder GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVENsetzen. Jede andere Option führt zu einem CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELS Fehler. Weitere Informationen finden Sie in unserem Blogpost zur Einstellung anderer Attributionsmodelle.

  • Der zulässige Bereich für das Feld click_through_lookback_window_days ist für Conversion-Aktionen vom Typ AD_CALL und WEBSITE_CALL [1, 60]. Für die meisten anderen Conversion-Aktionen ist der zulässige Bereich [1, 30].

  • Der zulässige Bereich für das Feld view_through_lookback_window_days ist für die meisten Conversion-Aktionen [1, 30]. Dieses Feld muss für Conversion-Aktionen vom Typ AD_CALL und WEBSITE_CALL nicht festgelegt sein.

  • Wenn Sie das Feld include_in_conversion_metrics für eine Conversion-Aktion festlegen oder aktualisieren, wird der Fehler FieldError.IMMUTABLE_FIELD ausgegeben. Legen Sie stattdessen das primary_for_goal Feld fest, wie im Leitfaden zu Conversion-Zielvorhaben beschrieben.

  • Beim Erstellen einer Conversion-Aktion vom Typ WEBSITE_CALL oder AD_CALL muss value_settings.always_use_default_value auf true gesetzt werden. Wenn Sie den Wert false angeben, wird der Fehler INVALID_VALUE ausgegeben.

Häufige Fehler

Fehler
INVALID_CONVERSION_ACTION_TYPE Die angegebene Conversion-Aktion hat einen Typ der für den Upload von Klick-Conversions nicht gültig ist. Prüfen Sie, ob die ConversionAction in Ihrer Uploadanfrage angegebene den Typ UPLOAD_CLICKS hat.
NO_CONVERSION_ACTION_FOUND Die angegebene Conversion-Aktion ist entweder nicht aktiviert oder kann in der hochladenden customer_id nicht gefunden werden. Rufen Sie Informationen zu Ihrer Conversion-Einrichtung ab um zu prüfen, ob die Conversion-Aktion in Ihrem Upload aktiviert ist und der customer_id der Uploadanfrage gehört.
TOO_RECENT_CONVERSION_ACTION Die Conversion-Aktion wurde erst kürzlich erstellt. Warten Sie nach dem Erstellen der Aktion mindestens sechs Stunden, bevor Sie die fehlgeschlagenen Conversions noch einmal versuchen.
INVALID_CUSTOMER_FOR_CLICK Die customer_id der Anfrage ist nicht dieselbe Kundennummer , die zum Zeitpunkt des Klicks das Google Ads API-Conversion-Konto war. Aktualisieren Sie die customer_id von der Anfrage auf den richtigen Kunden.
EVENT_NOT_FOUND Google Ads kann die Kombination aus Klick-ID und customer_id nicht finden. Prüfen Sie die Anforderungen für customer_id und bestätigen Sie, dass Sie den Upload mit dem richtigen Google Ads-Konto durchführen.
DUPLICATE_CLICK_CONVERSION_IN_REQUEST Mehrere Conversions in der Anfrage haben dieselbe Kombination aus Klick-ID, conversion_date_time und conversion_action. Entfernen Sie doppelte Conversions aus Ihrer Anfrage.
CLICK_CONVERSION_ALREADY_EXISTS Eine Conversion mit derselben Kombination aus Klick-ID, conversion_date_time, und conversion_action wurde bereits hochgeladen. Ignorieren Sie diesen Fehler, wenn Sie den Upload noch einmal versucht haben und diese Conversion zuvor erfolgreich war. Wenn Sie zusätzlich zur zuvor hochgeladenen Conversion eine weitere Conversion hinzufügen möchten, passen Sie die conversion_date_time der ClickConversion an, um zu vermeiden, dass die zuvor hochgeladene Conversion dupliziert wird.
EVENT_NOT_FOUND Google Ads kann die Kombination aus Klick-ID und customer_id nicht finden. Prüfen Sie die Anforderungen für customer_id und bestätigen Sie, dass Sie den Upload mit dem richtigen Google Ads-Konto durchführen.
EXPIRED_EVENT Der importierte Klick erfolgte vor dem im Feld click_through_lookback_window_days angegebenen Zeitraum. Eine Änderung an click_through_lookback_window_days wirkt sich nur auf Klicks aus, die nach der Änderung erfasst wurden. Daher würde eine Änderung des Lookback-Windows diesen Fehler für den jeweiligen Klick nicht beheben. Ändern Sie gegebenenfalls die conversion_action in eine andere Aktion mit einem längeren Lookback window.
CONVERSION_PRECEDES_EVENT Die conversion_date_time liegt vor dem Datum und der Uhrzeit des Klicks. Aktualisieren Sie die conversion_date_time auf einen späteren Wert.
GBRAID_WBRAID_BOTH_SET Für die ClickConversion wurde ein Wert für gbraid und wbraid festgelegt. Aktualisieren Sie die Conversion so, dass nur eine Klick-ID oder ein URL-Parameter verwendet wird, und achten Sie darauf, dass Sie nicht mehrere Klicks in derselben Conversion kombinieren. Jeder Klick hat nur eine Klick-ID oder einen URL-Parameter.
VALUE_MUST_BE_UNSET Prüfen Sie die location des GoogleAdsError um zu ermitteln, welches der folgenden Probleme zu dem Fehler geführt hat.
  • Für die ClickConversion wurde ein Wert für gclid sowie für mindestens einen der Parameter gbraid oder wbraid festgelegt. Aktualisieren Sie die Conversion so, dass nur eine Klick-ID oder ein URL-Parameter verwendet wird, und achten Sie darauf, dass Sie nicht mehrere Klicks in derselben Conversion kombinieren. Jeder Klick hat nur eine Klick-ID oder einen URL-Parameter.
  • Für die ClickConversion wurde ein Wert für entweder gbraid oder wbraid und ein Wert für custom_variables festgelegt. Google Ads unterstützt keine benutzerdefinierten Variablen für eine Conversion mit einem gbraid oder wbraid URL Parameter. Entfernen Sie die Festlegung des Felds custom_variables für die Conversion.