Stape

API de Conversão do Facebook Gateway. A maneira mais fácil de implementar o FB CAPI?

Autor
Stape
Publicado
September 30, 2021
Também disponível em

O portal da API de conversões do Facebook é a mais recente abordagem da FB na configuração da API de conversões e parece ser a mais fácil. É necessário ter o Amazon AWS (apenas AWS por agora) para alojar eventos do servidor. A FB CAPIG (portal da API de conversões do Facebook) recebe eventos do navegador e envia-os para a API de conversões.

Com FB CAPIG, não necessitará de configurar a remoção de duplicados de eventos, enviar parâmetros de utilizador e eventos a partir do servidor. Outra enorme vantagem é ter múltiplos domínios/pixels dentro de uma única instância de portal de API de Conversões. Múltiplos pixels só funcionam se estiverem localizados sob o mesmo Gestor de Negócios do Facebook.

Este post do blog irá discutir o que é o portal da API de Conversões do Facebook, as suas vantagens, e desvantagens em relação à implementação do FB CAPI no servidor do GTM. Mostrarei também como configurar o FB CAPIG utilizando o alojamento stape.io. Demora apenas 5 minutos!

Tudo o que terá de fazer é usar o gestor de eventos do Facebook para criar o URL de implantação, colar o URL de implantação no contentor de CAPIG do stape.io e adicionar um registo DNS para o subdomínio.

Facebook e rastreamento do lado do servidorCopiar link para esta secção

O Facebook lançou a sua solução de rastreamento do lado do servidor entre os primeiros quando o servidor Gestor de etiquetas do Google não estava sequer numa versão beta pública.

Desde essa altura, têm tentado tornar a implementação da API de Conversões do Facebook tão fácil quanto possível. As recentes restrições de rastreamento no iOS, adBlocker, ITPs, e navegadores como Brave, afectaram a capacidade do Facebook de recolher informação sobre os utilizadores.

A FB tem registado uma diminuição significativa nas taxas de sucesso para os anunciantes. Quando questionado sobre estas quedas, o Facebook alegou que tal se deve a restrições de rastreamento. A API de conversões do Facebook foi concebida para superar estas restrições.

Com FB CAPI, envia-se dados de eventos e de utilizadores para o Facebook a partir do servidor. Desta forma, o Facebook ainda é capaz de recolher informações do utilizador quando o rastreamento do navegador está bloqueado.

O Facebook passou um ano a pedir activamente aos anunciantes que implementassem a API de conversões. Parece que a velocidade com que a integração de CAPI do Facebook foi configurada não é tão rápida como se esperava. Assim, o direccionamento funciona pior, e os resultados das campanhas são mais baixos.

A razão mais aparente pela qual os anunciantes não usam CAPI de FB é que é difícil de implementar. A agência de Stape tem trabalhado muito com o rastreamento do lado do servidor e FB CAPI principalmente. Eu diria que para nós, em média, são necessárias cerca de 15 horas para implementar FB CAPI utilizando o servidor do GTM. A pessoa que o instala pela primeira vez pode precisar de X vezes mais tempo porque precisa de se familiarizar primeiro com o servidor do GMT.

É aqui que entra no jogo o portal da API de Conversões do Facebook. O portal de CAPI pode potencialmente funcionar como a solução mais rápida para implementar o CAPI do Facebook.

Como funciona o Portal da API de Conversões do FacebookCopiar link para esta secção

O portal da API de conversões do Facebook requer os Amazon Web Services, e não é necessário utilizar o servidor Gestor de etiquetas do Google para implementá-lo. A FB tem uma descrição detalhada de como funciona o CAPIG.

O processo começa na interface do gestor de eventos do Facebook. Depois, terá de enviar o URL de configuração aos seus programadores que irão configurar os Amazon Web Services.

O Facebook cria uma pilha de CloudFormation que faz o elemento de infra-estrutura necessário para executar o portal de CAPI do Facebook. Inclui instâncias de EC2 com valores pré-definidos e CloudWatch. Configura apenas um servidor para si, e espero que seja mudado no futuro. Por exemplo, a Google recomenda ter pelo menos três servidores para redundância.

Depois de toda a magia na AWS estar feita, FB usará pixel para enviar eventos do servidor. Todas as coisas como a remoção de duplicados de eventos, parâmetros de utilizador, parâmetros de eventos funcionarão com base nos eventos do navegador FB.

