Integrações

Ativar a marcação de eventos via API do Meta Ads

O Meta Ads é a plataforma de anúncios da Meta, utilizada para criar campanhas e acompanhar seu desempenho no Facebook e no Instagram. Para registrar as ações realizadas, como compras, assinaturas e geração de leads, a plataforma utiliza eventos de conversão.

A API de Conversões permite que esses eventos sejam enviados diretamente pelos servidores da Guru ao Meta Ads, tornando o rastreamento mais confiável.

Através dessa integração, é possível contornar as restrições do iOS14 e marcar os eventos de conversão para venda, assinatura e cadastro de lead.

De acordo com as ações realizadas no checkout, os seguintes eventos são enviados para o Pixel:

Ação no Checkout

Evento do Pixel

O cliente abre o checkout

Adição ao Carrinho (AddToCart)

O cliente preenche os dados do contato

Início da finalização da Compra (InitiateCheckout)

O cliente clica no botão Pagar

Adição de Informação de Pagamento (AddPaymentInfo)

O pagamento é aprovado

Compra (Purchase)

O cliente inicia o período de testes (apenas para assinaturas)

Iniciar Período de Avaliação (StartTrial)

Atenção: Ao utilizar a marcação do Pixel usando o Meta Ads API, os eventos não aparecerão na extensão Pixel Helper.

A marcação de eventos de conversão via API só está disponível para vendas e assinaturas realizadas através do Checkout Guru.

Nesta página, você aprenderá como configurar a API de Conversões no Meta Ads, obter o Pixel ID e o Token de Acesso, cadastrar as informações na Guru e ativar a marcação de eventos de conversão.


Nessa página:

  • Passo 1: Configurar API do Meta Ads

  • Passo 2: Obter Pixel ID no Meta Ads e gerar token de acesso

  • Passo 3: Configurar o Pixel na Guru

  • Passo 4: Ativar conversões na Guru


Antes de começar, você precisa:

Passo 1: Configurar API do Meta Ads

Neste passo, você vai configurar a API de conversão no Meta Ads. Esse recurso permite que a Guru envie os eventos de conversão diretamente aos servidores da Meta.

Etapas:

1 - Acesse o seu ambiente do Meta Business Manager com seu e-mail e senha.

2 - No menu lateral, clique em Gerenciador de Eventos.

meta-ads-gerenciador-eventos.png

3 - Em Conjuntos de dados, acesse as Configurações do Pixel que deseja.

pixels-selecionar-evento.png

4 - Desça até API de Conversões e clique em Começar.

facebook-API-Conversao-comecar.png

5 - Selecione as opções:

  1. Ver conteúdo;

  2. Adicionar ao carrinho;

  3. Iniciar finalização da compra;

  4. Adicionar informações de pagamento;

  5. Comprar;

  6. Iniciar período de avaliação.

  7. Contato.

facebook-configuração-conteudo.png

6 – Clique em Continuar.

7 – Selecione todos os parâmetros exceto Data de nascimento e Gênero.

facebook-selecao-parametros.png

8 - Repita o passo 7 para todos os eventos da lista.

9 - Clique em Confirmar configuração.

10 - Clique novamente em Confirmar configuração.

11 - Clique em Concluir.


Passo 2: Obter Pixel ID no Meta Ads e gerar token de acesso

Neste passo, você irá obter o Pixel ID no Meta Ads e gerar um token de acesso no Meta Ads. O Pixel ID identifica o pixel que receberá os eventos enviados pela Guru, enquanto o token de acesso autoriza a comunicação entre a Guru e a API de conversões da Meta.

Etapas:

1 - Acesse o seu ambiente do Meta Business Manager com seu e-mail e senha.

2 - No menu lateral, clique em Gestor de Eventos.

menu-lateral-gerenciador-de-eventos-facebook.png

3 - Em seguida, clique em Conjuntos de Dados.

conjunto-de-dados--facebook.png

4 - Copie e armazene o ID do Pixel.

copie-e-armazene-pixel-id-facebook.png

5 - Clique na aba Definições.

aba-definicoes-facebook.png

6 - Em seguida, clique em Gerar Token de Acesso.

gerar-token-de-acesso-facebook.png

7 - Clique novamente em Gerar Token de Acesso.

caixa-gerar-token-de-acesso-facebook.png

8 - Copie e armazene o Token de Acesso gerado.

copie-e-armazene-token-de-acesso-facebook.png

Passo 3: Configurar o Pixel na Guru

Nesse passo, você irá configurar o Pixel e o token de acesso do Meta Ads na Guru para estabelecer a comunicação entre a Guru e o Meta Ads, permitindo o envio dos eventos de conversão para a plataforma.

1 - Acesse o admin da Guru com seu usuário e senha.

2 - Clique em Configurações > Integrações > Anunciantes > Meta Ads.

menu-integrações-anunciantes-meta.png

3 - Clique na aba Pixels.

pixels-aba.png

