API de Conversões

Conversions API Gateway - Solução de erros e avisos

Se você notar que os eventos do servidor estão faltando, ou que o volume de eventos do servidor é menor do que os eventos do navegador, use esta documentação para resolver o problema. Para obter informações sobre ferramentas para solução de problemas, consulte Conversions API Gateway - Solução de problemas e monitoramento.

Use as seguintes etapas de resolução de problemas para ajudar a identificar o problema:

  1. Navegar até o Gerenciador de Eventos
  2. Abrir o site no navegador
  3. Interface do usuário administrador do Conversions API Gateway

O domínio não está configurado para enviar eventos

O Conversions API Gateway receberá eventos dos domínios conectados que você configurar durante a configuração de integração. Se o volume de eventos do servidor parecer mais baixo em comparação com os eventos do navegador, isso pode ser resultado de o Pixel estar disparando em domínios ainda não conectados à Meta.

Diagnóstico

  • Entre no Gerenciador de Eventos.
  • Selecione o evento apropriado.
  • Clique em Ver detalhes e selecione Visão geral do evento.
  • Na lista suspensa à esquerda, selecione Domínios para encontrar os domínios dos quais os eventos de navegador estão disparando.
  • Se estiverem ausentes ou forem diferentes dos domínios configurados, os eventos de navegador não serão capturados.

Resolução

  • Adicione os domínios necessários à sua conexão do Conversions API Gateway seguindo este guia.

DNS não está configurado ou mapeamento de DNS errado

O Conversions API Gateway está hospedado na AWS, que atribui a ele um endereço IP após a criação. Você tem que associar um subdomínio do seu domínio para esse endereço IP para que o ponto de extremidade do Conversions API Gateway possa ser alcançado a partir do navegador por meio de uma chamada de solicitação própria.

Diagnóstico

  • Use um verificador de DNS online como https://dnschecker.org/ para verificar se o domínio do Conversions API Gateway está resolvido para o endereço IP certo e totalmente propagado. Se o seu domínio não estiver resolvendo para nenhum endereço IP, consulte a seção de resolução para os próximos passos.
  • Obtenha o endereço IP do servidor do Conversions API Gateway no seu painel do AWS EC2 ou peça essa informação para seu ponto de contato da infraestrutura na nuvem.
  • Se os dois endereços IP forem diferentes, consulte a seção de resolução para os próximos passos.

Resolução

  • Trabalhe com um administrador no registrador de domínio.
  • Atualize o registro DNS no seu registrador de domínio com o endereço IP do servidor do Conversions API Gateway (o mostrado no seu painel do AWS EC2).
    • Defina um registro DNS A que associe seu subdomínio do Conversions API Gateway ao endereço IP do servidor gerado durante a configuração.

O certificado nunca foi emitido

Se o Conversions API Gateway nunca teve um certificado emitido pela Let’s Encrypt, mesmo que um longo tempo depois de o DNS estar configurado corretamente, significa que seu domínio é tão popular que a Let’s Encrypt se recusou a emitir um certificado.

Resolução

  • Considere colocar um balanceador de carga AWS (ALB) à frente da instância do Conversions API Gateway e use o ALB para hospedar o certificado que você possui.

O certificado foi emitido, mas expirou

Esse problema acontece se você fechou a porta 80 depois que o Conversions API Gateway foi instalado com sucesso, ou se estiver executando versões antigas.

Resolução

A interface do usuário do Gateway não está acessível

Esse problema acontece se você fechou a porta 80 depois que o Conversions API Gateway foi instalado com sucesso, ou se estiver executando versões antigas.

Resolução

  • Verifique se o endereço IP da instância do Conversions API Gateway corresponde à configuração de DNS. Se não corresponder, veja DNS não está configurado ou mapeamento de DNS errado.
  • Se o servidor não responder, talvez o problema seja um erro de rede temporário, que pode ser resolvido reiniciando a instância. Talvez o Gateway da API de Conversões demore alguns minutos para iniciar. Aguarde cerca de 10 minutos para entrar novamente.

Gateway requer atualização de versão

Pode parecer que o Conversions API Gateway das versões anteriores à versão 1.0.8 tenha parado de enviar eventos para a Meta. Sugerimos que você atualize para pelo menos a versão 1.0.8 para maximizar o benefício da configuração. Isso retomará o fluxo de eventos e garantirá atualizações automáticas no futuro.

Diagnóstico

  • Verifique se você tem a versão atual do Conversions API Gateway:
    • Abra a Interface do usuário administrador do Conversions API Gateway:
https://<Conversions API Gateway Endpoint>/hub
  • Verifique a versão atual do seu servidor do Conversions API Gateway:
    • Menu à esquerda > Settings > Updates

Resolução

Para atualizar o Conversions API Gateway, faça o seguinte:

Resolução de problemas com registros de EKS

Se encontrar problemas ao instalar o Conversions API Gateway para a versão EKS de conta única ou versão de várias contas, consulte os registros para resolver o problema.

O registro de instalação do EKS está disponível no AWS Cloudwatch com o nome do grupo "ConversionsAPIGateway/cloud-init-output.log". Você pode verificar se há alguma mensagem de erro. Erros comuns incluem exceder a limitação de recursos da AWS e falta de permissões da AWS.



O registro DNS do tipo CAA não inclui amazonaws.com

Se o registro DNS solicitado pelo Conversions API Gateway não tiver um certificado TLS adequado ou um registro CAA, ignore esta seção.

Se você tiver um registro CAA para o domínio, use amazonaws.com como o valor do registro CAA caso tenha instalado a versão AWS EKS do Conversions API Gateway (para uma conta) ou a versão 1.10.* ou posterior do Conversions API Gateway para várias contas, que usa o AWS Certificate Manager na criação de domínios. Confira o seguinte exemplo de registro CAA:

0 issue "amazonaws.com"

Se você instalou a versão 1.9.* ou anterior do Conversions API Gateway para várias contas, forneça letsencrypt.org como o valor do registro CAA. Por exemplo:

0 issue "letsencrypt.org"

Veja também