Skip to main content
Skip table of contents

Ativar a marcação de eventos via API

Ative a marcação de eventos via API para acompanhar o comportamento dos seus clientes no Checkout Guru.

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.


Nessa página:

  • Passo 1: Configurar API do Meta Ads

  • Passo 2: Configurar o Pixel na Guru

  • Passo 3: Ativar conversões

  • Gerenciar o Pixel do MetaAds


Antes de começar, você precisa:

  • Ter uma conta de usuário ativa.

  • Ter uma conta de anúncio ativa.

  • Ser usuário administrador na Guru ou ter permissões para executar os passos a seguir.


Passo 1: Configurar API do Meta Ads

Neste passo, você vai configurar a API do Meta Ads.

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.

3 - Acesse as Configurações do Pixel que deseja.

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

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.

6 – Clique em Continuar.

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

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: Configurar o Pixel na Guru

Nesse passo, você irá configurar o Pixel do Meta Ads na Guru.

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

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

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

integrações-anunciantes-meta.png

11 - Clique na aba Pixels.

aba-pixel-facebook.png

12 - Clique em Adicionar Conta.

icone-adicionar-conta-facebook.png

13 - Em Adicionar Conta, informe:

  1. Nome: nome do Pixel;

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

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

adicionar-pixel-facebook.png

14 - Clique em Enviar.


Passo 3: Ativar conversões

Para ativar as conversões você deve ir às configurações do checkout e escolher qual o pixel deseja ativar a marcação de eventos de conversão.

Na Guru, essa configuração pode ser aplicada em 3 níveis:

  1. Nível Global: aplica-se ao checkout de todos os produtos cadastrados - configuração padrão;

  2. Nível do Produto: aplica-se ao produto em questão - sobrescreve as definições do item 1;

  3. Nível da Oferta: aplica-se à oferta do produto em questão - sobrescreve as definições dos itens 1 e 2.


Gerenciar o Pixel do Meta Ads

Depois de criado, é possível editar e excluir um Pixel. Esse recurso é útil quando você precisa mudar a regra de gerenciamento de um Pixel.

Editar Pixel

Você pode editar um Pixel, para alterar as informações como ID do pixel, nome, access-token.

Etapas:

1 - Na listagem, localize o pixel desejado e clique no mesmo.

editar-pixel-facebook.png

2 - Em Adicionar Conta, informe:

  1. Nome: nome do Pixel;

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

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

editar-informacoes-pixel-facebook.png

3 - Clique em Enviar.

Excluir Pixel

Depois de criado, é possível remover um pixel. Esse recurso é útil quando você não deseja mais as marcações de eventos.

Etapas:

1 - Na listagem, localize o pixel desejado e clique no botão Remover correspondente ao mesmo.

remover-pixel-facebook.png

2 - Confirme se deseja realizar a exclusão. Para confirmar que o pixel foi excluído, uma mensagem será exibida por alguns segundos no topo superior direito da página.

confirmar-remover-pixel-facebook.png

Mais Recursos

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.