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

Ce guide vous aidera à résoudre les problèmes de taux de correspondance faibles et les 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 d'essayer de valider votre taux de correspondance.

Votre taux de correspondance peut être inférieur aux prévisions pour plusieurs raisons, par exemple :

  • 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 avec ceux d'un autre système.
  • Vous essayez d'ajouter plusieurs identifiants utilisateur à un seul objet UserIdentifier. Ajoutez plutôt plusieurs objets UserIdentifier à un seul objet UserData, 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 de taux de correspondance faibles, 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'ils ne peuvent pas être touchés par la liste pour le ciblage des clients. La taille de la liste correspond au nombre d'utilisateurs actifs qui ont été associés à 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 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 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 ne dépassant 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 limiter ce problème, vous pouvez regrouper 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 d'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 enregistré aucune demande de ciblage par liste de clients entre le 1er octobre 2025 et le 31 mars 2026. Vous devez utiliser l' API Data Manager pour les workflows de ciblage par liste de clients.

Assistance supplémentaire pour le dépannage

Si vous rencontrez toujours des problèmes, contactez-nous via l'outil de dépannage pour le ciblage par liste de clients.