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 von der API nicht nachvollziehbare Fehler erhalten oder sich über die Messwerte oder Diagnosen in der Benutzeroberfläche nicht im Klaren sind.

Messwerte in der Google Ads-Benutzeroberfläche lesen

  • In der Google Ads-Benutzeroberfläche werden Conversion-Messwerte nicht nach Importdatum sortiert. Daher können die Berichte auf der Benutzeroberfläche irreführend sein, wenn Sie die Importergebnisse überprüfen möchten. Um die Importintegrität zu prüfen, beginnen Sie mit der Offlinediagnose. In der Google Ads-Benutzeroberfläche finden Sie auch Informationen zu den Diagnosen für erweiterte Conversions für Leads und erweiterte Conversions für das Web.

Probleme mit erweiterten Conversions für Leads

Häufige Fehler

Fehler
NO_CONVERSION_ACTION_FOUND

Die angegebene Conversion-Aktion ist entweder nicht aktiviert oder es kann über das im Feld „client_id“ in der Anfrage angegebene Kundenkonto nicht darauf zugegriffen werden. 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 mithilfe der Ressource click_view prüfen, ob eine GCLID zu einem Kundenkonto gehört. Reichen Sie dazu eine Abfrage ein, die nach click_view.gclid und segments.date filtert. Das Datum ist das Datum des Klicks.

INVALID_CONVERSION_ACTION_TYPE Der Typ der angegebenen Conversion-Aktion ist für erweiterte Conversions für Leads nicht zulässig. Achten Sie darauf, dass die in Ihrer Uploadanfrage angegebene ConversionAction den Typ UPLOAD_CLICKS hat.
CLICK_CONVERSION_ALREADY_EXISTS Für diesen Klick ist bereits eine Conversion mit dieser conversion_date_time vorhanden. Achten Sie darauf, dass der conversion_date_time für jedes Ereignis eindeutig ist, und versuchen Sie es noch einmal.
CUSTOMER_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS Sie müssen in den Conversion-Einstellungen erweiterte Conversions für Leads aktivieren. 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 auf dem UploadClickConversionsRequest true ist.

Wenn bei einer Conversion diese Warnung auftritt, wird sie in der Google Ads API in die successful_event_count der Offlinedatendiagnose 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:

In seltenen Fällen, in denen der Kunde, der die Daten hochlädt, nicht mit dem Google Ads-Conversion-Kunden übereinstimmt, kann dieser Fehler bedeuten, dass der Kunde, der die Daten hochlädt, die Nutzungsbedingungen für Kundendaten akzeptiert hat, der Kunde, für den die Anzeigen ausgeliefert werden, dies aber nicht getan hat.

Ob ein Konto die Nutzungsbedingungen für Kundendaten akzeptiert hat, können Sie anhand der Ressource customer im Feld customer.offline_conversion_tracking_info.accepted_customer_data_terms prüfen.

Abweichungen bei Messwerten

