OpenAdLibraryOpenAdLibrary
Afiliado e Media Buying

Macros Taboola & Parâmetros de URL de Redes Nativas: O Guia Rápido

A chave de ligação entre seu investimento em anúncios e suas conversões é uma macro. Aqui está o conjunto completo da Taboola, os equivalentes do Outbrain, MGID e Revcontent, e os erros de modelo que silenciosamente comprometem o rastreamento.

Ilustração editorial: Macros Taboola & Parâmetros de URL de Redes Nativas: O Guia Rápido

Macros Taboola são tokens dinâmicos — {click_id}, {site}, {campaign_id} e cerca de uma dúzia de outros — que a Taboola substitui por valores reais no momento em que alguém clica no seu anúncio. Acrescentados à URL da sua página de destino, eles informam ao seu rastreador exatamente qual clique, posicionamento do publicador, campanha e criativo geraram cada visita e cada conversão. Sem macros você compra tráfego nativo às cegas; com elas você pode calcular custo por conversão em nível de posicionamento e eliminar o que perde. Este guia rápido cobre o conjunto funcional de macros na Taboola, os parâmetros dinâmicos equivalentes no Outbrain, MGID e Revcontent, e os poucos erros de modelo que silenciosamente comprometem o rastreamento em todas elas.

Por que as macros decidem se você pode otimizar ou não#

Redes nativas cobram por clique, mas não atribuem nada para você. Cada decisão de otimização que você tomar — pausar esse posicionamento, aumentar esse lance, remover esse criativo, escalar essa campanha — depende de conectar os dados de gasto da rede aos seus dados de conversão. A chave de ligação é a macro.

A configuração padrão é rastreamento server-to-server (S2S):

  1. A Taboola substitui {click_id} por um valor único quando seu anúncio é clicado.
  2. Seu rastreador (ou seu próprio backend) armazena esse ID de clique na sessão.
  3. Quando o visitante converte, você dispara a URL de postback da rede com o ID de clique armazenado.
  4. A rede atribui a conversão ao clique exato — posicionamento, criativo, geo, dispositivo e tudo mais — e seu algoritmo de lances começa a aprender com conversões reais em vez de cliques brutos.

Ignorar as macros faz com que essa cadeia não exista. Você verá sessões nas análises e gasto no painel, sem forma confiável de conectá‑los. A Taboola também oferece um pixel on‑page, e vale a pena usar ambos — mas o postback S2S baseado em {click_id} é o que sobrevive a bloqueadores de anúncios, recursos de privacidade do iOS e jornadas cross‑device, razão pela qual compradores experientes o tratam como a fonte da verdade.

O guia rápido de macros Taboola#

Macros Taboola usam chaves simples, todas minúsculas. O conjunto funcional que a maioria dos compradores de mídia realmente usa:

Macro O que retorna Para que você usa
{click_id} ID único para este clique A chave de junção S2S — indispensável
{site} Código do site do publicador Otimização e bloqueio em nível de posicionamento
{site_id} ID numérico do site Mesma função, como chave numérica estável
{site_domain} Domínio do publicador Relatórios de posicionamento legíveis
{campaign_id} ID da campanha Relatórios multi‑campanha
{campaign_name} Nome da campanha Relatórios legíveis (atenção à codificação de URL)
{campaign_item_id} ID do anúncio (criativo) específico Análise de vencedores em nível de criativo
{title} Manchete do anúncio Análise de manchetes
{thumbnail} URL da imagem criativa Unindo variantes de imagem entre anúncios
{platform} Plataforma do dispositivo Divisão desktop / mobile / tablet
{timestamp} Timestamp do clique Depuração e análise de dayparting

Um URL de rastreamento completo fica assim:

https://track.yourdomain.com/click?clickid={click_id}&source={site_id}&camp={campaign_id}&ad={campaign_item_id}&device={platform}

Dois apontamentos práticos. Primeiro, macros diferenciam maiúsculas de minúsculas — {Click_ID} passa como texto literal e seu rastreador recebe uma string inútil. Segundo, a Taboola adiciona e ocasionalmente renomeia macros; a lista acima é o núcleo estável, mas verifique no centro de ajuda da Taboola antes de um grande lançamento. Se estiver configurando sua primeira campanha de ponta a ponta, o guia passo‑a‑passo de configuração da Taboola mostra onde os campos de rastreamento ficam na interface.

Os mesmos conceitos no Outbrain, MGID e Revcontent#

