Fehlerbehebung

Die Verwaltung von Conversions erfordert eine komplexe Integration, die oft mehrere voneinander abhängige Tools und Prozesse umfasst. In diesem Leitfaden finden Sie detaillierte Schritte zur Fehlerbehebung, wenn Sie Fehler von der API erhalten, die Sie nicht verstehen, oder wenn Sie die Messwerte oder Diagnosen in der Benutzeroberfläche nicht nachvollziehen können.

Wichtig : Eine erfolgreiche Importantwort der API bedeutet nicht zwangsläufig, dass die Conversions zugeordnet wurden. Weitere Informationen zu Datenabweichungen nach einem erfolgreichen Import finden Sie im Abschnitt Datenabweichungen nach erfolgreichem Upload.

Messwerte in der Google Ads-Benutzeroberfläche ablesen

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 zur Überprüfung der Importergebnisse zu verwenden. Beginnen Sie mit der Diagnose von Offlinedaten, um den Zustand des Imports zu prüfen. Weitere Informationen zur Diagnose in der Google Ads-Benutzeroberfläche finden Sie unter 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 von erweiterten Conversions für Leads behandelt.

Häufige Fehler

Die folgenden Informationen helfen Ihnen, häufige Fehler bei erweiterten Conversions für Leads zu diagnostizieren und zu beheben.

Fehler
NO_CONVERSION_ACTION_FOUND	Die angegebene Conversion-Aktion ist entweder nicht aktiviert oder kann nicht über das Kundenkonto aufgerufen werden, das im Feld customer_id in der Anfrage angegeben ist. Die Conversion-Aktion in Ihrem Upload muss aktiviert sein und dem Kunden gehören, 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 mit der Ressource click_view prüfen, ob eine GCLID zu einem Kundenkonto gehört. Senden Sie dazu eine Abfrage, die nach click_view.gclid und segments.date filtert, wobei das Datum dem Datum des Klicks entspricht.
INVALID_CONVERSION_ACTION_TYPE	Die angegebene Conversion-Aktion hat einen Typ, der für erweiterte Conversions für Leads nicht gültig ist. Achten Sie darauf, dass die in Ihrer Uploadanfrage angegebene ConversionAction den Typ UPLOAD_CLICKS hat.
CUSTOMER_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS	Achten Sie darauf, dass 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. Hinweis: Behandeln Sie diesen Fehler als Warnung, es sei denn, er tritt bei der Mehrzahl Ihrer Conversions auf. Wenn bei einer Conversion diese Warnung auftritt, wird sie von der Google Ads API in die successful_event_count Ihrer Diagnose für Offlinedaten aufgenommen. Die Google Ads API enthält einen Eintrag für CLICK_NOT_FOUND in der Sammlung alerts, 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. Sie können beispielsweise aus SA360 oder DV360 stammen. Weitere mögliche Ursachen: Der hochladende Kunde unterscheidet sich vom Google Ads-Conversion-Kunden. Das Tagging ist für Ihr Lead-Formular nicht richtig konfiguriert. Die hochgeladenen Daten wurden nicht korrekt normalisiert und gehasht. In seltenen Fällen, in denen der hochladende Kunde nicht mit dem Google Ads-Conversion-Kunden übereinstimmt, kann dieser Fehler bedeuten, dass der hochladende Kunde die Nutzungsbedingungen für Kundendaten akzeptiert hat, der ausliefernde Kunde jedoch nicht. Sie können feststellen, ob die Nutzungsbedingungen für Kundendaten für ein Konto akzeptiert wurden, indem Sie die Ressource customer abfragen und das Feld customer.conversion_tracking_setting.accepted_customer_data_terms 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 unter Datenabweichungen nach erfolgreichem Upload.

• Prüfen Sie, ob das Google-Tag auf Ihrer Webseite korrekt eingerichtet ist und beim Senden von Lead-Formularen ausgelöst wird. Wenn das Tag bei Formulareinreichungen nicht ausgelöst wird oder falsche Daten sendet, ist die Attribution bei hochgeladenen Conversions wahrscheinlich gering oder gar nicht vorhanden. In unseren Hilfeartikeln finden Sie Informationen 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 aufnehmen. Legen Sie dazu für jede Conversion das Feld ClickConversion.gclid fest.

• Prüfen Sie, ob Sie die Einwilligung in Ihren Uploads richtig angeben. Dazu können Sie entweder die Standardeinstellungen für die Einwilligung für Ihr Konto festlegen (klicken Sie in der Google Ads-Benutzeroberfläche auf Tools > Data Manager > Einwilligungseinstellungen) 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 angezeigten Messwerten zufrieden sind, aber nach der Implementierung von erweiterten Conversions für Leads nicht die erwarteten Verbesserungen der Kampagnenleistung oder „Steigerung“ 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 von erweiterten Conversions für das Web behandelt.

Häufige Fehler

Die folgenden Hinweise helfen Ihnen, häufige Fehler bei erweiterten Conversions für das Web zu diagnostizieren und zu beheben.

Fehler
CONVERSION_NOT_FOUND	Für das angegebene Paar aus 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 im customer_id der Anfrage angegeben ist. Prüfen Sie außerdem, ob die Conversion nicht für einen Klick erfolgte, bei dem gbraid oder wbraid anstelle von gclid ausgefüllt wurde. 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 bereits eine Anpassung mit der angegebenen order_id und conversion_action vorgenommen. Geben Sie für jede Conversion eine eindeutige order_id an.
CONVERSION_ACTION_NOT_ELIGIBLE_FOR_ENHANCEMENT	Die angegebene conversion_action ist nicht für erweiterte Conversions für das Web geeignet. Klicken Sie in der Google Ads-Benutzeroberfläche das Kästchen Erweiterte Conversions aktivieren für die Conversion-Aktion an, auf die in Ihrer Anfrage verwiesen wird. Eine Anleitung dazu findest du in der Hilfe.

