Rastreio

Links curtos rastreáveis (/r/xxxx) que mostram o que cada link gerou: cliques agora, leads e vendas depois, por cliente, canal, vídeo e campanha.

Pra que serve

O YouTube não conta clique em link. Você cola uma URL na descrição, na bio ou no comentário fixado e não sabe quantas pessoas clicaram, quantas viraram lead e quantas compraram. O Rastreio resolve isso.

Você cria um link curto do YouFlow (fica no formato seudominio.com/r/abc123) que redireciona pro seu destino final. Cada clique é registrado. Se você instalar o pixel ou o postback no seu site, também aparecem as conversões (leads e vendas) e a receita gerada por aquele link.

O ganho maior é o vínculo em cascata: cada link pode ser amarrado a um cliente, a um canal, a um vídeo e a um projeto (campanha). Assim os rankings respondem perguntas reais: qual vídeo mais vende, qual posição converte melhor (descrição x comentário fixado), qual cliente gera mais receita, qual campanha performou.

ℹ️

Receita em cents: os valores de venda são guardados em centavos internamente e exibidos em reais (R$) na tela. Você não precisa se preocupar com isso, é só como o sistema calcula pra não perder precisão.

Quem pode acessar

Rastreio é um módulo do plano Agency. Aparece no menu no grupo Produção. Precisa estar no plano certo e o módulo estar liberado pro workspace (o super-admin pode ajustar acessos por workspace em /admin/acessos).

Os filtros e rankings por cliente só aparecem em workspaces business/agency (que têm cadastro de clientes). Em creator o módulo funciona igual, só sem a camada de cliente.

As quatro abas

Visão geral

KPIs do período (cliques, únicos, conversões, receita verificada) e rankings por vídeo, posição, objetivo, canal, projeto e cliente.

Links

Lista de todos os links. Cria link único (com vínculo em cascata e UTMs) ou vários de uma vez em Criar em lote.

Projetos

Campanhas que agrupam links (um lançamento, uma promoção) pra comparar campanhas entre si nos rankings.

Configurações

Tokens do pixel e do postback, com os snippets prontos pra instalar no seu site.

Visão geral: o que os números dizem

No topo você escolhe o período (padrão: últimos 28 dias) e filtra por cliente, canal e projeto. Escolher um canal já seleciona o cliente dele; escolher um cliente com um único canal já seleciona o canal.

Os KPIs do período:

KPI	O que é
Cliques	Total de cliques nos links no período.
Únicos	Visitantes distintos (o mesmo visitante clicando duas vezes conta 1).
Conversões	Leads + vendas registrados. Mostra abaixo quantas foram vendas.
Receita verificada	Só vendas confirmadas por postback. Se houver receita estimada por pixel, aparece somada abaixo, separada e marcada como estimada.

Abaixo vêm os rankings. O de Vídeos é uma tabela com cliques, conversões, receita, views (importadas do CSV), CTR sobre views e R$ por mil views, o indicador que mostra quanto cada vídeo rende de verdade em relação ao alcance. Os demais (Posições, Objetivos, Canais, Projetos e Clientes) são barras proporcionais, ordenadas por cliques.

Como criar um link único

Abra a aba Links e clique em Novo link.
Destino (URL final). Cole a página pra onde o clique deve levar (página de vendas, checkout, WhatsApp, etc). É o único campo obrigatório.
Nome (opcional). Um apelido pra você reconhecer o link na lista (ex: "Checkout do curso").
Objetivo e Posição. Objetivo é o que o link faz (Checkout, Página, Vídeo, Arquivo, WhatsApp, Inscrição). Posição é onde ele fica (Bio do canal, Descrição, Postagem, Comentário fixado, QR Code). São essas as fatias dos rankings.
Projeto (opcional). Amarre a uma campanha pra comparar depois.
Vínculo (opcional). Cliente, canal e vídeo em cascata. Escolher o canal já preenche o cliente; ao escolher o canal aparece a lista de vídeos dele. Esse vínculo é o que faz o link aparecer nos rankings certos.
UTMs. Vêm preenchidas (utm_source, utm_medium acompanha a posição, utm_campaign acompanha o projeto) e são anexadas ao destino final. Edite se quiser; assim que você mexer num campo, ele para de se atualizar sozinho.
Criar link. Aparece a URL curta pronta pra copiar. Cole na posição escolhida e cada clique passa a contar.

Como criar links em lote

Use quando quiser "encher" vários vídeos com os links de uma mesma campanha de uma vez (ótimo pra vídeos antigos). Na aba Links, clique em Criar em lote.

