Rastreamento de anúncios

01Como funciona

Anúncio que manda direto para o t.me perde o rastro: a Meta e a TikTok não sabem quem clicou, então não sabem quem comprou. O Crownbot resolve isso com um link próprio para o anúncio:

1. O anúncio aponta para crownbot.com.br/t/seu_bot, não para o t.me.
2. Esse link guarda o clique (o identificador do anúncio, as UTMs, o IP e o navegador) e, na mesma hora, abre o bot com um código no /start.
3. O bot liga o código à conversa. Dali em diante, cada passo da pessoa vira um evento, enviado pelo servidor.

Tudo sai do servidor do Crownbot (Conversions API da Meta, Events API da TikTok e API da UTMify). Não há pixel no navegador, então bloqueador de anúncio e navegador do Instagram não atrapalham.

02Passo 1: o link no anúncio

Em Painel > Bots, no cartão do bot, abra Rastreamento e copie o link. Ele é sempre https://www.crownbot.com.br/t/ seguido do @ do bot, sem o @. Use esse link no anúncio no lugar do t.me.

Para a UTMify saber qual campanha, conjunto e anúncio venderam, preencha os parâmetros de URL do anúncio. O identificador do clique (fbclid ou ttclid) a plataforma põe sozinha.

utm_source=FB&utm_campaign={{campaign.name}}|{{campaign.id}}&utm_medium={{adset.name}}|{{adset.id}}&utm_content={{ad.name}}|{{ad.id}}&utm_term={{placement}}

utm_source=tiktok&utm_campaign=__CAMPAIGN_NAME__|__CAMPAIGN_ID__&utm_medium=__AID_NAME__|__AID__&utm_content=__CID_NAME__|__CID__&utm_term=__PLACEMENT__

Nos números do fluxo (Painel > Fluxos e o editor), a origem de quem entrou pelo link vira o utm_source (FB, tiktok). Para uma origem diferente, acrescente &origem=nome ao link.

03Passo 2: Meta (Facebook e Instagram)

1. No Gerenciador de Eventos, abra o conjunto de dados (o pixel) que o anúncio usa. O ID fica embaixo do nome.
2. Em Configurações > API de Conversões, clique em Gerar token de acesso e copie.
3. No Rastreamento do bot, cole o ID e o token no cartão da Meta e clique em Ligar.
4. Para conferir: na aba Eventos de teste do Gerenciador, copie o código (TEST12345), cole no campo Código de teste e clique em Enviar compra de teste. A compra aparece na aba em segundos e não conta nos anúncios.

Os eventos reais aparecem no Gerenciador de Eventos como recebidos pelo servidor (API de Conversões). Para otimizar a campanha por venda, escolha o evento Compra no conjunto de anúncios.

04Passo 3: TikTok

1. No Gerenciador de Eventos da TikTok, abra o pixel que o anúncio usa. O código fica embaixo do nome.
2. Em Configurações > Events API, clique em Gerar token de acesso e copie.
3. No Rastreamento do bot, cole o código e o token no cartão da TikTok e clique em Ligar.
4. Para conferir: na aba Eventos de teste do pixel, copie o código de teste e use o botão Enviar compra de teste.

05Passo 4: UTMify

1. Na UTMify, em Integrações > Webhooks > Credenciais de API, clique em Adicionar credencial e copie.
2. No Rastreamento do bot, cole no cartão da UTMify e clique em Ligar.
3. Para conferir: Validar com um pedido de teste. A UTMify confere o pedido e não grava (é o modo de teste dela).

Cada Pix do bot vira um pedido na plataforma "Crownbot", com as UTMs do clique, o nome do plano e a comissão (o valor menos a tarifa do Crownbot e a taxa do gateway). O Telegram não informa e-mail: se o fluxo não perguntou (bloco Pergunta com a variável email), o pedido vai com um endereço técnico, telegram-<id>@crownbot.com.br.

06O que vai para as plataformas

• Do clique: IP, navegador, a página do link e o identificador do anúncio. Vão como estão, que é como a Meta e a TikTok pedem para comparar com quem clicou.
• Da pessoa: o ID do Telegram e o primeiro nome, só como hash SHA-256 para a Meta e a TikTok. A UTMify recebe o primeiro nome, o IP e o e-mail, se o fluxo perguntou.
• Da venda: valor, moeda (BRL), o nome do plano e o código do Pix.
• Nunca: o que a pessoa escreveu no bot, o @ dela, o token do bot ou dados de outros bots.

07Entrega, falhas e casos especiais

• Cada evento sai uma vez só: a confirmação de pagamento que chega repetida não vira duas compras, e o mesmo código de evento faz a Meta e a TikTok descartarem o que se repetir.
• Plataforma fora do ar: tenta de novo depois de 1 min, 5 min, 30 min, 2 h e 12 h. Token ou pixel recusado: para na hora, com a mensagem da plataforma na lista de Últimos envios.
• Venda de quem não veio pelo link (entrou por outro caminho): a compra vai assim mesmo, sem clique (na Meta, como conversa). Não há Lead, porque não há anúncio para atribuir.
• O chat de teste do rascunho (o seu) não conta.
• O clique fica guardado por 90 dias; o histórico de envios, por 30.

08Quando algo não aparece

1. O anúncio usa o link crownbot.com.br/t/…? Com o t.me direto, só a compra chega, sem atribuição.
2. O cartão da plataforma está como Ligado no Rastreamento do bot?
3. Em Últimos envios, o evento está como Falhou? A mensagem ao lado diz o motivo (token vencido, pixel errado).
4. O teste chegou? Se o teste chega e o evento real não, confira o passo 1. A Meta pode levar alguns minutos para mostrar os eventos no Gerenciador.
5. A UTMify só aceita pedidos de até 7 dias. Pedido mais antigo que isso não entra.