Fehlerbehebung

Wenn bei der Verwendung der Search Ads 360 API Probleme auftreten, lesen Sie den folgenden Abschnitt zur Fehlerbehebung.

Wenn Sie ein Problem haben, das Sie nicht beheben können, nachdem Sie die Ressourcen auf dieser Website gelesen haben, wenden Sie sich an den Support und halten Sie die folgenden Informationen bereit:

  • Search Ads 360-Agentur-ID und Werbetreibenden-ID, auf die Sie zugreifen möchten

  • Projektnummer aus der Google API Console

  • Der Nutzername des Google-Kontos, mit dem Sie auf die API zugreifen.
    Das ist das Konto, dem Zugriff auf Search Ads 360 gewährt wurde. Es ist dasselbe Konto, mit dem Sie die Autorisierung einrichten.

  • Code-Snippet Ihrer Anfrage

  • JSON-Antwort
    Wenn die Antwort einen Fehler enthält, gib nicht nur den numerischen Fehlercode, sondern auch die Fehlermeldung an.

Autorisierungsfehler

Im Folgenden sind einige häufige Autorisierungsfehler aufgeführt:

Meldung Beschreibung

Access Not Configured. Please use Google API Console to activate the API for your project.

Dieser Fehler tritt auf, wenn Sie die Search Ads 360 API nicht für Ihr Konto aktiviert haben. Achten Sie darauf, dass

  1. Gehen Sie zur Google API Console.

  2. Wählen Sie Ihr Projekt aus. Falls Sie noch kein Projekt erstellt haben, lesen Sie Projekt für Client erstellen.

  3. Erweitern Sie in der linken Seitenleiste die Option APIs und Authentifizierung. Klicken Sie dann auf APIs. Prüfen Sie in der Liste der APIs, ob der Status der Search Ads 360 API AKTIVIERT ist.

Invalid grant

Dieser Fehler tritt auf, wenn Ihr Aktualisierungstoken ungültig ist. So rufen Sie das Search Ads 360-Dienstprogrammskript auf, um ein Aktualisierungstoken zu erhalten:

sa360Api.py --login

Weitere Informationen zum empfohlenen Workflow für die Autorisierung

Invalid client
no application name

Dieser Fehler tritt auf, wenn Sie bei der Einrichtung Ihres Projekts in der Google API Console keinen Produktnamen angegeben haben. Um diesen Fehler zu beheben, geben Sie den Namen Ihres Produkts auf dem Zustimmungsbildschirm in der Google API Console ein.

Andere Arten von Autorisierungsfehlern

Verwenden Sie ein Google-Konto, dem Zugriff auf Search Ads 360 gewährt wurde, wenn Sie sich in der Google API Console anmelden, um Ihre Client-ID und Ihr Client-Secret abzurufen und ein Aktualisierungstoken zu erhalten.

Fehler beim Upload von Conversions

In der folgenden Tabelle sind die Fehler aufgeführt, die beim Hochladen von Conversions auftreten können. Die Hexadezimal-Fehlercodes sind unveränderlich und können daher in Ihren eigenen Scripts verwendet werden, um Fehler zu identifizieren.

Fehlercode Meldung Beschreibung
0x00000101

Click ID '{ID}' is not found

Die in einer update-Anfrage angegebene Klick-ID ist ungültig. Laden Sie die Conversions noch einmal hoch, nachdem Sie Folgendes getan haben:

  • Die Klick-ID wurde 4 Stunden vor dem Upload der Conversions generiert.

  • API-Conversion-Dienst aktiviert

  • Wenn Sie Conversions bestimmten Besuchen zuordnen, warten Sie nach dem Besuch mindestens 30 Minuten, bevor Sie die Conversion hochladen. Search Ads 360 erkennt die Klick-ID des Besuchs möglicherweise nicht, wenn Sie den Upload früher als 30 Minuten nach dem Besuch durchführen. In seltenen Fällen kann es bis zu 4 Stunden dauern, bis Search Ads 360 die clickId erkennt.

  • Es wurde bestätigt, dass der Klick aus einer gültigen Quelle stammt, wie durch den Parameter gclsrc angegeben.

  • Wir haben bestätigt, dass Sie in der Spalte Werbetreibenden-ID den richtigen Werbetreibenden angegeben haben.

  • Es wurde überprüft, ob Ihre Klick-ID innerhalb der letzten 90 Tage generiert wurde.

0x0000010E Floodlight activity name '{name}' is not found