Todas as redes nativas implementam os mesmos quatro conceitos — clique, posicionamento, campanha, criativo — com nomes e sintaxes diferentes. O mapeamento:

Conceito Taboola Outbrain MGID Revcontent
Sintaxe {macro} {{macro}} {macro} {macro}
ID de clique {click_id} {{ob_click_id}} {click_id} ver painel
Posicionamento {site} / {site_id} {{publisher_id}} / {{section_id}} {widget_id} {widget_id}
Nome do posicionamento {site_domain} {{publisher_name}} / {{section_name}}
Campanha {campaign_id} {{campaign_id}} {campaign_id} {boost_id}
Criativo {campaign_item_id} {{ad_id}} / {{ad_title}} {teaser_id} {content_id}

Detalhes que valem a pena saber:

  • Outbrain usa chaves duplas e seu modelo de posicionamento tem dois níveis: um publicador e uma seção — a posição específica do widget naquele publicador. Otimize na seção, não apenas no publicador; o widget dentro do artigo e o da barra lateral podem ter desempenho totalmente diferente no mesmo site.
  • MGID chama criativos de "teasers", daí {teaser_id}. Seus IDs de widget são a unidade que você vai bloquear diariamente.
  • Revcontent organiza campanhas como "boosts", portanto {boost_id} é a chave da campanha. Sua lista de macros mudou ao longo dos anos — extraia o conjunto atual do seu painel em vez de um tópico antigo.
  • Um traço na tabela indica que a rede trata essa dimensão no nível de estrutura de campanha, ou que o macro mudou com frequência demais para ser listado. Em caso de dúvida, consulte a documentação atual da rede.

Um modelo de rastreamento que funciona em todas as quatro redes#

Normalize do seu lado, não do deles. Defina nomes de parâmetros canônicos — por exemplo clickid, source, camp, ad — e mapeie as macros de cada rede para eles:

Taboola:   ?clickid={click_id}&source={site_id}&camp={campaign_id}&ad={campaign_item_id}
Outbrain:  ?clickid={{ob_click_id}}&source={{section_id}}&camp={{campaign_id}}&ad={{ad_id}}

Seu rastreador, seus relatórios e suas regras de bloqueio então funcionam de forma idêntica em todos os lugares, e adicionar uma quinta rede se torna um exercício de mapeamento de cinco minutos. Direcione cliques através de um domínio de rastreamento de cliques dedicado para que você possa trocar de software de rastreamento depois sem reconstruir cada campanha.

Prefira IDs a nomes no modelo. {campaign_name} e {title} contêm espaços, e‑commercials e emojis que chegam codificados em URL — e um & não codificado dentro de uma manchete truncará silenciosamente todos os parâmetros subsequentes. IDs são estáveis; nomes são editados durante o voo e dividem uma linha de dados em duas.

Macros e parâmetros UTM: use ambos, para funções diferentes#

Tags UTM alimentam suas análises; macros alimentam suas decisões de compra. Um modelo dual sensato define utm_source=taboola, utm_medium=native e preenche o resto dinamicamente — utm_campaign={campaign_id}, utm_content={campaign_item_id}, utm_term={site_id} — para que os relatórios de tráfego das análises alinhem com os relatórios de posicionamento do rastreador. Apenas não otimize apenas com base nas análises: contagens de sessões e cliques divergem (redirecionamentos, rejeições antes do disparo da tag, scripts bloqueados), e a diferença aumenta exatamente onde a qualidade do tráfego é pior — os posicionamentos que você mais precisa capturar.

Cinco erros de macro que silenciosamente consomem orçamento#

  1. Macros literais na URL. Um erro de digitação — chaves erradas, caso errado, espaço extra — faz com que o token nunca seja substituído e sua página de destino receba o texto literal {click_id}. As conversões deixam de ser associadas, a campanha "mostra" CVR zero, e você elimina um possível vencedor. Inspecione as strings de consulta das suas primeiras dez sessões após cada lançamento.
  2. Ausência de macro de posicionamento. Sem {site} ou {widget_id} no modelo você não pode criar listas brancas e negras de posicionamento — e a poda de posicionamento é onde reside a maior parte do lucro de otimização nativa. O ID de publicador e site é o átomo da compra de mídia nativa.
  3. Postback sem deduplicação. Se o mesmo ID de clique puder disparar seu postback duas vezes — recarregamento de página, lógica de retry, usuário revisitando a página de agradecimento — você conta a conversão duas vezes e escala perdedores. Deduplice pelo ID de clique no rastreador.
  4. Nomes em vez de IDs. Uma renomeação de campanha durante o voo divide seus dados; veja acima.
  5. Teste com gasto real. Verifique a substituição com as ferramentas de pré‑visualização da rede e uma campanha canário de orçamento mínimo em uma geo barata, não com seu orçamento de lançamento.

