Fehlerbehebung

Wenn bei der Verwendung der Search Ads 360 API Probleme auftreten, sehen Sie sich diesen Abschnitt zur Fehlerbehebung an.

Wenn du nach dem Lesen der Ressourcen auf dieser Website ein Problem lösen kannst, das du nicht mehr lösen kannst, wende dich an den Support und halte 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 der Zugriff auf Search Ads 360 gewährt wurde. Das ist dasselbe Konto, mit dem Sie die Autorisierung einrichten.

  • Code-Snippet Ihrer Anfrage

  • JSON-Antwort
    Wenn die Antwort ein Fehler ist, achten Sie darauf, die Fehlermeldung und nicht nur den numerischen Fehlercode anzugeben.

Autorisierungsfehler

Im Folgenden sind einige häufige Fehler bei der Autorisierung aufgeführt:

die Botschaft und 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. Gehen Sie so vor:

  1. Gehen Sie zur Google API Console.

  2. Wählen Sie Ihr Projekt aus. Wenn Sie noch kein Projekt erstellt haben, finden Sie weitere Informationen unter Projekt für den Client erstellen.

  3. Maximieren 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 für die Search Ads 360 API AKTIVIERT ist.

Invalid grant

Dieser Fehler tritt auf, wenn Ihr Aktualisierungstoken ungültig ist. Sie können ein Aktualisierungstoken abrufen, indem Sie das Search Ads 360-Dienstprogrammskript so aufrufen:

sa360Api.py --login

Weitere Informationen zum empfohlenen Workflow für die Autorisierung.

Invalid client
no application name

Dieser Fehler tritt auf, wenn Sie beim Einrichten Ihres Projekts in der Google API Console keinen Produktnamen angegeben haben. Zur Behebung dieses Fehlers gib den Namen deines Produkts auf dem Zustimmungsbildschirm der Google API-Konsole ein.

Andere Arten von Autorisierungsfehlern

Achten Sie darauf, ein Google-Konto zu verwenden, dem Zugriff auf Search Ads 360 gewährt wurde, wenn Sie sich in der Google API Console anmelden, um Ihre Client-ID und Ihren Clientschlüssel abzurufen und um ein Aktualisierungstoken abzurufen.

Fehler beim Conversion-Upload

In der folgenden Tabelle sind die Fehler aufgeführt, die beim Hochladen von Conversions auftreten können. Die hexadezimalen Fehlercodes sind unveränderlich, sodass Sie sie in Ihren eigenen Skripts verwenden können, um Fehler zu identifizieren.

Fehlercode die Botschaft und Beschreibung
0x00000101

Click ID '{ID}' is not found

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

  • Die Klick-ID wurde 4 Stunden vor dem Hochladen von Conversions generiert.

  • Sie haben den API-Conversion-Service aktiviert.

  • Wenn Sie Bestimmten Besuchen Conversions 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 vor mehr als 30 Minuten durchführen. In seltenen Fällen kann es bis zu 4 Stunden dauern, bis Search Ads 360 die Klick-ID erkennen kann.

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

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

  • Die Klick-ID wurde in den letzten 90 Tagen generiert.

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

Der Name der Floodlight-Aktivität, der in der Spalte segmentationName angegeben ist, ist falsch oder noch nicht verfügbar. Wenn dieser Fehler angezeigt wird, prüfen Sie die folgenden häufigen Probleme:

  • Bei Namen wird zwischen Groß- und Kleinschreibung unterschieden. Die Anfrage muss also genau mit der Groß-/Kleinschreibung übereinstimmen.
  • Achten Sie darauf, dass der Name der Floodlight-Aktivität keine nicht druckbaren Unicode-Zeichen oder doppelten Leerzeichen enthält.
  • 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 benutzerdefinierte Floodlight-Variable, die Sie angegeben haben, wurde als Dimension (nicht als Messwert) für den Werbetreibenden eingerichtet, der mit clickId, criterionId oder productGroupId für die Conversion verknüpft ist.

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

Die benutzerdefinierte Floodlight-Variable, die Sie angegeben haben, wurde als Messwert (nicht als Dimension) für den Werbetreibenden eingerichtet, der mit dem Conversion-Typ clickId, criterionId oder productGroupId verknüpft ist.

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

Es wurde bereits eine Conversion für denselben Umfang und dieselbe Conversion-ID hochgeladen, wie in der Spalte conversionId angegeben.

Die Conversion-ID des Werbetreibenden wird generiert. 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

Mit Ihrer update-Anfrage wurde versucht, eine Conversion-ID eines Werbetreibenden zu aktualisieren, die nicht vorhanden ist. 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 Client verwendet, ist nicht berechtigt, den in der Anfrage angegebenen Werbetreibenden anzusehen.

Wenn Sie sich in der Google API Console anmelden, um Ihre Client-ID und Ihren Clientschlüssel abzurufen, und wenn Sie ein Aktualisierungstoken erhalten, achten Sie darauf, ein Google-Konto zu verwenden, dem der angegebene Werbetreibende Zugriff gewährt hat.

0x0000011F Advertiser conversion ID is already specified in this request

Mindestens zwei Conversions in der Anfrage geben denselben Umfang und dieselbe Conversion-ID von Werbetreibenden an.

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

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

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

Antwortcodes und Fehlermeldungen melden

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

Die Daten in 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 Daten übereinstimmen, die von der API zurückgegeben werden. Wenn Sie includeRemovedEntities in einer Berichtsanfrage auf true festlegen, muss in der UI auch das Kästchen Entfernte anzeigen aktiviert sein.