API de Conversões

Conversions API Gateway: AWS App Runner

O Conversions API Gateway é uma opção de configuração de autoatendimento no Gerenciador de Eventos. Com esse recurso, as empresas podem realizar a integração seguindo as boas práticas. Além disso, podem enviar eventos com o Pixel da Meta e a API de Conversões em uma configuração redundante, sem recursos dedicados a desenvolvedores, o que elimina a necessidade de parceiros e códigos de terceiros.

O Conversions API Gateway também oferece eficiências incrementais, tais como:

  1. Velocidade: reduz o tempo possível de integração da API de Conversões de semanas para horas.
  2. Custo: o Conversions API Gateway pode gerar um custo mais baixo para os clientes devido à redução de recursos ou de requisitos técnicos. O único custo do Conversions API Gateway são as taxas de recursos de nuvem associadas.
  3. Baixo incremento técnico: profissionais de marketing de desempenho com algum conhecimento técnico podem configurar a API de Conversões por conta própria, com o mínimo de suporte das equipes de TI ou de desenvolvedores.
  4. Baixo custo de manutenção: ao contrário de integrações diretas manuais, o Conversions API Gateway será atualizado automaticamente (com o consentimento do cliente) sempre que novos recursos estiverem disponíveis, o que reduz os custos de manutenção no longo prazo.

O Conversions API Gateway é um produto baseado em nuvem e requer uma solução de hospedagem nesse tipo de ambiente para ser configurado. Durante a configuração, você terá a opção de usar uma conta própria na nuvem ou de hospedar sua conta em um serviço parceiro. Se você quer hospedar uma conta própria, uma configuração de nuvem que usa o App Runner da Amazon Web Services pode oferecer um custo mensal fixo mais baixo e ser implementada em cerca de 15 minutos seguindo as etapas abaixo.

Caso sua conta receba mais de 2,4 bilhões de eventos por mês, considere usar uma configuração do Conversions API Gateway baseada no Elastic Kubernetes Service durante a implementação.

Arquitetura

O Conversions API Gateway é configurado por meio do autoprovisionamento de uma instância do servidor no seu ambiente de nuvem, que é usado para enviar eventos da web por meio de um servidor confiável para conexão do servidor com o Facebook.

Veja um diagrama de alto nível dos principais componentes envolvidos no Conversions API Gateway:


Nesse diagrama:

  • Um Pixel da Meta configurado com o ponto de extremidade do Gateway também enviará eventos ao Gateway pelo script do pixel.
  • O Conversions API Gateway recebe dados de eventos dos navegadores e depois envia esses dados para a API de Conversões.
  • A chave de desduplicação event_id é gerada e propagada automaticamente para ajudar a garantir a desduplicação entre os dois canais.

Componentes do Conversions API Gateway

O Conversions API Gateway exige uma conta de provedor de nuvem gerenciada por terceiros que não seja da Meta (por exemplo, AWS). Isso permite que as empresas implantem automaticamente a infraestrutura subjacente sem a necessidade de um desenvolvedor, além de gerar um custo previsível.

Componentes de software

Pixel da Meta

O Pixel da Meta é uma biblioteca JavaScript padrão carregada no site de um anunciante que permite à empresa compartilhar dados sobre as ações do cliente, chamados de Dados das Ferramentas para Empresas nos Termos das Ferramentas da Meta para Empresas. Para empresas que habilitam o Conversions API Gateway, essa tag JavaScript enviará eventos para a Meta e para o Conversions API Gateway por meio de uma conexão segura (HTTPS) sempre que o Pixel da Meta for disparado do navegador.

Conversions API Gateway

O Conversions API Gateway é um produto independente da Meta hospedado na instância do App Runner de um provedor de nuvem. Ele é provisionado na conta de um provedor de nuvem de propriedade da empresa. Também é composto por dois módulos principais:

  • Um módulo de middleware responsável por receber eventos de navegadores, transformar esses eventos de navegador em eventos da API de Conversões e enviar eventos à Meta por meio da conexão da API de Conversões
  • Um portal de administração (interface de usuário da web) no qual as empresas podem administrar, manter e monitorar a instância de servidor do Conversions API Gateway

Interface do usuário administrador do Conversions API Gateway

O Conversions API Gateway fornece uma interface do usuário com o produto. É possível acessar essa interface do usuário em “https://<ponto de extremidade do Conversions API Gateway>/hub/capig” (ou seja, o ponto de extremidade do Conversions API Gateway configurado no DNS).

Nessa interface do usuário, você pode ver o seguinte:

  • Pixels conectados: abra e feche conexões para diferentes pixels da Meta
  • Atividade de evento: veja o volume de eventos recebidos pela Meta nos dois canais, pixel e Conversions API Gateway
  • Taxa de sucesso da API de Conversões: confira a porcentagem de eventos recebidos do navegador que foram publicados na Meta
  • Notificações: receba notificações sobre atualizações de produto e atualize o software do Conversions API Gateway

Saiba mais