Installer la mesure sur votre site

La pose du script est la seule étape technique de Pulsar. Voici la procédure exacte pour chaque environnement, y compris ceux qui réservent des surprises.

En bref

Copiez les deux lignes de script affichées dans vos réglages, collez-les dans l'en-tête de vos pages, et la mesure démarre à la première visite. La même paire de lignes fonctionne en pose directe comme via un gestionnaire de balises.

Les deux lignes à copier

Ouvrez votre site dans Pulsar, puis Réglages, Installation. L'encadré noir contient exactement ce qu'il faut poser. Copiez-le entier : les deux lignes ont chacune leur rôle, et en omettre une casse certaines installations.

La première ligne déclare la configuration dans une variable globale et prépare la file d'attente des événements personnalisés. Elle ne charge rien.
La seconde ligne charge le script de mesure, en asynchrone, avec la même configuration répétée en attributs data-*.

La configuration est écrite deux fois à dessein, dans la variable globale et dans les attributs. C'est ce qui rend la même paire de lignes valable partout, y compris sous un gestionnaire de balises qui supprime les attributs. Ne supprimez pas la ligne qui vous paraît redondante.

Pose directe dans le HTML

C'est la méthode la plus fiable, et celle à préférer chaque fois qu'elle est possible. Le script ne dépend d'aucun intermédiaire, et rien ne peut le retarder ni le supprimer.

1 Ouvrez le gabarit qui produit le <head> de toutes vos pages.
2 Collez les deux lignes juste avant </head>.
3 Publiez, puis chargez une page de votre site.
4 Revenez dans Réglages, Installation et cliquez sur Tester : Pulsar vous dit s'il a reçu quelque chose.

WordPress

Trois chemins, du plus durable au plus rapide. Le premier survit aux mises à jour du thème, les autres non.

Par une extension d'insertion de code. WPCode, Header Footer Code Manager ou équivalent. Collez les deux lignes dans la zone d'en-tête, portée à tout le site. C'est le chemin recommandé : rien ne se perd à la mise à jour du thème.
Par les réglages du thème. Beaucoup de thèmes offrent un champ « Scripts d'en-tête » dans l'outil de personnalisation. Pratique, mais le contenu appartient au thème : changer de thème efface le script.
Par le fichier header.php. À réserver à un thème enfant. Dans un thème parent, la prochaine mise à jour écrasera votre modification sans prévenir.

Si votre site utilise un cache, videz-le après la pose. Une page servie depuis le cache garde son ancien HTML, sans le script, et vous conclurez à tort que l'installation a échoué.

Google Tag Manager, en détail

GTM fonctionne, mais impose une précaution que rien ne signale. Le conteneur injecte les scripts externes sans recopier leurs attributs data-*, et met document.currentScript à null. Un script qui lirait sa configuration dans ses attributs ne trouverait donc rien, et se tairait sans erreur.

C'est précisément pour cela que la première ligne existe. En collant les deux lignes ensemble, la configuration passe par la variable globale et l'installation fonctionne.

1 Dans GTM, ouvrez Balises, puis Nouvelle.
2 Choisissez le type HTML personnalisé.
3 Collez les deux lignes copiées depuis vos réglages, sans rien modifier.
4 Laissez Prise en charge de document.write décochée : le script n'en a pas besoin.
5 Déclencheur : Toutes les pages, de type Page vue. Choisissez l'initialisation la plus précoce disponible pour ne pas perdre les visiteurs qui repartent aussitôt.
6 Nommez la balise, enregistrez, puis publiez le conteneur. Une balise enregistrée mais non publiée ne fait rien.
7 Vérifiez en mode Aperçu : la balise doit apparaître comme déclenchée, et l'onglet Réseau doit montrer un appel vers le domaine de collecte.

Une installation par GTM ajoute une dépendance : si un visiteur bloque le conteneur, il bloque aussi votre mesure. Les bloqueurs visent GTM bien plus souvent que Pulsar. Sur un public technique, l'écart avec une pose directe atteint couramment quinze pour cent.

Shopify

1 Depuis l'administration, ouvrez Boutique en ligne, Thèmes, puis Modifier le code sur le thème actif.
2 Ouvrez layout/theme.liquid.
3 Collez les deux lignes juste avant </head>.
4 Enregistrez : Shopify publie immédiatement.

Le tunnel de commande de Shopify est servi depuis des pages distinctes, sur lesquelles ce fichier ne s'applique pas. Les pages de paiement ne seront donc pas mesurées, sauf sur les offres qui autorisent les scripts dans le tunnel.

Webflow, Wix, Squarespace

Webflow : Paramètres du projet, onglet Custom code, champ Head code. Republiez le site, le code personnalisé n'étant pas actif en aperçu.
Wix : Paramètres, Outils de suivi et analyses, ajouter un outil personnalisé, portée Toutes les pages, emplacement Head.
Squarespace : Paramètres, Injection de code, champ Header. Disponible à partir des offres Business.

Applications monopage : React, Vue, Next, Nuxt

Rien de particulier à faire. Le script surveille l'historique de navigation, pushState, replaceState et le retour arrière compris : chaque changement de vue est compté comme une page vue, sans appel de votre part.

Posez les deux lignes dans le document HTML de base : index.html pour Vite, app/layout.tsx pour Next avec le composant Script en stratégie afterInteractive, app.html pour SvelteKit.

N'appelez pas manuellement le pixel à chaque changement de route : vous compteriez chaque vue deux fois. Le suivi de l'historique est déjà en place.

Servir le script depuis votre domaine

Par défaut, le script vient du domaine de collecte de Pulsar. Vous pouvez le servir depuis un sous-domaine du vôtre, par exemple stats.votresite.com. Il cesse alors d'être une ressource tierce.

L'intérêt est double : il échappe aux listes de blocage visant les domaines d'analyse, et il profite d'une connexion déjà ouverte, ce qui récupère les pages vues perdues sur les navigations rapides. Selon les publics, cela représente entre cinq et vingt pour cent des visites.

Le réglage se fait dans Réglages, Installation. Le script déduit alors son adresse de collecte de sa propre origine : les deux lignes affichées sont mises à jour automatiquement, il suffit de les recopier.

Vérifier que tout fonctionne

Le bouton Tester des réglages interroge la collecte et vous dit si des données arrivent. C'est le contrôle le plus rapide.

En cas de doute, ouvrez la console de votre navigateur, onglet Réseau, et rechargez une page de votre site. Vous devez y voir une requête vers le domaine de collecte, se terminant par /e.

Aucune requête. Le script n'est pas chargé : vérifiez qu'il figure bien dans le HTML servi, et non seulement dans votre gabarit.
Requête bloquée. Une extension du navigateur la filtre. Testez en navigation privée, extensions désactivées.
Requête partie, aucun chiffre. Votre adresse IP figure probablement dans les exclusions du compte. C'est la cause la plus fréquente d'un « ça ne marche pas » alors que tout fonctionne.

Mesurer une action précise

Une fois le script posé, vous pouvez signaler un événement depuis votre code, par exemple à l'envoi d'un formulaire :

pulsar('devis_envoye', { formule: 'pro' })

L'appel fonctionne même avant le chargement complet du script : la première ligne du snippet met les appels en file d'attente, et le script les traite à son arrivée. Vous pouvez donc l'utiliser sans précaution d'ordre.

Un événement devient une conversion suivie dès que vous le marquez comme objectif, d'un clic sur l'étoile dans le tableau de bord.

Il vous manque une réponse ? Écrivez-nous, nous répondons nous-mêmes et nous complétons ce guide.

Poser une question