Seções da documentação
Tráfego
Conexão com o site
Para o fluxo começar a funcionar, ligue-o ao seu site. Um método basta. O anúncio aponta para o endereço do seu site, e as páginas continuam no seu servidor.
Nesta página
Qual método escolher
- Site em Tilda, Webflow, Unbounce, Shopify ou WordPress → construtor.
- O tráfego já passa pelo seu Keitaro ou Binom → filtro do Keitaro ou portão do Binom.
- Precisa do modo «Tracker» → só o arquivo PHP.
- O código do site não pode ser editado, mas o domínio está no Cloudflare → Cloudflare.
- Nos demais casos → tag JS, o primeiro método na janela de conexão.
| Método | O que precisa | Modo «Tracker» | Nosso código no fonte da página | Dificuldade |
|---|---|---|---|---|
| Tag JS | acesso ao <head> | não | visível | fácil |
| Arquivo PHP | hospedagem com PHP | sim | invisível: decisão no servidor | média |
| Keitaro / Binom | tracker próprio | não | invisível: decisão no servidor | média |
| Construtores, Cloudflare | conta no serviço | não | visível (é a mesma tag) | fácil |
Se o site do fluxo está hospedado conosco (Onde hospedar o site → No nosso servidor), não é preciso conectar nada: nós colocamos o arquivo do fluxo no servidor e o atualizamos. Detalhes em Sites.
Abra a janela de conexão
Encontre o fluxo
Seção Fluxos → na linha do fluxo, clique em ⋯ → Conectar.

Linha do fluxo: 1 — menu de ações do fluxo, 2 — janela de conexão. Abra um método
Os métodos ficam recolhidos, e só dá para abrir um de cada vez. O método que está funcionando aparece em verde, com a marca «Instalado».

Janela de conexão do fluxo: 1 tag JS, 2 arquivo PHP — aqui ele já está no site.
Um fluxo no modo «Tracker» só se conecta pelo arquivo PHP — tag, Keitaro, Binom e construtores não aparecem para ele.
Tag JS
Copie o código
Abra Adicione o script à sua landing page e clique no botão de copiar à direita do código 1.

Na conta de demonstração o código fica oculto; no seu painel, o campo 1 traz o código do seu fluxo. A linha 2 mostra onde colar: logo depois de <head>.Cole como primeira linha do <head>
Em cada página da landing — logo depois de
<head>, acima de todos os outros scripts 2. Salve e recarregue a página.index.html<head> <!-- código da janela de conexão --> <meta charset="utf-8"> … </head>Não instale o código pelo Google Tag Manager ou outros gerenciadores de tags e não acrescente
asyncnemdefer: com eles o script roda mais tarde, e a página chega a aparecer para todo mundo antes de existir uma decisão.Verifique a conexão
Clique em Verificar minha página: o painel abre a página principal da pasta onde está a oferta do fluxo e procura o código lá. Sem endereço de oferta, a verificação não roda.

O botão de verificação 1 é o último passo da tag JS e do arquivo PHP. 
1 botão de verificação, 2 resposta: o código foi encontrado na página. O bloco recebe a marca «Instalado».
A tag esconde a página até a decisão chegar. Se a decisão não chegar em 5 segundos, a tag leva o visitante para a White Page. E se a White Page não tiver endereço próprio (modo «Código de status» ou uma página pronta nossa), o visitante vê uma página em branco.
Arquivo PHP
Para sites em hospedagem com PHP. É o único método para o modo «Tracker». O modo sombra funciona com o arquivo PHP, o filtro do Keitaro e o portão do Binom.
Baixe o arquivo
Abra Envie o arquivo para o seu servidor e clique em Baixar arquivo 1.

