Resolver problemas com listas de clientes

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 objetos UserIdentifier a um único objeto UserData, 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.