Dépannage

La gestion des conversions nécessite une intégration complexe, qui implique souvent plusieurs outils et processus interdépendants. Ce guide propose des étapes détaillées 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 que vous voyez dans l'UI.

Lire les métriques dans l'UI Google Ads

L'interface utilisateur de Google Ads n'organise pas les métriques de conversion par date d'importation. Par conséquent, l'utilisation des rapports de l'interface utilisateur 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'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

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

Erreurs fréquentes

Les conseils suivants vous aident à 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 n'est pas accessible par le compte client spécifié par le champ customer_id dans la requête. Assurez-vous que l'action de conversion de votre importation est activée et qu'elle 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 à la date 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. Pour savoir comment procéder, 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.

Si une conversion rencontre cet avertissement, l'API Google Ads l'inclut dans le 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 :

Dans les 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 qui diffuse les annonces.

Vous pouvez déterminer si un compte a accepté les conditions d'utilisation des données client en interrogeant la ressource customer et en vérifiant le champ customer.conversion_tracking_setting.accepted_customer_data_terms.

Écarts entre les métriques

Tenez compte des problèmes courants suivants :

  • Les conversions peuvent être supprimées par notre pipeline de traitement pour diverses raisons, et ces conversions sont irrécupérables. 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 constaterez probablement une attribution faible, voire 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, vous pouvez définir les paramètres de consentement par défaut de votre compte (dans l'interface utilisateur de 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 de performances de la campagne

Si vous ne rencontrez aucun problème technique lors de l'importation de vos conversions et que les métriques présentées vous conviennent, mais que vous ne constatez pas l'amélioration attendue des performances de votre campagne (ou "lift") 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 aident à diagnostiquer et à corriger les erreurs courantes liées au suivi avancé des conversions pour le Web.

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 le customer_id de la requête.
Vérifiez également que la conversion n'a pas été enregistrée pour un clic où gbraid ou wbraid ont été renseignés 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 requête. Vous trouverez les instructions correspondantes dans le guide des prérequis.
CONVERSION_ALREADY_ENHANCED Cette conversion a déjà été ajustée avec les valeurs order_id et conversion_action indiquées. 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, veillez à 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

Tenez compte des 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 alors que l'annonceur ne sait peut-être pas si le consentement a été accordé. 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 l'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 des autres modèles d'attribution.

  • La plage autorisée pour le champ click_through_lookback_window_days est de 1 à 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 de 1 à 90 jours.

  • La plage autorisée pour le champ view_through_lookback_window_days est de 1 à 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.

  • La définition ou la mise à jour du champ include_in_conversions_metric sur une action de conversion entraîne une erreur FieldError.IMMUTABLE_FIELD. 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, le champ value_settings.always_use_default_value doit être défini sur true. Si vous spécifiez la valeur false, une erreur INVALID_VALUE se produit.

Erreurs fréquentes

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

Erreur
INVALID_CONVERSION_ACTION_TYPE L'action de conversion spécifiée comporte un type qui n'est pas valide pour l'importation des conversions par 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 les informations sur votre configuration de conversion pour vous assurer que l'action de conversion de votre importation est activée et qu'elle 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 réessayer d'importer les conversions ayant échoué.
INVALID_CUSTOMER_FOR_CLICK Le customer_id de la requête n'est pas le même numéro client que celui du compte de conversion de l'API Google Ads au moment du clic. Remplacez customer_id de la requête par le client approprié.
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 requête 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 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 cette conversion et qu'elle a déjà été effectuée. Si vous souhaitez ajouter une autre conversion en plus de celle que vous avez déjà importée, ajustez le conversion_date_time de ClickConversion pour éviter de dupliquer la conversion déjà importée.
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 période d'analyse 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é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 La valeur conversion_date_time est antérieure à la date et à l'heure du clic. Remplacez conversion_date_time par une valeur ultérieure.
VALUE_MUST_BE_UNSET

La valeur de ClickConversion est définie sur gbraid ou wbraid (sans gclid) et sur custom_variables ou cart_data, ce que Google Ads n'accepte pas avec gbraid ou wbraid. Annulez la définition du champ en conflit.