Bloco do arquivo PHP: 1 botão de download e o esquema da pasta da landing 2. Coloque-o na raiz da landing com o nome index.php
E renomeie a sua landing, por exemplo para
offer.php:Pasta da landing/ ├── index.php ← nosso arquivo └── offer.php ← sua landing (era index.php ou index.html)Coloque o novo endereço da landing na oferta do fluxo
Por exemplo,
https://seu-site.com/offer.php.Coloque ao lado um arquivo .htaccess
Essas linhas são as mesmas para todos os fluxos; se já existe um
.htaccessna pasta, acrescente-as abaixo doRewriteEngine Onexistente..htaccessRewriteEngine On RewriteCond %{REQUEST_FILENAME} !-f RewriteCond %{REQUEST_FILENAME} !-d RewriteRule ^ index.php [L,QSA]Verifique a conexão
Botão Verificar minha página — o painel confere se o arquivo responde.
A regra manda para o nosso arquivo todas as requisições a endereços que não existem no site. Ela serve para duas coisas.
Pré-landing. Depois do botão da pré-landing, a oferta abre no endereço start na mesma pasta do link do anúncio: seu-site.com/start?parâmetros para a oferta seu-site.com/offer.php, seu-site.com/pasta/start?parâmetros para seu-site.com/pasta/offer.php. Sem a regra, se você recarregar essa página, dá erro 404. Com a regra, o botão {click_url} leva ao seu domínio — seu-site.com/start?parâmetros, e não ao nosso endereço de redirecionamento: o próprio arquivo nos repassa o clique, e o nosso domínio não aparece no código da pré-landing.
White Page de outro domínio. O arquivo entrega as páginas, imagens e estilos dela em endereços do seu domínio: o link de menu white-site.com/kontakt.html vira seu-site.com/kontakt.html, e o visitante não sai para o domínio da White Page. Sem a regra, os links continuam levando ao domínio da White Page.
No nginx sem Apache, adicione a regra abaixo (no lugar de /folder/, a sua pasta) e, mesmo assim, coloque ao lado do index.php um arquivo .htaccess com as mesmas linhas: o nginx não o lê, mas o nosso arquivo entende por ele que a regra está configurada. Se ficar só o try_files, a página recarrega normalmente, mas o botão da pré-landing e os links da White Page levam aos nossos endereços.
location /folder/ {
try_files $uri $uri/ /folder/index.php?$query_string;
}O arquivo no servidor não se atualiza sozinho. Quando sai uma versão nova, a janela mostra o aviso «Você está usando um arquivo antigo» e a lista do que a sua versão não sabe fazer. Baixe o arquivo de novo e substitua.
Como enviar o arquivo para a hospedagem
Coloque o arquivo PHP e o .htaccess na pasta do site para onde o anúncio leva. Se o anúncio leva a my-landing.com/promo/, é a pasta public_html/promo/; se leva à raiz my-landing.com/, é a própria public_html/.
Se a pasta já tem um index.php ou index.html, essa é a sua landing. Primeiro renomeie-a, por exemplo para offer.php, e coloque o novo endereço na oferta do fluxo; só depois envie o nosso index.php. Senão ele substitui a landing. Se existirem tanto index.html quanto index.php, muitas hospedagens abrem o index.html primeiro — e aí o nosso arquivo não funciona.
Pelo gerenciador de arquivos do painel da hospedagem
Abra o gerenciador de arquivos
No painel da hospedagem — a seção «Arquivos» ou «Gerenciador de arquivos» 1.
Vá até a pasta da landing
Normalmente
public_html(às vezeswwwouhtdocs), depois a pasta para onde o anúncio leva 2.Clique em «Enviar»
O botão 3 abre a janela de upload.

Exemplo de interface — na sua hospedagem os botões podem ter outros nomes. 1 gerenciador de arquivos, 2 pasta da landing, 3 upload. Escolha os arquivos
Arraste
index.phpe.htaccesspara a janela 4 e espere a marca de «enviado» 5. O nome tem que ser exatamenteindex.php: se você baixar de novo, às vezes o navegador acrescenta «(1)» ao nome.
Exemplo de interface. 4 área de upload, 5 arquivos enviados. Confira as permissões e abra o site
Permissões dos arquivos —
644, das pastas —755. Em alguns gerenciadores o.htaccessfica oculto — ative «mostrar arquivos ocultos». Abra o endereço da landing no navegador e clique em Verificar minha página no painel.
Por um cliente FTP ou SFTP
Conecte-se
Host, usuário e senha estão no painel da hospedagem, seção FTP/SSH 1. Porta: 21 para FTP, 22 para SFTP. Clique em «Conectar» 2.
Abra a pasta da landing no servidor
À direita fica o servidor: vá até
public_html/pasta3.Transfira os arquivos
À esquerda fica o seu computador: selecione
index.phpe.htaccess4 e arraste para a direita 5.
Exemplo de interface — no seu cliente os botões podem ter outros nomes. 1 dados de conexão, 2 conectar, 3 pasta no servidor, 4 arquivos no computador, 5 transferir.
| Erro | Como perceber | O que fazer |
|---|---|---|
| Arquivo em outra pasta | Verificação: «Sua página abriu, mas esta configuração não respondeu nela» | Coloque o arquivo na pasta que abre no endereço do anúncio |
| PHP antigo | A página mostra «PHP 7.2 or higher is required.» | Ative no painel da hospedagem o PHP 7.2 ou mais novo |
| Sem .htaccess ou ele está oculto | Depois do botão da pré-landing, a página start dá 404 | Envie o .htaccess ao lado do index.php |
| Proxy da hospedagem | Todas as visitas no log têm o mesmo IP | Passe o domínio pelo Cloudflare (nuvem laranja) ou peça à hospedagem para repassar o IP real do visitante (veja Se algo não funciona) |
| Cache da hospedagem ou CDN | Todo mundo vê a página, ou a decisão muda com atraso | Tire a landing do cache |
Filtro para Keitaro

