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 Probleme haben, z. B. wenn Sie unverständliche Fehlermeldungen von der API erhalten oder wenn Sie sich nicht sicher sind, was die Messwerte oder Diagnosen in der Benutzeroberfläche bedeuten.

Wichtig :Eine erfolgreiche Importantwort von der API bedeutet nicht unbedingt, dass die Conversions zugeordnet wurden. Weitere Informationen zu Datenabweichungen nach einem erfolgreichen Import

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. Um den Importstatus zu prüfen, beginnen Sie mit der Offlinediagnose. 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 geht es um die Behebung häufiger Probleme beim Importieren von erweiterten Conversions für Leads.

Häufige Fehler

Fehler
NO_CONVERSION_ACTION_FOUND	Die angegebene Conversion-Aktion ist entweder nicht aktiviert oder kann nicht über das Kundenkonto aufgerufen werden, das im Feld „client_id“ 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 der GCLID-Wert 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 Ressource click_view verwenden und eine Abfrage senden, die nach click_view.gclid und segments.date gefiltert wird. Das Datum muss dabei das Datum des Klicks sein.
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 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 für UploadClickConversionsRequest auf true festgelegt ist. Hinweis:Behandeln Sie diesen Fehler als Warnung, sofern er nicht bei der Mehrzahl Ihrer Conversions auftritt. Wenn bei einer Conversion diese Warnung angezeigt wird, wird sie in 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 wird erwartet, wenn der Klick nicht aus einer Google Ads-Kampagne stammt. Sie kann beispielsweise aus SA360 oder DV360 stammen. Weitere mögliche Ursachen: Der Kunde, der die Daten hochlädt, ist nicht derselbe wie der Google Ads-Conversion-Kunde. 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 sich der Kunde, der die Daten hochlädt, vom Google Ads-Conversion-Kunden unterscheidet, kann dieser Fehler bedeuten, dass der Kunde, der die Daten hochlädt, die Nutzungsbedingungen für Kundendaten akzeptiert hat, der Kunde, der die Daten verwendet, jedoch nicht. Ob ein Konto die Nutzungsbedingungen für Kundendaten akzeptiert hat, können Sie ermitteln, indem Sie die Ressource customer abfragen und das Feld customer.offline_conversion_tracking_info.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 im Artikel Datenabweichungen nach erfolgreichem Upload.

• Prüfen Sie, ob das Google-Tag korrekt auf Ihrer Webseite eingerichtet ist und bei gesendeten Lead-Formularen ausgelöst wird. Wenn Ihr Tag nicht bei Formulareinsendungen ausgelöst wird oder falsche Daten sendet, ist die Attribution bei hochgeladenen Conversions wahrscheinlich gering oder gar nicht vorhanden. In unseren Hilfeartikeln Google-Tag konfigurieren und Google Tag Manager konfigurieren finden Sie weitere Informationen zum Einrichten erweiterter 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 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 präsentierten Messwerten zufrieden sind, aber nach der Implementierung von erweiterten Conversions für Leads nicht die erwarteten Verbesserungen der Kampagnenleistung oder des Kampagnen-„Lift“ sehen, wenden Sie sich an den Google Ads-Produktsupport.

Probleme mit erweiterten Conversions für das Web

In diesem Abschnitt geht es um die Behebung häufiger Probleme beim Importieren erweiterter Conversions für das Web.

Häufige Fehler

Fehler
CONVERSION_NOT_FOUND	Für die angegebene Conversion-Aktion und das Conversion-ID-Paar oder order_id wurde keine Conversion gefunden. Prüfen Sie, ob die Conversion eine Google Ads-Conversion für den im customer_id der Anfrage angegebenen Google Ads-Conversion-Kunden ist. Prüfen Sie außerdem, ob die Conversion nicht für einen Klick erfolgt ist, bei dem gbraid oder wbraid anstelle von gclid ausgefüllt wurde. Erweiterte Conversions für das Web werden für diese Conversions in Google Ads nicht unterstützt.
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 Voraussetzungen.
CONVERSION_ALREADY_ENHANCED	Für diese Conversion wurde bereits eine Anpassung mit den angegebenen order_id und conversion_action vorgenommen. Geben Sie für jede Conversion einen eindeutigen order_id an.
CONVERSION_ACTION_NOT_ELIGIBLE_FOR_ENHANCEMENT	Die angegebene conversion_action kommt nicht für erweiterte Conversions für das Web infrage. Achten Sie darauf, dass Sie in der Google Ads-Benutzeroberfläche das Kästchen Erweiterte Conversions aktivieren für die in Ihrem Antrag angegebene Conversion-Aktion ankreuzen. Eine Anleitung dazu finden Sie 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. Dies ist ein häufiges Problem, wenn consent angegeben wird, obwohl der Werbetreibende möglicherweise nicht weiß, ob eine Einwilligung erteilt wurde. 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 bei der Erstellung ä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 ist [1, 60] für Conversion-Aktionen vom Typ AD_CALL und WEBSITE_CALL. Für die meisten anderen Conversion-Aktionen liegt der zulässige Bereich bei [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 des Typs AD_CALL und WEBSITE_CALL nicht festgelegt werden.

• 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 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 value_settings.always_use_default_value auf true festgelegt werden. Wenn Sie den Wert false angeben, wird ein INVALID_VALUE-Fehler 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. Achten Sie darauf, dass der 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 Upload customer_id nicht gefunden werden. Informationen zu Ihrer Conversion-Einrichtung abrufen, 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 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 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 das richtige Google Ads-Konto zum Hochladen 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	Es wurde bereits eine Conversion mit derselben Kombination aus Klick-ID, conversion_date_time und conversion_action hochgeladen. Ignorieren Sie diesen Fehler, wenn Sie den Upload wiederholt haben und die Konvertierung 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 die zuvor hochgeladene Conversion nicht zu duplizieren.
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 das richtige Google Ads-Konto zum Hochladen 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 conversion_action gegebenenfalls in eine andere Aktion mit einem längeren Lookback-Window.
CONVERSION_PRECEDES_EVENT	Das 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 ein Wert für gbraid und wbraid festgelegt. Aktualisieren Sie die Conversion so, dass nur eine Klick-ID verwendet wird, und achten Sie darauf, dass Sie nicht mehrere Klicks in derselben Conversion kombinieren. Jeder Klick hat nur eine Klick-ID.
VALUE_MUST_BE_UNSET	Prüfen Sie die location des GoogleAdsError, um herauszufinden, welches der folgenden Probleme zu dem Fehler geführt hat. Für ClickConversion ist ein Wert für gclid sowie mindestens einer der Werte gbraid oder wbraid festgelegt. Aktualisieren Sie die Conversion so, dass nur eine Klick-ID verwendet wird, und achten Sie darauf, dass Sie nicht mehrere Klicks in derselben Conversion kombinieren. Jeder Klick hat nur eine Klick-ID. Für ClickConversion ist entweder ein Wert für gbraid oder wbraid festgelegt und es gibt einen Wert für custom_variables. Google Ads unterstützt keine benutzerdefinierten Variablen für eine Conversion mit einer gbraid- oder wbraid-Klick-ID. Entfernen Sie den Wert des Felds custom_variables der Conversion.