Vous souhaitez nous faire part de vos commentaires sur l'API Google Ads ? Inscrivez-vous pour être invité à participer à des recherches sur l'expérience utilisateur.

Cette page a été traduite par l'API Cloud Translation.

Dépannage

La gestion des conversions nécessite une intégration complexe, impliquant souvent plusieurs outils et processus interdépendants. Ce guide décrit les étapes détaillées que vous pouvez suivre pour résoudre les problèmes que vous rencontrez, que vous receviez des erreurs de l'API que vous ne comprenez pas ou que vous ne compreniez pas les métriques ou les diagnostics affichés dans l'interface utilisateur.

Lire les métriques dans l'interface utilisateur Google Ads

L'interface utilisateur de Google Ads n'organise pas les métriques de conversion par date d'importation. Il peut donc être trompeur d'utiliser les rapports de l'interface utilisateur pour vérifier les résultats d'importation. Pour vérifier l'état de l'importation, commencez par les diagnostics hors connexion. Vous pouvez également en savoir plus sur les diagnostics dans l'interface utilisateur de Google Ads pour le suivi avancé des conversions pour les prospects et le suivi avancé des conversions pour le Web.

Problèmes liés au suivi avancé des conversions pour les prospects

Erreurs fréquentes

Erreur
`NO_CONVERSION_ACTION_FOUND`	L'action de conversion spécifiée n'est pas activée ou n'est pas accessible par le compte client spécifié par le champ "client_id" dans la requête. Assurez-vous que l'action de conversion de votre importation est activée et appartient au client qui envoie la demande d'importation. Cette erreur peut également se produire si le GCLID de la requête appartient à un compte client qui n'a pas accès à l'action de conversion spécifiée dans la requête. Vous pouvez vérifier si un GCLID appartient à un compte client à l'aide de la ressource `click_view` en envoyant une requête filtrée par `click_view.gclid` et `segments.date`, où la date correspond à celle du clic.
`INVALID_CONVERSION_ACTION_TYPE`	Le type de l'action de conversion spécifiée n'est pas valide pour le suivi avancé des conversions pour les prospects. Assurez-vous que le `ConversionAction` spécifié dans votre demande d'importation est de type `UPLOAD_CLICKS`.
`CLICK_CONVERSION_ALREADY_EXISTS`	Une conversion avec cet `conversion_date_time` existe déjà pour ce clic. Assurez-vous que l'élément `conversion_date_time` est unique pour chaque événement, puis réessayez.
`CUSTOMER_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS`	Assurez-vous d'avoir activé le suivi avancé des conversions pour les prospects dans vos paramètres de conversion. Pour ce faire, consultez le guide des prérequis.
`DUPLICATE_ORDER_ID`	Les événements importés incluent plusieurs conversions avec le même ID de commande et n'ont donc pas été traités. Supprimez les doublons dans les ID de commande, puis réessayez.
`CLICK_NOT_FOUND`	Aucun clic ne correspond aux identifiants utilisateur fournis. L'API Google Ads ne renvoie cette erreur que si `debug_enabled` est `true` sur le `UploadClickConversionsRequest`. Remarque:Traitez cette erreur comme un avertissement, sauf si elle se produit avec la majorité de vos conversions. Si une conversion rencontre cet avertissement, l'API Google Ads l'inclut dans la section `successful_event_count` de vos diagnostics des données hors connexion. L'API Google Ads inclut une entrée pour `CLICK_NOT_FOUND` dans la collection `alerts` afin que vous puissiez surveiller la fréquence de cet avertissement. Cette erreur est attendue si le clic ne provient pas d'une campagne Google Ads. Par exemple, il peut provenir de SA360 ou de DV360. Voici d'autres causes possibles: Le client qui importe les données est différent du client de la conversion Google Ads. Le taggage n'est pas correctement configuré pour votre formulaire pour prospects. Les données importées n'ont pas été correctement normalisées et hachées. Dans de rares cas où le client qui importe les données est différent du client de la conversion Google Ads, cette erreur peut signifier que le client qui importe les données a accepté les conditions relatives aux données client, mais que le client qui diffuse les annonces ne l'a pas fait. Pour déterminer si un compte a accepté les conditions d'utilisation des données client, interrogez la ressource `customer` et vérifiez le champ `customer.offline_conversion_tracking_info.accepted_customer_data_terms`.

Écarts entre les métriques

Gardez à l'esprit les problèmes courants suivants:

