Usa o plugin. É uma definição e sobrevive a uma mudança de tema, coisa que uma etiqueta colada num tema não faz.

O plugin

  1. No WordPress, vai a Plugins → Adicionar novo plugin e procura Skomi Analytics.
  2. Instala e ativa.
  3. Vai a Definições → Skomi Analytics.
  4. Cola o teu identificador de sítio e guarda.

Está publicado em wordpress.org/plugins/skomi-analytics e atualiza-se como qualquer outro plugin do diretório.

Se o teu sítio não conseguir instalar a partir do diretório, descarrega skomi-analytics.zip, que vai sempre buscar a versão mais recente, e carrega-o em Plugins → Adicionar novo plugin → Carregar plugin. É o mesmo plugin, por isso o WordPress oferece-lhe as mesmas atualizações.

⚠ Se fores tu ao repositório, tira o zip de uma release, não do botão verde "Code → Download ZIP". Esse embrulha tudo numa pasta com o nome do repositório e do ramo, e o WordPress instala um plugin sob a pasta que o zip contiver. O plugin ficaria instalado com o nome errado, e a extensão para WooCommerce mais abaixo (que pede o skomi-analytics pelo nome) deixaria de o encontrar.

O identificador de sítio está na página do teu sítio na Skomi. É um UUID, e não é um segredo: aparece no código-fonte de todas as páginas que mede.

Há duas definições que importam e as restantes podem ficar como estão:

  • Ativo, que está ligado. Desligá-lo interrompe a recolha e mantém o teu identificador de sítio, para não teres de o ir procurar outra vez a seguir.
  • Identificador de sítio. Um identificador que não seja um UUID é recusado com uma mensagem em vez de guardado, porque um identificador errado, uma vez guardado, poria uma etiqueta de script partida em todas as páginas.

Vale a pena conhecer um valor de origem: as visitas de pessoas com sessão iniciada no WordPress não são medidas. Num sítio pequeno as tuas próprias recargas ultrapassam o tráfego real em número, e nada num painel to diz. Há uma caixa para assinalar se as quiseres medir.

Se vendes através do WooCommerce, acrescenta também o Skomi Analytics for WooCommerce (skomi-analytics-for-woocommerce.zip). Ainda não está no diretório, por isso carrega-o em Plugins → Adicionar novo plugin → Carregar plugin. Reporta o total, a moeda e o número de cada encomenda, e é o número da encomenda que impede uma página de agradecimento recarregada de contar uma segunda venda.

O código-fonte dos dois é público, em skomi-plugin-wordpress e skomi-plugin-woocommerce, e vale a pena lê-lo todo antes de instalares seja o que for num sítio que recebe dinheiro.

Colar a etiqueta à mão

Não precisas disto se usaste o plugin. Está aqui porque há sítios que não conseguem acrescentar um, e porque uma etiqueta colada num tema é a forma mais comum de a analítica parar em silêncio no WordPress: uma mudança de tema leva-a com ela, sem erro nenhum e sem nada para dar por isso.

Vai buscar primeiro o fragmento ao teu painel. Tem este aspeto, com o teu próprio identificador de sítio no caminho:

<script src="https://t.skomi.com/s/your-site-id.js" defer></script>

Um plugin de cabeçalho e rodapé

A opção a que recorrer se preferires não mexer num tema. Plugins como o WPCode ou o Head & Footer Code acrescentam uma página de definições com uma caixa para o cabeçalho e uma caixa para o rodapé. Cola a etiqueta na caixa do rodapé e guarda.

Isto sobrevive a todas as mudanças de tema e a todas as atualizações de tema, e esse é todo o argumento a seu favor.

Um tema-filho

Se já tens um tema-filho, acrescenta isto ao functions.php dele:

add_action( 'wp_footer', function () {
    ?>
    <script src="https://t.skomi.com/s/your-site-id.js" defer></script>
    <?php
}, 100 );

O wp_footer dispara mesmo antes da etiqueta </body> de fecho, e a prioridade 100 põe a etiqueta a seguir aos scripts que o WordPress enfileira e que imprime com a prioridade 20.

⚠ Um tema-filho, não o próprio tema. Editar o footer.php de um tema-pai funciona até esse tema atualizar, e depois a etiqueta desaparece sem erro nenhum e sem sinal de que alguma coisa mudou. Pura e simplesmente deixas de recolher dados.

O campo do próprio tema

Muitos temas comerciais têm uma definição de "código personalizado", "código de medição" ou "scripts". Se o teu tiver, é a mesma ideia de um plugin de cabeçalho e rodapé com menos uma coisa instalada. Usa o campo do rodapé ou do corpo em vez do campo do cabeçalho.

⚠ É também a opção que desaparece com o tema, portanto é a mais fraca das três a não ser que tenhas a certeza de que o tema é permanente.

O que o teu plugin de cache vai fazer

Isto aplica-se seja como for que a etiqueta tenha ido parar à página, com plugin ou sem plugin.

Limpa a cache depois de acrescentares a etiqueta. Uma página em cache foi gerada antes de a etiqueta existir e não a contém, portanto não chega nada e não há nada de errado.

Exclui o script da Skomi de "combinar JavaScript" e de qualquer opção que copie scripts de terceiros para o teu próprio servidor. A Skomi constrói um pacote por sítio a partir dos produtos que tens ligados, e o navegador deve ir buscar o atual. Uma cópia presa dentro do pacote do teu plugin de otimização está congelada no dia em que foi copiada: ligar um produto mais tarde não mudaria nada, e não haveria nada para ver que explicasse porquê.

Os plugins de otimização que apenas adiam ou atrasam o script não fazem mal: a etiqueta já traz defer.

Mais do que um sítio

Um WordPress multisite, ou várias instalações, quer dizer vários sítios na Skomi: cada domínio é registado em separado e recebe o seu próprio identificador, e cada subsítio precisa da sua própria etiqueta. Os subdomínios de um domínio registado são aceites pelo sítio a que pertencem.

Confirma que está a funcionar

Carrega uma página do teu sítio e depois olha para o teu painel. Se não chegar nada, percorre o que verificar quando o fragmento não funciona; no WordPress a resposta é quase sempre uma cache que não foi limpa, ou um plugin de otimização que reescreveu a etiqueta.