Dépannage

La gestion des conversions nécessite une intégration complexe, qui implique souvent plusieurs outils et processus interdépendants. Ce guide décrit en détail les étapes à suivre 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 de diagnostics qui vous semblent confus 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 sur les campagnes dans l'interface utilisateur pour vérifier les résultats d'importation peut être trompeuse. Pour vérifier l'état de l'importation au niveau des requêtes API, commencez par les diagnostics des données hors connexion. Les diagnostics des données hors connexion n'évaluent pas la correspondance asynchrone des balises ni la qualité des identifiants utilisateur pour le suivi avancé des conversions. Pour vérifier l'état de la correspondance, consultez les rapports de diagnostic de l'interface utilisateur Google Ads pour le suivi avancé des conversions pour les prospects et le suivi avancé des conversions pour le Web. Pour connaître la procédure de dépannage, consultez Alertes de diagnostic de l'UI après une importation d'API réussie.

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 dans le champ customer_id de la requête. Vérifiez que l'action de conversion de votre importation est activée et que son propriétaire est le client de conversion Google Ads du clic ou un compte de la hiérarchie de suivi des conversions du compte 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 l'élément 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 de 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

Gardez à l'esprit les 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 vos campagnes (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 aideront à diagnostiquer et à corriger les erreurs courantes liées au suivi avancé des conversions pour le Web.

Erreur
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 des instructions à ce sujet dans le guide des prérequis.
CONVERSION_ALREADY_ENHANCED Cette conversion a déjà reçu un ajustement ENHANCEMENT avec les champs order_id et conversion_action indiqués. Veillez à fournir une valeur 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.
INVALID_USER_IDENTIFIER Un champ d'identifiant utilisateur haché (hashed_email, hashed_phone_number, hashed_first_name, hashed_last_name ou hashed_street_address) n'est pas un condensé SHA-256 hexadécimal valide de 64 caractères. Normalisez et hachez les données fournies par l'utilisateur avant de les importer. Pour savoir comment procéder, consultez Normaliser et hacher les données fournies par l'utilisateur.
CONVERSION_NOT_FOUND

Google Ads n'a pas trouvé de conversion correspondant au champ conversion_action et à l'identifiant de conversion (order_id ou gclid_date_time_pair) fournis. Cette erreur ne s'applique qu'aux ajustements RESTATEMENT et RETRACTION. Pour en savoir plus, consultez Exigences concernant l'importation des ajustements des conversions.

Pour les ajustements ENHANCEMENT, l'API accepte la requête sans renvoyer d'erreur CONVERSION_NOT_FOUND et évalue la correspondance order_id entre la balise et l'API de manière asynchrone. Des taux élevés de valeurs order_id sans correspondance déclenchent une alerte de non-concordance des ID de commande dans le rapport sur les diagnostics du suivi avancé des conversions de l'interface utilisateur Google Ads. Pour connaître la procédure de dépannage, consultez Alertes de diagnostic de l'UI après une importation réussie via l'API.

Alertes de diagnostic de l'UI après une importation réussie via l'API

Lorsque vous importez des ajustements ENHANCEMENT à l'aide du service ConversionAdjustmentUploadService, l'API valide le formatage de la requête au moment de l'ingestion et met en correspondance les améliorations avec les événements de balise de site Web de manière asynchrone. Par conséquent, les requêtes API peuvent aboutir sans erreur dans le champ partial_failure_error et afficher l'état EXCELLENT dans le diagnostic des données hors connexion. En même temps, le rapport sur les diagnostics du suivi avancé des conversions dans l'UI Google Ads peut toujours afficher des alertes.

