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 lu les ressources disponibles sur ce site, contactez l'assistance et gardez les informations suivantes à disposition:

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

  • Numéro de projet dans la console d'API Google

  • Nom d'utilisateur du compte Google que vous utilisez pour accéder à l'API.
    Il s'agit du compte autorisé à accéder à Search Ads 360, qui est le compte 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 pas uniquement le code d'erreur numérique.

Erreurs d'autorisation

Voici quelques erreurs d'autorisation couramment rencontrées:

d'un 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 la section Créer un projet pour votre client.

  3. Dans la barre latérale située à gauche, développez API et authentification. Cliquez ensuite sur API. Dans la liste des API, assurez-vous que l'état est activé 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 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 d'autorisation de la console API Google.

Autres types d'erreurs d'autorisation

Veillez à 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 répertorie les erreurs que vous pouvez rencontrer lors de l'importation 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 d'un 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. Réimportez les conversions après avoir effectué les opérations suivantes:

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

  • activé le service de conversion de l'API ;

  • Si vous attribuez des conversions à des visites spécifiques, attendez au moins 30 minutes avant d'importer les conversions. Search Ads 360 peut ne pas reconnaître l'ID de clic de la visite si vous importez les données dans un délai inférieur à 30 minutes après la visite. Dans de rares cas, vous devrez peut-être attendre jusqu'à quatre heures avant que Search Ads 360 ne reconnaisse l'ID de clic.

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

  • Vérifiez que vous avez spécifié l'annonceur approprié dans la colonne advertiserId.

  • Vous avez vérifié 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ée dans la colonne segmentationName est incorrect ou n'est pas encore disponible. Si vous rencontrez cette erreur, recherchez les problèmes courants suivants:

  • Les noms sont sensibles à la casse. Assurez-vous donc que votre requête 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.
  • Vérifiez que vous avez 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.
  • 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 une métrique) pour l'annonceur associé à l'élément clickId, criterionId ou productGroupId que vous attribuez pour 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é au clickId, au criterionId ou au productGroupId que vous attribuez pour la conversion.

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

Quelqu'un a déjà importé une conversion avec le même champ d'application et le même ID de conversion d'annonceur que ceux indiqués dans la colonne conversionId.

L'ID de conversion 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. Il est unique.
0x0000011B Advertiser conversion ID '{ID}' is not found

Votre demande update a tenté de mettre à jour un ID de conversion d'annonceur qui n'existe pas. Assurez-vous d'avoir indiqué le bon ID.
0x0000011D User does not have permission to view advertiser {advertiser ID}

Le compte Google utilisé par votre client ne dispose pas des autorisations nécessaires pour 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 code secret client, et lorsque vous obtenez un jeton d'actualisation, assurez-vous d'utiliser un compte Google autorisé à accéder à l'annonceur que vous avez spécifié.
0x0000011F Advertiser conversion ID is already specified in this request

Plusieurs requêtes 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 d'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é.

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 Codes de réponse dans l'API Search Ads 360 et Réponses d'erreur standards pour plus d'informations sur l'erreur.

Les données de l'interface utilisateur de Search Ads 360 ne correspondent pas à celles d'un rapport renvoyé par l'API

Par défaut, les données de l'interface utilisateur de 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.