Parece simples, certo? Vamos entrar em mais detalhes!

Prós e contras do portal da API de conversões do FacebookCopiar link para esta secção

Prós:Copiar link para esta secção

1. Rápido. O portal da API de Conversões do Facebook parece ser a forma mais directa de configurar o FB CAPI. Não tem mais remoções de duplicados de eventos, parâmetros do utilizador, baixa classificação de correspondência. CAPIG adequa-se ao melhor para pessoas ou agências que apenas publicam anúncios no Facebook e querem melhorar o rastreamento da FB. Podem utilizar uma instância de AWS para alojar todos os pixels que têm no gestor de negócios da FB. O alojamento de Stape.io para FB CAPIG custa $100/mês, e pode adicionar tantos domínios/pixels quantos desejar.

Contras:Copiar link para esta secção

1. Novo. O portal de CAPI é novo, e o mais provável é que a FB venha a lançar novas funcionalidades e a actualizar a existente. Por isso, tenho de estar preparado para mudanças. 

2. Solução a curto prazo. Se quiser ter todas as vantagens do rastreamento do lado do servidor, o servidor do GTM é a melhor solução. Ainda precisará do servidor do GTM para gerir os anúncios do servidor GA ou Google Ads. Além disso, utilizar o servidor do Gestor de etiquetas do Google é mais acessível do que ter tanto sGTM como o portal de FB CAPI no AWS.

3. Fiabilidade. Pelo que vemos no nosso AWS, o Facebook configura apenas um servidor para si. Isto parece muito arriscado porque se um servidor parar de funcionar, não há backup, o que significa que os seus dados serão perdidos. A Google recomenda a utilização de três servidores em produção, o que deverá ajudar imensamente com estabilidade e durabilidade contra falhas - algo de que qualquer negócio necessita quando executa anúncios e confia nos dados de conversão.

Alojamento de Stape para o portal da API de conversões do FacebookCopiar link para esta secção

Pode utilizar o alojamento do stape.io para o portal da API de conversões do Facebook. Para configurar o CAPIG com stape, tudo o que precisa de fazer é:

1. Copiar o URL de configuração dentro do Gestor de Eventos da FB.

2. Adicionar o URL copiado à sua conta stape.io.

3. Definir um registo DNS para o seu subdomínio.

!

Preço. O alojamento do FB CAPIG na Stape custa $100/mês, e pode utilizá-lo para tantos pixels quantos necessitar.

Note que se quiser utilizar a mesma instância de FB CAPIG para múltiplos pixels, todos estes pixels devem estar localizados num único gestor de negócios do Facebook.

Uma vez criado o contentor FB CAPIG no stape, criamos uma pilha de cloud formation no Amazon AWS com base nos requisitos do Facebook. Trataremos de todas as actualizações por si.

Importante: Por favor, adicione um método de pagamento ao contentor de FB CAPIG no prazo de 24 horas. Infelizmente, teremos de desactivar os contentores que não adicionem pagamento no prazo de 24 horas.

Como configurar o portal da API de conversões do FacebookCopiar link para esta secção

1. Abra FB events manager -> Settings -> Clique em Choose a Partner -> Clique em Conversion API Gateway.

FB events manager 

2. Adicione o seu nome de domínio -> Facebook irá gerar um subdomínio para o seu servidor de etiquetagem -> Copie um subdomínio, vamos precisar dele nos próximos passos -> Clique em next.

subdomain 

3. No método de implantação, escolha " Select your hosting region"-> Seleccione a sua região de Amazon Web Services -> Clique em Copy URL -> Guarde este URL, vamos precisar dele no nosso próximo passo -> Clique em next.

Importante: o URL que copiou é válido apenas por 24 horas. Por isso, certifique-se de que avança para o passo seguinte no prazo de 24 horas. Caso contrário, terá de gerar um novo URL.

Select your hosting region

4. Vá para a sua conta stape.io -> Abra o separador CAPI Getaway -> Clique em Create.

CAPI Getaway tab

5. Cole o URL de configuração que copiou no passo 3 -> Add container name (adicionar nome do contentor)

❗❗copy Admin email and Password to a safe place. (copie email do admin e palavra-passe para um local seguro) Infelizmente o FB CAPIG não tem a opção de restaurar ou criar uma nova palavra-passe para o seu admin de FB CAPIG -> Clique em create.

