Dépannage

La gestion des conversions nécessite une intégration complexe, impliquant souvent plusieurs outils et processus interdépendants. Ce guide vous propose des étapes détaillées pour résoudre les problèmes que vous rencontrez, qu'il s'agisse d'erreurs de l'API que vous ne comprenez pas ou de métriques ou diagnostics que vous ne comprenez pas dans l'UI.

Important : Une réponse d'importation réussie de l'API ne signifie pas nécessairement que les conversions ont été attribuées. Pour en savoir plus sur les écarts de données après une importation réussie, consultez Écarts de données après une importation réussie.

Lire les métriques dans l'UI Google Ads

L'UI Google Ads n'organise pas les métriques de conversion par date d'importation. Par conséquent, l'utilisation des rapports dans l'UI pour vérifier les résultats d'importation peut être trompeuse. Pour vérifier l'état de l'importation, commencez par les diagnostics des données hors connexion. Vous pouvez également en savoir plus sur les diagnostics dans l'UI 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

Cette section explique comment résoudre les problèmes courants rencontrés lors de l'importation de conversions optimisées pour les prospects.

Erreurs fréquentes

Les conseils suivants vous aideront à diagnostiquer et à corriger les erreurs courantes liées au suivi avancé des conversions pour les prospects.

Erreur
NO_CONVERSION_ACTION_FOUND	L'action de conversion spécifiée n'est pas activée ou le compte client spécifié par le champ customer_id de la requête ne peut pas y accéder. 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 qui filtre 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.
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. Vous trouverez les instructions correspondantes dans le guide des conditions préalables.
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 correspondant aux identifiants utilisateur fournis n'a été trouvé. 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 le successful_event_count de vos diagnostics sur les 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 normale 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 conversion Google Ads. Le taggage n'est pas correctement configuré pour votre formulaire de lead. 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 conversion Google Ads, cette erreur peut signifier que le client qui importe les données a accepté les conditions d'utilisation des données client, mais pas le client de diffusion. 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.conversion_tracking_setting.accepted_customer_data_terms.

Écarts dans les métriques

Voici quelques problèmes courants à prendre en compte :

• Les conversions peuvent être supprimées par notre pipeline de traitement pour diverses raisons. Il est impossible de les récupérer. Pour en savoir plus, consultez É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 de lead. Si votre balise ne se déclenche pas lors de l'envoi de formulaires ou si elle envoie des données incorrectes, vous verrez probablement une attribution faible, voire nulle, dans les conversions importées. Consultez nos articles du 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, vous pouvez définir les paramètres de consentement par défaut pour votre compte (dans l'UI Google Ads, cliquez sur Outils > Gestionnaire de données > Paramètres de consentement) ou définir le champ ClickConversion.consent pour chaque conversion importée.

Problèmes liés aux performances de la campagne

Si vous ne rencontrez aucun problème technique pour importer vos conversions et que vous êtes à l'aise avec les métriques présentées, mais que vous ne constatez pas les améliorations attendues des performances de vos campagnes (ou "hausse") 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

Cette section explique comment résoudre les problèmes courants rencontrés lors de l'importation du suivi avancé des conversions pour le Web.

Erreurs fréquentes

Les conseils suivants vous aideront à diagnostiquer et à corriger les erreurs courantes liées au suivi avancé des conversions pour le Web.

Erreur
CONVERSION_NOT_FOUND	Aucune conversion n'a été trouvée pour la paire action de conversion et identifiant de conversion fournie ou order_id. Vérifiez que la conversion est une conversion Google Ads pour le client de conversion Google Ads spécifié dans le customer_id de la demande. Vérifiez également que la conversion ne correspond pas à un clic pour lequel gbraid ou wbraid ont été renseignés au lieu de gclid. Google Ads n'accepte pas 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. Vous trouverez les instructions correspondantes dans le guide des prerequisites.
CONVERSION_ALREADY_ENHANCED	Cette conversion a déjà fait l'objet d'un ajustement avec les valeurs order_id et conversion_action. Veillez à fournir un order_id unique pour chaque conversion.
CONVERSION_ACTION_NOT_ELIGIBLE_FOR_ENHANCEMENT	Le conversion_action fourni n'est pas éligible au suivi avancé des conversions pour le Web. Dans l'UI Google Ads, assurez-vous de cocher la case Activer le suivi avancé des conversions pour l'action de conversion mentionnée dans votre demande. Pour savoir comment procéder, consultez le Centre d'aide.

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

