Guia do Pixel Taboola

Antes de começar

Cinco minutos aqui evitam duas horas de suporte depois.

O que é o pixel

O Pixel Taboola é um código JavaScript que o Taboola te dá. Ele é colocado nas páginas do seu site e avisa o Taboola cada vez que alguém entra numa página (page_view) ou faz uma ação que você definiu (por exemplo, make_purchase). Com isso o Taboola sabe quais cliques viraram venda, mostra o resultado no painel e otimiza a entrega dos anúncios para quem converte.

Sem pixel você compra clique no escuro. Com pixel errado é pior: você otimiza para o evento errado.

Os dois eventos que este guia instala

O que você precisa ter em mãos

• Login no Taboola Ads / Realize (ads.realizeperformance.com). "Realize" é o nome novo da interface do Taboola Ads — é a mesma coisa.
• O seu Account ID numérico (mostro onde achar na Parte 1).
• Acesso de administrador na plataforma onde está o checkout (Shopify, Hotmart, Monetizze, Cartpanda, WordPress).
• Google Chrome com a extensão Taboola Pixel Helper instalada (Parte 3).

Glossário rápido

Shopify

Dois caminhos. O app oficial resolve tudo em cinco cliques e já manda valor da compra. O Custom Pixel é o plano B para quem não pode instalar apps.

Caminho A · App oficial "Taboola Pixel" (recomendado)

Desenvolvido pela própria Taboola, gratuito. Instala o código base e cria automaticamente 8 conversões no Realize: page_view, make_purchase (com revenue, currency e order id), start_checkout, add_to_cart, cart_view, product_view, collection_view, search_submitted. Você não cria nada à mão.

1. Abra a Shopify App Store em apps.shopify.com/taboola-ads-pixel (ou busque "Taboola Pixel", desenvolvedor Taboola). Clique em Install. A Shopify mostra as permissões do app; confirme em Install.

   

2. O app abre dentro do admin Shopify. Clique em Get started.

   

3. Abre um popup de login do Realize. Faça login com o e-mail da sua conta Taboola. Se o popup não abrir, desative o bloqueador de anúncios e recarregue.

4. Popup Connect Shopify App to Realize: clique em Next.

   

5. Select the account to connect: escolha a conta Taboola que vai receber as conversões (digite o nome para filtrar) e clique em Connect.

   

6. De volta ao app: confira a conta no campo e clique em Install.

   

7. Pronto: "Your Taboola Pixel is Ready!". Abra Installed Conversions (8) para ver a lista. Se você usa app de upsell pós-compra, abra Post-Purchase Upsell Code Snippet e siga a instrução (cola um snippet na configuração de checkout). Depois vá para a Parte 3 e teste pelo link Testing Tool.

   

Caminho B · Custom Pixel (manual, sem app)

Use só se não puder instalar o app. Você cola um script em Customer events e depois cria as conversões no Realize à mão (pelo menos a make_purchase da Parte 1.4).

1. No admin Shopify: Settings → Customer events. Clique em Add custom pixel (canto superior direito).

   

2. Dê um nome (ex.: Manual Taboola Pixel) e clique em Add pixel.

   

3. Na caixa Code, apague o conteúdo de exemplo e cole o código abaixo, trocando 1234 pelo seu Account ID (aparece duas vezes: na constante e na URL do tfa.js).

   

   const your_account_id = 1234; // seu Account ID numérico
   
   window._tfa = window._tfa || [];
   window._tfa.push({ notify: "event", name: "page_view", id: your_account_id });
   !(function (t, f, a, x) {
     if (!document.getElementById(x)) {
       t.async = 1; t.src = a; t.id = x; f.parentNode.insertBefore(t, f);
     }
   })(document.createElement("script"), document.getElementsByTagName("script")[0],
      "//cdn.taboola.com/libtrc/unip/1234/tfa.js", "tb_tfa_script");
   
   analytics.subscribe("product_viewed", e => { _tfa.push({ notify:"event", name:"product_view", id: your_account_id }); });
   analytics.subscribe("product_added_to_cart", e => { _tfa.push({ notify:"event", name:"add_to_cart", id: your_account_id }); });
   analytics.subscribe("checkout_started", e => { _tfa.push({ notify:"event", name:"start_checkout", id: your_account_id }); });
   analytics.subscribe("checkout_completed", e => {
     _tfa.push({
       notify: "event", name: "make_purchase", id: your_account_id,
       currency: e.data?.checkout?.currencyCode,
       orderid:  e.data?.checkout?.order?.id,
       revenue:  e.data?.checkout?.totalPrice?.amount
     });
   });

