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 munissez-vous des 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

  • Le 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. Il s'agit du compte que vous utilisez pour configurer les autorisations.

  • Extrait de code de votre requête

  • 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 couramment rencontrées:

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 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, saisissez le nom de votre produit sur l'écran de consentement de la console Google APIs.

Autres types d'erreurs d'autorisation

Veillez à 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. Réimportez les conversions après avoir effectué les opérations suivantes:

  • Vérification 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 la conversion. Il est possible que Search Ads 360 ne reconnaisse pas l'ID de clic de la visite si vous effectuez l'importation moins de 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.

  • Vous avez 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 vous rencontrez cette erreur, recherchez 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.
  • Vérifiez que vous avez indiqué 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.)
  • Lorsque vous créez ou modifiez une activité Floodlight, patientez 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 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 indiqué le bon ID.
0x0000011D User does not have permission to view advertiser {advertiser ID}

Le compte Google que votre client utilise 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 dans la demande 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 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 requête de rapport, assurez-vous que la case Afficher les éléments supprimés est également cochée dans l'UI.