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é.
|
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2024/12/16 (UTC).
[null,null,["Dernière mise à jour le 2024/12/16 (UTC)."],[[["This page provides troubleshooting information for common issues encountered while using the Search Ads 360 API, including authorization and conversion upload errors."],["If the provided resources don't resolve your issue, contact support with specific information about your problem, including your Search Ads 360 and Google API Console credentials, code snippets, and JSON responses."],["The page lists common authorization errors such as `Access Not Configured`, `Invalid grant`, and `Invalid client`, with explanations and solutions."],["It also includes a table of conversion upload errors, detailing their hexadecimal error codes, descriptions, and troubleshooting steps."],["For report discrepancies, refer to the Response Codes and Standard Error Responses documentation and ensure the `includeRemovedEntities` setting in your request matches the \"Show removed\" checkbox selection in the Search Ads 360 UI."]]],["When troubleshooting the Search Ads 360 API, consult the provided resources. If issues persist, contact support, providing your Agency/Advertiser ID, Project Number, API access username, code snippet, and JSON response (including full error messages). Common authorization errors include `Access Not Configured`, `Invalid grant`, and `Invalid client`, often resolved by enabling the API, refreshing tokens, or naming your project. Conversion upload errors relate to invalid click IDs, Floodlight activity names, or custom dimensions/metrics. Ensure correct permissions and data consistency between UI and API.\n"]]
