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 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 UserIdentifiers 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.