Résoudre les problèmes liés aux listes de clients
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Ce guide vous aidera à résoudre les problèmes liés aux faibles taux de correspondance et aux erreurs courantes qui peuvent survenir lors de l'intégration du ciblage par liste de clients.
Valider le taux de correspondance
Assurez-vous que votre job d'importation est terminé avant de tenter de valider votre taux de correspondance.
Votre taux de correspondance peut être inférieur à ce que vous attendiez pour plusieurs raisons :
Les données n'ont pas été hachées avant d'être importées.
Les données n'ont pas été correctement mises en forme avant d'être hachées.
Vous comparez les taux de correspondance à ceux d'un autre système.
Vous essayez d'ajouter plusieurs identifiants utilisateur à un seul objet UserIdentifier. Ajoutez plutôt plusieurs UserIdentifier à un seul objet UserData, comme indiqué dans cet exemple de code.
Un annonceur peut toucher entre 1 % et 99 % des utilisateurs de sa liste, en fonction de leur activité sur le Réseau de Recherche Google, Gmail ou YouTube. Pour obtenir un guide plus détaillé sur la résolution des problèmes liés aux faibles taux de correspondance, consultez le Centre d'aide.
Différences entre le taux de correspondance et la taille de la liste
Notez que la taille de la liste et le taux de correspondance reflètent des valeurs différentes. Le taux de correspondance comptabilise tous les utilisateurs disposant d'un compte Google, même s'il n'est pas possible de les toucher avec la liste pour le ciblage par liste de clients. La taille de la liste correspond au nombre d'utilisateurs actifs qui correspondent à un compte Google et qui peuvent être touchés par la personnalisation des annonces.
Déboguer les erreurs courantes
| Erreur |
USER_PERMISSION_DENIED
|
Vous pouvez rencontrer des erreurs d'autorisation si vous essayez de modifier une liste créée par un autre compte. Vous ne pouvez modifier que les listes créées par votre propre compte.
|
EXTERNAL_UPDATE_ID_ALREADY_EXISTS
|
Cette erreur peut se produire si vous essayez de créer plusieurs jobs avec le même external_id.
|
CONFLICTING_OPERATION
|
Cette erreur peut se produire si des opérations remove sont associées à des opérations create dans un même job.
|
TOO_MANY_USER_IDENTIFIERS
|
Les opérations create d'un même job contiennent plus de 100 000 user_identifiers au total. Divisez la requête en plusieurs requêtes qui ne dépassent pas cette limite.
|
CONCURRENT_MODIFICATION
|
Cette erreur peut se produire si vous essayez d'effectuer des opérations sur la même liste en même temps.
|
RESOURCE_EXHAUSTED
|
Cette erreur peut se produire si vous essayez d'envoyer trop de requêtes. Pour atténuer ce problème, regroupez vos opérations par lots conformément au
flux d'utilisation recommandé. Vous pouvez également consulter le guide des bonnes pratiques concernant les limites et quotas des API.
|
Assistance supplémentaire pour la résolution des problèmes
Si vous rencontrez toujours des problèmes, contactez-nous à l'aide de l'outil de dépannage du ciblage par liste de clients.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/09/05 (UTC).
[null,null,["Dernière mise à jour le 2025/09/05 (UTC)."],[[["\u003cp\u003eThis guide helps you troubleshoot low Customer Match rates and debug common errors during integration.\u003c/p\u003e\n"],["\u003cp\u003eLow match rates can stem from data formatting issues, hashing problems, or comparing against different systems.\u003c/p\u003e\n"],["\u003cp\u003eMatch rate and list size differ: match rate includes all matched Google Accounts, while list size only includes active, reachable users.\u003c/p\u003e\n"],["\u003cp\u003eCommon errors like permission issues, conflicting operations, and exceeding user identifier limits are addressed with solutions.\u003c/p\u003e\n"],["\u003cp\u003eFor persistent issues, consult the Customer Match troubleshooter or Help Center for detailed guidance.\u003c/p\u003e\n"]]],[],null,["# Troubleshoot customer list issues\n\nUse this guide to help you troubleshoot low match rates and common errors that\nmight come up in your Customer Match integration.\n\nValidate match rate\n-------------------\n\nEnsure that your upload job has completed before attempting to validate your\nmatch rate.\n\nYour match rate might be lower than expected for a number of reasons, including:\n\n- The data was not hashed before it was uploaded.\n\n- The data was not correctly formatted before it was hashed.\n\n- You are comparing against match rates in a different system.\n\n- You are trying to add multiple user identifiers to a single `UserIdentifier`\n object. Instead, add multiple `UserIdentifier`s to a single `UserData`\n object as shown in this\n [code example](/google-ads/api/docs/remarketing/audience-segments/customer-match/get-started#code_example).\n\nIt's possible for an advertiser to reach anywhere from 1% to 99% of their list,\nbased on how active their users are on Google Search, Gmail, or YouTube. For a\nmore detailed guide on troubleshooting low match rates, visit the [Help\nCenter](//support.google.com/google-ads/answer/7474166).\n\n### Differences between match rate and list size\n\nNote that list size and match rate reflect different values. Match rate\ncounts all users with a Google Account even if they are not actually able to be\nreached with the Customer Match list. List size counts\n[active](//support.google.com/google-ads/answer/7474166?#zippy=%2Ctroubleshoot-low-traffic)\nusers that matched a Google Account and are able to be reached by Ads\npersonalization.\n\nDebug common errors\n-------------------\n\n| Error ||\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| [`USER_PERMISSION_DENIED`](/google-ads/api/reference/rpc/v21/AuthorizationErrorEnum.AuthorizationError#user_permission_denied) | You might run into permissions errors if you attempt to modify a list that was created by another account. You can only edit a list that your own account created. |\n| [`EXTERNAL_UPDATE_ID_ALREADY_EXISTS`](/google-ads/api/reference/rpc/v21/OfflineUserDataJobErrorEnum.OfflineUserDataJobError#external_update_id_already_exists) | This error can occur if you attempt to create multiple jobs with the same [`external_id`](/google-ads/api/reference/rpc/v21/OfflineUserDataJob#external_id). |\n| [`CONFLICTING_OPERATION`](/google-ads/api/reference/rpc/v21/OfflineUserDataJobErrorEnum.OfflineUserDataJobError#conflicting_operation) | This error can occur if `remove` operations are mixed with `create` operations in a single job. |\n| [`TOO_MANY_USER_IDENTIFIERS`](/google-ads/api/reference/rpc/v21/OfflineUserDataJobErrorEnum.OfflineUserDataJobError#too_many_user_identifiers) | The `create` operations in a single job contain more than 100,000 `user_identifiers` in total. Split the request into multiple requests that don't exceed that limit. |\n| [`CONCURRENT_MODIFICATION`](/google-ads/api/reference/rpc/v21/DatabaseErrorEnum.DatabaseError#concurrent_modification) | This error can occur if you try to operate on the same list at the same time. |\n| [`RESOURCE_EXHAUSTED`](/google-ads/api/reference/rpc/v21/QuotaErrorEnum.QuotaError#resource_exhausted) | This error can occur if you try to send too many requests. You can mitigate this by batching your operations as per the recommended [usage flow](/google-ads/api/docs/remarketing/audience-segments/customer-match/get-started#usage-flow). You can also refer to the best practices guide for [API limits and quotas](/google-ads/api/docs/best-practices/quotas). |\n\nAdditional troubleshooting support\n----------------------------------\n\nIf you're still having issues, reach out to us through the Customer Match\n[troubleshooter](//support.google.com/google-ads/troubleshooter/10028577)."]]
