Documentação

Tráfego

Conexão com o site

Para o fluxo começar a funcionar, conecte-o ao seu site. Abra o menu do fluxo → Conectar e escolha um método — um basta. O anúncio aponta para o endereço do seu site: as páginas continuam com você.

  • Os métodos ficam recolhidos, e só um fica aberto por vez. O método que está funcionando é marcado em verde e com a etiqueta “Instalado”.
  • Um fluxo no modo “Tracker” só é conectado pelo arquivo PHP — a tag, o Keitaro, o Binom e os construtores não aparecem para ele.

Tag JS

  1. Copie o código.
  2. Cole-o como primeira linha do <head> em cada página da landing, salve e recarregue a página. Não conecte o código pelo Google Tag Manager ou outros gerenciadores de tags e não adicione async nem defer: eles executam o script mais tarde, e a página chega a aparecer para todos antes da decisão.
  3. Verifique a conexão com o botão Verificar minha página: o painel abre a página e procura o código nela.

A tag esconde a página até a decisão chegar e leva para a White Page se não houver decisão.

Arquivo PHP

Para sites em hospedagem com PHP. Serve para o modo “Tracker”. O modo sombra funciona no arquivo PHP, no filtro do Keitaro e no portão do Binom.

  1. Baixe o arquivo com o botão Baixar arquivo.
  2. Coloque-o na raiz da landing com o nome index.php e renomeie a sua landing, por exemplo para offer.php.
  3. Defina o novo endereço da landing na oferta do fluxo, por exemplo https://seu-site.com/offer.php.
  4. Verifique a conexão — o painel confere se o arquivo responde.

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” com a lista do que a sua versão atual não consegue fazer. Baixe o arquivo de novo e substitua-o.

Filtro para Keitaro

Se o seu tráfego já passa pelo Keitaro, o ArtisanClo entra nele como filtro de fluxo: o Keitaro nos pergunta se a visita pode ir para a oferta, e os seus fluxos do Keitaro decidem para onde ela vai.

  1. Baixe o arquivo de filtro deste fluxo.
  2. Coloque-o no servidor do Keitaro em /var/www/keitaro/var/filters (application/filters em versões antigas) e recarregue o Keitaro.
  3. Na campanha do Keitaro, abra o fluxo da oferta e adicione o filtro com o nome do arquivo no modo «Sim». Abaixo dele, coloque o fluxo com a sua White Page — todos os outros vão para lá.

O Keitaro consulta o filtro antes de responder ao visitante, então aqui não há página de verificação: a checagem de JavaScript, o tempo na página e a interação real não se aplicam a este método; a decisão é tomada pela rede e pela requisição. Os endereços de oferta e White Page do fluxo do ArtisanClo não são usados — quem os define são os fluxos do Keitaro. Se o nosso serviço não responder em 3 segundos, a visita vai para a White Page.

Portão para Binom

Se o seu tráfego passa pelo Binom, o ArtisanClo entra na landing como portão: a verificação é a primeira linha da landing e decide antes de exibi-la. Um humano vê a sua landing com o link de oferta do Binom de sempre; um bot e um revisor recebem 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. Torne-o a primeira linha da landing, antes de qualquer saída: <?php require __DIR__ . '/ac_binom_NNN.php'; ?>
  3. Confira a conexão: um humano chega à landing, um bot recebe a White Page.

O portão decide antes de responder ao visitante, então não há página de verificação: a checagem de JavaScript, o tempo na página e a interação real não se aplicam; decide-se pela rede e pela requisição. Se o serviço não responder em 3 segundos, o visitante vai para a White Page embutida no arquivo no momento do download; se você trocar a White Page, baixe o arquivo de novo. O Binom não tem pasta de filtros como o Keitaro, por isso o método é um arquivo na própria landing, não um filtro de fluxo.

Construtores de sites

No Starter, o site é conectado pela tag JS ou pelo arquivo PHP. O plugin para WordPress, o worker da Cloudflare e as instruções para construtores estão disponíveis a partir do plano Professional.

  • WordPress a partir do Professional — Baixar o plugin → no WordPress, “Plugins” → “Enviar plugin” → “Ativar” → “Configurações” → ArtisanClo → cole a chave de API 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 construtor: cole o código na seção head e publique o site.
  • Unbounce a partir do Professional — Script Manager, posicionamento Head. Não funciona no domínio unbouncepages.com.
  • Shopify a partir do Professional — cole o código no template do tema logo depois de <head>.
  • Cloudflare a partir do Professional — o código é inserido do lado da Cloudflare, e os arquivos do site não mudam. O domínio precisa passar pelo proxy da Cloudflare (nuvem laranja).
    1. Workers & Pages → Create application → Start with Hello World: dê um nome e clique em Deploy.
    2. Edit code: substitua o código padrão pelo código da janela de conexão e clique em Deploy.
    3. Settings → Variables and Secrets → Add: tipo Text, nome AC_SNIPPET, valor — todo o código para colar. Clique em Deploy.
    4. Settings → Domains & Routes → Add → Route: escolha o domínio e informe um padrão, por exemplo example.com/*.
    Sem Deploy depois de adicionar a variável, o código não é inserido, e com a nuvem cinza o worker não é executado.

Verificação da conexão

  • Respostas da verificação: “Conexão encontrada na sua página”, “A página abriu, mas este método de conexão não respondeu nela” ou “Não foi possível abrir sua página”. A última ainda não significa que a conexão não funciona: alguns sites não deixam a verificação entrar.
  • Dá para verificar uma vez a cada 20 segundos. A verificação zera as marcas anteriores “Instalado” e “Conectado” — elas voltam 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, se a rede ou um bloqueador no servidor o cortar), a página não é escondida e a moderação a vê. Coloque o código na primeira linha e verifique a conexão depois de cada alteração no site.

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