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 ne parvenez pas à résoudre un problème après avoir consulté les ressources de ce site, contactez l'assistance et préparez les informations suivantes:

• ID de l'agence Search Ads 360 et ID de l'annonceur 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 auquel vous avez accordé l'autorisation d'accéder à Search Ads 360, qui est le même que celui que vous utilisez pour configurer l'autorisation.

• Extrait de code de votre demande

• Réponse JSON
  Si la réponse est une erreur, veillez à inclure le message d'erreur, et non 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: Accédez à la console Google APIs. Sélectionnez votre projet. Si vous n'avez pas encore créé de projet, consultez Créer un projet pour votre client. 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 est ON pour l'API Search Ads 360.
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 d'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, inscrivez le nom de votre produit sur l'écran de consentement de la console Google API.
Autres types d'erreurs d'autorisation	Assurez-vous d'utiliser un compte Google auquel a été accordé l'accès à Search Ads 360 lorsque vous vous connectez à la console Google API pour récupérer votre ID client et votre secret client, et lorsque vous obtenez un jeton d'actualisation.

Erreurs d'importation des conversions

Le tableau suivant répertorie les erreurs que vous pouvez rencontrer lorsque vous importez des 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 update n'est pas valide. Importez à nouveau les conversions après avoir effectué les opérations suivantes: Vérification que l'ID de clic a été généré six heures avant l'importation des conversions. Activez le service de conversion de l'API. Si vous attribuez des conversions à des visites spécifiques, attendez au moins six heures après la visite avant d'importer les données sur la conversion. Si vous les importez moins de six heures après la visite, Search Ads 360 risque de ne pas reconnaître l'ID de clic de la visite. Dans de rares cas, vous devrez peut-être patienter jusqu'à 24 heures avant que Search Ads 360 ne reconnaisse l'ID de clic. Nous avons confirmé que le clic provient d'une source valide, comme indiqué par le paramètre gclsrc. Vous avez vérifié que vous avez spécifié l'annonceur approprié dans la colonne advertiserId. Vérifier que votre ID de clic a été généré au cours des 90 derniers jours
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 demande correspond 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 que vous avez spécifié dans la colonne advertiserId. (Il est possible que vous ayez spécifié le mauvais annonceur.) Une fois que vous avez créé ou modifié une activité Floodlight, attendez quelques heures avant d'importer les 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 métrique) pour l'annonceur associé aux 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é aux clickId, criterionId ou productGroupId que vous attribuez à la conversion.
0x0000011A	The advertiser conversion ID is already specified for a conversion with Search Ads 360 conversion ID {ID}	Une conversion a déjà été importée pour la même portée 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 comme étant 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. Assurez-vous d'avoir spécifié le bon ID.
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 spécifié dans la demande. Lorsque vous vous connectez à la console Google APIs pour récupérer votre ID client et votre secret client, et lorsque vous obtenez un jeton d'actualisation, assurez-vous d'utiliser un compte Google auquel l'accès a été accordé à l'annonceur que vous avez spécifié.
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 de l'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 indiqués ne correspondent pas au type de conversion que vous avez spécifié.

Signaler les codes de réponse et les messages d'erreur

Si vous demandez un rapport et que la réponse est un message d'erreur, consultez les sections 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'interface utilisateur de Search Ads 360 ne correspondent pas à un rapport renvoyé par l'API

Par défaut, les données de l'interface utilisateur de Search Ads 360 doivent correspondre aux données 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.