Seções da documentação
Configuração do fluxo
Etapa 1. Destinos
Para onde vai o tráfego: ofertas e White Page.
Modo do fluxo
| Modo | O que acontece | Quando escolher |
|---|---|---|
| Cloakingpadrão | O filtro separa: bots e moderadores vão para a White Page, pessoas vão para a oferta. | Anúncios em que a moderação não deve ver a oferta. |
| Tracker | Todos vão para a oferta. Cliques, conversões, custo e lucro são contados, e os bots só são marcados nos relatórios. | Tráfego que não precisa de filtragem, mas precisa de controle financeiro. Funciona com a conexão pelo arquivo PHP, pelo filtro do Keitaro ou pelo Binom. Pela tag JS e pelo link, esse fluxo filtra o tráfego como um cloaking comum. |
| Cloaking + Tracker | O filtro separa, e o dinheiro é contado sobre o tráfego aprovado: fontes, preço do clique, ramos, pré-landings. | Quando você precisa de proteção e de controle completo. |
- Abaixo da chave aparece o caminho da visita no modo escolhido.
- No modo “Tracker”, os moderadores da plataforma também veem a oferta. Ali o bloco White Page se chama “Página de reserva”: os visitantes só vão para ela se o fluxo estiver pausado, o plano não estiver pago, o endereço estiver na sua lista negra de IPs, o modo “Em revisão” estiver ligado ou o shield estiver ativo.
- Ramos, pré-landings, fixação do visitante, rede de afiliados, preços e marcadores só estão disponíveis nos modos com tracker.
Fonte de tráfego
- Lista suspensa: “Sem fonte” (padrão) e as suas fontes. O último item, Adicionar uma fonte, abre a criação da fonte ali mesmo — a fonte nova já fica selecionada.
- Escolher a fonte:
- distribui os parâmetros e SubIDs dela pelos marcadores de campanha, a partir dos quais o link do anúncio é montado;
- ajusta a proteção da etapa 2 para a plataforma da fonte (Facebook, Google, TikTok, anúncios nativos ou outra);
- passa ao fluxo o preço do clique enquanto o fluxo não tem um modelo próprio.
- Se você já alterou a proteção à mão, o painel primeiro pergunta se deve substituí-la (veja Rigor das verificações).
Nome e projeto
- Nome do fluxo — obrigatório, até 190 caracteres. Exemplo no campo: “ex.: Fluxo principal”. Só você e a sua equipe veem o nome.
- Projeto — aparece se você tem projetos. Os projetos agrupam fluxos por cliente, oferta ou equipe e separam o acesso. Um membro da equipe com acesso só a projetos precisa escolher um projeto.
Preset de filtragem
Aparece se você tem presets salvos. Escolha um preset e ele preenche o formulário:
- todas as listas de público com seus modos: países, dispositivos, SO, navegadores, idiomas, fusos, cidades, regiões, redes, provedores, sites de origem;
- a agenda;
- as dez chaves de proteção, o limite de cliques por IP, o aquecimento, o tempo mínimo na página;
- a plataforma e o rigor; a fonte do preset, se o fluxo ainda não tiver a sua.
A aplicação é única: o fluxo passa a viver com a sua própria cópia das regras, e editar o preset não o altera mais. Para trazer a versão nova do preset, escolha-o de novo. O preset não transfere o modo sombra, e os recursos que não fazem parte do plano são desligados na hora.
Páginas de oferta
O bloco fica sempre aberto. À esquerda está escrito “Ofertas: X de Y.”; quando o limite acaba, o botão Adicionar oferta fica apagado, e ao lado aparece o plano que permite mais ofertas.
| Campo | O que é | Padrão |
|---|---|---|
| Ativo | Uma oferta desligada não recebe tráfego, mas continua no fluxo. | ligado |
| Nome | Nome da oferta nos relatórios, até 190 caracteres. | “Oferta (principal)”; nas seguintes, “Oferta” |
| Modo | Carregamento — a página da oferta abre sob o seu endereço de anúncio. Redirect (302) — o visitante é redirecionado, e a barra de endereços mostra o endereço da oferta. Iframe — a página é incorporada à sua. | Carregamento |
| URL | Endereço da oferta com http:// ou https://, até 2000 caracteres. Macros como {click_id} são permitidas. | — |
| Peso | Parcela do tráfego da oferta, de 1 a 100. Aparece quando há duas ofertas ou mais. Para que uma oferta fique temporariamente sem tráfego, desligue-a em vez de colocar peso 0. | partes iguais: 50/50, 34/33/33… |
| Ramo | A qual ramo a oferta pertence (modos com tracker). | Ramo padrão |
- Uma oferta nova recebe o modo “Carregamento” e as etiquetas de link da primeira oferta. As regras do bloco “Parâmetros do link da oferta” dela começam vazias e são definidas à parte.
- Qualquer oferta pode ser removida, exceto a primeira. Ela é excluída de vez ao salvar.
- O link do anúncio não muda com o número de ofertas: a oferta é escolhida para cada visita depois de todas as verificações.
- Se o modo “Iframe” estiver escolhido e o site da oferta proibir a exibição em frame, aparece uma explicação abaixo do endereço: o nosso servidor mostra a página mesmo assim, mas os links dentro dela abrem na aba inteira. Isso não impede de salvar.
- Para abrir um app no Google Play, coloque na URL da oferta o deeplink
market://details?id=pacotee o modo “Redirecionamento”. Uma loja de apps não pode ser carregada nem exibida em iframe, e a pré-landing e a White Page não aceitam esse link.
Parâmetros do link da oferta
A plataforma de anúncios (Facebook, Google, TikTok) acrescenta ao link as próprias etiquetas: fbclid, gclid, ttclid, utm_source e outras. A rede de afiliados espera os próprios nomes: sub1, aff_id, s1, click_id. Quase nunca coincidem.
As regras reescrevem as etiquetas no caminho para a oferta: renomeiam, definem e removem parâmetros. Três tarefas que sem elas não se resolvem:
- Receber a conversão de volta. A rede envia o postback para o identificador que você passou. Coloque o nosso
{click_id}nosub1dela e o postback encontra o clique certo. As etiquetas da plataforma não carregam nenhum id nosso; só o macro carrega. - Dar à rede os nomes dela. A plataforma enviou
fbclid, a rede lêsub1— renomeie, e o valor chega com o nome certo. - Não vazar o que não deve. Uma etiqueta da plataforma (
utm_source=facebook) que revela a origem pode ser removida para não chegar à rede.
Só a oferta e o pré-lander veem as regras. No registro de cliques e na White Page as etiquetas ficam como chegaram, o que importa: um fbclid renomeado na White Page seria uma pista.
Cada oferta e cada pré-landing tem o seu próprio conjunto de regras: ofertas diferentes vão para redes de afiliados diferentes, e os nomes das etiquetas mudam de uma para outra. A White Page não tem regras.
Ações
| Ação | O que faz | Exemplo |
|---|---|---|
| Renomear | O parâmetro sai com outro nome, mesmo valor. | fbclid → sub1 |
| Definir | O parâmetro recebe um valor. Um macro ou texto. Pode não ter existido — vai aparecer. | aff_id = {click_id} |
| Remover | O parâmetro não vai para a oferta. No lugar do campo de valor, a linha mostra “A etiqueta não chegará à oferta”. | utm_source |
As regras são aplicadas de cima para baixo, cada uma ao resultado da anterior. A ordem importa: renomeie fbclid para sub1 primeiro, e só então uma regra sobre sub1 verá esse valor.
O bloco fica recolhido no cartão da oferta e da pré-landing, e o título mostra o número de regras. Cada regra é uma linha “etiqueta da visita → o que fazer → resultado”, e as linhas são numeradas porque a ordem importa. A ação é escolhida na chave Renomear / Definir / Remover. Os botões “Adicionar rápido: fbclid → sub_id · aff_sub = {click_id} · − utm_source” adicionam uma regra pronta com um clique. Cada conjunto aceita até 20 regras. “Renomear” não faz nada se a etiqueta não estiver na visita. O valor é escrito sem espaços e sem o sinal &.
Um exemplo completo
Um visitante chega pelo link de anúncio do fluxo:
https://sua-landing.com/?fbclid=IwAR123&utm_source=facebook&utm_campaign=nutra_de
A oferta do fluxo é https://track.partner.com/click?offer=55. As regras do fluxo:
- Renomear
fbclid→sub1 - Definir
aff_id={click_id} - Remover
utm_source
A oferta recebe:
https://track.partner.com/click?offer=55&utm_campaign=nutra_de&sub1=IwAR123&aff_id=C-01JB8Q3Z7XKP4M2R9TVN6WDY5H
Antes: fbclid e utm_source. Depois: fbclid passou para sub1, surgiu aff_id com o id do clique, utm_source foi removido. utm_campaign não foi tocado pelas regras e chegou como estava. No registro este clique ainda carrega fbclid e utm_source.
Macros para «Definir»
O valor pode levar dados da visita: {click_id} — nosso id de clique, {flow_id} — id do fluxo, {geo} — país, {city} — cidade, {device} — dispositivo, {os} — SO, {browser} — navegador, {isp} — provedor, {ext_click_id} — click id externo, {cost} — custo do clique, {sub1}…{sub10} — etiquetas do fluxo.
As regras funcionam igual no link do fluxo e no arquivo PHP. O arquivo PHP precisa da versão mais recente: se houver uma nova, aparece um aviso na janela de conexão.
Ramos a partir do Professional
Visitantes diferentes para ofertas diferentes: por país, dispositivo, parâmetro do link ou marcador de campanha. Aparecem nos modos com tracker quando há duas ofertas ou mais.
- Adicionar ramo cria o “Ramo N” com a condição “País é um destes”.
- Cada ramo tem: nome (até 120 caracteres), a chave Ativo, as setas Subir e Descer e a exclusão. As ofertas de um ramo excluído passam para o ramo padrão.
- A condição se lê como “Se [campo] [operador] [valores]”. Várias condições no mesmo ramo precisam ser atendidas todas ao mesmo tempo.
- Campos: País, Dispositivo, SO, Navegador, Provedor, ASN, Cidade, Região, Idioma, Referrer, Parâmetro do link, Marcador (sub). Para parâmetro do link e marcador, informe o nome, por exemplo
utm_sourceousub1. - Operadores: “é um destes”, “não é nenhum destes”, “contém”, “está definido”, “não está definido”.
- Valores — separados por vírgula.
- Campos: País, Dispositivo, SO, Navegador, Provedor, ASN, Cidade, Região, Idioma, Referrer, Parâmetro do link, Marcador (sub). Para parâmetro do link e marcador, informe o nome, por exemplo
- Os ramos são verificados de cima para baixo, e decide o primeiro que corresponder. Visitantes que não correspondem a nenhum vão para as ofertas sem ramo.
- Para vincular uma oferta a um ramo, escolha-o no campo Ramo do cartão da oferta. Se o ramo não tiver ofertas, os visitantes dele vão para as ofertas padrão.
- Limites: até 30 ramos e até 15 condições por ramo.
Pré-landings a partir do Professional
Sua página antes da oferta: quiz, artigo, review. O visitante aprovado pelo filtro vê primeiro a pré-landing, e o botão nela leva à oferta. O relatório mostra quantos chegaram à oferta.
- O cartão é igual ao da oferta; o modo padrão é “Redirect”. A pré-landing ocupa espaço no mesmo limite: com ela, o botão Adicionar oferta fica apagado uma oferta antes do que o contador mostra.
- Leva à oferta — “Por peso entre as ofertas” ou uma oferta específica.
- O botão da pré-landing deve apontar para a macro
{click_url}, por exemplo?go={click_url}. Se houver vários botões, acrescente/2,/3ao endereço — abrem a segunda e a terceira oferta. - Com duas pré-landings ou mais, elas ganham o campo “Peso”.
White Page
A página para quem o filtro não deixou chegar à oferta. É obrigatória. Há três formas de defini-la:
- Com o seu endereço — o campo URL e o modo “Carregamento” ou “Redirect”. O iframe não é usado para a White Page. Abaixo do campo ficam botões com os endereços das suas White Pages recentes e o link Pedir uma White Page do catálogo.
- Com uma página pronta nossa — a lista Ou mostre uma das nossas — sem precisar de endereço. O site pronto abre no seu endereço de anúncio, sem precisar enviá-lo para lugar nenhum. A lista traz as suas 100 páginas prontas mais recentes e sempre a que já está no fluxo. Com a conexão pelo arquivo PHP, é preciso a versão mais recente dele.
- Com um código de status — o modo “Código de status (200/403/404)”: o visitante filtrado recebe uma página de erro do servidor vazia, como um endereço fechado ou inexistente. Não há página nenhuma, então um programa de verificação não tem o que ler. Funciona com o arquivo PHP e o link; a tag JS não pode mudar o código e deixa uma página em branco no lugar da landing. Plataformas com moderação manual (Google, Facebook) costumam rejeitar esses anúncios — o modo é para fontes em que um programa, e não uma pessoa, olha a página.
Distribuição do tráfego
O bloco aparece quando há duas ofertas (ou pré-landings) ou mais.
- Rotação por peso — cada clique vai para uma oferta de forma aleatória com a probabilidade definida; em volumes grandes, as parcelas se aproximam das definidas. A soma dos pesos é exatamente 100%. O botão Pesos automáticos divide igualmente dentro de cada conjunto: ofertas sem ramo, ofertas de cada ramo, pré-landings.
- Prioridade a partir do Professional — todo o tráfego vai para a primeira oferta ativa, e as demais ficam de reserva.
- Fixação do visitante, h — de 0 a 720 (modos com tracker). O visitante que voltar dentro desse prazo recebe a mesma pré-landing e a mesma oferta. 0 — não fixar.
Erros possíveis
- “O nome do fluxo é obrigatório.”
- “Adicione pelo menos um destino de oferta ativo com URL.”
- “URL inválida nos destinos: …” — o endereço deve começar com http:// ou https://.
- “Adicione pelo menos um destino white ativo — com um endereço ou uma das nossas páginas prontas.”
- “Os pesos devem somar 100” — clique em Pesos automáticos.
ArtisanClo · Documentação do painel. Dúvidas: info@artisanclo.com ou @artisanclo_support no Telegram.