Add container name

6. Demorará até 30 minutos a implementar AWS para o seu portal da API de conversões do Facebook. Assim que vir o contentor de CAPIG a funcionar:

■ copie o Instance URL do portal da API de conversões do admin do stape.io e abra no seu navegador.

■ configure um registo DNS para o subdomínio. Deve apontar um registo do subdomínio que o Facebook criou para si e que você copiou no passo 2 para o endereço IP que você vê no admin do stape.io.

Conversions Api Gateway Instance URL
set up a DNS record for the subdomain

7. Uma vez adicionado o registo DNS deverá ver "DNS setup successfully" no gestor de eventos do Facebook -> Clique em Next -> Clique em Go to console -> Use login e palavra-passe copiados no passo 5.

DNS setup successfully

8.  Terá acesso ao admin com estatísticas sobre os pedidos da CAPI da FB.

Importante: se clicou em connect e viu que a ligação não era segura para o subdomínio personalizado, precisa de esperar. Por favor, volte à mesma página em 1 hora. O certificado de SSL será emitido para o seu domínio.

FB CAPI requests

Também pode utilizar o gestor de eventos da FB para aceder ao CAPIG, clicando em partner integration.

 FB events manager

9. Depois de ter verificado que tudo funciona correctamente, queira acrescentar a facturação ao stape.io. O portal da API de conversões do Facebook custa $100/mês para o número ilimitado de pixels e domínios.

Importante: Teremos de desactivar o contentor FB CAPIG se não recebermos um pagamento dentro de 24 horas a partir da data de criação.

Como adicionar domínios e pixels adicionais ao seu portal da API de conversões do FBCopiar link para esta secção

10. Abra a CAPIG partner integration dentro do FB Events manager (gestor de eventos do FB) -> Clique em Settings -> Selecione Add a pixel to an existing Conversions API Gateway connection (Adicionar um pixel a uma ligação existente do portal da API de conversões).

Add a pixel to an existing Conversions API Gateway connection

11. Seleccione um pixel existente ou crie um novo -> add a new domain (adicionar um novo domínio) -> clique em Next (Seguinte).

Atenção: Se vir o domínio errado (o anterior que adicionou), remova-o e adicione um novo domínio. 

add a new domain

12. Verá o subdomínio inicial que criou para o CAPIG e adicionou o registo DNS no Establish Connection. Não o modifique. Clique em Connect -> Será redireccionado para o admin de CAPIG -> adicione o e-mail e palavra-passe que foi criada no passo 5.

  DNS record in the Establish Connection

13. Verá a mensagem "Connection Already Exists" -> Clique em Connect -> Deverá ver o estado Connected -> Clique em Open Conversions API Gateway.

Connection Already Exists
Open Conversions API Gateway

14. No admin do FB CAPIG, verá a lista de todos os pixels ligados. O novo pixel terá o estado Deactivated -> Clique em três pontos do lado direito do pixel -> Activate.

connected pixels

Como testar o portal da API de Conversões do FacebookCopiar link para esta secção

15. Abra o gestor de eventos do Facebook -> partner integration -> Conversions API Gateway -> Verifique se a ligação está activa para todos os pixels que configurou, e CAPIG vê eventos. Deve mostrar os mesmos eventos que configurou usando uma integração de browser.

browser integration

16. Abra a consola do seu website e verifique se a FB envia pedidos para o seu subdomínio.

website’s console

Conclusão:Copiar link para esta secção

Há muitas vantagens em utilizar o portal da API de Conversões do Facebook, e a principal delas é a simplicidade. Se estiver interessado apenas no rastreamento preciso do Facebook e tiver vários pixels num único Gestor de Negócios, então CAPIG poderá ser a solução perfeita para si. Pode usar apenas um CAPIG e AWS para todos os seus pixels e domínios.

Mas também há algumas desvantagens. A configuração do FB CAPI utilizando o servidor do GTM seria a melhor solução para as pessoas que querem utilizar o rastreamento do lado do servidor em múltiplas plataformas, e não apenas no Facebook.

Tagged with:How to

Aloje o seu servidor GTM no Stape

Ao se inscrever, você concorda com os Terms and Conditions e a Privacy Policy de Stape