Par défaut, l’analyse web est anonyme : elle compte les visites sans savoir qui les a faites. Une fois un visiteur identifié, ses visites apparaissent dans la chronologie de son contact et les segments peuvent utiliser son comportement.
Comme /track est un endpoint public, une adresse seule ne prouve rien. L’identification est donc toujours signée.
identify()
Appelez identify dès que vous savez qui est le visiteur, avec son adresse et une signature calculée sur votre serveur.
NotifuseAnalytics.identify('alice@example.com', '<hmac from your server>')
Les deux arguments sont obligatoires : sans eux, identify rejette l’appel au lieu d’échouer en silence. Il rejette aussi une adresse de plus de 255 caractères ou une signature de plus de 64 octets. Une adresse mal signée échoue en silence : le serveur ignore l’identité et enregistre la visite comme anonyme.
Calculer la signature
La signature est un HMAC-SHA256, encodé en hexadécimal, calculé sur la chaîne wa_identify: suivie de l’adresse email, avec la clé secrète de votre espace de travail comme clé.
import { createHmac } from 'crypto'
function webIdentifyHmac(email, workspaceSecretKey) {
return createHmac('sha256', workspaceSecretKey)
.update('wa_identify:' + email)
.digest('hex')
}func webIdentifyHMAC(email, workspaceSecretKey string) string {
mac := hmac.New(sha256.New, []byte(workspaceSecretKey))
mac.Write([]byte("wa_identify:" + email))
return hex.EncodeToString(mac.Sum(nil))
}Signez l’adresse exactement telle que vous la passez à identify : la signature est vérifiée avant la normalisation de l’adresse, donc Alice@Example.com doit être signée sous la forme Alice@Example.com.
Attention
Ne calculez jamais cette signature dans le navigateur. Elle existe parce que n’importe qui peut envoyer des données à l’endpoint de suivi, et une clé secrète livrée dans la page lui retire toute utilité.
Le préfixe wa_identify: distingue cette signature de celle de vos liens de désabonnement. Une signature récupérée dans un email transféré ne peut donc pas identifier un visiteur, et une signature récupérée dans votre page ne peut pas modifier les abonnements de quelqu’un.
clearIdentity() empêche les beats suivants de porter l’identité. Il ne rend pas anonyme ce qui a déjà été enregistré.
Identifier depuis les liens des emails
Notifuse peut ajouter une identité signée aux liens des emails suivis. Un destinataire qui clique sur l’un d’eux est alors reconnu à son arrivée, sans aucun code sur votre site.
Cette option est désactivée par défaut. Activez Identifier les destinataires des emails dans Paramètres → Analyse web.
Note
Avec identify(), c’est votre serveur qui fait l’appel, avec votre propre secret. Ici, l’identifiant est généré par Notifuse pour chaque destinataire de chaque envoi suivi. C’est pour cela qu’il a son propre réglage et qu’il ne s’active pas avec l’analyse web.
L’identité est un paramètre nf_id chiffré qui expire 7 jours après sa génération. Il n’est ajouté qu’aux liens dont l’hôte figure dans vos domaines autorisés : les liens tiers du même email ne le portent jamais. Le tracker le lit à l’arrivée et le retire de l’URL.
Un envoi n’en porte jamais quand le suivi est explicitement désactivé pour la notification, ou (avec l’API transactionnelle) quand le message a un destinataire en CC ou en BCC, car l’identité serait sinon remise à quelqu’un qui n’est pas le contact.
Attention
Désactiver le suivi des clics ne retire pas l’identité. Sans redirection pour l’envelopper, le paramètre est écrit directement sur votre propre lien. Pour le supprimer, il faut désactiver le suivi de la notification ou désactiver l’identification par les liens des emails.
Désactiver le réglage empêche seulement la génération de nouveaux identifiants. Un nf_id déjà présent dans le navigateur d’un visiteur continue de l’identifier jusqu’à son expiration, au plus 7 jours plus tard.
Ce que l’identification enregistre
Une fois le visiteur identifié, cette visite et tout ce qui y a déjà été enregistré sont attribués au contact :
- Sur les lignes analytiques : l’adresse du contact. Contact Email devient ainsi une dimension et Identified Contacts une mesure.
- Dans la chronologie du contact : une entrée par page vue et une entrée qui résume la visite, ainsi que les objectifs sous forme d’événements personnalisés.
Si l’adresse n’est pas encore un contact, un contact est créé avec la langue et le fuseau horaire signalés par la visite, ainsi que le pays déduit de l’IP du visiteur quand la géolocalisation est active. Une valeur que Notifuse ne peut pas stocker, comme une langue non prise en charge ou un fuseau horaire inconnu, est laissée de côté. Un contact existant n’est jamais modifié par une visite, et un contact créé de cette façon n’est ajouté à aucune liste.
Sur la fiche du contact
L’onglet Visites web de la fiche d’un contact liste ses visites identifiées, de la plus récente à la plus ancienne : quand, combien de temps, combien de pages, d’où il venait et sur quel appareil. Dépliez une visite pour voir son parcours page par page, avec les objectifs atteints en chemin. Au-dessus de la liste, un résumé donne la première visite identifiée, les objectifs atteints et les pages les plus vues, et Ouvrir dans l’analyse web ouvre le dashboard filtré sur le contact.
L’onglet n’apparaît qu’aux membres qui peuvent lire l’analyse web, et seulement quand l’analyse web est activée.
Segments
Le comportement web est disponible sous forme de conditions d’activité dans un segment :
| Condition | Filtre sur |
|---|---|
| Voir la page web | Chemin, temps passé sur la page, profondeur de défilement, numéro de la page dans la visite, type d’entrée |
| Visiter le site web | Page d’entrée, page de sortie, pages vues, durée de la visite, profondeur de défilement, objectifs atteints, valeur des objectifs, domaine référent, source, medium et campagne UTM, canal, groupe de canaux, appareil, navigateur, système d’exploitation, pays |
« A vu /pricing au moins deux fois au cours des 30 derniers jours » ou « est venu d’une campagne de newsletter et a atteint au moins un objectif » sont donc des conditions de segment ordinaires. Voir Contacts pour la façon dont les conditions se combinent.
Note
La navigation ne déclenche jamais d’automation. Les pages vues et les visites sont enregistrées et utilisables dans les segments, mais seuls les objectifs atteignent les automations, par le déclencheur custom_event, sous le nom normalisé de l’objectif. Les objectifs portent un type déclaré : ils sont donc aussi accessibles par la condition Custom Events Goal. Voir Objectifs.
Confidentialité
- Aucun cookie n’est déposé, et aucun identifiant ne suit un visiteur d’un site à l’autre.
- Les adresses IP servent à déterminer un emplacement et ne sont jamais stockées.
- Une visite anonyme reste anonyme. Rien ne la relie après coup à un contact identifié lors d’une session ultérieure.
- Supprimer un contact efface son adresse partout où elle était stockée : les lignes analytiques, les entrées de sa chronologie et les événements personnalisés créés à partir de ses objectifs web. Le trafic reste, en anonyme, et les totaux historiques ne changent pas.
Attention
Un visiteur dont le navigateur conserve encore un identifiant est identifié à nouveau (et recréé comme contact) lors de sa visite suivante, même après sa suppression. Pour l’arrêter définitivement, cessez d’appeler identify() pour cette adresse, et désactivez l’identification par les liens des emails si l’identifiant venait d’un lien. Un nf_id généré avant la désactivation du réglage fonctionne jusqu’à son expiration.
Remarques
- L’identification est limitée en débit par adresse et par IP source. La création d’un nouveau contact à partir d’une identification est en plus limitée par espace de travail.
- Dépasser une limite fait perdre l’identité sur ce beat, jamais la visite.
- Chaque passe de projection écrit au plus 100 pages vues par visite, en gardant les plus récentes. Une longue visite projetée en plusieurs passes peut laisser plus de 100 entrées de pages vues dans la chronologie.
- Les objectifs de plus de 24 heures ne sont pas ajoutés à une chronologie : une visite hors ligne renvoyée plus tard ne déclenche pas d’automations avec un jour de retard.
- Référence de l’API