4. Clique em Save (barra preta no topo) e depois em Connect.

   

5. Volte em Customer events e confirme o status Connected.

   

6. No Realize, crie a conversão make_purchase (Parte 1.4) e, se quiser, start_checkout (categoria Start Checkout) e add_to_cart (categoria Add to Cart) com os mesmos nomes do código.

Hotmart

Integração nativa. Você não cola código: escolhe "Taboola", informa o Account ID e a Hotmart dispara os eventos no checkout e na página de obrigado dela.

Como a Hotmart nomeia os eventos

A Hotmart usa nomes fixos e por produto. Você vai precisar deles ao criar as conversões no Realize:

O ID do produto é o número que aparece na lista de produtos da Hotmart (e na URL do checkout). Exemplo: produto 1234567 → evento hotmart_purchase_1234567.

Passo 1 · No Realize: criar as conversões

1. Tracking → + New Conversion → tipo EVENT → categoria Make Purchase → em Event Name digite hotmart_purchase_IDDOPRODUTO (com o número real). Fixed Value em branco. Marque "Include in total conversions" e "Include in total value". Create.

2. Repita para o checkout, se quiser acompanhar: categoria Start Checkout, Event Name hotmart_checkout_IDDOPRODUTO. Não marque "Include in total conversions" neste.

Passo 2 · Na Hotmart: ativar o pixel

1. Entre em app.hotmart.com. No menu lateral, Ferramentas → Ver todas.

2. Procure e abra Pixel de rastreamento.

3. Selecione o produto e, na lista de provedores, escolha Taboola.

4. Informe o seu Account ID do Taboola (só o número; não é para colar o código). Clique em Continuar.

5. Marque os tipos de evento: Vendas realizadas (obrigatório) e Visitas na página de pagamento (opcional). Abra as configurações avançadas:

   • Métodos de pagamento: "Todos", "Apenas pagamentos imediatos (cartão)" ou "Apenas não imediatos (boleto, Pix)". Para não contar boleto gerado como venda, escolha apenas imediatos — ou aceite todos e trate o ajuste no relatório.
   • Valor enviado: "Valor da transação" (recomendado — vai como revenue) ou "Valor que eu definir" (fixo).
   • Order bump e produtos adicionais precisam de pixel configurado por produto.

6. Continuar → forma de envio (Web / API de Conversões / ambos, conforme o que a Hotmart oferecer para o Taboola) → Salvar.

7. Teste: abra o checkout do produto com o Pixel Helper aberto e confira page_view e hotmart_checkout_…. Faça uma compra de teste (cupom 100% ou valor mínimo) e confira hotmart_purchase_… no Test Events do Realize.

Cartpanda

Nativo e simples. Se precisar de controle total, a Cartpanda também aceita scripts personalizados com variáveis do pedido.

Caminho A · Pixel nativo

1. No painel: Admin → Rastreamento e Script (menu lateral esquerdo; em lojas com "Loja Online", o caminho aparece como Loja Online → Pixels). Clique em Novo Pixel.

   

2. Selecione Taboola. Preencha Nome do pixel (ex.: Taboola) e Taboola Pixel Id = seu Account ID.

3. Opções:

   • Disparar evento de "Compra" para Boleto Bancário: marque só se quiser contar boleto gerado.
   • Incluir valor do frete no evento "Compra": a seu critério (revenue com ou sem frete).
   • Evento de pixel: Disparar em todos os eventos (checkout iniciado + compra). "Disparar apenas Compra" ignora o checkout; "Disparar apenas Checkout Iniciado" ignora a página de obrigado — onde a conversão acontece. Não use esta última.

   

4. Salve. No Realize, crie a conversão de compra por EVENT (Parte 1.4). A documentação da Cartpanda não informa o nome exato do evento enviado — faça uma compra de teste com o Pixel Helper aberto, leia o nome que aparece (provavelmente make_purchase ou purchase) e use exatamente esse nome no Realize. Se o evento chegar como "Undefined conversion" no Test Events, clique em Create Conversion ali mesmo.

Caminho B · Scripts adicionais (controle total)

Em Admin → Rastreamento e Scripts → Scripts Adicionais você escolhe a área (Loja, Checkout ou Página de Obrigado) e a seção (<head> ou <body>), cola o código e salva. A Cartpanda expõe variáveis do pedido:

Receita pronta (use ou o pixel nativo ou os scripts — nunca os dois, senão duplica):

1) Loja + Checkout + Página de Obrigado → <head>: cole o código base da Parte 1.3.

2) Página de Obrigado → <body>:

