Fehlerbehebung

Wenn bei der Verwendung der Search Ads 360 API Probleme auftreten, lesen Sie den 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 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, geben Sie nicht nur den numerischen Fehlercode, sondern auch die Fehlermeldung an.

Autorisierungsfehler

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

Nachricht senden 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. Wenn Sie noch kein Projekt erstellt haben, lesen Sie den Hilfeartikel Projekt für den Kunden erstellen.

  3. Maximieren Sie in der linken Seitenleiste 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-Dienstprogramm-Script 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 in der Google API Console auf dem Zustimmungsbildschirm den Namen Ihres Produkts 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 hexadezimalen Fehlercodes sind unveränderlich und können daher in Ihren eigenen Scripts verwendet werden, um Fehler zu identifizieren.

Fehlercode Nachricht senden Beschreibung
0x00000101

Click ID '{ID}' is not found

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

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

  • API-Conversion-Dienst aktiviert

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

  • Der Klick stammt aus einer gültigen Quelle, wie vom Parameter gclsrc angegeben.

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

  • Ihre Klick-ID wurde in den letzten 90 Tagen generiert.
0x0000010E Floodlight activity name '{name}' is not found

Der Name der Floodlight-Aktivität in der Spalte segmentationName 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.
  • Nachdem Sie eine Floodlight-Aktivität erstellt oder bearbeitet haben, sollten Sie einige Stunden warten, 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 Umfang 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. Prüfen Sie, ob 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 im Antrag 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.