Der in der Spalte segmentationName angegebene Name der Floodlight-Aktivität ist falsch oder noch nicht verfügbar. Wenn dieser Fehler auftritt, prüfen Sie, ob eines der folgenden häufigen Probleme vorliegt:

  • Bei Namen wird zwischen Groß- und Kleinschreibung unterschieden. Achten Sie daher darauf, dass die Namen in Ihrer Anfrage genau übereinstimmen.
  • Der Name der Floodlight-Aktivität darf keine nicht druckbaren Unicode-Zeichen oder doppelten Leerzeichen enthalten.
  • Achten Sie darauf, dass Sie den Namen einer Floodlight-Aktivität und nicht einer Floodlight-Spalte angegeben haben.
  • Prüfen Sie, ob die Floodlight-Aktivität für den Werbetreibenden vorhanden ist, den Sie in der Spalte advertiserId angegeben haben. Möglicherweise haben Sie den falschen Werbetreibenden angegeben.
  • Warten Sie nach dem Erstellen oder Bearbeiten einer Floodlight-Aktivität einige Stunden, bevor Sie Conversions für die Aktivität hochladen.
0x00000115 Custom dimension '{name}' is not found

Die von Ihnen angegebene benutzerdefinierte Floodlight-Variable muss für den Werbetreibenden, der mit clickId, criterionId oder productGroupId verknüpft ist, als Dimension (nicht als Messwert) eingerichtet sein.

0x00000116 Custom metric '{name}' is not found

Die von Ihnen angegebene benutzerdefinierte Floodlight-Variable muss für den Werbetreibenden, der mit clickId, criterionId oder productGroupId verknüpft ist, als Messwert (nicht als Dimension) eingerichtet sein.

0x0000011A The advertiser conversion ID is already specified for a conversion with Search Ads 360 conversion ID {ID}

Für denselben Gültigkeitsbereich und die in der Spalte conversionId angegebene Conversion-ID des Werbetreibenden wurde bereits eine Conversion hochgeladen.

Die „Conversion-ID des Werbetreibenden“ ist eine von Ihnen generierte ID. In Search Ads 360 muss diese ID für einen bestimmten Bereich eindeutig sein. Die Search Ads 360-Conversion-ID wird von Search Ads 360 generiert und ist garantiert eindeutig.

0x0000011B Advertiser conversion ID '{ID}' is not found

Bei Ihrer update-Anfrage wurde versucht, eine nicht vorhandene Conversion-ID eines Werbetreibenden zu aktualisieren. Achten Sie darauf, dass Sie die richtige ID angegeben haben.

0x0000011D User does not have permission to view advertiser {advertiser ID}

Das Google-Konto, das Ihr Kunde verwendet, ist nicht berechtigt, den in der Anfrage angegebenen Werbetreibenden aufzurufen.

Wenn Sie sich in der Google API Console anmelden, um Ihre Client-ID und Ihr Client-Secret abzurufen, und wenn Sie ein Aktualisierungstoken abrufen, verwenden Sie ein Google-Konto, dem Zugriff auf den von Ihnen angegebenen Werbetreibenden gewährt wurde.

0x0000011F Advertiser conversion ID is already specified in this request

Für zwei oder mehr Conversions in der Anfrage wurde derselbe Gültigkeitsbereich und dieselbe Conversion-ID des Werbetreibenden angegeben.

Die Conversion-ID des Werbetreibenden ist eine ID, die Sie generieren und in der Spalte conversionId angeben. In Search Ads 360 muss diese ID für einen bestimmten Umfang eindeutig sein.

0x0000011E The requested Floodlight activity '{name}' does not match the conversion type (ACTION/TRANSACTION)

Die von Ihnen angegebene ID oder der Name der Floodlight-Aktivität stimmt nicht mit dem angegebenen Conversion-Typ überein.

Antwortcodes und Fehlermeldungen melden

Wenn Sie einen Bericht anfordern und als Antwort eine Fehlermeldung erhalten, finden Sie unter Antwortcodes in der Search Ads 360 API und Standardfehlerantworten weitere Informationen zum Fehler.

Die Daten auf der Search Ads 360-Benutzeroberfläche stimmen nicht mit einem Bericht überein, der von der API zurückgegeben wurde

Die Daten in der Search Ads 360-Benutzeroberfläche sollten standardmäßig mit den von der API zurückgegebenen Daten übereinstimmen. Wenn Sie in einer Berichtsanfrage includeRemovedEntities auf true festlegen, muss in der Benutzeroberfläche auch das Kästchen Entfernte Anzeigen anzeigen angeklickt sein.