Allgemeine Probleme bei der Conversion-Verwaltung

Beachten Sie die folgenden häufigen Probleme:

• Wenn Sie versuchen, ein Enum-Feld auf UNKNOWN festzulegen, wird der Fehler RequestError.INVALID_ENUM_VALUE ausgegeben. Das ist ein häufiges Problem, wenn consent angegeben wird, der Werbetreibende aber möglicherweise nicht weiß, ob eine Einwilligung vorliegt. Wenn der Status von consent unbekannt ist, sollte er auf DENIED festgelegt werden.

• Wenn Sie eine Conversion-Aktion für App-Conversions oder Firebase und App-Analysen von Drittanbietern erstellen, 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 Feld ConversionAction.attribution_model_settings.attribution_model nur auf GOOGLE_ADS_LAST_CLICK oder GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN festlegen. 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 beträgt 1 bis 60 Tage für Conversion-Aktionen vom Typ AD_CALL und WEBSITE_CALL. Bei den meisten anderen Conversion-Aktionen liegt der zulässige Bereich zwischen 1 und 90 Tagen.

• Der zulässige Bereich für das Feld view_through_lookback_window_days beträgt für die meisten Conversion-Aktionen 1 bis 30 Tage. Dieses Feld muss für Conversion-Aktionen vom Typ AD_CALL und WEBSITE_CALL nicht festgelegt sein.

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

• Wenn Sie eine Conversion-Aktion vom Typ WEBSITE_CALL oder AD_CALL erstellen, muss die value_settings.always_use_default_value auf true festgelegt werden. Wenn Sie den Wert false angeben, wird der Fehler INVALID_VALUE ausgegeben.

Häufige Fehler

Die folgenden Hinweise helfen Ihnen, häufige Fehler beim Import von Offline-Conversions zu diagnostizieren und zu beheben.

Fehler
INVALID_CONVERSION_ACTION_TYPE	Die angegebene Conversion-Aktion hat einen Typ, der für das Hochladen von Klick-Conversions nicht gültig ist. Achten Sie darauf, dass die in Ihrer Uploadanfrage angegebene ConversionAction den Typ UPLOAD_CLICKS hat.
NO_CONVERSION_ACTION_FOUND	Die angegebene Conversion-Aktion ist entweder nicht aktiviert oder kann im hochladenden customer_id nicht gefunden werden. Rufen Sie Informationen zu Ihrer Conversion-Einrichtung ab, um sicherzustellen, dass die Conversion-Aktion in Ihrem Upload aktiviert ist und dem customer_id der Uploadanfrage gehört.
TOO_RECENT_CONVERSION_ACTION	Die Conversion-Aktion wurde neu erstellt. Warten Sie nach dem Erstellen der Aktion mindestens 6 Stunden, bevor Sie die fehlgeschlagenen Conversions noch einmal hochladen.
INVALID_CUSTOMER_FOR_CLICK	Die customer_id der Anfrage ist nicht die Kundennummer, die zum Zeitpunkt des Klicks das Google Ads API-Conversion-Konto war. Aktualisieren Sie die customer_id der Anfrage auf den richtigen Kunden.
EVENT_NOT_FOUND	Google Ads kann die Kombination aus Klick-ID und customer_id nicht finden. Lesen Sie die Anforderungen für customer_id und prüfen Sie, ob Sie das richtige Google Ads-Konto für den Upload verwenden.
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 wiederholt 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 eine Duplizierung der zuvor hochgeladenen Conversion zu vermeiden.
EVENT_NOT_FOUND	Google Ads kann die Kombination aus Klick-ID und customer_id nicht finden. Lesen Sie die Anforderungen für customer_id und prüfen Sie, ob Sie das richtige Google Ads-Konto für den Upload verwenden.
EXPIRED_EVENT	Der importierte Klick erfolgte vor dem im Feld click_through_lookback_window_days angegebenen Zeitraum. Eine Änderung des click_through_lookback_window_days wirkt sich nur auf Klicks aus, die nach der Änderung erfasst werden. Wenn Sie das Lookback-Window ändern, wird dieser Fehler für den jeweiligen Klick also nicht behoben. Ändern Sie gegebenenfalls die conversion_action in eine andere Aktion mit einem längeren Lookback-Window.
CONVERSION_PRECEDES_EVENT	Der conversion_date_time liegt vor dem Datum und der Uhrzeit des Klicks. Aktualisieren Sie conversion_date_time auf einen späteren Wert.
GBRAID_WBRAID_BOTH_SET	Für ClickConversion ist sowohl für gbraid als auch für wbraid ein Wert festgelegt. Aktualisieren Sie die Conversion so, dass nur eine Klick-ID oder ein URL-Parameter verwendet wird. 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 den location des GoogleAdsError, um festzustellen, welches der folgenden Probleme zu dem Fehler geführt hat. Für ClickConversion ist ein Wert für gclid sowie mindestens ein Wert für gbraid oder wbraid festgelegt. Aktualisieren Sie die Conversion so, dass nur eine Klick-ID oder ein URL-Parameter verwendet wird. 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 ClickConversion ist ein Wert für gbraid oder wbraid und ein Wert für custom_variables festgelegt. Google Ads unterstützt keine benutzerdefinierten Variablen für eine Conversion mit dem URL-Parameter gbraid oder wbraid. Entfernen Sie das Feld custom_variables der Conversion.