Se o tráfego já passa pelo seu Keitaro, o ArtisanClo vira um filtro dentro do stream do Keitaro: o Keitaro nos pergunta se deixa o visitante ir para a oferta, e para qual exatamente quem decide são os seus streams no Keitaro.
Baixe o arquivo de filtro deste fluxo
Coloque-o no servidor do Keitaro
Na pasta
/var/www/keitaro/var/filters(em versões antigas,application/filters) e recarregue a página do Keitaro.Adicione o filtro à campanha
Na campanha do Keitaro, abra o stream da oferta e adicione o filtro com o mesmo nome do arquivo, no modo «Sim». Abaixo dele, coloque o stream com a sua White Page — para lá vai todo mundo que não passou no filtro.
O Keitaro consulta o filtro antes de responder ao visitante, por isso aqui não há página de espera: checagem de JavaScript, tempo na página e interação real não valem neste método, e a decisão é tomada só pela rede e pelos dados da requisição. Os endereços de oferta e White Page do fluxo ArtisanClo não são usados — quem os define são os streams do Keitaro. Se o nosso serviço não responder em 3 segundos, a visita vai para a White Page. A checagem de JavaScript, tempo e interação pode ser ativada à parte — veja Verificação do navegador na pré-landing.
Portão para Binom

Se o tráfego passa pelo seu Binom, o ArtisanClo se conecta à landing como portão: a nossa verificação fica na primeira linha da landing e decide para quem mostrá-la antes de ela abrir. A pessoa vê a sua landing com o link de sempre do Binom para a oferta; bot e revisor veem a White Page.
Baixe o arquivo do portão deste fluxo
E coloque-o ao lado do arquivo da landing do Binom no seu servidor.
Inclua o arquivo na primeira linha da landing
Antes de qualquer saída:
Landing do Binom<?php require __DIR__ . '/ac_binom_NNN.php'; ?>Verifique a conexão
A pessoa chega à landing, o bot recebe a White Page.
O portão decide antes de a landing responder ao visitante, por isso não tem página de espera: checagem de JavaScript, tempo na página e interação real não valem, e a decisão é tomada só pela rede e pelos dados da requisição. Se o nosso serviço não responder em 3 segundos, o visitante vê a White Page cujo endereço ficou gravado no arquivo no momento do download. Trocou a White Page? Baixe o arquivo de novo. Se a White Page não tiver endereço próprio (modo «Código de status» ou uma página pronta nossa), nessa situação o portão responde com erro 503. O Binom não tem pasta de filtros como o Keitaro, por isso a conexão é um arquivo dentro da própria landing. A checagem de JavaScript, tempo e interação pode ser ativada à parte — veja Verificação do navegador na pré-landing.
Verificação do navegador na pré-landing
O filtro do tracker só vê o endereço IP e os cabeçalhos da requisição — o navegador em si ele não verifica. Para verificar também o navegador, coloque a nossa tag na pré-landing para onde o tracker manda quem passou pelo filtro. A tag confere se o JavaScript funciona, quanto tempo o visitante ficou na página, se mexeu o mouse ou rolou a página e se não é um navegador automatizado. Não passou — vê a White Page. Passou — fica na pré-landing e segue pela sua campanha. Nas estatísticas a visita conta uma vez só, não duas.
Ativa-se na janela de conexão do fluxo, no bloco do filtro do Keitaro ou do portão do Binom. Ali também aparecem o parâmetro exato para o endereço da pré-landing (abaixo ele aparece como NAME) e três linhas que mostram se tudo está conectado direito.

