Integração RedTrack + Taboola

A integração mais importante: como o RedTrack envia dados de conversão de volta para o Taboola via S2S postback para otimização automática.

O que você vai aprender nesta seção:

Criar conversão S2S no Taboola Realize
Configurar o postback do RedTrack para o Taboola
Configurar parâmetros de tracking na campanha
Entender o fluxo completo de Click IDs
Configurar o Pixel do Taboola (opcional mas recomendado)

Documentação RedTrack: Taboola Integration
Documentação Taboola: S2S with RedTrack

Parte 1: Criando Conversão S2S no Taboola

Documentação: Defining Conversions

Acesse Tracking no Realize

No Realize, acesse Tracking na barra lateral esquerda.

Crie nova conversão

Clique em + New Conversion.

Selecione 'Create conversions using code'

Clique em Continue.

Preencha as informações

Conversion Name: Nome descritivo (ex: "Compra BuyGoods")
Category: Selecione "Purchase"
Event Name: Nome técnico único — OBRIGATORIAMENTE em letras minúsculas

REGRA CRÍTICA

O Event Name DEVE ser em letras minúsculas. Exemplo correto: purchase. Exemplos incorretos: Purchase, PURCHASE. O Taboola é case-sensitive neste campo.

Configure as janelas de conversão

Click Conversion Window: 1-30 dias após o clique
View Conversion Window: 1-24 horas após visualização

Finalize

Decida sobre "Include in Total Conversions", atribua valor monetário (recomendado) e clique em Create.

Anote o Event Name exato — você vai precisar dele no próximo passo!

Parte 2: Configurando S2S Postback no RedTrack

Acesse as configurações da campanha

No RedTrack, acesse as configurações da sua campanha Taboola.

Encontre a seção de postback

Role até "S2S Postback for Taboola" e clique em Add.

Configure o Event Name

Verifique que o parâmetro EVENT_NAME está substituído pelo nome do seu evento (em letras minúsculas, exatamente como criado no Realize).

A URL de postback que o RedTrack enviará ao Taboola terá este formato:

Postback URL do RedTrack para o Taboola

https://trc.taboola.com/actions-handler/log/3/s2s-action?click-id={click_id}&name=purchase&revenue={payout}&currency=USD

Salve

Clique em Save Changes.

URL do Postback S2S do Taboola — Detalhes

Documentação: The Postback URL

Formato base do postback S2S

https://trc.taboola.com/actions-handler/log/3/s2s-action?click-id=CLICK_ID&name=EVENT_NAME&revenue=REVENUE&currency=CURRENCY&orderid=ORDER_ID

Parâmetro	Obrigatório	Descrição
`click-id`	SIM	Click ID do Taboola. USA HÍFEN, NÃO UNDERSCORE!
`name`	SIM	Event Name exatamente como no Realize (minúsculas)
`revenue`	Não	Valor da transação (ex: 49.95)
`currency`	Não	Moeda (ex: USD, BRL, EUR)
`orderid`	Não	ID do pedido
`quantity`	Não	Quantidade de itens

ARMADILHA #1 — click-id com HÍFEN

O parâmetro DEVE se chamar click-id (com hífen). Se você usar click_id ou clickid, as conversões NÃO serão registradas. Esta é a causa #1 de tracking quebrado!

ARMADILHA #2 — Event Name case-sensitive

O Event Name deve ser em letras minúsculas exatamente como definido no Realize. purchase ≠ Purchase ≠ PURCHASE.

Parte 3: Configurando Tracking na Campanha do Taboola

Configure parâmetros de tracking

Na campanha do Taboola, na seção Tracking Code, adicione:

Parâmetros de Tracking no Taboola

tbclid={click_id}&sub1={campaign_id}&sub2={campaign_item_id}&sub3={site_id}&sub4={platform}

Configure URL de destino dos anúncios

Cole o Click URL do RedTrack como URL dos seus anúncios.

Fluxo Completo de Click IDs

1. Taboola gera click_id único (ex: tb1abc123xyz456)

2. URL do anúncio: https://track.seudominio.com/CAMPAIGN?tbclid=tb1abc123xyz456

3. RedTrack recebe, cria seu próprio clickid interno (ex: redtrack_abc123)

4. RedTrack armazena: redtrack_abc123 ↔ tb1abc123xyz456

5. Passa para oferta: ...?subid=redtrack_abc123 (BuyGoods) ou ...?tid=redtrack_abc123 (Clickbank)

6. Na conversão, rede retorna: clickid=redtrack_abc123

7. RedTrack busca associação: redtrack_abc123 → tb1abc123xyz456

8. Envia para Taboola: click-id=tb1abc123xyz456&name=purchase

Pixel do Taboola (Opcional mas Recomendado)

Documentação: Conversion Tracking Overview

Mesmo usando S2S como método principal, instale o pixel base na landing page. O pixel ajuda o Taboola a otimizar campanhas e coletar dados de audiência.

Ferramentas de verificação do pixel:

Taboola Pixel Helper (extensão Chrome)

Resumo

Crie conversão S2S no Realize com Event Name em minúsculas
Configure postback no RedTrack com URL usando click-id (hífen!)
Parâmetros de tracking na campanha: tbclid={click_id}
O RedTrack mapeia automaticamente seus click IDs com os do Taboola
Instale o pixel base mesmo usando S2S