<script>
  window._tfa = window._tfa || [];
  _tfa.push({
    notify: 'event',
    name: 'make_purchase',
    id: SEU_ACCOUNT_ID,
    revenue: ,
    currency: 'BRL',
    orderid: ''
  });
</script>

WooCommerce

Loja própria em WordPress: use o plugin "Taboola Pixel for WooCommerce". Ele instala o base e cria as 8 conversões, com valor da compra, sem código. A alternativa manual fica no fim para quem precisa.

Caminho A · Plugin oficial "Taboola Pixel for WooCommerce"

1. Plugins → Adicionar novo → busque Taboola Pixel for WooCommerce (By Taboola; exige o WooCommerce ativo) → Instalar agora.

   

2. Ativar.

   

3. Menu lateral Taboola Pixel → Connect Realize Account → login → popup Connect WooCommerce App → Next → escolha a conta → Connect (mesmo fluxo da Parte 2.6).

   

4. Clique em Install Pixel.

   

5. Pronto. O card "We installed conversions on your store" lista os 8 eventos criados automaticamente: Make Purchase, Start Checkout, Add To Cart, Cart View, Search Submitted, Collection View, Product View, Page View. Nada mais a configurar. Vá para a Parte 3 e teste com um pedido.

   

Caminho B · Manual (WPCode + hook do WooCommerce)

Para quem não pode usar o plugin (conflito, page builder, checkout customizado). Duas peças: o código base no header e o evento de compra na página "Pedido recebido".

1. Instale o plugin WPCode (antigo "Insert Headers and Footers"). Em Code Snippets → Header & Footer, cole o código base da Parte 1.3 na caixa Header e salve. Isso cobre o page_view em todas as páginas.

2. Em Code Snippets → Add Snippet → Add Your Custom Code, tipo PHP Snippet, cole o código abaixo. Insert Method: Auto Insert, Location: Run Everywhere (o hook cuida de disparar só na página de pedido recebido). Ative.

   <?php
   // Taboola make_purchase na página "Pedido recebido" do WooCommerce.
   // Requer o código base já carregado no <head>.
   add_action( 'woocommerce_thankyou', 'cb_taboola_purchase', 10, 1 );
   function cb_taboola_purchase( $order_id ) {
       if ( ! $order_id ) { return; }
       $order = wc_get_order( $order_id );
       if ( ! $order || $order->has_status( array( 'failed', 'cancelled' ) ) ) { return; }
   
       // dispara uma vez por pedido (recarregar a página não duplica)
       if ( $order->get_meta( '_taboola_purchase_sent' ) ) { return; }
       $order->update_meta_data( '_taboola_purchase_sent', 1 );
       $order->save();
   
       $account_id = 1234567; // seu Account ID
       ?>
       <script>
         window._tfa = window._tfa || [];
         _tfa.push({
           notify:   'event',
           name:     'make_purchase',
           id:       <?php echo (int) $account_id; ?>,
           revenue:  <?php echo wp_json_encode( round( (float) $order->get_total(), 2 ) ); ?>,
           currency: <?php echo wp_json_encode( $order->get_currency() ); ?>,
           quantity: <?php echo (int) $order->get_item_count(); ?>,
           orderid:  <?php echo wp_json_encode( (string) $order->get_order_number() ); ?>
         });
       </script>
       <?php
   }

3. No Realize, crie a conversão make_purchase (Parte 1.4). Faça um pedido de teste e confira no Test Events.

Afiliado: Ratoeira Ads + RedTrack

Como afiliado você não instala pixel no checkout do produtor. Você rastreia pelo seu próprio funil (presell) e por um tracker.

Fontes oficiais consultadas

Taboola Dev Center — base pixel manual · definir conversões · valores dinâmicos · Make Purchase · Pixel Helper · Testing Tool · Shopify app · Shopify custom pixel · apps que pulam o checkout (Releasit) · WordPress plugin · WooCommerce plugin · GTM · postback S2S · macros de URL · Realize Tracking overview
Shopify App Store — Taboola Pixel · WordPress.org — Taboola Pixel · Taboola Pixel for WooCommerce
Hotmart — integração Taboola · Pixel de rastreamento · configurações avançadas · página de obrigado
Monetizze — integração Taboola · parâmetros da página de obrigado
Cartpanda — pixel Taboola · scripts adicionais
Releasit — por que pedidos COD não passam pelo checkout Shopify.
Prints das interfaces reproduzidos das documentações oficiais acima (set/2026). Interfaces mudam; se a tela estiver diferente, o caminho de menu continua o mesmo.