Stape
Procurar

API de conversão do Facebook para WordPress

Atualizado
14 de mai de 2024
Publicado
30 de mar de 2023
Também disponível

Está à procura de uma maneira fácil de configurar uma API de conversão do Facebook para o seu site WordPress? Este post irá cobrir tudo o que precisa de saber sobre a API de conversão do Facebook. Depois, seguiremos instruções passo a passo sobre como configurar a API de Conversão do Facebook para WordPress com a ajuda do plugin do lado do servidor GTM do Stape.

Porquê implementar o FB CAPI para WordPress

Há anos que usamos o Facebook Pixel para ver como os nossos anúncios estão a agir e para gerar grandes audiências de remarketing. Mas, a influência do Facebook Pixel está a diminuir devido às melhorias de privacidade do iOS 14 e ao iminente desaparecimento dos cookies no próximo ano.

Para resolver este problema, o Facebook lançou o novo e melhorado Facebook Conversions API. Esta tecnologia tem sido sempre útil para os profissionais de marketing que querem rastrear corretamente as conversões, mas é agora crucial para os anunciantes do Facebook que querem provar a sua estratégia no futuro num ambiente de privacidade primeiro.

Resiliência aos bloqueadores de anúncios

A CAPI utiliza o rastreamento do lado do servidor, que envia dados diretamente do servidor do seu website para o Facebook, contornando as limitações impostas pelas configurações de privacidade do usuário e as restrições do navegador, uma vez que não depende de cookies. Além disso, pode ajudá-lo a passar através de bloqueadores, uma vez que os pedidos de rastreamento são enviados a partir do seu lado do servidor e não do navegador do usuário. Isto pode melhorar o desempenho das suas campanhas publicitárias.

Optimização melhorada

A API de Conversão do Facebook para WordPress fornece pontos de dados adicionais que podem ajudá-lo a optimizar as suas campanhas, tais como eventos personalizados como tempo no site, profundidade de deslocamento, e envio de formulários. Isto permite-lhe compreender melhor o comportamento do usuário adequadamente.

Melhor atribuição

A CAPI permite-lhe atribuir com precisão as conversões ao anúncio direito, mesmo que a conversão ocorra depois de o usuário ter deixado o seu website. Isto porque o seguimento do lado do servidor permite-lhe enviar dados sobre o evento de conversão directamente para o Facebook, sem depender do navegador do usuário para desencadear o pedido de rastreamento.

Como configurar a API de Conversão do Facebook para WordPress

Configure o servidor Google Tag Manager container no stape

1. Vá a https://tagmanager.google.com/ e inicie sessão na sua conta Google Tag Manager.

Google Tag Manager account

2. Clique no botão "Admin", e sob a coluna " Containers", clique no botão "+ Criar Container".

Create Container

3. Escolha um nome para o container do seu servidor, seleccione "Servidor" como o tipo de container, e clique no botão "Criar"

create server container in google tag manager

4. Selecione a opção " Servidor de etiquetagem de fornecimento manual," e copie a configuração do container que aparece. Guarde esta configuração num editor de texto, pois irá precisar dela mais tarde.

Manually provision tagging server

5. Entre na sua conta no nosso serviço ou crie uma nova conta, no caso de ainda não o ter feito.

6. Uma vez conectado, clique no botão "Criar Container". Dê um nome ao seu container, cole a Configuração do Container que copiou do seu Container do Servidor Google Tag Manager, e selecione a localização do servidor. Clique em " Criar Container".

create container at stape

7. Aguarde cerca de 5 minutos para que o container do servidor seja instalado. Atualize a página para atualizar o estado. Se a configuração foi feita corretamente, deverá ver o estado "Em execução". Se vir "Erro", verifique duas vezes se copiou a configuração correcta do conteiner. Contacte o suporte se o erro persistir.

8. Nesta etapa, é necessário configurar um URL de etiquetagem.

Tem duas opções:

  • Pode escolher usar o URL de etiquetagem que foi criado para si e está alojado no nosso domínio (stape.io)
  • Ou utilizar um domínio personalizado. Recomendo vivamente a utilização desta opção porque ajudará a evitar que o rastreio seja bloqueado e aumentará a vida útil dos cookies.

Se optar pela primeira opção, passe ao passo 9.

Se quiser configurar um URL de etiquetagem personalizado, clique em "Adicionar domínio" sob o URL de etiquetagem fornecido por stape -> inicie sessão no seu serviço de nomes de domínio e crie um novo registo DNS para o subdomínio que pretende utilizar. Pode utilizar qualquer nome de subdomínio que desejar. 