Keitaro
Acrescente o parâmetro ao endereço da pré-landing
No Keitaro, no stream da oferta, acrescente este parâmetro ao endereço da pré-landing (ou landing) — depois de
?se o endereço ainda não tem parâmetros, ou depois de&se já tem. Com ele reconhecemos na pré-landing o visitante que o filtro deixou passar:ParâmetroNAME={subid}Cole a nossa tag bem no início do <head> dessa pré-landing
Atualize o arquivo do filtro
Baixe-o de novo e substitua o antigo — a versão nova nos envia o subid. Depois abra você mesmo o link da campanha: após a primeira visita, as três linhas de verificação ficam verdes.
Binom
Acrescente o parâmetro ao endereço da landing
No Binom, acrescente este parâmetro ao endereço da landing — depois de
?ou de&. Com ele reconhecemos na landing o visitante que o portão deixou passar:ParâmetroNAME={clickid}Cole a nossa tag bem no início do <head> dessa mesma landing
Atualize o arquivo do portão
Baixe-o de novo e substitua o antigo — a versão nova lê o clickid. Depois abra você mesmo o link da campanha: após a primeira visita, as três linhas de verificação ficam verdes.
Sem o parâmetro, ligamos a visita mesmo assim pelo endereço IP e pelo navegador, mas com menos precisão: nas operadoras móveis, muita gente costuma dividir o mesmo endereço. A visita que o tracker deixou passar aparece no log assim que a tag responder. Se o visitante nunca chegar à pré-landing, a visita é registrada cerca de dois minutos depois, com a decisão que o filtro tomou no tracker. Quem abrir a pré-landing direto, sem passar pelo tracker (por exemplo, um moderador da rede de anúncios), passa pela verificação completa da tag. Essa verificação não funciona no modo sombra nem no modo «Tracker».
Construtores de sites

No Starter você tem a tag JS, o arquivo PHP, o filtro do Keitaro e o portão do Binom. O plugin de WordPress, o worker do Cloudflare e as instruções passo a passo para construtores ficam disponíveis a partir do Professional e no período de teste. Um site no Tilda, Webflow, Unbounce ou Shopify também pode ser conectado no Starter — com a tag JS comum, só que sem instruções.
- WordPress a partir do Professional — Baixar o plugin → no WordPress, «Plugins» → «Adicionar novo» → «Enviar plugin» → «Instalar agora» → «Ativar» → «Configurações» → Traffic Gate (é o nome do nosso plugin) → cole o token de API da seção «Integração via API» (menu do avatar) e escolha o fluxo. Se o site tiver um plugin de cache, limpe o cache depois de conectar.
- Tilda, Webflow a partir do Professional — é preciso um plano pago do próprio construtor. Cole o código na seção head e publique o site.
- Unbounce a partir do Professional — Script Manager, posicionamento Head. No subdomínio unbouncepages.com não funciona: é preciso ter domínio próprio.
- Shopify a partir do Professional — cole o código no template do tema logo depois de
<head>.
Cada construtor tem o próprio bloco na janela de conexão: 1 o código para colar — copiado pelo botão à direita, 2 os passos para aquele construtor.




Cloudflare a partir do Professional — um worker do lado do Cloudflare insere a tag, e os arquivos do site não mudam. O passo a passo está em Conexão pelo Cloudflare.
Verificação da conexão
- Respostas da verificação: «Configuração encontrada na sua página», «Sua página abriu, mas esta configuração não respondeu nela» ou um aviso de que não foi possível abrir a página, com o motivo:
- a página não deixou nossa verificação entrar — na maioria das vezes é a proteção contra bots da hospedagem ou do CDN (por exemplo, o desafio do Cloudflare). A conexão ainda pode estar certa: a primeira visita real vai confirmar;
- não há página no endereço da oferta;
- o servidor da sua página respondeu com um erro;
- a página não respondeu a tempo;
- a página redireciona para outro lugar.
- Se a página tiver a tag de outro fluxo seu, a verificação diz isso: «A página tem a tag de outro dos seus fluxos — "…". Substitua pelo snippet deste fluxo» (o snippet é o código da tag).
- Dá para verificar uma vez a cada 20 segundos; se clicar antes, o painel responde «Verificado agora há pouco». Cada verificação tira as marcas «Instalado» e «Conectado» de todos os métodos, inclusive Keitaro e Binom. «Instalado» volta na hora se a verificação encontrar a conexão; senão, com a primeira visita. «Conectado» sempre volta com a primeira visita.
- Abaixo do método aparece «Funcionando agora» ou a data da última atividade.
Se o script da tag não carregar (por exemplo, a rede ou uma proteção no servidor o bloqueia), a página não fica escondida e a moderação a vê. Coloque o código como primeira linha e verifique a conexão depois de cada mudança no site.
ArtisanClo · Documentação do painel. Dúvidas: info@artisanclo.com ou @artisanclo_support no Telegram.