Voici quelques problèmes courants à prendre en compte :

• Si vous tentez de définir un champ enum sur UNKNOWN, vous obtiendrez une erreur RequestError.INVALID_ENUM_VALUE. Il s'agit d'un problème courant lorsque vous spécifiez consent alors que l'annonceur ne sait 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 Firebase et les solutions d'analyse d'applications tierces, vous ne pouvez modifier le champ app_id que lors 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 des autres modèles d'attribution.

• La plage autorisée pour le champ click_through_lookback_window_days est comprise entre 1 et 60 jours 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 comprise entre 1 et 90 jours.

• La plage autorisée pour le champ view_through_lookback_window_days est comprise entre 1 et 30 jours 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.

• Si vous définissez ou mettez à jour le champ include_in_conversions_metric d'une action de conversion, une erreur FieldError.IMMUTABLE_FIELD se produira. Définissez plutôt le champ primary_for_goal, comme décrit dans le guide sur les objectifs de conversion.

• Lorsque vous créez une action de conversion de type WEBSITE_CALL ou AD_CALL, value_settings.always_use_default_value doit être défini sur true. Si vous spécifiez la valeur false, une erreur INVALID_VALUE se produira.

Erreurs fréquentes

Les conseils suivants vous aideront à diagnostiquer et à résoudre les erreurs courantes liées à l'importation des conversions hors connexion.

Erreur
INVALID_CONVERSION_ACTION_TYPE	L'action de conversion spécifiée a un type qui n'est pas valide pour importer des conversions après clic. Assurez-vous que le 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 est introuvable dans le customer_id d'importation. Récupérez des informations sur votre configuration de conversion pour vous assurer que l'action de conversion de votre importation est activée et appartient au 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 relancer les conversions ayant échoué.
INVALID_CUSTOMER_FOR_CLICK	Le customer_id de la demande 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 demande pour qu'il corresponde au bon client.
EVENT_NOT_FOUND	Google Ads n'a pas trouvé la combinaison de l'ID de clic et de customer_id. Consultez les exigences concernant customer_id et vérifiez que vous effectuez l'importation dans le bon compte Google Ads.
DUPLICATE_CLICK_CONVERSION_IN_REQUEST	Plusieurs conversions de la demande ont la même combinaison d'ID de clic, de conversion_date_time et de conversion_action. Supprimez les conversions en double de votre requête.
CLICK_CONVERSION_ALREADY_EXISTS	Une conversion avec la même combinaison d'ID de clic, de conversion_date_time et de conversion_action a déjà été importée. Ignorez cette erreur si vous avez réessayé d'importer le fichier et que cette conversion a déjà réussi. Si vous souhaitez ajouter une autre conversion en plus de celle précédemment importée, ajustez le conversion_date_time de ClickConversion pour éviter de dupliquer la conversion précédemment importée.
EVENT_NOT_FOUND	Google Ads n'a pas trouvé la combinaison de l'ID de clic et de customer_id. Consultez les exigences concernant customer_id et vérifiez que vous effectuez l'importation dans le 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 la click_through_lookback_window_days n'a d'impact que sur les clics enregistrés après la modification. Par conséquent, la modification de la période d'analyse ne résoudra pas cette erreur pour le clic en question. Si nécessaire, remplacez conversion_action par une autre action avec une période d'analyse plus longue.
CONVERSION_PRECEDES_EVENT	Le conversion_date_time est antérieur à la date et à l'heure du clic. Remplacez la valeur conversion_date_time par une valeur ultérieure.
GBRAID_WBRAID_BOTH_SET	La valeur de ClickConversion est définie pour gbraid et wbraid. Mettez à jour la conversion pour n'utiliser qu'un seul paramètre d'URL ou 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 ou paramètre d'URL.
VALUE_MUST_BE_UNSET	Vérifiez le location de 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 une des valeurs gbraid ou wbraid. Mettez à jour la conversion pour n'utiliser qu'un seul ID de clic ou paramètre d'URL, et assurez-vous de ne pas combiner plusieurs clics dans la même conversion. Chaque clic ne comporte qu'un seul ID de clic ou paramètre d'URL. La valeur de ClickConversion est définie sur gbraid ou wbraid, et la valeur de custom_variables est définie. Google Ads n'accepte pas les variables personnalisées pour une conversion avec un paramètre d'URL gbraid ou wbraid. Supprimez le champ custom_variables de la conversion.