Pour diverses raisons, notre pipeline de traitement peut supprimer des conversions. Ces conversions ne sont pas récupérables. Pour en savoir plus, consultez l'article Corriger les écarts de données après une importation réussie.
Vérifiez que la balise Google est correctement configurée sur votre page Web et qu'elle se déclenche lors de l'envoi de formulaires pour prospects. Si votre balise ne se déclenche pas lors de l'envoi de formulaires ou si elle envoie des données incorrectes, vous constaterez probablement une attribution faible ou nulle dans les conversions importées. Consultez les articles de notre centre d'aide sur la configuration de la balise Google et la configuration de Google Tag Manager pour le suivi avancé des conversions pour les prospects.
Si vous utilisez le suivi avancé des conversions pour les prospects sans la balise Google sur votre page Web, vous devez inclure le GCLID dans vos importations de conversions en définissant le champ ClickConversion.gclid pour chaque conversion.
Vérifiez que vous spécifiez correctement le consentement dans vos importations. Pour ce faire, définissez les paramètres de consentement par défaut de votre compte (dans l'interface utilisateur Google Ads, cliquez sur Outils -> Gestionnaire de données -> Paramètres de consentement) ou définissez le champ ClickConversion.consent pour chaque conversion importée.

Problèmes liés aux performances des campagnes

Si vous n'avez aucun problème technique lors de l'importation de vos conversions et que vous êtes à l'aise avec les métriques présentées, mais que vous ne constatez pas l'amélioration attendue des performances de vos campagnes (ou "amélioration") après avoir implémenté le suivi avancé des conversions pour les prospects, contactez l'assistance produit Google Ads pour obtenir de l'aide.

Problèmes liés au suivi avancé des conversions pour le Web

Erreurs fréquentes

Erreur
`CONVERSION_NOT_FOUND`	Impossible de trouver une conversion pour la paire d'action de conversion et d'identifiant de conversion fournie ou pour `order_id`. Vérifiez que la conversion est une conversion Google Ads pour le client de conversion Google Ads spécifié dans l'`customer_id` de la requête. Vérifiez également que la conversion ne correspond pas à un clic pour lequel `gbraid` ou `wbraid` a été renseigné au lieu de `gclid`. Google Ads n'est pas compatible avec le suivi avancé des conversions pour le Web pour ces conversions.
`CUSTOMER_NOT_ACCEPTED_CUSTOMER_DATA_TERMS`	Les conditions d'utilisation des données client n'ont pas été acceptées pour le `customer_id` de la demande. Pour ce faire, consultez le guide des prérequis.
`CONVERSION_ALREADY_ENHANCED`	Cette conversion a déjà fait l'objet d'un ajustement avec les `order_id` et `conversion_action` indiqués. Veillez à fournir un `order_id` unique pour chaque conversion.
`CONVERSION_ACTION_NOT_ELIGIBLE_FOR_ENHANCEMENT`	L'`conversion_action` fourni n'est pas éligible au suivi avancé des conversions pour le Web. Dans l'interface utilisateur Google Ads, assurez-vous de cocher la case Activer le suivi avancé des conversions pour l'action de conversion référencée dans votre requête. Pour savoir comment procéder, consultez le Centre d'aide.

Problèmes généraux de gestion des conversions

Gardez à l'esprit les problèmes courants suivants:

Toute tentative de définition d'un champ d'énumération sur UNKNOWN entraîne une erreur RequestError.INVALID_ENUM_VALUE. Il s'agit d'un problème courant lorsque vous spécifiez consent, car l'annonceur ne sait peut-être pas si le consentement a été donné. Si l'état de consent est inconnu, il doit être défini sur DENIED.
Lorsque vous créez une action de conversion pour les conversions d'application ou pour Firebase et les fonctionnalités d'analyse d'applications tierces, vous ne pouvez modifier le champ app_id qu'au moment de la création. Une fois l'action de conversion créée, ce champ ne peut plus être modifié.
Lorsque vous créez une action de conversion, vous ne pouvez définir le champ ConversionAction.attribution_model_settings.attribution_model que sur GOOGLE_ADS_LAST_CLICK ou GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN. Toute autre option entraînera une erreur CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELS. Pour en savoir plus, consultez notre article de blog annonçant l'abandon d'autres modèles d'attribution.
La plage autorisée pour le champ click_through_lookback_window_days est [1, 60] pour les actions de conversion de type AD_CALL et WEBSITE_CALL. Pour la plupart des autres actions de conversion, la plage autorisée est [1, 30].
La plage autorisée pour le champ view_through_lookback_window_days est [1, 30] pour la plupart des actions de conversion. Ce champ doit être non défini pour les actions de conversion de type AD_CALL et WEBSITE_CALL.
Définir ou mettre à jour le champ include_in_conversion_metrics sur une action de conversion entraînera une erreur FieldError.IMMUTABLE_FIELD. Définissez plutôt le champ primary_for_goal, comme décrit dans le guide des objectifs de conversion.
Lorsque vous créez une action de conversion de type WEBSITE_CALL ou AD_CALL, l'attribut value_settings.always_use_default_value doit être défini sur true. Si vous spécifiez la valeur false, une erreur INVALID_VALUE est générée.

Erreurs fréquentes

Erreur
`INVALID_CONVERSION_ACTION_TYPE`	L'action de conversion spécifiée comporte un type non valide pour importer des conversions par clic. Assurez-vous que l'`ConversionAction` spécifié dans votre demande d'importation est de type `UPLOAD_CLICKS`.
`NO_CONVERSION_ACTION_FOUND`	L'action de conversion spécifiée n'est pas activée ou ne peut pas être trouvée dans le `customer_id` d'importation. Récupérez des informations sur la configuration de vos conversions pour vous assurer que l'action de conversion de votre importation est activée et appartient à l'`customer_id` de la demande d'importation.
`TOO_RECENT_CONVERSION_ACTION`	L'action de conversion vient d'être créée. Attendez au moins six heures après la création de l'action avant de réessayer les conversions ayant échoué.
`INVALID_CUSTOMER_FOR_CLICK`	Le `customer_id` de la requête ne correspond pas au numéro client qui était le compte de conversion de l'API Google Ads au moment du clic. Mettez à jour le `customer_id` de la requête avec le bon client.
`EVENT_NOT_FOUND`	Google Ads ne trouve pas la combinaison de l'ID de clic et de `customer_id`. Consultez les exigences concernant `customer_id` et vérifiez que vous importez les données à l'aide du bon compte Google Ads.
`DUPLICATE_CLICK_CONVERSION_IN_REQUEST`	Plusieurs conversions de la demande ont la même combinaison d'ID de clic, `conversion_date_time` et `conversion_action`. Supprimez les conversions en double de votre requête.
`CLICK_CONVERSION_ALREADY_EXISTS`	Une conversion associée à la même combinaison d'ID de clic, `conversion_date_time` et `conversion_action` a déjà été importée. Ignorez cette erreur si vous essayez de réimporter le fichier et que cette conversion a déjà réussi. Si vous souhaitez ajouter une autre conversion en plus de celle importée précédemment, ajustez le `conversion_date_time` de `ClickConversion` pour éviter de dupliquer la conversion importée précédemment.
`EVENT_NOT_FOUND`	Google Ads ne trouve pas la combinaison de l'ID de clic et de `customer_id`. Consultez les exigences concernant `customer_id` et vérifiez que vous importez les données à l'aide du bon compte Google Ads.
`EXPIRED_EVENT`	Le clic importé s'est produit avant la période spécifiée dans le champ `click_through_lookback_window_days`. Une modification de `click_through_lookback_window_days` n'affecte que les clics enregistrés après la modification. Par conséquent, modifier la période d'analyse ne résout pas cette erreur pour le clic en question. Le cas échéant, remplacez `conversion_action` par une autre action avec une période d'analyse plus longue.
`CONVERSION_PRECEDES_EVENT`	La valeur `conversion_date_time` est antérieure à la date et à l'heure du clic. Remplacez `conversion_date_time` par une valeur ultérieure.
`GBRAID_WBRAID_BOTH_SET`	La valeur `ClickConversion` est définie pour `gbraid` et `wbraid`. Modifiez la conversion pour qu'elle n'utilise qu'un seul ID de clic et assurez-vous de ne pas combiner plusieurs clics dans la même conversion. Chaque clic ne possède qu'un seul ID de clic.
`VALUE_MUST_BE_UNSET`	Vérifiez le `location` de l'`GoogleAdsError` pour déterminer lequel des problèmes suivants a entraîné l'erreur. `ClickConversion` a une valeur définie pour `gclid`, ainsi qu'au moins l'un des éléments `gbraid` ou `wbraid`. Modifiez la conversion pour n'utiliser qu'un seul ID de clic et assurez-vous de ne pas combiner plusieurs clics dans la même conversion. Chaque clic ne possède qu'un seul ID de clic. `ClickConversion` a une valeur définie pour `gbraid` ou `wbraid` et une valeur pour `custom_variables`. Google Ads n'est pas compatible avec les variables personnalisées pour une conversion avec un ID de clic `gbraid` ou `wbraid`. Définissez le champ `custom_variables` de la conversion sur "non défini".

Rapports