Documentação

Configuração do fluxo

Etapa 1. Destinos

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

Nesta página

Modo do fluxo

Bloco «Modo do fluxo»: seletor Cloaking / Tracker / Cloaking + Tracker e o caminho da visita
Abaixo do seletor aparece o caminho da visita no modo escolhido.
Padrão
«Cloaking»
Recomendamos
«Cloaking» para anúncios com moderação; «Cloaking + Tracker» se você precisa acompanhar o dinheiro
Plano
todos os planos
Erro comum
escolher «Tracker» e conectar o site pela tag JS — na janela de conexão, um fluxo assim só tem o arquivo PHP; no log, as visitas aparecem como «Rastreado, sem filtragem» (TRACKING_ONLY)
ModoO que aconteceQuando escolher
CloakingpadrãoO filtro distribui os visitantes: bots e moderadores vão para a White Page, pessoas vão para a oferta.Anúncios em que a moderação não pode ver a oferta.
TrackerTodo mundo vai para a oferta. São contados cliques, conversões, gasto e lucro; os bots só são marcados nos relatórios.Tráfego que não precisa de filtragem, mas precisa de controle financeiro. Na janela de conexão, um fluxo no modo «Tracker» só tem o arquivo PHP: tag, Keitaro, Binom e construtores não aparecem para ele.
Cloaking + TrackerO filtro barra quem não deve passar, e sobre os visitantes que passaram o dinheiro é contabilizado: fontes, custo do clique, ramos, pré-landings.Quando você precisa de proteção e de controle completo.
  • No modo «Tracker», os moderadores da plataforma também veem a oferta. O bloco White Page passa a se chamar «Página de reserva»: os visitantes só caem nela se o fluxo estiver pausado, o plano não estiver pago, o endereço estiver na sua lista negra de IP, o modo «Em moderação» estiver ativo ou o escudo estiver ativado.
  • Ramos, pré-landings, fixação do visitante, rede de afiliados, preços e parâmetros só existem nos modos com tracker.
Bloco «Onde hospedar o site»: Na minha hospedagem ou No nosso servidor
Acima da fonte fica a escolha de onde mora o site do fluxo: com você ou no nosso servidor (seção «Sites»).

A opção «No nosso servidor» fica disponível com plano pago; no período de teste ela fica indisponível.

Fonte de tráfego

Bloco «Fonte de tráfego»: Meta Ads selecionado, contadores de parâmetros e custo do clique, link «Abrir fonte»
 1 escolha da fonte, 2 o que ela trouxe para o fluxo: parâmetros e custo do clique, 3 abrir a fonte para editar.
  • Lista suspensa: «Sem fonte» (padrão) e as suas fontes. O último item, Adicionar fonte, abre a criação de uma fonte ali mesmo — a fonte nova já fica selecionada.
  • Escolher a fonte:
    • distribui os parâmetros e SubIDs dela nos marcadores da campanha, com os quais o link do anúncio é montado;
    • ajusta a proteção da etapa 2 para a plataforma da fonte (Facebook, Google, TikTok, native ou outra);
    • passa ao fluxo o custo do clique, se o fluxo não tiver um modelo de custo próprio.
  • Se você já mudou a proteção à mão, o painel primeiro pergunta se deve substituí-la (veja Rigor das verificações).

Nome e projeto

Bloco «Nome do fluxo»: campo com o nome e as sugestões prontas depois de «Sugerir:»
 1 nome, 2 sugestões prontas a partir da fonte, dos países, do domínio e do modo — um clique preenche a sugestão.
  • Para quê: é pelo nome que o fluxo é encontrado na lista, no log e nos relatórios. Um esquema prático: «plataforma · oferta · países».
  • Erro: campo vazio — «O nome do fluxo é obrigatório.», e o fluxo não é salvo.
  • Nome do fluxo — obrigatório, até 190 caracteres. Exemplo no campo: «FB — Nutra — Main Flow». Só você e a equipe veem.
  • Projeto — aparece se você tem projetos. Projetos agrupam fluxos por cliente, oferta ou equipe e separam os acessos. Um membro da equipe com acesso só a projetos precisa escolher um projeto.