Vérifiez les causes suivantes lorsque des alertes de diagnostic de l'UI s'affichent après des importations d'API réussies :

  • Champs d'adresse obligatoires manquants : un objet OfflineUserAddressInfo dans le champ address_info nécessite quatre champs dans la même entrée : hashed_first_name, hashed_last_name, country_code et postal_code. Les champs hashed_street_address, city et state sont facultatifs (si vous renseignez le champ hashed_street_address, il doit toujours s'agir d'un condensé hexadécimal SHA-256 valide de 64 caractères). L'API accepte les objets address_info partiels non vides (par exemple, prénom et nom uniquement) sans renvoyer d'erreur dans le champ partial_failure_error. Cependant, la mise en correspondance en aval supprime les adresses incomplètes et déclenche une alerte pour les champs d'adresse manquants. Si l'un des quatre champs obligatoires n'est pas disponible, omettez l'objet UserIdentifier pour le champ address_info.

  • ID de transaction manquants dans les événements de balise de site Web : si vous omettez le champ order_id d'un ajustement ENHANCEMENT dans l'API, une erreur FieldError.REQUIRED synchrone est renvoyée. Lorsque vos requêtes API incluent le champ order_id, une alerte dans l'interface utilisateur concernant un ID de transaction manquant dans l'événement de conversion fait référence à la balise de votre site Web. Cette alerte s'affiche lorsque moins de 90 % des événements de balise de conversion sur le site Web incluent un ID de transaction valide (ou lorsque la balise envoie des chaînes d'espace réservé telles que "undefined" ou "null"). Configurez votre balise de conversion sur le site Web pour envoyer un ID de transaction unique pour chaque événement de conversion.

  • Incohérence entre les ID de commande de la balise et de l'API, ou importations tardives : pour les ajustements ENHANCEMENT, l'API ne renvoie pas d'erreur CONVERSION_NOT_FOUND ou CONVERSION_EXPIRED au moment de l'importation. Au lieu de cela, les valeurs order_id sans correspondance déclenchent une alerte de non-concordance d'ID de commande dans l'UI, et les améliorations importées plus de 24 heures après la conversion déclenchent une alerte d'importation tardive. Faites correspondre le champ order_id de l'API à la chaîne exacte de l'ID de transaction envoyée par la balise de conversion de votre site Web, puis importez l'amélioration dans les 24 heures suivant l'événement de conversion.

  • Données utilisateur non normalisées hachées avant l'importation : le hachage de valeurs non normalisées (par exemple, des lettres majuscules, des espaces de début ou de fin, ou des numéros de téléphone qui ne sont pas au format E.164) produit toujours un condensé hexadécimal SHA-256 valide de 64 caractères. L'API accepte l'importation sans renvoyer d'erreur INVALID_USER_IDENTIFIER, tandis que la mise en correspondance en aval échoue et signale des alertes de mise en forme ou de faible taux de correspondance. Suivez les règles de normalisation décrites dans Normaliser et hacher les données fournies par l'utilisateur.

  • Faible volume d'améliorations d'API par rapport au volume de balises de site Web : les diagnostics de l'interface utilisateur comparent les améliorations d'API dédupliquées contenant des identifiants utilisateur aux événements de balise de site Web dédupliqués pour lesquels l'utilisateur a donné son consentement :

    • Configuration du mode Consentement : lorsque le mode Consentement sur la balise Google signale le paramètre ad_storage='denied', les diagnostics de l'interface utilisateur excluent de la comparaison les événements de balise de site Web sans consentement. Ainsi, l'omission de ces événements dans les importations d'API ne déclenche pas d'alerte de faible volume. Toutefois, une gestion incohérente du consentement entre la balise de votre site Web et les déclencheurs de backend génère des alertes :

      • La balise ne comporte pas de ad_storage='denied', le backend ignore l'importation : les diagnostics de l'interface utilisateur comptabilisent les événements de balise comme ayant reçu le consentement et signalent une alerte de faible couverture.
      • Signaux de balise ad_storage='denied', amélioration des importations backend : Les améliorations importées ne sont pas associées à un événement de balise avec consentement et contribuent aux alertes de non-concordance d'ID de commande.

      Appliquez le même état du consentement à la balise de votre site Web et à vos importations d'amélioration d'API.

    • Événements de site Web anonymes : n'activez pas le suivi avancé des conversions pour les actions de conversion en haut de l'entonnoir (comme les pages vues ou les vues d'articles) où la balise de site Web se déclenche pour les visiteurs anonymes. Si votre serveur n'envoie des améliorations d'API que pour les utilisateurs connectés dont les coordonnées sont connues, les événements de balise anonymes sans correspondance déclenchent une alerte de faible couverture. N'activez le suivi avancé des conversions que pour les actions de conversion pour lesquelles les données fournies par l'utilisateur sont systématiquement disponibles.

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 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, l'élément 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 aident à diagnostiquer et à corriger les erreurs courantes liées à l'importation des conversions hors connexion, y compris les erreurs d'accès au suivi des conversions multicomptes.

Erreur
INVALID_CONVERSION_ACTION_TYPE L'action de conversion spécifiée comporte un type qui n'est pas valide pour l'importation de 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 n'est pas accessible par le compte dans le champ customer_id de la requête. Récupérez des informations sur la configuration du suivi des conversions pour vérifier que l'action de conversion est activée. Le propriétaire de l'action de conversion doit être le client de conversion Google Ads du clic ou un compte de la hiérarchie de suivi des conversions du compte d'importation. Par exemple, cette erreur se produit si l'action de conversion appartient à un ancien compte administrateur qui a été dissocié après le clic.
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 champ customer_id de la requête ne correspond pas au client de conversion Google Ads au moment du clic. Cette erreur se produit lorsque le compte d'importation ne dispose pas non plus d'un accès multicompte à l'action de conversion. Remplacez le champ customer_id de la requête par un compte de la hiérarchie du propriétaire de l'action de conversion.
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 la conversion et qu'elle a déjà été importé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 précédemment 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

Le ClickConversion comporte une valeur définie pour gbraid ou wbraid (sans gclid) et une valeur pour custom_variables ou cart_data, que Google Ads n'accepte pas avec gbraid ou wbraid. Annulez la définition du champ en conflit.