4.5 Tratamento de erros
Introdução
Neste guia, mencionamos os possíveis problemas que podem surgir no fluxo de configuração das campanhas Performance Max. No entanto, também podem surgir problemas fora do fluxo, depois que o comerciante cria a campanha Performance Max. O tratamento de erros adequado é tão fundamental para o sucesso da integração que esta seção é dedicada a explicar melhor as práticas recomendadas quando se trata de erros.
Esta seção aborda apenas problemas comuns que:
Pode afetar a veiculação de campanhas Performance Max, exceto erros já mencionados na Etapa 3 (que não são específicos para anúncios).
São graves e podem levar à suspensão da conta, à reprovação do produto ou à impossibilidade de veiculação da campanha. Os problemas classificados como "avisos" não são listados.
Exigir a resolução do comerciante. Problemas comuns que precisam ser resolvidos por você, como erros com a implementação do acompanhamento de conversões (registro de zero conversões ou conversões desnecessárias, como visualizações de página) não são abordados nesta seção. Consulte as seções anteriores, especialmente as dicas para reduzir o risco de encontrar esses problemas após o lançamento.
Exigir a solicitação de revisão de anúncios. Novo método de suporte do comerciante para ativar a solicitação de análise.
Especificamente, esta seção aborda os seis problemas a seguir na conta do Google Ads:
- Acesso limitado à conta do Google Ads
- A verificação em duas etapas é obrigatória
- Conta suspensa
- Verificação do anunciante
- Informações de pagamento ausentes (para faturamento direto)
- Conflito na configuração do acompanhamento de conversões devido ao acompanhamento de conversões atual
Para cada problema, são fornecidos uma breve descrição, um link para a seção de implementação relevante neste guia, as etapas de resolução do comerciante e sugestões sobre onde apresentar o problema.
Orientação sobre UX
Para mais detalhes sobre erros no nível da conta do Google Ads durante a integração, consulte a última parte da seção Criação de conta do Google Ads.
Após a integração, os erros no nível da conta do Google Ads devem aparecer em todo o app e no nível da campanha. Confira abaixo um exemplo de como isso pode acontecer no cenário de informações de faturamento corrompidas.
Confira abaixo uma visão geral de todos os erros no nível da conta do Google Ads e como eles podem aparecer nos níveis da campanha e da página.
Outros problemas que impedem a veiculação de anúncios devem ser tratados da mesma maneira. Veja abaixo um exemplo de falha na sincronização de produtos.
Se existirem vários erros no nível da conta do Google Ads: para não sobrecarregar o usuário, recomendamos que você mostre somente o erro mais grave no nível da conta do Google Ads por vez e o próximo mais grave depois que o anterior for resolvido. O Google propõe a seguinte hierarquia:
Orientação técnica
A documentação da API Ads aborda as práticas recomendadas para o tratamento geral de erros durante as chamadas de API. Nesta seção, abordamos mais erros conceituais que podem afetar o sucesso da campanha Performance Max do comerciante.
A verificação em duas etapas está ativada
Se você exigir que os usuários configurem a 2SV, o erro TWO_STEP_VERIFICATION_NOT_ENROLLED será retornado se as chamadas de API forem feitas com tokens de acesso gerados por um token de atualização emitido antes de o usuário ativar a verificação em duas etapas. O aplicativo deve processar esse erro e direcionar o usuário para ativar a verificação em duas etapas na Conta do Google em:
https://safety.google/authentication/
Consulte a seção Verificação em duas etapas deste guia para saber mais.
Conta suspensa
Uma conta do Google Ads pode ser suspensa por vários motivos. Você pode verificar o status de uma conta do Google Ads usando custome.status para saber se o valor "SUSPENDED" é retornado.
Se a conta estiver suspensa, avise o comerciante sobre esse status e o direcione para:
Clique na notificação na conta no Front-end do Google Ads para ver mais informações e siga as etapas para enviar uma contestação.
Verifique se você recebeu um e-mail de notificação do Google. O e-mail contém o CID da conta do Google Ads que foi suspensa, o motivo da suspensão e um link para enviar uma contestação se o comerciante acreditar que a conta foi suspensa por engano.
Acesso limitado a contas do Google Ads
Para vincular uma conta do Google Ads a uma conta do Merchant Center, a conta de usuário do Google Ads precisa ter o nível de acesso de administrador.
Se um comerciante tentar vincular uma conta do Google Ads em que é usuário com acesso somente leitura ou padrão, a chamada de API vai encontrar um erro. Os comerciantes que utilizam seu aplicativo para vincular uma conta do Google Ads em que são usuários com acesso somente leitura ou padrão podem encontrar um erro relacionado ao acesso limitado ao Google Ads quando uma chamada de API é feita para vincular essas contas.
Alerte o comerciante para que peça a um membro da equipe com acesso de administrador à conta do Google Ads atual a:
1) Atualizar a conta de usuário para uma conta de administrador; ou
2) Siga o fluxo de integração do aplicativo novamente com a conta de usuário de acesso de administrador.
Informações de pagamento ausentes (para o cenário de faturamento direto)
Se faltarem informações de pagamento na conta do Google Ads, as campanhas não serão veiculadas. Use BillingSetupStatus para verificar se o comerciante concluiu a configuração de faturamento. Qualquer valor diferente de "APPROVED" faz com que os anúncios não sejam veiculados.
De acordo com as etapas de implementação, talvez você tenha fornecido aos comerciantes um link direto para a interface do Google Ads durante a integração, mas talvez eles não tenham adicionado as informações de pagamento (consulte outros problemas de pagamento).
Alerte o comerciante sobre esse problema de faturamento e mostre novamente o link direto para concluir a configuração de faturamento. Como alternativa, se o link direto não estiver disponível, direcione o comerciante para o front-end do Google Ads.
Ferramentas e configurações > Faturamento > Configurações para concluir a configuração.
Aviso de várias ações de conversão
Se você permite que comerciantes reutilizem uma conta do Google Ads, talvez eles já tenham configurado o site.