Preset de filtro

Bloco «Preset de filtro»: Sem preset e três presets salvos com seus países e regras
 1 «Sem preset» — a filtragem é configurada na etapa 2, 2 preset salvo: abaixo do nome, países, dispositivos e número de regras.

Aparece se você tem presets salvos. Escolha um preset — 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 cloaking e nove verificações), 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 uma.

O preset é aplicado uma vez só: o fluxo recebe a própria cópia das regras, e editar o preset não afeta mais o fluxo. Para puxar a versão nova do preset, escolha-o de novo. O preset não leva o modo sombra, e recursos que não estão no plano são desligados na hora.

Páginas de oferta

Cartão da oferta: nome, modo «Carregamento», URL
O cartão da oferta abre com um clique no título.
Padrão
uma oferta «Oferta (principal)», modo «Carregamento»
Recomendamos
«Carregamento» — a barra de endereço continua mostrando o seu endereço
Plano
ofertas: Starter — 2, Professional e teste — 5, Business — sem limite
Erro comum
oferta desativada ou sem endereço — as visitas recebem «O fluxo não tem oferta para onde enviar» (NO_OFFER_DEST); o site da oferta não respondeu — «A oferta não carregou» (OFFER_UNDELIVERED)

O bloco fica sempre aberto. À esquerda está escrito «Ofertas: X de Y.»; quando o limite acaba, o botão Adicionar oferta fica desativado, e ao lado aparece o plano com mais ofertas.

CampoO que éPadrão
AtivadoUma oferta desativada não recebe tráfego, mas continua no fluxo.ativado
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 — o visitante é redirecionado, e a barra de endereço mostra o endereço da oferta. Iframe — a página é embutida na sua.Carregamento
URLEndereço da oferta com http:// ou https://, até 2000 caracteres. Dá para usar macros, por exemplo {click_id}.—
  • Uma oferta nova recebe o modo «Carregamento» e os parâmetros do link da primeira oferta. As regras do bloco «Parâmetros do link da oferta» começam vazias e são definidas separadamente.
  • Dá para excluir qualquer oferta, menos a primeira. Ela é removida de vez ao salvar.
  • As partes das ofertas, o modo de distribuição e a fixação não ficam no cartão, e sim no painel Como as visitas são divididas abaixo das ofertas (se houver ramos, Como as visitas restantes são divididas). O painel aparece quando há duas ofertas ou mais. Para uma oferta não receber tráfego por um tempo, desative-a em vez de colocar a parte 0.
  • 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 exibição em frame, aparece uma explicação abaixo do endereço: o nosso servidor mostra a página assim mesmo, mas os links dentro dela abrem na aba inteira. Isso não impede salvar.
  • Para abrir um app no Google Play, coloque na URL da oferta o deep link market://details?id=pacote e o modo «Redirect». Não dá para carregar a loja de apps nem mostrá-la em frame, e na pré-landing e na White Page esse tipo de link não é aceito.

Parâmetros do link da oferta

Bloco «Parâmetros do link da oferta» com os botões para renomear, definir e remover parâmetro
 1 «Renomear» fbclid → sub1, 2 «Definir» aff_id = {click_id}, 3 «Remover» utm_source, 4 botões de adicionar.
Padrão
sem regras — os parâmetros vão para a oferta como chegaram
Recomendamos
colocar o número do clique no parâmetro da rede de afiliados: «Definir» sub1 = {click_id}
Plano
todos os planos, até 20 regras por oferta
Erro comum
renomear um parâmetro que não existe na visita — a regra não faz nada; o postback não encontra o clique e não há conversões

A plataforma de anúncios (Facebook, Google, TikTok) acrescenta ao link os próprios parâmetros: fbclid, gclid, ttclid, utm_source e outros. A rede de afiliados espera os nomes dela: sub1, aff_id, s1, click_id. Esses nomes quase nunca batem.

