Dépannage

Si vous rencontrez des problèmes lors de l'utilisation de l'API Search Ads 360, consultez cette section de dépannage.

Si vous rencontrez un problème que vous ne parvenez pas à résoudre après avoir lu les ressources de ce site, contactez l'assistance et préparez les informations suivantes :

  • ID d'agence et référence annonceur Search Ads 360 auxquels vous essayez d'accéder

  • Numéro de projet dans la console Google APIs

  • Nom d'utilisateur du compte Google que vous utilisez pour accéder à l'API.
    Il s'agit du compte qui a été autorisé à accéder à Search Ads 360, qui est le même que celui que vous utilisez pour configurer l'autorisation.

  • Extrait de code de votre requête

  • Réponse JSON
    Si la réponse est une erreur, veillez à inclure le message d'erreur, et pas seulement le code d'erreur numérique.

Erreurs d'autorisation

Voici quelques erreurs d'autorisation courantes :

Message Description

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

Cette erreur se produit si vous n'avez pas activé l'API Search Ads 360 pour votre compte. Assurez-vous d'avoir effectué les opérations suivantes :

  1. Accédez à la console Google APIs.

  2. Sélectionnez votre projet. Si vous n'avez pas encore créé de projet, consultez Créer un projet pour votre client.

  3. Dans la barre latérale de gauche, développez API et authentification. Cliquez ensuite sur API. Dans la liste des API, assurez-vous que l'état de l'API Search Ads 360 est ACTIVÉ.

Invalid grant

Cette erreur se produit lorsque votre jeton d'actualisation n'est pas valide. Vous pouvez obtenir un jeton d'actualisation en appelant le script utilitaire Search Ads 360 comme suit :

sa360Api.py --login

En savoir plus sur le workflow recommandé pour l'autorisation.

Invalid client
no application name

Cette erreur se produit si vous n'avez pas spécifié de nom de produit lors de la configuration de votre projet dans la console Google APIs. Pour corriger cette erreur, saisissez le nom de votre produit sur l'écran de consentement de la console Google APIs.

Autres types d'erreurs d'autorisation

Assurez-vous d'utiliser un compte Google autorisé à accéder à Search Ads 360 lorsque vous vous connectez à la console Google APIs pour récupérer votre ID client et votre code secret du client, et lorsque vous obtenez un jeton d'actualisation.

Erreurs d'importation des conversions

Le tableau suivant liste les erreurs que vous pouvez rencontrer lors de l'importation de conversions. Notez que les codes d'erreur hexadécimaux sont immuables. Vous pouvez donc les utiliser dans vos propres scripts pour identifier les erreurs.

Code d'erreur Message Description
0x00000101

Click ID '{ID}' is not found

L'ID de clic que vous avez spécifié dans une requête insert ou update n'est pas valide. Réimportez les conversions après avoir effectué les opérations suivantes :

  • Vérifiez que l'ID de clic a été généré six heures avant l'importation des conversions.

  • Activé le service de conversion d'API.

  • Si vous attribuez des conversions à des visites spécifiques, attendez au moins six heures après la visite avant d'importer la conversion. Il est possible que Search Ads 360 ne reconnaisse pas l'ID de clic de la visite si vous l'importez moins de six heures après la visite. Dans de rares cas, vous devrez peut-être attendre jusqu'à 24 heures avant que Search Ads 360 ne reconnaisse le clickId.

  • Vérifiez que le clic provient d'une source valide, comme indiqué par le paramètre gclsrc.

  • Vérifiez que votre ID de clic a été généré au cours des 90 derniers jours.

0x00000106 Either a click ID or keyword ID is required

La conversion ne spécifie pas à quoi elle est attribuée. Spécifiez la colonne clickId, ou les colonnes customerId, campaignId, adGroupId et criterionId qui identifient un mot clé.

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

Spécifiez segmentationType: "FLOODLIGHT" et l'activité Floodlight dans la colonne segmentationName ou segmentationId.

Lorsque vous modifiez une conversion enregistrée par Search Ads 360 via une balise Floodlight, l'activité Floodlight est requise pour identifier la conversion.

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

Le nom de l'activité Floodlight spécifié dans la colonne segmentationName est incorrect ou n'est pas encore disponible. Si cette erreur s'affiche, vérifiez les problèmes courants suivants :

  • Les noms sont sensibles à la casse. Assurez-vous donc que votre requête respecte exactement la casse.
  • Assurez-vous de ne pas avoir inclus de caractères Unicode non imprimables ni d'espaces doubles dans le nom de l'activité Floodlight.
  • Assurez-vous d'avoir spécifié le nom d'une activité Floodlight, et non d'une colonne Floodlight.
  • Vérifiez que l'activité Floodlight existe pour l'annonceur auquel appartient l'ID de clic ou le mot clé de votre requête.
  • Après avoir créé ou modifié une activité Floodlight, attendez quelques heures avant d'importer des conversions pour cette activité.
0x00000115 Custom dimension '{name}' is not found

Assurez-vous que la variable Floodlight personnalisée que vous avez spécifiée a été configurée en tant que dimension (et non en tant que métrique) pour l'annonceur associé à l'élément clickId, criterionId ou productGroupId que vous attribuez à la conversion.

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