Beachten Sie dabei Folgendes:

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

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

  • Prüfen Sie, ob Sie in Ihren Uploads die Einwilligung korrekt angeben. Sie können entweder die Standardeinstellungen für die Einwilligung für Ihr Konto festlegen (klicken Sie dazu 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 beim Hochladen Ihrer Conversions keine technischen Probleme haben und mit den angezeigten Messwerten zufrieden sind, Sie aber nach der Implementierung erweiterter Conversions für Leads nicht die erwartete Steigerung der Kampagnenleistung feststellen, wenden Sie sich bitte an den Google Ads-Produktsupport.

Probleme mit erweiterten Conversions für das Web

Häufige Fehler

Fehler
CONVERSION_NOT_FOUND Für das angegebene Conversion-Aktions- und Conversion-ID-Paar oder für order_id konnte keine Conversion gefunden werden. 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 auf einen Klick zurückzuführen ist, bei dem statt gclid gbraid oder wbraid erfasst wurde. In Google Ads werden für diese Conversions keine erweiterten Conversions für das Web 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 ist nicht für erweiterte Conversions für das Web geeignet. Klicken Sie in der Google Ads-Benutzeroberfläche bei der Conversion-Aktion, auf die in Ihrer Anfrage verwiesen wird, das Kästchen Erweiterte Conversions aktivieren an. Eine Anleitung dazu finden Sie in der Hilfe.

Allgemeine Probleme mit der Conversion-Verwaltung

Beachten Sie dabei Folgendes:

  • Der Versuch, ein Enum-Feld auf UNKNOWN festzulegen, führt zu einem RequestError.INVALID_ENUM_VALUE-Fehler. Das ist ein häufiges Problem, wenn consent angegeben wird, obwohl der Werbetreibende möglicherweise nicht weiß, ob die 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 App-Analysen von Firebase und Drittanbietern erstellen, können Sie das Feld app_id nur beim Erstellen ändern. Nach dem Erstellen der Conversion-Aktion 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. Alle anderen Optionen führen zu einem Fehler vom Typ CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELS. 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. Bei den 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 leer sein.

  • Wenn Sie das Feld include_in_conversion_metrics für eine Conversion-Aktion festlegen oder aktualisieren, führt das zu einem FieldError.IMMUTABLE_FIELD-Fehler. 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 gesetzt sein. Wenn Sie den Wert false angeben, führt das zu einem INVALID_VALUE-Fehler.

Häufige Fehler

Fehler
INVALID_CONVERSION_ACTION_TYPE Die angegebene Conversion-Aktion hat einen Typ, der für den Upload von Klick-Conversions nicht zulässig 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 hochgeladenen customer_id nicht gefunden werden. Holen Sie sich Informationen zur Conversion-Einrichtung, um sicherzustellen, dass die Conversion-Aktion in Ihrem Upload aktiviert ist und der customer_id der Uploadanfrage zugewiesen ist.
TOO_RECENT_CONVERSION_ACTION Die Conversion-Aktion wurde gerade erstellt. Warten Sie nach dem Erstellen der Aktion mindestens 6 Stunden, bevor Sie die fehlgeschlagenen Conversions noch einmal versuchen.
INVALID_CUSTOMER_FOR_CLICK Die customer_id der Anfrage entspricht nicht der Kundennummer, die zum Zeitpunkt des Klicks dem Conversion-Konto der Google Ads API zugewiesen war. Aktualisiere die customer_id der Anfrage auf den richtigen Kunden.
EVENT_NOT_FOUND Die Kombination aus Klick-ID und customer_id kann in Google Ads nicht gefunden werden. Sehen Sie sich die Anforderungen für customer_id an und prüfen Sie, ob Sie den Upload mit dem richtigen Google Ads-Konto ausfü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 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 noch einmal versucht haben und diese Conversion bereits erfolgreich war. Wenn Sie zusätzlich zur zuvor hochgeladenen Conversion eine weitere 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 kann in Google Ads nicht gefunden werden. Sehen Sie sich die Anforderungen für customer_id an und prüfen Sie, ob Sie den Upload mit dem richtigen Google Ads-Konto ausführen.
EXPIRED_EVENT Der importierte Klick erfolgte vor dem im Feld click_through_lookback_window_days angegebenen Zeitraum. Eine Änderung an der click_through_lookback_window_days wirkt sich nur auf Klicks aus, die nach der Änderung erfasst wurden. Das Ändern des Lookback-Window würde diesen Fehler für den betreffenden Klick also nicht beheben. Ändern Sie gegebenenfalls die conversion_action in eine andere Aktion mit einem längeren Lookback-Window.
CONVERSION_PRECEDES_EVENT Der Wert für 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 verwendet wird. Achten Sie darauf, dass Sie nicht mehrere Klicks mit derselben Conversion verknüpfen. Jeder Klick hat nur eine Klick-ID.
VALUE_MUST_BE_UNSET Prüfe 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 und mindestens einer für gbraid oder wbraid festgelegt. Aktualisieren Sie die Conversion so, dass nur eine Klick-ID verwendet wird. Achten Sie darauf, dass Sie nicht mehrere Klicks mit derselben Conversion verknüpfen. Jeder Klick hat nur eine Klick-ID.
  • Für ClickConversion ist entweder gbraid oder wbraid festgelegt und es gibt einen Wert für custom_variables. In Google Ads werden keine benutzerdefinierten Variablen für Conversions mit einer gbraid- oder wbraid-Klick-ID unterstützt. Setzen Sie das Feld custom_variables der Conversion auf „–“.
Zurück
Berichterstellung