As regras reescrevem os parâmetros no caminho para a oferta: renomeiam, definem e removem parâmetros. Três tarefas que não se resolvem sem elas:

  • Receber a conversão de volta. A rede de afiliados manda o postback com o identificador que você passou para ela. Se você colocar o nosso {click_id} no sub1 dela, o postback encontra o clique certo. O nosso número não existe nos parâmetros da plataforma — só a macro fornece.
  • Entregar à rede os nomes dela. A plataforma mandou fbclid, e a rede lê sub1 — renomeie, e o valor chega com o nome certo.
  • Não expor o que não precisa. O parâmetro da plataforma (utm_source=facebook), que denuncia a fonte, pode ser removido para não ir até a rede de afiliados.

As regras só valem no caminho para a oferta e para a pré-landing. No log de cliques e na White Page os parâmetros ficam como chegaram — isso é importante: um fbclid renomeado na White Page entregaria o cloaking.

Cada oferta e cada pré-landing tem o próprio conjunto de regras: ofertas diferentes vão para redes de afiliados diferentes, com nomes de parâmetros diferentes. A White Page não tem regras.

Ações

AçãoO que fazExemplo
RenomearO parâmetro segue com outro nome e o mesmo valor.fbclid → sub1
DefinirO parâmetro recebe um valor. Pode ser macro ou texto. Mesmo que o parâmetro não existisse, ele passa a existir.aff_id = {click_id}
RemoverO parâmetro não vai para a oferta. No lugar do campo de valor, a linha diz «não chegará à oferta».utm_source

As regras são aplicadas de cima para baixo, cada uma sobre o resultado da anterior. Por isso a ordem importa: primeiro renomeie fbclid para sub1, e só depois uma regra sobre sub1 enxerga esse valor.

O bloco fica recolhido no cartão da oferta e da pré-landing, com o número de regras no título. Cada regra é uma linha «parâmetro da visita → o que fazer → resultado», e as linhas são numeradas — por elas se vê a ordem. A ação é escolhida no seletor Renomear / Definir / Remover. Uma regra nova é adicionada pelos botões da linha «Adicionar:» — Renomear parâmetro, Definir parâmetro, Remover parâmetro. Cabem até 20 regras. «Renomear» não faz nada se o parâmetro não estiver na visita. O valor é escrito sem espaços e sem o sinal &.

Exemplo completo

O visitante chegou 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. Regras do fluxo:

  • Renomear fbclid → sub1
  • Definir aff_id = {click_id}
  • Remover utm_source

Para a oferta vai o endereço:

https://track.partner.com/click?offer=55&utm_campaign=nutra_de&sub1=IwAR123&aff_id=C-01JB8Q3Z7XKP4M2R9TVN6WDY5H

Antes: fbclid e utm_source. Depois: fbclid foi para sub1, surgiu aff_id com o número do clique, utm_source foi removido. As regras não mexeram em utm_campaign — ele chegou como estava. No log, esse clique continua com fbclid e utm_source registrados.

Macros para «Definir»

No valor dá para inserir dados da visita: {click_id} — o nosso número do clique, {flow_id} — número 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} — parâmetros do fluxo.

Na conexão por link e pelo arquivo PHP as regras funcionam igual. Para o arquivo PHP é preciso a versão mais recente: se saiu uma nova, aparece um aviso na janela de conexão.

Ramos a partir do Professional

Bloco de ofertas com dois ramos «Mobile → quiz prelander» e «Desktop → direct offer» e os botões de adicionar oferta e ramo
 1 adicionar oferta, 2 adicionar ramo. Os ramos são verificados de cima para baixo.
Padrão
sem ramos — todos vão para as ofertas sem ramo
Recomendamos
dividir por dispositivo ou país quando as ofertas são diferentes
Plano
a partir do Professional, modos com tracker; até 30 ramos, até 15 condições
Erro comum
ramo sem ofertas — os visitantes dele vão para as ofertas sem ramo, não para a White Page