Assurez-vous que la variable Floodlight personnalisée que vous avez spécifiée a été configurée en tant que métrique (et non en tant que dimension) pour l'annonceur associé à l'élément clickId, criterionId ou productGroupId que vous attribuez à la conversion.

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

Votre requête update n'a pas spécifié la colonne conversionId. conversionId est requis pour identifier la conversion que vous souhaitez modifier. Consultez Abandon de dsConversionId.

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

Un utilisateur a déjà importé une conversion pour le même champ d'application et le même ID de conversion d'annonceur spécifiés dans la colonne conversionId.

L'"ID de conversion de l'annonceur" est un ID que vous générez. Search Ads 360 requiert que cet ID soit unique pour un champ d'application donné. L'ID de conversion Search Ads 360 est généré par Search Ads 360 et est garanti unique.

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

Votre requête update a tenté de mettre à jour un ID de conversion d'annonceur qui n'existe pas. Recherchez les problèmes courants suivants :

  • Assurez-vous d'avoir spécifié le bon ID dans la colonne conversionId. Pour les conversions importées via l'API, il s'agit de l'élément conversionId que vous avez spécifié lorsque vous avez inséré la conversion. Pour les conversions enregistrées via des balises Floodlight, il s'agit de l'ID de commande Floodlight.
  • Assurez-vous que conversionTimestamp correspond au code temporel de la conversion existante, en millisecondes Epoch UTC. Un code temporel converti à partir d'un fuseau horaire local ou spécifié en secondes plutôt qu'en millisecondes ne correspond pas à la conversion existante.
  • Pour les conversions enregistrées via des balises Floodlight, assurez-vous d'avoir spécifié l'activité Floodlight de la conversion dans la colonne segmentationName ou segmentationId, et que la conversion a eu lieu au cours des 28 derniers jours.
0x0000011D User does not have permission to view advertiser {advertiser ID}

Le compte Google utilisé par votre client n'est pas autorisé à afficher l'annonceur auquel appartient l'ID de clic ou le mot clé de la requête.

Lorsque vous vous connectez à la console Google APIs pour récupérer votre ID client et votre code secret du client, et lorsque vous obtenez un jeton d'actualisation, veillez à utiliser un compte Google autorisé à accéder à cet annonceur.

0x0000011F Advertiser conversion ID is already specified in this request

Au moins deux conversions de la requête spécifient le même champ d'application et le même ID de conversion d'annonceur.

L'ID de conversion de l'annonceur est un ID que vous générez et spécifiez dans la colonne conversionId. Search Ads 360 requiert que cet ID soit unique pour un champ d'application donné.

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

L'ID ou le nom de l'activité Floodlight que vous avez fourni ne correspond pas au type de conversion que vous avez spécifié.

0x00000124 Conversion timestamp is before click timestamp

La valeur conversionTimestamp est antérieure à l'heure du clic que vous avez spécifiée dans la colonne clickId. Assurez-vous que le code temporel est spécifié en millisecondes Epoch UTC, et non en secondes ou dans un fuseau horaire local.

0x00000125 Conversion age is older than the max supported age

Votre requête update a tenté de modifier une conversion trop ancienne pour être modifiée. Les conversions enregistrées par Search Ads 360 via des balises Floodlight ne peuvent être modifiées que dans les 28 jours suivant la conversionTimestamp.

0x00000126 Service internal error

Réessayez plus tard. Il s'agit probablement d'une erreur temporaire. Veuillez contacter l'assistance SA360 si cette erreur persiste.

0x00000129 Invalid customer ID: {ID}

Search Ads 360 ne trouve pas le numéro client que vous avez spécifié dans la colonne customerId. Spécifiez le numéro client de la nouvelle interface Search Ads 360 du compte client contenant le mot clé (par exemple, 123-456-7890).

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

Search Ads 360 ne trouve pas le mot clé identifié par les colonnes customerId, campaignId, adGroupId et criterionId. Assurez-vous que les quatre ID sont des ID de la nouvelle interface Search Ads 360 et que le mot clé appartient au groupe d'annonces, à la campagne et au compte client que vous avez spécifiés.

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

Une conversion attribuée à un mot clé doit spécifier customerId, campaignId, adGroupId et criterionId. Le message indique l'ID manquant. Consultez Attribuer une conversion à un mot clé uniquement.

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

Votre requête update a spécifié un clickId généré il y a plus de 60 jours. Les conversions ne peuvent être modifiées que dans les 60 jours suivant le clic.

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

Votre requête update spécifiait la colonne obsolète dsConversionId ou transmettait un ID de conversion Search Ads 360 dans la colonne conversionId. Identifiez plutôt la conversion par son ID de conversion d'annonceur. Consultez Abandon de dsConversionId.

Codes de réponse et messages d'erreur des rapports

Si vous demandez un rapport et que la réponse est un message d'erreur, consultez Codes de réponse dans l'API Search Ads 360 et Réponses d'erreur standards pour en savoir plus sur l'erreur.

Les données de l'UI Search Ads 360 ne correspondent pas à un rapport renvoyé par l'API

Par défaut, les données de l'UI Search Ads 360 doivent correspondre à celles renvoyées par l'API. Si vous définissez includeRemovedEntities sur true dans une demande de rapport, assurez-vous que la case Afficher les éléments supprimés est également cochée dans l'interface utilisateur.