Instalar a medição no seu site

Colocar o script é a única etapa técnica do Pulsar. Eis o procedimento exato para cada ambiente, incluindo os que reservam surpresas.

Em resumo

Copie as duas linhas de script indicadas nas suas definições, cole-as no cabeçalho das suas páginas, e a medição começa na primeira visita. O mesmo par de linhas funciona tanto na colocação direta como através de um gestor de etiquetas.

As duas linhas a copiar

Abra o seu site no Pulsar e vá a Definições, Instalação. A caixa preta contém exatamente o que há a colocar. Copie-a por inteiro: cada linha tem o seu papel, e omitir uma delas quebra certas instalações.

A primeira linha declara a configuração numa variável global e prepara a fila de espera dos eventos personalizados. Não carrega nada.
A segunda linha carrega o script de medição, de forma assíncrona, com a mesma configuração repetida em atributos data-*.

A configuração está escrita duas vezes de propósito, na variável global e nos atributos. É isso que torna o mesmo par de linhas válido em toda a parte, incluindo sob um gestor de etiquetas que remove os atributos. Não elimine a linha que lhe parecer redundante.

Colocação direta no HTML

É o método mais fiável, e o que deve preferir sempre que for possível. O script não depende de nenhum intermediário, e nada o pode atrasar nem suprimir.

1 Abra o modelo que produz o <head> de todas as suas páginas.
2 Cole as duas linhas mesmo antes de </head>.
3 Publique e depois carregue uma página do seu site.
4 Volte a Definições, Instalação e clique em Testar: o Pulsar diz-lhe se recebeu alguma coisa.

WordPress

Três caminhos, do mais duradouro ao mais rápido. O primeiro sobrevive às atualizações do tema, os outros não.

Por uma extensão de inserção de código. WPCode, Header Footer Code Manager ou equivalente. Cole as duas linhas na zona de cabeçalho, aplicada a todo o site. É o caminho recomendado: nada se perde na atualização do tema.
Pelas definições do tema. Muitos temas oferecem um campo « Scripts de cabeçalho » no personalizador. Prático, mas o conteúdo pertence ao tema: mudar de tema apaga o script.
Pelo ficheiro header.php. A reservar a um tema-filho. Num tema principal, a próxima atualização substituirá a sua alteração sem aviso.

Se o seu site usa cache, esvazie-a depois da colocação. Uma página servida a partir da cache mantém o HTML antigo, sem o script, e concluiria erradamente que a instalação falhou.

Google Tag Manager, em detalhe

O GTM funciona, mas impõe uma precaução que nada assinala. O contentor injeta os scripts externos sem copiar os seus atributos data-* e coloca document.currentScript a null. Um script que lesse a sua configuração nos seus atributos não encontraria nada, e calar-se-ia sem qualquer erro.

É precisamente para isso que existe a primeira linha. Ao colar as duas linhas juntas, a configuração passa pela variável global e a instalação funciona.

1 No GTM, abra Etiquetas e depois Nova.
2 Escolha o tipo HTML personalizado.
3 Cole as duas linhas copiadas das suas definições, sem alterar nada.
4 Deixe Suporte a document.write desmarcado: o script não precisa disso.
5 Acionador: Todas as páginas, do tipo Visualização de página. Escolha a inicialização mais precoce disponível para não perder os visitantes que saem de imediato.
6 Dê nome à etiqueta, guarde e publique o contentor. Uma etiqueta guardada mas não publicada não faz nada.
7 Verifique no modo de pré-visualização: a etiqueta deve aparecer como acionada, e o separador Rede deve mostrar uma chamada ao domínio de recolha.

Instalar através do GTM acrescenta uma dependência: se um visitante bloquear o contentor, bloqueia também a sua medição. Os bloqueadores visam o GTM muito mais do que o Pulsar. Num público técnico, a diferença face a uma colocação direta atinge com frequência quinze por cento.

Shopify

1 Na administração, abra Loja online, Temas e depois Editar código no tema ativo.
2 Abra layout/theme.liquid.
3 Cole as duas linhas mesmo antes de </head>.
4 Guarde: o Shopify publica de imediato.

O processo de pagamento do Shopify é servido a partir de páginas distintas, às quais este ficheiro não se aplica. As páginas de pagamento não serão portanto medidas, exceto nos planos que autorizam scripts no pagamento.

Webflow, Wix, Squarespace

Webflow: Definições do projeto, separador Custom code, campo Head code. Volte a publicar o site, o código personalizado não está ativo na pré-visualização.
Wix: Definições, Ferramentas de seguimento e análise, adicionar uma ferramenta personalizada, âmbito Todas as páginas, colocação Head.
Squarespace: Definições, Injeção de código, campo Header. Disponível a partir dos planos Business.

Aplicações de página única: React, Vue, Next, Nuxt

Nada de especial a fazer. O script vigia o histórico de navegação, incluindo pushState, replaceState e o botão de retroceder: cada mudança de vista é contada como uma página vista, sem qualquer chamada da sua parte.

Coloque as duas linhas no documento HTML de base: index.html para o Vite, app/layout.tsx para o Next com o componente Script na estratégia afterInteractive, app.html para o SvelteKit.

Não chame o pixel manualmente a cada mudança de rota: contaria cada vista duas vezes. O seguimento do histórico já está em funcionamento.

Servir o script a partir do seu domínio

Por omissão, o script vem do domínio de recolha do Pulsar. Pode servi-lo a partir de um subdomínio seu, por exemplo stats.oseusite.com. Deixa então de ser um recurso de terceiros.

A vantagem é dupla: escapa às listas de bloqueio que visam os domínios de análise e aproveita uma ligação já aberta, o que recupera as páginas vistas perdidas nas navegações rápidas. Consoante os públicos, isso representa entre cinco e vinte por cento das visitas.

A definição encontra-se em Definições, Instalação. O script deduz então o seu endereço de recolha da sua própria origem: as duas linhas apresentadas são atualizadas automaticamente, basta voltar a copiá-las.

Verificar que tudo funciona

O botão Testar das definições interroga a recolha e diz-lhe se estão a chegar dados. É a verificação mais rápida.

Em caso de dúvida, abra a consola do seu navegador, separador Rede, e recarregue uma página do seu site. Deve ver aí um pedido ao domínio de recolha, terminado em /e.

Nenhum pedido. O script não está carregado: verifique se consta mesmo do HTML servido, e não apenas do seu modelo.
Pedido bloqueado. Uma extensão do navegador filtra-o. Teste em navegação privada, com as extensões desativadas.
Pedido enviado, nenhum número. O seu endereço IP consta provavelmente das exclusões da conta. É a causa mais frequente de um « não funciona » quando tudo funciona.

Medir uma ação precisa

Uma vez o script colocado, pode assinalar um evento a partir do seu código, por exemplo ao enviar um formulário:

pulsar('orcamento_enviado', { plano: 'pro' })

A chamada funciona mesmo antes do carregamento completo do script: a primeira linha do excerto coloca as chamadas numa fila de espera, e o script trata delas à chegada. Pode portanto usá-la sem cuidados de ordem.

Um evento torna-se uma conversão seguida assim que o marcar como objetivo, com um clique na estrela do painel.

Falta-lhe uma resposta? Escreva-nos. Respondemos nós próprios e completamos este guia.

Fazer uma pergunta