Projeto (opcional) e canal (com cliente antes, se for business). Escolher o canal carrega os vídeos dele.
Selecione os vídeos. Marque um a um ou use "Selecionar todos". Há filtro por título e a opção "só publicados" (ligada por padrão).
Destino, objetivo e nome (o destino vale pra todos os links do lote).
Posições. Escolha uma ou mais (padrão: Descrição e Comentário fixado). Gera um link por vídeo e por posição: 5 vídeos x 2 posições = até 10 links.
Criar. O botão mostra quantos links vai criar. Pares vídeo+posição que já existem são pulados, então pode rodar de novo sem duplicar. No fim aparece quantos foram criados e quantos foram pulados.

💡

Dica: depois do lote, volte à aba Links pra copiar cada URL e colar na descrição e no comentário do vídeo correspondente. Cada link é único por vídeo, é isso que separa os cliques certo nos rankings.

Ações em cada link

Na lista da aba Links, cada card mostra o nome, os selos de posição/objetivo/projeto, o vínculo (vídeo, canal, cliente), a URL curta e os números (cliques, conversões, receita). Você pode:

Copiar a URL curta.
QR: baixar o QR Code (PNG) que aponta pro link, útil pra material impresso ou tela.
Pausar / reativar pelo interruptor. Link pausado para de redirecionar (mostra "Pausado" e fica esmaecido). Os números históricos continuam lá.

Projetos (campanhas)

Na aba Projetos você cria agrupamentos por campanha. Cada projeto tem nome, objetivo (opcional), cor e, em business/agency, um cliente. O card mostra quantos links estão dentro.

Excluir um projeto não apaga os links dele: eles só ficam sem projeto. A confirmação avisa isso.

Configurações: pixel x postback

Aqui ficam os dois tokens do workspace e as instruções de instalação. A diferença entre os dois métodos é a confiança do dado:

	Pixel (token `ylp_`, público)	Postback (token `ylk_`, secreto)
Como funciona	Um `<script>` no seu site dispara eventos do navegador	Seu checkout/plataforma chama a API quando a venda confirma
Vai onde	No HTML da página (pode ficar visível)	Servidor a servidor, nunca em página pública
Confiabilidade	Estimativa (pode perder se fecharam a página)	Verificada, conta na "Receita verificada"
Recomendado pra	Leads e sinal rápido	Receita de venda

⚠️

Postback é o recomendado pra receita. O pixel entra como receita estimada; só o postback vira receita verificada, porque registra a venda mesmo que o comprador tenha fechado a página. Guarde o ylid (vem na URL de destino do clique) no seu checkout pra mandar de volta no postback.

O token público vai no snippet do pixel (colado antes do </body> das páginas de destino). Depois dele, você dispara os eventos onde fizer sentido, por exemplo yf('lead') e yf('venda', { valor: 297.00, dedup: 'pedido-123' }). O campo dedup evita contar a mesma venda duas vezes (use o número do pedido).

O token secreto autentica o postback (uma chamada POST pra /api/rastreio/conversions com Authorization: Bearer). Os snippets prontos ficam na própria aba, é só copiar.

Você pode rotacionar os tokens (gerar novos) a qualquer momento. Ao rotacionar, os antigos param na hora: o pixel instalado nos sites e os postbacks configurados precisam ser atualizados com os novos.

Rastreio dentro do vídeo

Não precisa vir até este módulo pra criar link de um vídeo específico. No detalhe do vídeo há uma aba Rastreio com tudo focado nele:

Mini-KPIs do vídeo: cliques, conversões, receita e (se houver views importadas do CSV) CTR sobre views, consolidando todos os links daquele vídeo.
Criação rápida: destino, objetivo, posição, nome e um seletor de projeto. Cria o link já vinculado ao vídeo, sem escolher canal ou cliente (o vídeo já sabe de quem é).
Lista dos links do vídeo: copiar URL, baixar QR e pausar/reativar, igual à aba Links.

Um mesmo vídeo pode ter vários links (descrição, comentário fixado, QR), cada um medido separado.

Dicas e atalhos

💡

Uma posição por link. Não reaproveite a mesma URL curta na descrição e no comentário: crie um link pra cada posição. É assim que o ranking de Posições te diz onde a audiência realmente clica.

As views dos rankings vêm do CSV do YouTube Studio importado em Dados do Canal. Sem import, CTR e R$ por mil views ficam sem base.
Amarrar o link a um cliente faz o Rastreio conversar com Clientes e com os Relatórios: dá pra mostrar a receita atribuída àquele cliente.
Rode o Criar em lote de novo sempre que criar vídeos novos na campanha: os que já têm link são pulados, só os novos ganham.

Limitações conhecidas

Rastreio existe só no plano Agency.
Conversões e receita dependem de instalação no seu site (pixel ou postback). Sem isso, você mede cliques, mas não leads nem vendas.
Receita verificada só conta vendas por postback. Vendas capturadas por pixel aparecem à parte, como estimativa.
No lote, o filtro carrega até os vídeos mais recentes do canal e, por padrão, só os publicados (desmarque "só publicados" pra ver os demais).