Resolver problemas com listas de clientes

Use este guia para resolver problemas de taxas de correspondência baixas e erros comuns que podem surgir na sua integração da Segmentação por Lista de Clientes.

Validar a taxa de correspondência

Verifique se o job de upload foi concluído antes de tentar validar sua taxa de correspondência.

Sua taxa de correspondência pode ser menor do que o esperado por vários motivos, incluindo:

  • Os dados não foram criptografados antes do upload.
  • Os dados não foram formatados corretamente antes de serem criptografados com hash.
  • Você está comparando com as 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.

É possível que um anunciante alcance de 1% a 99% da lista, com base no nível de 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 a taxa de correspondência e o 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 eles não possam ser alcançados com o segmento de público-alvo por lista de clientes. O tamanho da lista conta os usuários ativos que correspondem a uma Conta do Google e podem ser alcançados pela personalização de anúncios.

Depurar erros comuns

Erro
USER_PERMISSION_DENIED Você poderá encontrar erros de permissão se tentar modificar uma lista que foi criada por outra conta. Só é possível editar uma lista criada pela sua própria 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 reduzir esse problema, agrupe as operações em lote de acordo com o fluxo de uso recomendado. Consulte também o guia de práticas recomendadas para limites da API e cotas.
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 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 tiver problemas, entre em contato usando o solucionador de problemas da Segmentação por Lista de Clientes.