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 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 |
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 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 ressourcecustomer 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.gclidpour 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.consentpour 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 Pour les ajustements |
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
OfflineUserAddressInfodans le champaddress_infonécessite quatre champs dans la même entrée :hashed_first_name,hashed_last_name,country_codeetpostal_code. Les champshashed_street_address,cityetstatesont facultatifs (si vous renseignez le champhashed_street_address, il doit toujours s'agir d'un condensé hexadécimal SHA-256 valide de 64 caractères). L'API accepte les objetsaddress_infopartiels non vides (par exemple, prénom et nom uniquement) sans renvoyer d'erreur dans le champpartial_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'objetUserIdentifierpour le champaddress_info.ID de transaction manquants dans les événements de balise de site Web : si vous omettez le champ
order_idd'un ajustementENHANCEMENTdans l'API, une erreurFieldError.REQUIREDsynchrone est renvoyée. Lorsque vos requêtes API incluent le champorder_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'erreurCONVERSION_NOT_FOUNDouCONVERSION_EXPIREDau moment de l'importation. Au lieu de cela, les valeursorder_idsans 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 champorder_idde 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.
- La balise ne comporte pas de
É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
UNKNOWNentraîne une erreurRequestError.INVALID_ENUM_VALUE. Il s'agit d'un problème courant lorsque vous spécifiezconsentalors que l'annonceur ne sait peut-être pas si le consentement a été accordé. Si l'état deconsentest inconnu, il doit être défini surDENIED.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_idqu'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_modelque surGOOGLE_ADS_LAST_CLICKouGOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN. Toute autre option entraînera une erreurCANNOT_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_daysest de1à60jours pour les actions de conversion de typeAD_CALLetWEBSITE_CALL. Pour la plupart des autres actions de conversion, la plage autorisée est de1à90jours.La plage autorisée pour le champ
view_through_lookback_window_daysest de1à30jours pour la plupart des actions de conversion. Ce champ doit être non défini pour les actions de conversion de typeAD_CALLetWEBSITE_CALL.La définition ou la mise à jour du champ
include_in_conversions_metricsur une action de conversion entraîne une erreurFieldError.IMMUTABLE_FIELD. Définissez plutôt le champprimary_for_goal, comme décrit dans le guide sur les objectifs de conversion.Lorsque vous créez une action de conversion de type
WEBSITE_CALLouAD_CALL, l'élémentvalue_settings.always_use_default_valuedoit être défini surtrue. Si vous spécifiez la valeurfalse, une erreurINVALID_VALUEse 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 |