Resolver problemas com listas de clientes
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Use este guia para resolver problemas de baixa taxa de correspondência e erros comuns que podem surgir na integração da Segmentação por lista de clientes.
Validar a taxa de correspondência
Confira se o job de upload foi concluído antes de tentar validar sua taxa de correspondência.
Sua taxa de correspondência pode estar menor do que o esperado por vários motivos, incluindo:
Os dados não foram gerados com hash antes do upload.
Os dados não foram formatados corretamente antes da criptografia com hash.
Você está comparando com taxas de correspondência em um sistema diferente.
Você está tentando adicionar vários identificadores de usuário a um único objeto UserIdentifier
. Em vez disso, adicione vários UserIdentifier
s a um único objeto UserData
, conforme mostrado neste exemplo de código.
É possível que um anunciante alcance de 1% a 99% da lista, dependendo da atividade dos usuários na Pesquisa Google, no Gmail ou no YouTube. Para um guia mais detalhado sobre como resolver problemas de taxas de correspondência baixas, acesse a Central de Ajuda.
Diferenças entre taxa de correspondência e tamanho da lista
O tamanho da lista e a taxa de correspondência refletem valores diferentes. A taxa de correspondência conta todos os usuários com uma Conta do Google, mesmo que não seja possível alcançar todos eles com a Segmentação por lista de clientes. O tamanho da lista conta usuários ativos que corresponderam a uma Conta do Google e podem ser alcançados pela personalização de anúncios.
Depurar erros comuns
Erro |
USER_PERMISSION_DENIED
|
Você pode encontrar erros de permissão se tentar modificar uma lista criada por outra conta. Só é possível editar uma lista criada pela sua conta.
|
EXTERNAL_UPDATE_ID_ALREADY_EXISTS
|
Esse erro pode ocorrer se você tentar criar vários jobs com o mesmo
external_id .
|
CONFLICTING_OPERATION
|
Esse erro pode ocorrer se as operações remove forem misturadas com as operações create em um único job.
|
TOO_MANY_USER_IDENTIFIERS
|
As operações create em um único job contêm mais de 100.000 user_identifiers no total. Divida a solicitação em várias solicitações que não excedam esse limite.
|
CONCURRENT_MODIFICATION
|
Esse erro pode ocorrer se você tentar operar na mesma lista ao mesmo
tempo.
|
RESOURCE_EXHAUSTED
|
Esse erro pode ocorrer se você tentar enviar muitas solicitações. Para evitar isso, agrupe suas operações de acordo com o
fluxo de uso recomendado. Você também pode consultar o guia de práticas recomendadas para limites e cotas de API.
|
Suporte adicional para solução de problemas
Se você ainda estiver com problemas, entre em contato com nossa equipe usando o solucionador de problemas da Segmentação por lista de clientes.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-09-05 UTC.
[null,null,["Última atualização 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)."]]