Skip to main content
Skip table of contents

Ativar a marcação de eventos de conversão (pixel)

Você pode ativar a marcação de eventos de conversão nos principais anunciantes e ferramentas de analytics.

A marcação dos eventos de conversão em plataformas como o Facebook ajuda a otimizar o direcionamento de anúncios, reduzir o custo por ação e mensurar resultados.

No 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.

Nesse tutorial, sempre que possível, você será orientado a realizar a configuração a nível global (recomendado). Para realizar configurações nos demais níveis, acesse a aba Checkout no cadastro do produto ou oferta em questão.

Atenção: essa configuração envolve plataformas externas ao Guru. Em caso de dúvidas, solicite assistência à plataforma. Nosso suporte auxilia apenas em configurações feitas dentro do nosso admin.


Nessa página, vai aprender como configurar a marcação de eventos de conversão para:

  • Facebook

  • Google Ads

  • Google Tag Manager

  • Propeller Ads


Antes de começar, você precisa…

  • Ser usuário administrador ou ter permissão para realizar as ações a seguir.

Facebook

A marcação de eventos de conversão para o Facebook pixel pode ser feito de duas formas:

  • via Facebook API (recomendado)- realizado pelo servidor do 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, os seguintes eventos são enviados para o Pixel:

Ação no Checkout

Evento

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)

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.

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

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:

1 - Acesse Configurações » Assinaturas.

2 - Ative a opção Marcar Evento Facebook a Cada Renovação e clique em Enviar.

3 - Acesse Configurações » Checkout.

4 - Clique na aba Pixels.

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

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:

1 - No menu lateral, acesse RPPC > de Capturas.

2 - Clique no RPPC de Captura desejado.

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

4 - Clique em Atualizar.

5 - Repita os passos de 2 a 4 para cada RPPC 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.

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

4 - Clique em Enviar.


Google Ads

Se você anuncia através do Google Ads, pode ativar a marcação de eventos de conversão.

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.

Informe o ID de Conversão Google Ads e Rótulo de Conversão do Google Ads.

4 - Clique em Enviar.


Google Tag Manager

Você pode enviar os eventos de conversão para o Google Tag Manager onde pode centralizar o disparo dos eventos de conversão para todos os seus anunciantes através das etiquetas.

Para configurar etiquetas no Google Tag Manager consulte a nossa playlist de tutorais:

Caso deseje a integração de anunciantes como Google ads/Facebook deve fazê-lo apenas por GTM e retirar os ID's desses anunciantes das configurações do Checkout. Isto deve ser feito, para evitar duplicidade de marcações do mesmo pixel.

ATENÇÃO: Recomendamos centralizar tudo no GTM.

Para informar o ID do Tag Manager no Guru, siga os passos abaixo:

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.

3 - Informe o ID do contentor do Google Tag Manager.

4 - Clique em Enviar.

O Guru dispara eventos para o Google Tag Maganer à medida que o comprador vai interagindo com o Checkout.

Será disparado outra vez, caso os dados sejam alterados.

Os eventos disparados são os seguintes:

Evento

Ação do cliente

addToCart

O evento é disparado quando a página é carregada.

begin_checkout

O evento é disparado quando os dados do contacto são preenchidos.

moved_to_payment

O evento é disparado quando os dados de endereço são preenchidos.

processing_payment

O evento é disparado quando se clica em “Pagar”.

purchase

O evento é disparado quando a compra é aprovada.

start_trial

O evento é disparado quando é iniciado o período de teste gratuito (trial) .

billet_payment

O evento é disparado quando o boleto é impresso.

pending_payment

O evento é disparado quando o pagamento fica pendente.

cancelled_payment

O evento é disparado quando a compra é negada.

Os parâmetros enviados são os seguintes:

Parâmetro

Descrição

checkout

Em que fase do checkout se encontra o comprador.

contact

Dados do contato do comprador.

contact_email

Email encriptado do comprador ("legacy").

contact.email

Email encriptado do comprador.

contact.name

Nome do comprador.

contact.phone

Númeto de telemóvel do comprador.

contact.zip_code

CEP ou código postal do enderenço do comprador.

currency

Moeda utilizada na compra.

event

Evento de checkout - ex: adicionar ao carrinho.

ecommerce

Informação relativa ao ecommerce utilizado.

infrastructure

Informação encriptada sobre a localização e acesso do comprador.

items

