Résoudre les problèmes liés aux listes de clients

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 tâche d'importation est terminée avant de tenter de valider votre taux de correspondance.

Votre taux de correspondance peut être inférieur aux attentes pour plusieurs raisons, y compris les suivantes :

  • Les données n'ont pas été hachées avant d'être importées.

  • Les données n'ont pas été mises en forme correctement avant d'être hachées.

  • Vous comparez les taux de correspondance dans un autre système.

  • Vous essayez d'ajouter plusieurs identifiants utilisateur à un seul objet UserIdentifier. Ajoutez plutôt plusieurs UserIdentifier à un seul UserData objet, comme illustré dans cet exemple de code.

Un annonceur peut toucher entre 1 % et 99 % de sa liste, en fonction de l'activité de ses utilisateurs sur la 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'ils ne peuvent pas être touchés avec la liste pour le ciblage des clients. La taille de la liste comptabilise les 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 tentez de modifier une liste qui a été créée par un autre compte. Vous ne pouvez modifier qu'une liste créée par votre propre compte.
EXTERNAL_UPDATE_ID_ALREADY_EXISTS Cette erreur peut se produire si vous tentez de créer plusieurs tâches avec le même external_id.
CONFLICTING_OPERATION Cette erreur peut se produire si des opérations remove sont combinées à des opérations create dans une même tâche.
TOO_MANY_USER_IDENTIFIERS Les opérations create d'une même tâche 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. Vous pouvez l'éviter en regroupant 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 les quotas des API.
CUSTOMER_NOT_ALLOWLISTED_FOR_THIS_FEATURE Cette erreur se produit si votre jeton de développeur n'a pas envoyé de requêtes pour le ciblage par liste de clients avant le 1er avril 2026. Vous devez plutôt utiliser l'API Data Manager pour les workflows de ciblage par liste de clients.

Assistance supplémentaire pour la résolution des problèmes

Si le problème persiste, contactez-nous via l'outil de dépannage du ciblage par liste de clients .