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

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 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 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. Der in Ihrer Uploadanfrage angegebene ConversionAction muss vom Typ UPLOAD_CLICKS sein.
CUSTOMER_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS Vergewissern Sie sich, 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.

Wenn für eine Conversion diese Warnung angezeigt wird, ist sie in der Google Ads API in der successful_event_count Ihrer Diagnose für Offlinedaten enthalten. 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 können beispielsweise aus SA360 oder DV360 stammen. Weitere mögliche Ursachen:

In seltenen Fällen, in denen der Kunde, der die Daten hochlädt, sich 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 Anzeigen ausliefert, jedoch nicht.

Sie können feststellen, ob ein Konto die Nutzungsbedingungen für Kundendaten akzeptiert hat, 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 richtig eingerichtet ist und bei gesendeten Lead-Formularen ausgelöst wird. Wenn Ihr Tag nicht bei Formulareinsendungen ausgelöst wird oder falsche Daten sendet, werden hochgeladenen Conversions wahrscheinlich nur wenige oder gar keine Attributionen zugeordnet. Weitere Informationen finden Sie in den Hilfeartikeln Google-Tag für erweiterte Conversions für Leads konfigurieren und Google Tag Manager für erweiterte Conversions für Leads konfigurieren.

  • 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 beim Hochladen Ihrer Conversions keine technischen Probleme auftreten und Sie mit den präsentierten Messwerten zufrieden sind, aber nach der Implementierung erweiterter Conversions für Leads nicht die erwarteten Verbesserungen der Kampagnenleistung oder des Kampagnen-Lifts feststellen, wenden Sie sich an den Google Ads-Produkt-Support.

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

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 bei der Conversion 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 erfolgte, 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 den 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 ausgelöst. Das ist ein häufiges Problem, wenn consent angegeben wird, der Werbetreibende aber 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 Drittanbieter-App-Analysen 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.

  • Wenn Sie eine Conversion-Aktion erstellen, 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 liegt zwischen 1 und 60 Tagen 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 liegt für die meisten Conversion-Aktionen zwischen 1 und 30 Tagen. 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 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 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 den Upload von Klick-Conversions nicht gültig ist. Achte darauf, dass das in deiner 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 wie das Google Ads API-Conversion-Konto zum Zeitpunkt des Klicks. Aktualisieren Sie die customer_id der Anfrage auf den richtigen Kunden.
EVENT_NOT_FOUND Die Kombination aus Klick-ID und customer_id wurde in Google Ads nicht gefunden. Prüfen Sie die Anforderungen für customer_id und vergewissern Sie sich, 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 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 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 eine Duplizierung der zuvor hochgeladenen Conversion zu vermeiden.
EVENT_NOT_FOUND Die Kombination aus Klick-ID und customer_id wurde in Google Ads nicht gefunden. Prüfen Sie die Anforderungen für customer_id und vergewissern Sie sich, 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 der 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 die conversion_action gegebenenfalls 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 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 oder ein URL-Parameter verwendet wird, und achten Sie darauf, dass Sie nicht mehrere Klicks in derselben Conversion kombinieren. Für jeden Klick gibt es nur eine Klick-ID oder einen URL-Parameter.
VALUE_MUST_BE_UNSET Prüfen Sie die 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 einer der Werte 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 ClickConversion ist ein Wert für gbraid oder wbraid und ein Wert für custom_variables festgelegt. In Google Ads werden keine benutzerdefinierten Variablen für eine Conversion mit dem URL-Parameter gbraid oder wbraid unterstützt. Entfernen Sie das Feld custom_variables der Conversion.