Visitantes diferentes para ofertas diferentes: por país, dispositivo, parâmetro do link ou parâmetro da campanha. O bloco aparece nos modos com tracker quando há duas ofertas ou mais.

  • Adicionar ramo cria o «Ramo N» com a condição «País é um de».
  • O ramo tem: nome (até 120 caracteres), a chave Ativada, as setas Subir e Descer e a exclusão. As ofertas de um ramo excluído passam a ser ofertas sem ramo.
  • A condição se lê como «Se [campo] [operador] [valores]». Várias condições num mesmo ramo precisam ser todas atendidas.
    • Campos: País, Dispositivo, SO, Navegador, Provedor, ASN, Cidade, Região, Idioma, Referrer, Parâmetro do link, Marcador (sub). Para o parâmetro do link e o marcador, informe o nome, por exemplo utm_source ou sub1.
    • Operadores: «é um de», «não é nenhum de», «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 se encaixar. Visitantes que não se encaixam em nenhum vão para as ofertas sem ramo. Se todas as ofertas estiverem distribuídas em ramos, esses visitantes vão para qualquer oferta do fluxo — no formulário isso aparece na linha «Visitas restantes → não há ofertas livres — vão para qualquer oferta do fluxo».
  • As ofertas são atribuídas no próprio ramo: no bloco Para onde enviar, marque as que quiser. Uma oferta só pode estar em um ramo — uma oferta de outro ramo aparece em cinza, com o nome desse ramo. Se o ramo não tiver ofertas, os visitantes dele vão para as ofertas sem ramo. As pré-landings escolhem o ramo no próprio cartão.
  • Limites: até 30 ramos, até 15 condições por ramo.

Pré-landings

Cartão da pré-landing: chave, nome, modo, «Leva à oferta», ramo, URL, peso
 1 se está ativada, 2 nome e modo, 3 para qual oferta o botão leva, 4 ramo, 5 endereço da pré-landing, 6 peso entre as pré-landings.

A sua página antes da oferta: quiz, artigo, review. O visitante que passou pelo filtro vê essa página primeiro, e o botão nela leva à oferta. O relatório mostra quantos chegaram à oferta.

  • O bloco existe nos modos com tracker, em todos os planos e no período de teste. O cartão é igual ao da oferta; o modo padrão é «Redirect».
  • As pré-landings não entram no limite de ofertas, mas cada oferta pode ter no máximo uma. Quando há tantas pré-landings quanto ofertas, o botão + Pré-landing fica desativado, e ao lado aparece «Uma pré-landing por oferta.»
  • Leva à oferta — «Por peso entre as ofertas» ou uma oferta específica. Uma oferta para a qual outra pré-landing já leva não aparece na lista.
  • 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.
  • Na conexão pelo arquivo PHP, coloque ao lado do nosso index.php um arquivo .htaccess com a regra para o caminho start — sem ele, ao recarregar a página da oferta aparece o erro 404. O caminho start fica na pasta do link do anúncio, e no formulário do fluxo não dá para mudá-lo. Detalhes em Arquivo PHP.
  • Na conexão pela tag JS não é preciso nem arquivo nem regra: o botão leva de volta à sua página de anúncio, a oferta abre nela, e os nossos parâmetros de serviço saem da barra de endereço. Ao recarregar a página, a oferta continua lá se o visitante esteve ativo nos últimos 5 minutos.
  • Mantenha a pré-landing no domínio da oferta, numa pasta própria, por exemplo seu-site.com/pasta/lead/. Na conexão pelo arquivo PHP no modo «Carregamento», a pré-landing abre pelo link do anúncio sem a tag <base>: o próprio arquivo reescreve os endereços de imagens, estilos e links com caminhos a partir da raiz, e nenhum outro domínio aparece no código. Uma pré-landing em outro domínio também abre, mas com ressalvas. Esse domínio fica visível nos endereços de imagens e estilos. As fontes dele só carregam se ele permitir o uso por outros sites (cabeçalho Access-Control-Allow-Origin). E os endereços que a página monta por script (por exemplo fetch('send.php')) passam a ser relativos ao link do anúncio, não à pré-landing.
  • Com duas pré-landings ou mais, aparece o «Peso» delas.

Exemplo. A oferta é best-shop.com/promo/offer.php, o link do anúncio é best-shop.com/promo/?utm_source=fb. O visitante abre o link e vê a pré-landing, sem mudança na barra de endereço. Veja no que o arquivo transforma os endereços no código da pré-landing:

