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étodoO que precisaModo «Tracker»Nosso código no fonte da páginaDificuldade
Tag JSacesso ao <head>nãovisívelfácil
Arquivo PHPhospedagem com PHPsiminvisível: decisão no servidormédia
Keitaro / Binomtracker próprionãoinvisível: decisão no servidormédia
Construtores, Cloudflareconta no serviçonãovisí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

  1. Encontre o fluxo

    Seção Fluxos → na linha do fluxo, clique em ⋯ → Conectar.

    Linha do fluxo na lista: botão «⋯» e o menu aberto com «Conectar», «Duplicar», «Excluir»
    Linha do fluxo: 1 — menu de ações do fluxo, 2 — janela de conexão.
  2. 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 «Conectar»: lista de métodos — script JS, arquivo PHP (marcado como «Instalado»), Keitaro, Binom, WordPress, Cloudflare, Tilda
    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

  1. Copie o código

    Abra Adicione o script à sua landing page e clique no botão de copiar à direita do código 1.

    Bloco «Adicione o script à sua landing page»: campo com o código e o botão de copiar, esquema de inserção no head, aviso sobre gerenciadores de tags
    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>.
  2. 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 async nem defer: com eles o script roda mais tarde, e a página chega a aparecer para todo mundo antes de existir uma decisão.

  3. 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.

    Passo «Verifique a conexão» com o botão «Verificar minha página»
    O botão de verificação 1 é o último passo da tag JS e do arquivo PHP.
    Passo «Verifique a conexão» depois da verificação: botão «Verificar minha página» e a linha «Encontrado na sua página»
     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.

  1. Baixe o arquivo

    Abra Envie o arquivo para o seu servidor e clique em Baixar arquivo 1.

    Bloco «Envie o arquivo para o seu servidor»: botão «Baixar arquivo», esquema da pasta com index.php e offer.php, passo com o novo endereço da landing
    Bloco do arquivo PHP: 1 botão de download e o esquema da pasta da landing 2.
  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)
  3. Coloque o novo endereço da landing na oferta do fluxo

    Por exemplo, https://seu-site.com/offer.php.

  4. Coloque ao lado um arquivo .htaccess

    Essas linhas são as mesmas para todos os fluxos; se já existe um .htaccess na pasta, acrescente-as abaixo do RewriteEngine On existente.

    .htaccess
    RewriteEngine On
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteRule ^ index.php [L,QSA]
  5. Verifique a conexão

    Botão Verificar minha página — o painel confere se o arquivo responde.

Para que serve a regra do .htaccess

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.

nginx
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

  1. Abra o gerenciador de arquivos

    No painel da hospedagem — a seção «Arquivos» ou «Gerenciador de arquivos» 1.

  2. Vá até a pasta da landing

    Normalmente public_html (às vezes www ou htdocs), depois a pasta para onde o anúncio leva 2.

  3. Clique em «Enviar»

    O botão 3 abre a janela de upload.

    Exemplo de painel de hospedagem: gerenciador de arquivos, caminho /public_html/promo/ e o botão «Enviar»
    Exemplo de interface — na sua hospedagem os botões podem ter outros nomes. 1 gerenciador de arquivos, 2 pasta da landing, 3 upload.
  4. Escolha os arquivos

    Arraste index.php e .htaccess para a janela 4 e espere a marca de «enviado» 5. O nome tem que ser exatamente index.php: se você baixar de novo, às vezes o navegador acrescenta «(1)» ao nome.

    Exemplo de janela de upload: área para os arquivos e dois arquivos enviados, index.php e .htaccess
    Exemplo de interface. 4 área de upload, 5 arquivos enviados.
  5. Confira as permissões e abra o site

    Permissões dos arquivos — 644, das pastas — 755. Em alguns gerenciadores o .htaccess fica 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

  1. 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.

  2. Abra a pasta da landing no servidor

    À direita fica o servidor: vá até public_html/pasta 3.

  3. Transfira os arquivos

    À esquerda fica o seu computador: selecione index.php e .htaccess 4 e arraste para a direita 5.

    Exemplo de cliente FTP: campos de conexão, arquivos do computador à esquerda, pasta /public_html/promo/ do servidor à direita
    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.
ErroComo perceberO que fazer
Arquivo em outra pastaVerificaçã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 antigoA 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á ocultoDepois do botão da pré-landing, a página start dá 404Envie o .htaccess ao lado do index.php
Proxy da hospedagemTodas as visitas no log têm o mesmo IPPasse 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 CDNTodo mundo vê a página, ou a decisão muda com atrasoTire a landing do cache

Filtro para Keitaro

Bloco «Filtro para Keitaro» na janela de conexão: três passos e o botão «Baixar o filtro»
 1 baixar o filtro, 2 onde colocar o arquivo no servidor do Keitaro, 3 como adicionar o filtro ao stream do 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.

  1. Baixe o arquivo de filtro deste fluxo

  2. 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.

  3. 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

Bloco «Portão para Binom» na janela de conexão: três passos, a linha de inclusão do arquivo e o botão «Baixar o portão»
 1 baixar o portão, 2 a linha para o início da landing, 3 verificação: pessoa na landing, bot na White Page.

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.

  1. Baixe o arquivo do portão deste fluxo

    E coloque-o ao lado do arquivo da landing do Binom no seu servidor.

  2. Inclua o arquivo na primeira linha da landing

    Antes de qualquer saída:

    Landing do Binom
    <?php require __DIR__ . '/ac_binom_NNN.php'; ?>
  3. 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.

Bloco «Verificação do navegador na pré-landing» no filtro do Keitaro: parâmetro para o endereço da pré-landing, a tag e três linhas verdes de verificação
 1 parâmetro para o endereço da pré-landing, 2 tag para o <head> dela, 3 três linhas de verificação — tudo conectado.

Keitaro

  1. 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âmetro
    NAME={subid}
  2. Cole a nossa tag bem no início do <head> dessa pré-landing

  3. 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

  1. 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âmetro
    NAME={clickid}
  2. Cole a nossa tag bem no início do <head> dessa mesma landing

  3. 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

Bloco WordPress na janela de conexão: passos de instalação do plugin e o botão «Baixar o plugin»
 1 baixar o plugin, 2 instalar no WordPress, 3 colar o token de API, 4 escolher o fluxo.

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.

Bloco Tilda: código para colar e três passos
Tilda. 1 «Código para colar», 2 etapas de instalação.
Bloco Webflow: código para colar e três passos
Webflow. 1 «Código para colar», 2 etapas de instalação.
Bloco Unbounce: código para colar e quatro passos
Unbounce. 1 «Código para colar», 2 etapas de instalação.
Bloco Shopify: código para colar e quatro passos
Shopify. 1 «Código para colar», 2 etapas de instalação.

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.
    O código de resposta vem entre parênteses — dá para repassá-lo ao suporte.
  • 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.
O código precisa carregar primeiro

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.