Informações relativas ao produto (nome, quantidades, preço e ID).

payment_method

Método de pagamento utilizado na venda.

productQty

Quantidade de produtos.

productTotal

Valor do produto (unitário).

product_id

Código de identificação do produto.

product_name

Nome do produto.

product_total_value

Valor total do produto = valor do produto x quantidade de produto.

product_type

Tipo de produto.

shipping

Valor de frete.

subtotal

Valor do produto mais valor do frete.

taxValue

Valor da taxa.

total_value

Valor total a pagar pelo comprador.

transaction_id

Código de identificação da transação.

unhashed

Dados não encriptados relativos ao contato, endereço e localização do comprador.

Acesse as representações dos parâmetros, clicando nos links acima:

checkout
JSON
{
  "step":4,
  "option":"Payment",
  "status":"address"
}

contact
JSON
{
  "email":"9533cfa4e07997fda660e3ed7ec9567e4313ed95911aa42af5c356c2161988be",
  "name":"Lucas Silva",
  "phone":"+55(11)90000-1111",
  "zip_code":"57490-770"
}

ecommerce
JSON
{
  "purchase":{
    "actionField":{
      "id":"9bfef2b0-4f09-4e41-a6cc-96b513cc1d37",
      "revenue":568.4,
      "tax":0,
      "shipping":6.15
    },
    "products":[]
  },
  "checkout_option":{
    "actionField":{
      "step":4,
      "option":"Payment",
      "status":"address",
      "id":"9bfef2b0-4f09-4e41-a6cc-96b513cc1d37",
      "revenue":1136.8000000000002,
      "tax":0,
      "shipping":12.3
    }
  },
  "checkout":{
    "products":[
      {
        "name":"AlemdaMedicina",
        "id":"93a636be-0635-4832-8fe5-214b5f1a6e8a",
        "price":1000,
        "quantity":1
      }
    ]
  }
}

infrastructure
JSON
{
  "city":"9b6b5187b2fa1af02de9fc8249678be8f1f7ccfec0239625e1dbea99a2a49226",
  "city_lat_long":"8f05850b11b96ec2e481351ebe2bc2c1791842e11115aba753e9b38f18c8264c",
  "country":"169b032adf2ab80f3bdffbdf14358d9d72565fad7708f65c65cb4d7918a4ffb2",
  "ip":"0ea6ffb0249c72a256c3ba500e709c708a66ffe77a543124f484a9babfe47a19",
  "region":"4fc82b26aecb47d2868c4efbe3581732a3e7cbcc6c2efb32062c08170a05eeb8",
  "user_agent":"bd33e731a9dc71ed698fb3458da6dbe5d3ecceab239d26bc9d1da14c96e63705"
}

items
JSON
[
  {
    "id":"93a636be-0635-4832-8fe5-214b5f1a6e8a",
    "item_id":"1623420877",
    "item_name":"AlemdaMedicina",
    "item_brand":"",
    "price":500,
    "item_category":"",
    "quantity":1,
    "google_business_vertical":""
  }
]

unhashed
JSON
{
  "contact":{
    "address":"Rua A",
    "address_city":"Alegre",
    "address_comp":"",
    "address_country":"BR",
    "address_district":"Coronel Almeida",
    "address_number":"1111",
    "address_state":"PR",
    "address_zip_code":"57490-770",
    "doc":"24814981864",
    "email":"lucas@silva.email",
    "name":"Lucas Silva",
    "phone_local_code":"55",
    "phone_number":"(11)90000-1111"
  },
  "infrastructure":{
    "city":"santa-sales",
    "city_lat_long":"38.768033,-9.298784",
    "country":"BR",
    "ip":"22.100.00.111",
    "region":"11",
    "user_agent":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWeb Kit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 Sa fari/537.36"
  }
}
Os dados informados dentro das propriedades dos objetos são fictícios.

Propeller Ads

Se você anuncia através do Propeller Ads, pode ativar a marcação de eventos de conversão de venda.

Para enviar eventos de conversão, vai precisar obter ID da campanha. Para isso, acesse sua conta no Propeller Ads, clique em Campaigns e copie o ID da campanha desejada.

Para informar o ID da campanha no Guru, siga os passos abaixo:

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.

3 - Informe o ID da campanha em Propeller Ads.

4 - Clique em Enviar.


Mais Recursos

JavaScript errors detected

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

If this problem persists, please contact our support.