Documentação

Configuração do fluxo

Etapa 1. Destinos

Para onde vai o tráfego: ofertas e White Page.

Modo do fluxo

ModoO que aconteceQuando escolher
CloakingpadrãoO 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.
TrackerTodos 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 + TrackerO 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.

CampoO que éPadrão
AtivoUma oferta desligada não recebe tráfego, mas continua no fluxo.ligado
NomeNome da oferta nos relatórios, até 190 caracteres.“Oferta (principal)”; nas seguintes, “Oferta”
ModoCarregamento — 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
URLEndereço da oferta com http:// ou https://, até 2000 caracteres. Macros como {click_id} são permitidas.—
PesoParcela 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…
RamoA 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=pacote e 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} no sub1 dela 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çãoO que fazExemplo
RenomearO parâmetro sai com outro nome, mesmo valor.fbclid → sub1
DefinirO parâmetro recebe um valor. Um macro ou texto. Pode não ter existido — vai aparecer.aff_id = {click_id}
RemoverO 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_source ou sub1.
    • Operadores: “é um destes”, “não é nenhum destes”, “contém”, “está definido”, “não está definido”.
    • Valores — separados por vírgula.
  • 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, /3 ao 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.