Fehlerbehebung

Wenn bei der Verwendung der Search Ads 360 API Probleme auftreten, finden Sie in diesem Abschnitt zur Fehlerbehebung weitere Informationen.

Wenn Sie ein Problem haben, das Sie nach dem Lesen der Ressourcen auf dieser Website nicht beheben können, 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, das Sie zum Einrichten der Autorisierung verwenden.

  • Code-Snippet Ihrer Anfrage

  • JSON-Antwort
    Wenn die Antwort ein Fehler ist, geben Sie die Fehlermeldung an, nicht nur den numerischen Fehlercode.

Autorisierungsfehler

Hier sind einige häufig auftretende Autorisierungsfehler:

Nachricht 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 für Ihr Konto nicht aktiviert haben. Prüfen Sie, ob Sie Folgendes getan haben:

  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. Erweitere 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 EIN ist.

Invalid grant

Dieser Fehler tritt auf, wenn Ihr Aktualisierungstoken nicht gültig ist. Sie können ein Aktualisierungstoken abrufen, indem Sie das Search Ads 360-Dienstprogrammscript 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. Geben Sie in der Google API Console auf dem Zustimmungsbildschirm den Namen Ihres Produkts ein, um diesen Fehler zu beheben.

Andere Arten von Autorisierungsfehlern

Achten Sie darauf, dass Sie ein Google-Konto 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 wenn Sie ein Aktualisierungstoken erhalten.

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 Nachricht Beschreibung
0x00000101

Click ID '{ID}' is not found

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

  • Verifiziert, dass die Klick-ID sechs Stunden vor dem Hochladen der Conversions generiert wurde.

  • den API-Conversion-Dienst aktiviert haben

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

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

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

0x00000106 Either a click ID or keyword ID is required

Bei der Conversion wird nicht angegeben, worauf sie zurückzuführen ist. Geben Sie entweder die Spalte clickId oder die Spalten customerId, campaignId, adGroupId und criterionId an, die ein Keyword identifizieren.

0x0000010C Either of Floodlight activity ID or Floodlight activity name is required

Geben Sie segmentationType: "FLOODLIGHT" und die Floodlight-Aktivität entweder in der Spalte segmentationName oder segmentationId an.

Wenn Sie eine Conversion bearbeiten, die Search Ads 360 über ein Floodlight-Tag erfasst hat, ist die Floodlight-Aktivität erforderlich, um die Conversion zu identifizieren.

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 Groß- und Kleinschreibung in Ihrer Anfrage genau übereinstimmt.
  • 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, zu dem die Klick-ID oder das Keyword in Ihrer Anfrage gehört.
  • 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 angegebene benutzerdefinierte Floodlight-Variable muss als Dimension (nicht als Messwert) für den Werbetreibenden eingerichtet sein, der mit dem clickId, criterionId oder productGroupId verknüpft ist, dem Sie die Conversion zuordnen.

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

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

0x00000119 A conversion ID or advertiser conversion ID is required to modify an existing conversion

In Ihrer update-Anfrage wurde die Spalte conversionId nicht angegeben. conversionId ist erforderlich, um die Conversion zu identifizieren, die Sie bearbeiten möchten. Weitere Informationen finden Sie unter Einstellung von dsConversionId.

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 Gültigkeitsbereich und dieselbe Conversion-ID des Werbetreibenden hochgeladen, die in der Spalte conversionId angegeben ist.

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

Mit Ihrer update-Anfrage wurde versucht, die Conversion-ID eines Werbetreibenden zu aktualisieren, die nicht existiert. Prüfen Sie, ob eines oder mehrere dieser häufigen Probleme vorliegen:

  • Achten Sie darauf, dass Sie in der Spalte conversionId die richtige ID angegeben haben. Bei Conversions, die über die API hochgeladen werden, ist dies die conversionId, die Sie beim Einfügen der Conversion angegeben haben. Bei Conversions, die über Floodlight-Tags erfasst werden, ist dies die Floodlight-Bestell-ID.
  • Achten Sie darauf, dass conversionTimestamp der Zeitstempel der vorhandenen Conversion in Millisekunden seit der Epoche (UTC) ist. Ein Zeitstempel, der aus einer lokalen Zeitzone konvertiert wurde oder in Sekunden statt Millisekunden angegeben ist, stimmt nicht mit der vorhandenen Conversion überein.
  • Bei Conversions, die über Floodlight-Tags erfasst werden, müssen Sie die Floodlight-Aktivität der Conversion in der Spalte segmentationName oder segmentationId angeben. Außerdem muss die Conversion innerhalb der letzten 28 Tage erfolgt sein.
