Links de campanha e sub-IDs

A pergunta desconfortável em qualquer compra de tráfego não é “quantos cliques conseguimos” - é “quais desses cliques eram pessoas, e quem mandou o resto”. Um total único não consegue responder: a newsletter, os parceiros e o panfleto desembocam no mesmo número, e a pior origem se esconde atrás da melhor.

A Kilo responde com três peças que trabalham juntas. Uma campanha agrupa os links e carrega os controles compartilhados - uma janela de tempo, uma meta de escaneamentos, um único lugar para encerrar tudo. Os sub-IDs marcam cada posicionamento para que ele reporte separado. E a classificação de qualidade de cliques rotula cada clique conforme acontece - data center, VPN ou proxy, provável humano - para que a divisão de cada origem se sustente sozinha.

No painel, abra Campanhas e escolha Nova campanha. Três decisões fazem quase todo o trabalho:

• A janela. Um início e um fim opcionais. Fora dela, os links param de encaminhar para os seus destinos normais e tomam o final que você escolheu.
• A meta de escaneamentos. Defina um número e escolha o que ele significa: acompanhar como meta só mostra o progresso - os links continuam funcionando depois dela - enquanto parar na meta fecha a campanha automaticamente quando as aberturas humanas alcançam o número, conferido a cada poucos minutos.
• O final. Quando a campanha acaba, os links podem retomar os próprios destinos, enviar os visitantes para uma URL de fim de campanha - ou para uma página de marca de “encerrada”, se você não definiu uma - ou devolver um 410 permanente.

Dois detalhes são deliberados. O teto conta só aberturas humanas - o mesmo número que a manchete da análise mostra - então tráfego de bots nunca pode fechar a sua campanha antes da hora. E uma URL de fim de campanha definida na campanha vence o fallback próprio de cada link, de modo que um único campo reaponta o final inteiro. Você também pode fechar ou reabrir uma campanha à mão a qualquer momento. A meta de escaneamentos como simples meta é grátis em todos os planos; a aplicação do teto, a URL de fim de campanha e o fechamento manual fazem parte dos controles de campanha pagos.

Os sub-IDs não precisam de configuração nenhuma. Pegue o link da campanha e dê a cada posicionamento a sua própria variante marcada - o mesmo link com um parâmetro de consulta a mais:

https://qr2r.com/aA3k9?sub_id=newsletter
https://qr2r.com/aA3k9?sub_id=partner-42
https://qr2r.com/aA3k9?s1=flyer-april

A Kilo captura a marca no momento do redirecionamento, e a análise ganha uma linha por valor. Os nomes de parâmetro são os que as plataformas de anúncios já emitem - subid, sub_id, s1 a s5, aff_sub a aff_sub5 - então o tráfego que chega de uma rede de afiliados costuma vir marcado antes de você fazer qualquer coisa. Uma marca é mantida por clique, os valores são limitados a 80 caracteres, e os cliques sem marca continuam contando em todo o resto - só não ganham uma linha de origem.

A mesma montagem são duas chamadas com uma chave de escrita. Crie a campanha - os carimbos de tempo são milissegundos epoch:

curl https://qr2r.com/api/groups \
  -H "Authorization: Bearer $KILO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Spring launch",
    "ends_at": 1735689600000,
    "target_scans": 10000,
    "enforce_target_scans": true,
    "campaign_fallback_url": "https://example.com/spring-recap"
  }'

Depois gere o link de cada posicionamento dentro dela. Em um plano com filtragem de tráfego, você também pode ativar o bloqueio do link já na criação:

curl https://qr2r.com/api/links \
  -H "Authorization: Bearer $KILO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "default_target": "https://example.com/spring",
    "name": "Spring - newsletter",
    "group_id": 51,
    "traffic_filter_enabled": true
  }'

Os portões batem exatamente com os do painel: enforce_target_scans e campaign_fallback_url precisam dos controles de campanha pagos, e traffic_filter_enabled precisa de um plano que carregue a filtragem de tráfego - uma requisição acima do seu plano é recusada com 402 plan_required, nunca rebaixada em silêncio. Definir target_scans sozinho, como meta, é grátis em todos os planos.

Conforme o tráfego chega, abra a análise do link - ou da campanha inteira. O painel de Qualidade de cliques mostra a divisão data center / VPN-ou-proxy / provável-humano, e abaixo dele a tabela de origens de tráfego por sub-ID dá a cada posicionamento a sua própria linha: cliques e qualidade, lado a lado. Um relance diz que a newsletter é quase toda de pessoas enquanto partner-42 é dois terços data center.

Depois, aja. Pause o posicionamento ruim, leve a linha dele para a conversa da fatura, mova o gasto para as origens que enviam humanos. Se uma origem insiste em mandar máquinas, você pode ativar Filtrar tráfego de bots e data centers naquele link - desligado por padrão, opcional por link, nos planos que o carregam. Com ele ligado, redes de data center conhecidas e bots declarados recebem uma página de “verifique que você é humano” em vez do seu destino, e as visitas bloqueadas continuam sendo contadas, para você ver exatamente o que foi barrado.

Esse é o ciclo: agrupe os links, marque os posicionamentos, leia a divisão de cada origem e deixe a campanha se encerrar sozinha na meta. Cada número sai da mesma análise agregada do resto da Kilo - construída sem nunca armazenar um IP bruto.