Use este guia para resolver problemas de baixa taxa de correspondência e erros comuns que podem surgir na sua 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 objetosUserIdentifiera um único objetoUserData, conforme mostrado neste exemplo de código.
Um anunciante pode alcançar 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 o segmento de público-alvo por lista de clientes. O tamanho da lista conta os 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 operações remove forem misturadas com
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
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. |
CUSTOMER_NOT_ALLOWLISTED_FOR_THIS_FEATURE
|
Esse erro ocorre se o projeto do Google Cloud (ou o token de desenvolvedor legado, descontinuado em 9 de setembro de 2026) não tiver recebido solicitações de segmentação por lista de clientes entre 1º de outubro de 2025 e 31 de março de 2026. Em vez disso, use a API Data Manager para fluxos de trabalho da segmentação por lista de clientes. |
Suporte adicional para solução de problemas
Se você ainda estiver com problemas, entre em contato usando o solucionador de problemas da segmentação por lista de clientes.