4 - Clique em Adicionar Pixel.

adicionar-pixel.png

5 - Em Adicionar Pixel, informe:

  1. Nome: nome do Pixel;

  2. Pixel ID: cole o Pixel ID - obtido no passo 2 - item 4;

  3. Access-Token (Token de Acesso): cole o Token de Acesso - obtido no passo 2 - item 8.

pixel-adicionar.png

6 - Clique em Enviar.


Passo 4: Ativar conversões na Guru

Depois de cadastrar o Pixel e o token de acesso na Guru, é necessário ativar a marcação de eventos para definir quais pixels receberão os eventos de conversão enviados pela plataforma.

Para isso, acesse as configurações de Checkout e selecione o pixel que deseja utilizar para a marcação de eventos.

A marcação de eventos de conversão para o Facebook (Meta Ads) pixel pode ser feita de duas formas:

  • via Facebook API (recomendado)- realizado pelo servidor da Guru através da API de conversões do Facebook (CAPI). Essa opção ajuda a contornar as restrições do iOS14.

  • via Navegador - realizado através do navegador do usuário durante o preenchimento do checkout.

Deverá optar por apenas 1 das formas indicadas a fim de evitar duplicidade de eventos no pixel.

De acordo com as ações realizadas no checkout e eventos do Pixels informados na lista acima (adição ao carrinho, início da finalização da compra, adição de informação de pagamento, compra ou iniciar período de avaliação):

Marcação do pixel via Facebook API

Para marcar os eventos de conversão via Facebook API, deverá selecionar o pixel que vai receber os eventos para cada tipo de conversão.

Etapas

1 - Adicionar o pixel e suas credenciais do Facebook API

Integrar pixel via Facebook API

2 - Selecionar o pixel para receber o evento em cada tipo de conversão.

Conversão de Vendas

Etapas:

1 - De acordo com o nível de configuração que deseja aplicar:

1.1 - Nível Global: acesse Configurações » Checkout.

1.2 - Nível do Produto: acesse Produtos » (produto desejado) » Checkout.

1.3 - Nível da Oferta: acesse Produtos » (produto desejado) » Ofertas » (oferta desejada) » Checkout.

2 - Clique na aba Pixels.

pixels-aba.png

3 - Em Pixel(s) do Facebook via API, selecione o pixel desejado (pode selecionar mais que um).

pixel-facebook-api.png

4 - Clique em Enviar.

ATENÇÃO: deixar o campo Pixel(s) do Facebook vazio para evitar a duplicidade na marcação de eventos.

Conversão de Assinatura

Se você possui produtos de assinatura, pode ativar a marcação de eventos para vendas (ativação da assinatura) e renovações. Para ativar esses eventos, siga os passos abaixo:

Etapas:

1 - Acesse Configurações » Assinaturas.

2 - Ative a opção Marcar evento de cada renovação no Meta e clique em Enviar.

marcar-evento-meta.png

3 - Acesse Configurações » Checkout.

4 - Clique na aba Pixels.

pixels-aba.png

5 - Em Pixel(s) do Facebook via API, selecione o píxel desejado (pode selecionar mais de um).

pixel-facebook-api.png

6 - Clique em Enviar.

ATENÇÃO: deixar o campo “Pixel(s) do Facebook” vazio para evitar a duplicidade na marcação de eventos.

Cadastro de Leads

Se você utiliza rastreamento de leads, pode ativar a marcação do evento “cadastro (lead)” no pixel do Facebook. Para ativar esse evento, siga os passos abaixo:

Etapas:

1 - No menu lateral, acesse R.P.P.C. > Capturas.

rppc-capturas-menu-lateral.png

2 - Clique no R.P.P.C. de Captura desejado.

rppc-capturas-selecionar.png

3 - Em Pixel(s) Facebook Para Marcar Evento selecione o pixel desejado (pode selecionar mais de um).

pixel-facebook-para-marcar-evento-cadastro-leads.png

4 - Clique em Atualizar.

5 - Repita os passos de 2 a 4 para cada R.P.P.C. de Captura que deseja ativar a marcação de eventos.

Marcação do Pixel via Navegador

Para marcar os eventos de conversão via navegador, deverá informar o identificador do pixel que vai receber os eventos de conversão em venda.

Etapas:

1 - De acordo com o nível de configuração que deseja aplicar:

1.1 - Nível Global: acesse Configurações » Checkout.

1.2 - Nível do Produto: acesse Produtos » (produto desejado) » Checkout.

1.3 - Nível da Oferta: acesse Produtos » (produto desejado) » Ofertas » (oferta desejada) » Checkout.

2 - Clique em Pixels.

pixels-aba.png

3 - Informe o ID do Pixel do Facebook. Pode inserir mais do que um, separando-os por vírgulas.

pixel-facebook.png

O campo Pixel(s) do Facebook não aceita novos dados, sendo preciso configurá-lo através do Google Tag Manager.

4 - Clique em Enviar.


Mais Recursos