Adicione estas configurações:

    Digite: A

    Nome: ss (ou qualquer outro nome de subdomínio que deseje)

    Endereço IPv4: O endereço IP depende da localização dos servidores. Pode encontrar o endereço IP de domínio personalizado na sua conta stape.io.

    TTL: Auto

    Proxy status: desactivado

As suas configurações devem ter este aspecto:

a custom tagging URL

9. Pode activar a funcionalidade Global CDN para o container do servidor, que utiliza a tecnologia Cloudflare para carregar ficheiros já de um servidor mais próximo dos visitantes do seu site, resultando num serviço mais rápido de ficheiros e numa melhor velocidade de página. Considere os regulamentos de privacidade do seu país antes de ativar esta funcionalidade. Adicione um registo CNAME para fazer com que a Global CDN funcione.

!

Considere os regulamentos de privacidade do seu país antes de ativar a Global CDN.

Depois de ativar a CDN Global, terá de adicionar um registo CNAME para fazer a CDN Global funcionar. 

10. Adicione o URL do servidor de etiquetagem ao container do Google Tag Manager Server, indo a "Admin," depois a "Configurações," e selecionando "Configurações do Container.”

Configure o plugin do lado do servidor GTM para WordPress

1. Inicie sessão no seu WordPress Admin, e vá para os plugins. Depois, clique em "Adicionar Novo," digite "GTM Server-Side," escolha este plugin, e clique em instalar agora. Uma vez estabelecido, clique em "Ativar". 

wordpress plugin by stape

2. Abra o plugin GTM Server-Side que instalou no primeiro passo e cole o URL de etiquetagem dentro das configurações do plugin. Em seguida, seleccione se pretende adicionar GTM web a todas as páginas do site ou simplesmente adicionar a funcionalidade plugin sem adicionar script GTM (esta opção deve ser usada no caso de estar a usar qualquer outro plugin que insira script GTM no site). Depois, adicione WEB Google Tag Manager ID, URL do servidor de etiquetagem, e identificador de container stape se quiser usar um carregador personalizado

GTM Server-Side plugin

3. Se tiver um site de comércio eletrônico e quiser empurrar eventos de comércio eletrônico e dados de usuários para a camada de dados, clique no segundo tab do plugin e ative duas caixas de verificação. Note que só pode funcionar com lojas de woocommerce. 

push ecommerce events and user data to the Data Layer

Configure GA4 do lado do servidor

1. Dentro do contentor Web, crie uma nova etiqueta do tipo Google Tag. Adicione o seu ID de tag do Google.

Na secção Definições de configuração, adicione os seguintes parâmetros:

  • Name: server_container_url
  • Value: Introduza o URL

Adicionar acionador à etiqueta GA4. Normalmente, ele deve ser acionado em todas as exibições de página.

set up Google Analytics 4 server-side 

Também pode criar uma variável Google tag: Variável de definições de configuração que predefinirá as definições de Google Tag se precisar de utilizar várias Google Tags no seu Web site e não quiser adicionar definições para cada uma das tags manualmente.

Estes parâmetros podem ser, por exemplo, uma configuração que define se pretende enviar um evento de visualização de página sempre que uma Google Tag é activada, definir parâmetros UTM, ID do cliente, etc. Existe uma lista de parâmetros de configuração padrão das Google Tags.

2. Para configurar o evento GA4, vá para a secção de etiquetas e crie uma nova etiqueta com o tipo de etiqueta Google Analytics: Evento GA4. Adicione seu ID do GA4 e o nome do evento; há uma lista de nomes de eventos padrão.

Pode criar uma variável Google Tag: Event Settings que ajudará a partilhar parâmetros de eventos em várias tags de eventos GA4 ou Google Tags. Podem ser, por exemplo, propriedades do utilizador ou do produto, e existe também uma lista de parâmetros padrão para definições de eventos.

Google analytics 4 events settings 
google tag event settings variable

3. Abra o contentor do Google Tag Manager Server -> clique em Client -> crie o cliente GA4 e guarde-o -> vá para Tags e configure a tag GA4. Lembre-se de que o GA4 envia automaticamente não só a visualização de páginas, mas também alguns outros eventos. Dentro de Event Name escolha a variável {{Event Name}}. -> adicione o gatilho Client Name igual a GA4.

set up ga4 tag in the server container 
set up ga4 client in the server container 

4. Abra o modo de pré-visualização de contentor do servidor e verifique se vê os pedidos da GA4.

