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: Gehen Sie zur Google API Console. Wählen Sie Ihr Projekt aus. Wenn Sie noch kein Projekt erstellt haben, finden Sie weitere Informationen unter Projekt für den Client erstellen. 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.