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.
Plusieurs raisons peuvent expliquer que votre taux de correspondance soit plus faible que prévu :
- 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 dans un autre système.
- Vous essayez d'ajouter plusieurs identifiants utilisateur à un même objet
UserIdentifier. Ajoutez plutôt plusieurs objetsUserIdentifierà un seul objetUserData, 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
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 des 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 tentez de créer plusieurs jobs avec le même
external_id.
|
CONFLICTING_OPERATION
|
Cette erreur peut se produire si des opérations remove sont mélangées à des opérations create dans un même job.
|
TOO_MANY_USER_IDENTIFIERS
|
Les create opérations 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 une opération 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 lot conformément au flux d'utilisation recommandé. Vous pouvez également consulter le guide des bonnes pratiques concernant les limites et quotas des API. |
CUSTOMER_NOT_ALLOWLISTED_FOR_THIS_FEATURE
|
Cette erreur se produit si votre projet Google Cloud (ou votre ancien jeton de développeur, obsolète depuis le 9 septembre 2026) n'a reçu aucune demande de ciblage par liste de clients entre le 1er octobre 2025 et le 31 mars 2026. Vous devez plutôt utiliser l' API Data Manager pour les workflows de ciblage par liste de clients. |
Aide supplémentaire pour résoudre les problèmes
Si le problème persiste, contactez-nous à l'aide de l'outil de dépannage du ciblage par liste de clients.