Lendo as macros de um concorrente#

Modelos de rastreamento vazam. Quando uma biblioteca de anúncios rastreia o caminho de clique de um anúncio nativo, a URL de destino capturada preserva a string de parâmetros do anunciante — com as macros já preenchidas. Extraia anúncios de concorrentes na ferramenta de espionagem de anúncios Taboola e inspecione as URLs de destino rastreadas: o domínio do rastreador indica qual software eles utilizam, a estrutura de subid revela a granularidade que otimizam, e um ID de posicionamento em um subid mostra que eles estão podando posicionamentos — a assinatura de um operador que vale a pena estudar. O fluxo completo de um anúncio ao seu funil está coberto em como encontrar páginas de destino de concorrentes.

Conclusão#

Macros são trinta minutos de configuração que determinam se cada hora subsequente de compra de mídia será mensurável. Obtenha {click_id} e uma macro de posicionamento no seu modelo no primeiro dia, faça postbacks server‑to‑server, prefira IDs a nomes e verifique a substituição antes de escalar. As redes renomeiam macros ocasionalmente; os quatro conceitos que codificam — clique, posicionamento, campanha, criativo — não mudaram em uma década.

Perguntas frequentes

O que são macros Taboola?
Macros Taboola são tokens dinâmicos — como {click_id}, {site} e {campaign_item_id} — que a Taboola substitui por valores reais quando um usuário clica no seu anúncio. Acrescentados à URL da sua página de destino ou de rastreamento, eles enviam a identidade do clique, posicionamento, campanha e criativo para o seu rastreador, permitindo otimização em nível de posicionamento e criativo.
Como passo o ID de clique da Taboola para o meu rastreador?
Adicione {click_id} como parâmetro na URL de rastreamento da sua campanha, por exemplo ?clickid={click_id}. A Taboola preenche esse valor no momento do clique, seu rastreador o armazena na sessão e, quando ocorre uma conversão, você dispara o postback server-to-server da Taboola com esse mesmo ID. A Taboola então atribui a conversão ao clique, posicionamento e criativo exatos.
Qual o equivalente no Outbrain ao {click_id} da Taboola?
O Outbrain usa chaves duplas e seu macro de identificador de clique é {{ob_click_id}}. Os conceitos de posicionamento também correspondem: {{publisher_id}} e {{section_id}} do Outbrain equivalem aproximadamente a {site_id} da Taboola, e {{ad_id}} corresponde a {campaign_item_id}. A sintaxe difere, mas os quatro conceitos subjacentes — clique, posicionamento, campanha, criativo — são idênticos entre as redes nativas.
Por que minha URL mostra {click_id} como texto literal?
A macro não foi substituída, o que quase sempre indica um erro de sintaxe: caso incorreto (macros são minúsculas), chaves erradas para a rede, um erro de digitação ou um nome de macro que a rede não suporta. A rede passa o token não reconhecido sem alterações. Corrija o modelo e verifique inspecionando a string de consulta em um clique de teste antes de investir.
Preciso de uma ferramenta de rastreamento para usar macros de anúncios nativos?
Não estritamente — você pode inserir macros no seu próprio backend ou até em UTMs de analytics — mas um rastreador dedicado ou um endpoint específico é a resposta prática para postbacks S2S, deduplicação de IDs de clique e relatórios em nível de posicionamento. O que importa é que algo armazene o ID do clique e seus metadados, e possa disparar o postback da rede quando uma conversão ocorre.
A Equipe OpenAdLibrary
Escrito porA Equipe OpenAdLibrary
Inteligência publicitária e pesquisa de anúncios nativos

Nós construímos o OpenAdLibrary, a plataforma aberta de transparência publicitária. Todos os dias, nossos sistemas capturam anúncios nativos ativos no Taboola, Outbrain, MGID, Revcontent, Teads, Yahoo e MSN, identificam o verdadeiro anunciante por trás de cada um e seguem o clique até sua página de destino. Estes guias condensam o que vemos nesses dados para que você possa pesquisar o mercado mais rapidamente.