Documentação

Verificar um site

Um site é verificado por um de três métodos: um registro DNS TXT, uma meta tag na página inicial ou um arquivo enviado para a raiz do site. São os mesmos três métodos que o Google Search Console usa, então a maioria dos donos de sites já fez um deles antes. A verificação é o que permite que um site seja rastreado; o rastreamento informa quais palavras do site podem ser vendidas no momento.

Adicionar o script de incorporação

O script de incorporação é um único elemento script, adicionado uma vez para que apareça em todas as páginas que devem exibir bolhas. A maioria das plataformas documenta um único lugar para isso. No WordPress, é a parte de template do cabeçalho do tema ou um bloco de HTML personalizado em todo o site; no Squarespace, no Ghost e no Webflow, é o campo de injeção de código no nível do site, nas configurações, e não o de cada página. Um plugin para WordPress está planejado e, até que ele exista, esses dois lugares documentados são o que a plataforma oferece.

O script carrega depois que o DOM da página está pronto e não tem dependências. Ele envia beacons com a própria API de beacon do navegador, que não atrasa a página quando ela é descarregada.

Escolher o escopo

O escopo é a parte de uma página que o script de incorporação pode examinar, indicada por um seletor como o elemento article, o contêiner entry-content ou qualquer elemento que tenha data-adbubbles-scope. O escopo é a configuração de maior consequência, porque decide quais palavras de um site podem ser vendidas.

Dentro do escopo, o script de incorporação já ignora títulos, links, código, texto pré-formatado, controles de formulário, navegação, cabeçalho e rodapé. Qualquer outra coisa que nunca deva exibir uma bolha pode ser marcada com data-noads, e o script de incorporação deixará intactos esse elemento e tudo o que estiver dentro dele.

O limite por página e as exclusões de categoria

O número máximo de bolhas por página é o controle de densidade. Seja qual for o valor definido, o script de incorporação sublinha apenas a primeira ocorrência de cada palavra comprada, abre no máximo uma bolha por palavra e nunca coloca duas no mesmo parágrafo.

As exclusões de categoria são escolhidas por conta, além das categorias que a AdBubbles proíbe em todos os lugares: jogos de azar, conteúdo adulto, armas, criptomoedas, suplementos e política. Os criativos de uma categoria excluída nunca chegam ao site.

Verificar se está funcionando

O painel mostra "waiting for first page view" (aguardando a primeira visualização de página) até que chegue o primeiro beacon de visualização e, depois, "live" (no ar). Por site e por dia, ele informa as visualizações de página que exibiram bolhas, as aberturas, os cliques e os ganhos acumulados, com um painel de problemas para um site que ficou em silêncio ou perdeu a verificação.