Use este guia para resolver problemas de taxas de correspondência baixas e erros comuns que podem surgir na 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 a taxa de correspondência.
A taxa de correspondência pode ser menor do que o esperado por vários motivos, incluindo:
Os dados não foram criptografados 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áriosUserIdentifiers a um únicoUserDataobjeto, conforme mostrado neste exemplo de código.
É possível que um anunciante alcance de 1% a 99% da lista, com base na 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 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ões 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
create operações em um único job.
|
TOO_MANY_USER_IDENTIFIERS
|
As create operações 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. É possível atenuar isso agrupando as 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 token de desenvolvedor não tiver enviado solicitações da Segmentação por lista de clientes antes de 1º de abril de 2026. Em vez disso, use a Data Manager API 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 conosco pelo solucionador de problemas da Segmentação por lista de clientes .