No código da pré-landingPré-landing best-shop.com/promo/lead/Pré-landing quiz-pages.net/keto/
assets/style.css/promo/lead/assets/style.csshttps://quiz-pages.net/keto/assets/style.css
img/photo.webp/promo/lead/img/photo.webphttps://quiz-pages.net/keto/img/photo.webp
../privacy.html/promo/privacy.htmlhttps://quiz-pages.net/privacy.html
#formfica na páginafica na página
{click_url}/promo/start?utm_source=fb com a regra no .htaccess; sem ela, o nosso endereço de redirecionamento/promo/start?utm_source=fb com a regra no .htaccess; sem ela, o nosso endereço de redirecionamento

Depois do botão, o visitante vê a oferta no endereço best-shop.com/promo/start?utm_source=fb nos dois casos. Mas no segundo, quiz-pages.net aparece nos endereços de imagens e estilos, e o fetch('send.php') do script da pré-landing vai para best-shop.com/promo/send.php, onde esse arquivo não existe.

White Page

Bloco White Page: nome, modo, URL e a lista «Ou deixe a gente mostrar a nossa, sem endereço»
 1 com endereço próprio ou 2 com uma página pronta nossa.
Padrão
nenhuma — o campo é obrigatório
Recomendamos
uma página sua no modo «Carregamento» ou uma pronta nossa do catálogo
Plano
todos os planos; catálogo de designs em todos, os premium a partir do Professional
Erro comum
White Page em «Redirect» — o moderador vê o salto para outro domínio; sem página o fluxo não é salvo: «Adicione pelo menos um destino white ativo»

A página para quem o filtro não deixou ir para a oferta. É obrigatória. Dá para defini-la de três jeitos:

  • Com endereço próprio — o campo URL e o modo «Carregamento» ou «Redirect». O modo «Iframe» não é usado para a White Page. Abaixo do campo ficam botões com os endereços das suas últimas White Pages e o link Pedir uma White Page do catálogo.
  • Com uma página pronta nossa — a lista Ou deixe a gente mostrar a nossa, sem endereço. O site pronto abre no seu endereço de anúncio, sem precisar subir nada em lugar nenhum. A lista mostra as suas últimas 100 páginas prontas e sempre a que já está no fluxo. Na 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 barrado recebe só o código de resposta, sem página: 200 — página em branco, 403 ou 404 — página de erro do servidor em branco, como num endereço fechado ou inexistente. O programa de verificação não tem o que ler. Funciona na conexão pelo arquivo PHP e por link; a tag JS não consegue mudar o código de resposta e deixa uma página em branco no lugar da landing. Plataformas com moderação manual (Google, Facebook) costumam reprovar esse tipo de anúncio — o modo é para fontes em que quem olha a página é um programa, não uma pessoa.

Distribuição do tráfego

Bloco «Como as visitas restantes são divididas»: Rotação por peso ou Prioridade, «dividir igualmente», fixação do visitante
Distribuição entre as ofertas.
Padrão
rotação por peso, em partes iguais; fixação de 0 h
Recomendamos
pesos para teste A/B; fixação de 24 h se importa mostrar uma única oferta por pessoa
Plano
pesos — todos os planos; «Prioridade» — a partir do Professional
Erro comum
pesos que não somam 100% — «Os pesos devem somar 100»; clique em «dividir igualmente»

O bloco aparece quando há duas ofertas (ou pré-landings) ou mais.

  • Rotação por peso — a oferta de cada clique é escolhida aleatoriamente, conforme o peso; com bastante tráfego, as partes se aproximam das definidas. A soma dos pesos é exatamente 100%. O botão dividir igualmente divide em partes iguais dentro de cada conjunto: ofertas sem ramo, ofertas de cada ramo, pré-landings. Se houver uma oferta e várias pré-landings, o mesmo botão se chama Pesos automáticos.
  • 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). Se o visitante voltar dentro desse prazo, ele vê 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 precisa começar com http:// ou https://.
  • «Adicione pelo menos um destino white ativo — com um endereço ou com uma das nossas páginas prontas.»
  • «Os pesos devem somar 100» — clique em dividir igualmente.

ArtisanClo · Documentação do painel. Dúvidas: info@artisanclo.com ou @artisanclo_support no Telegram.