tag details

Configure a API de Conversão do Facebook para WordPress

Tem 2 opções para configurar a nossa tag de conversão API do Facebook:

Herdado do cliente GA4:

Neste caso, vamos mapear os seus eventos GA4 em eventos padrão do Facebook. Se não conseguirmos mapear o evento GA no evento padrão FB, iremos registá-lo como um evento personalizado. Tudo será feito automaticamente, não é necessário configurar os eventos da FB. 

1. Crie uma nova Tag no seu container do servidor. Vá à galeria de templates da comunidade e adicione a Tag API de Conversão do Facebook. Na Tag, seleccione herdar do cliente. Introduza o seu FB API Access Token, FB Pixel ID, e Test ID para ver os eventos dentro da ferramenta de testes da FB. 

facebook conversion api

2. Adicione um ativador. Clique em ativadores-> + no canto superior direito-> configurações de ativador e selecione um ativador personalizado-> este ativador irá acionar em Alguns Eventos-> Nome do Cliente igual a GA4. Clicar em guardar.

trigger configuration

Override (anular):

Neste caso, terá de configurar manualmente os eventos da FB.

Terá de usar eventos GA4 para ativar eventos do servidor do Facebook.

Vamos tomar como exemplo um evento "add_to_cart" e queremos enviar parâmetros de valor, moeda e item_id.

1. Crie uma tag de evento GA4 no seu container da Web ou modifique um evento já existente. Escolha a configuração GA4 que acabou de criar como "Tag de Configuração" e defina o Nome do Evento para "add_to_cart". E queremos enviar os parâmetros do evento: valor, moeda, item_id. 

Create a GA4 Event tag in Web container

Tomamos estes parâmetros do DataLayer, mas como não passamos todos os dados do DataLayer, queremos fazer variáveis para estes parâmetros.

Para criar estas variáveis, precisamos de executar uma pré-visualização no container da web e abrir a camada de dados.

a preview in the web container

Vamos criar uma variável para "valor".

Abra as variáveis, faça uma nova Variável da Camada de Dados, no Nome da Variável da Camada de Dados escreva o trajeto que podemos ver na nossa camada de dados para este parâmetro. Neste caso, é ecommerce.value. Clique em guardar.

ecommerce.value

Repita o processo para os outros parâmetros.

Voltemos à nossa tag GA4 e escrevemos os parâmetros que queremos passar quando o add_to_cart é ativado. 

Adicione um ativador. O tipo de ativador é um evento personalizado que é accionado em todos os eventos personalizados, o nome do evento "add_to_cart". Clicar em guardar.

 event name “add_to_cart”

2. Crie uma nova tag API de Conversão do Facebook no container do seu servidor. Vá à galeria de templates da comunidade e adicione a tag API de Conversão do Facebook. Neste caso, selecionamos a substituição no Método de Configuração do Nome do Evento e o tipo de evento "AddToCart". Introduza o seu FB API Access Token, FB Pixel ID, e Test ID para ver eventos dentro da ferramenta de testes FB.

new Facebook Conversion API tag

Em seguida, introduza os dados personalizados que decidimos passar para o Facebook. Para estes parâmetros, também precisaremos de fazer variáveis, mas agora num container de servidor com o tipo de variável "dados de evento".

variable “event data“

Fazemos ativar um evento personalizado com o nome do evento add_to_cart que activa no nome do cliente igual a GA4. Clique em guardar.

event name add_to_cart

Verificando se a configuração está completa e correcta

Abra o depurador de containers GTM da web e do servidor e clique através do seu site. No container GTM do servidor, deverá ver os pedidos solicitados pela Tag API de conversão do Facebook. 

web and server GTM containers debugger

Pode também testar este evento dentro da ferramenta de teste do Facebook.

Facebook testing tool

Conclusão

É crucial estar atualizado com a tecnologia moderna e com a era digital em que vivemos atualmente, por isso, é imprescindível que compreenda a enorme ajuda que pode obter da tecnologia API de conversão do Facebook. A sua utilização para WordPress pode levar a um rastreio de dados mais preciso, tempos de carregamento mais rápidos, maior conformidade com a privacidade, e melhor segmentação de anúncios.

Portanto, se estiver pronto para implementar esta incrível ferramenta na sua estratégia empresarial - não hesite em contactar a nossa equipa de apoio para qualquer ajuda que possa necessitar na sua configuração. 

Tagged with:FacebookWordPress

Aloje o seu servidor GTM no Stape