0x0000011D User does not have permission to view advertiser {advertiser ID}

Das Google-Konto, das Ihr Kunde verwendet, ist nicht berechtigt, den Werbetreibenden aufzurufen, zu dem die Klick-ID oder das Keyword in der Anfrage gehört.

Wenn Sie sich in der Google API Console anmelden, um Ihre Client-ID und Ihren Clientschlüssel abzurufen, und wenn Sie ein Aktualisierungstoken abrufen, müssen Sie ein Google-Konto verwenden, dem Zugriff auf diesen Werbetreibenden gewährt wurde.

0x0000011F Advertiser conversion ID is already specified in this request

In der Anfrage sind zwei oder mehr Conversions mit demselben Gültigkeitsbereich und derselben 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 Bereich 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.

0x00000124 Conversion timestamp is before click timestamp

Der conversionTimestamp liegt vor dem Zeitpunkt des Klicks, den Sie in der Spalte clickId angegeben haben. Der Zeitstempel muss in Millisekunden seit der Epoche (in UTC) angegeben werden, nicht in Sekunden oder in einer lokalen Zeitzone.

0x00000125 Conversion age is older than the max supported age

Mit Ihrer update-Anfrage wurde versucht, eine Conversion zu bearbeiten, die zu alt ist, um bearbeitet zu werden. Conversions, die in Search Ads 360 über Floodlight-Tags erfasst wurden, können nur innerhalb von 28 Tagen nach dem conversionTimestamp bearbeitet werden.

0x00000126 Service internal error

Versuchen Sie es später noch einmal. Dies ist wahrscheinlich ein vorübergehender Fehler. Wenden Sie sich an den SA360-Support, wenn dieser Fehler weiterhin auftritt.

0x00000129 Invalid customer ID: {ID}

Die in der Spalte customerId angegebene Kundennummer wurde in Search Ads 360 nicht gefunden. Geben Sie die neue Search Ads 360-Kundennummer des Kundenkontos an, das das Keyword enthält, z. B. 123-456-7890.

0x0000012C Cannot find this keyword ID in Search Ads 360.

Search Ads 360 kann das Keyword nicht finden, das durch die Spalten customerId, campaignId, adGroupId und criterionId identifiziert wird. Achten Sie darauf, dass alle vier IDs neue Search Ads 360-Versionen sind und dass das Keyword zur angegebenen Anzeigengruppe, Kampagne und zum angegebenen Kundenkonto gehört.

0x0000012E Please provide the full set of new Search Ads 360 IDs: {missing ID}

Für eine Conversion, die einem Keyword zugeordnet ist, müssen customerId, campaignId, adGroupId und criterionId angegeben werden. In der Nachricht wird die fehlende ID genannt. Weitere Informationen finden Sie unter Conversion nur einem Keyword zuordnen.

0x0000012F Editing a click ID older than 60 days is not supported.

In Ihrer update-Anfrage wurde ein clickId angegeben, das vor mehr als 60 Tagen generiert wurde. Conversions können nur innerhalb von 60 Tagen nach dem Klick bearbeitet werden.

0x0000013C Conversion editing using integer DS conversion ID is deprecated. Please use conversion ID instead.

In Ihrer update-Anfrage wurde die verworfene Spalte dsConversionId angegeben oder eine Search Ads 360-Conversion-ID in der Spalte conversionId übergeben. Identifizieren Sie die Conversion stattdessen anhand der Conversion-ID des Werbetreibenden. Weitere Informationen finden Sie unter Einstellung von dsConversionId.

Berichtsantwortcodes und Fehlermeldungen

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

Die Daten in der Search Ads 360-Benutzeroberfläche stimmen nicht mit einem von der API zurückgegebenen Bericht überein.

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