Un objectif est quelque chose qui mérite d’être compté : une inscription, un achat, une demande de démo. Votre site le signale, et l’analyse web l’enregistre sur la visite qui l’a produit.
Enregistrer un objectif
NotifuseAnalytics.trackGoal({ action: 'purchase', type: 'purchase', value: 49.9 })
| Champ | Obligatoire | Remarques |
|---|---|---|
action | Oui | Le nom de l’objectif, jusqu’à 100 octets (100 caractères ASCII, moins pour un texte accentué ou non latin). |
type | Oui | Le genre de conversion : purchase, subscription, lead, signup, booking, trial ou other. |
value | Non | Un nombre positif ou nul : un chiffre d’affaires, ou ce que vous voulez totaliser. |
properties | Non | Jusqu’à 50 valeurs à vous, 1024 octets par valeur et 8 Ko au total, clés comprises. Elles sont stockées sous forme de chaînes. |
type est obligatoire parce que seul votre site sait si une conversion est une vente ou
un lead, et les conditions de segment basées sur les objectifs filtrent sur ce champ. trackGoal rejette
l’appel quand type manque ou ne fait pas partie de ces valeurs, en minuscules. Interceptez donc
l’erreur si vous attendez trackGoal avant de rediriger. Utilisez other quand aucune
des autres valeurs ne convient.
Le chemin de la page courante et sa position dans la visite sont ajoutés pour vous : un objectif sait toujours où il a eu lieu.
Note
Les objectifs partent immédiatement, sans attendre le prochain beat du tracker. Une conversion sur une page que le visiteur s’apprête à quitter arrive donc quand même.
Attention
Une value négative invalide tout l’objectif : il est rejeté en entier, nom compris, pas seulement le nombre. L’API Événements personnalisés se comporte autrement sur ce point : elle accepte volontairement les valeurs négatives, pour les remboursements et les rétrofacturations.
Vous n’avez pas à déclarer les objectifs au préalable. L’onglet Objectifs liste tous les noms que votre site a envoyés, triés par nombre de conversions, et affiche jusqu’aux 30 objectifs les plus convertis pour la période et les filtres appliqués.
Valeurs venant d’un tag manager ou de JavaScript simple
Un snippet ou un tag manager transmet souvent des valeurs lues dans la page. trackGoal convertit donc pour vous les types courants :
- Une
valuepassée comme chaîne écrite comme un nombre JSON, par exemple'49.90'ou'120', est stockée comme un nombre. Ce n’est pas le cas de'49,90','1,299.00','€49.90'et'.5', et un tel objectif est écarté, comme décrit plus bas. - Une
valueégale àNaN(ce que renvoieparseFloat('€49.90')), à un nombre infini, ànullou à une chaîne vide enregistre l’objectif sans valeur et sans avertissement. L’onglet Objectifs et les rapports comptent un tel objectif comme 0 dans les valeurs moyennes et médianes. - Les nombres et les booléens de
propertiessont stockés comme chaînes, et uneDatecomme sa chaîne ISO.null,NaN, un nombre infini et uneDateinvalide sont stockés comme chaîne vide, et une entréeundefinedest ignorée. - Quand
propertiesvautfalse,''ou0, comme le donnecoupon && { coupon }en l’absence de coupon, l’objectif est enregistré sans propriétés.
Un objectif dont les données ne peuvent toujours pas être enregistrées est écarté, avec un avertissement dans la console du navigateur. L’appel se résout quand même, si bien qu’une page qui attend trackGoal avant de rediriger redirige toujours. C’est le cas d’une action absente, vide, qui n’est pas une chaîne ou qui dépasse 100 octets, d’une value qui n’est pas un nombre ou qui sort de l’intervalle 0 à 1e12, et de properties qui sont un tableau, une chaîne non vide, true ou un nombre autre que 0 et NaN, qui contiennent un objet ou un tableau, ou qui dépassent les limites ci-dessus. Le reste de la visite continue d’être enregistré.
Une Map, un FormData ou un URLSearchParams n’a pas de champs propres. Un objectif qui en reçoit un comme properties est donc enregistré sans propriétés et sans avertissement : passez plutôt son Object.fromEntries(…), sans les champs de fichier, dont la valeur est un objet.
Ce que produit un objectif
L’œil sur la carte d’un objectif ouvre son tableau de bord en pleine largeur. Tous les chiffres qu’il affiche ne comptent que les conversions de cet objectif.
- La barre ramène aux Objectifs, passe à l’objectif précédent ou suivant de la grille avec les flèches ou avec K et J, et affiche la période ainsi que celle à laquelle elle est comparée. Les deux se règlent dans l’onglet Objectifs.
- Filtré par liste les filtres appliqués, que vous pouvez retirer un par un. Ce sont les filtres de toute la section Analyse web : cliquer sur une ligne ou un pays du tableau de bord en ajoute un là aussi.
- La bande de KPI donne Nombre, Taux de conv., Valeur totale et Valeur médiane, par rapport à la période de comparaison. Cliquer sur Nombre, Valeur totale ou Valeur médiane en affiche le graphique.
- Taux de conv. est le nombre de conversions de l’objectif divisé par le nombre de sessions de la période, comme sur la carte de l’objectif. Il compte les événements d’objectif et non les sessions qui convertissent : un objectif atteint deux fois dans une session compte deux fois, et le taux peut dépasser 100 %. Son infobulle prévient qu’il inclut tout le trafic, quelle que soit la raison de la visite.
- Le graphique suit la granularité que vous y choisissez et porte vos annotations. Il est accompagné d’une heatmap de l’objectif par jour et par heure.
- Les cartes détaillent les conversions et leur valeur : Principales sources (référents, canaux, groupes de canaux), Principales campagnes (campagnes, sources, mediums, sans les conversions qui n’en ont pas), Appareils (appareils, navigateurs, OS), Pays (carte et liste), Pages d’atterrissage (pages d’atterrissage et pages de l’objectif), et une carte pour celles de vos dimensions personnalisées qui ont un nom.
Dans les rapports, les objectifs vous donnent les mesures Goals, Total Goal Value, Avg Goal Value, Median Goal Value et Converting Sessions, et les dimensions Goal Name, Goal Path et Goal Value. Au niveau des sessions, Sessions with Goals et Goal Value vous permettent de comparer les canaux selon les conversions plutôt que selon le trafic.
Pour un visiteur identifié, un objectif devient aussi un événement personnalisé dans la chronologie de son contact, ce qui le rend accessible aux segments et aux automations. Voir Identifier les visiteurs.
Noms des objectifs dans la chronologie du contact
Un objectif qui arrive dans la chronologie d’un contact est d’abord normalisé : mis en minuscules, tout ce qui sort de l’ASCII a–z, 0–9, . et / est remplacé par un seul _, les _ du début et de la fin sont retirés, et le résultat est coupé à 100 caractères. Trial Started arrive donc sous la forme trial_started, et c’est sur ce nom qu’une automation ou un segment fait sa correspondance.
Attention
Les caractères conservés sont uniquement ASCII : les lettres accentuées et non latines sont supprimées, pas translittérées. Café arrive sous la forme caf. Un nom sans aucune lettre ni chiffre ASCII, comme 購入, se normalise en une chaîne vide et n’arrive jamais dans la chronologie. L’objectif est quand même enregistré et compté dans les rapports, seule la copie dans la chronologie est sautée. Donnez des noms ASCII à vos objectifs si vous les utilisez dans des segments ou des automations.
Cette règle est aussi plus stricte que celle des noms d’événements envoyés par l’API Événements personnalisés, qui accepte les traits d’union : black-friday envoyé depuis un objectif web devient black_friday.
Utiliser les objectifs web dans les segments
Un objectif web porte les trois mêmes informations qu’un événement personnalisé créé par l’API : un nom, une valeur et un type.
- La condition Custom Events Goal correspond aux objectifs web, pour un type précis ou pour All types, et compte, additionne ou fait la moyenne de leur valeur.
- Une automation peut se déclencher sur un événement personnalisé portant le nom normalisé de l’objectif.
Note
Le type est déclaré par votre site, et Notifuse ne le vérifie pas. C’est aussi la même page qui choisit le nom et la valeur de l’objectif. Lisez les rapports de chiffre d’affaires en gardant cela en tête, comme vous le feriez pour des événements envoyés par l’API.
Limites
- Au plus 100 objectifs d’une même session sont copiés dans la chronologie du contact par lot d’écriture. Les objectifs au-delà dans le même lot sont définitivement absents de la chronologie. Le compteur repart à zéro à chaque lot : une longue visite qui continue de convertir peut donc laisser plus de 100 entrées au total dans la chronologie. La visite elle-même continue d’être enregistrée, et la limite ne concerne que la copie dans la chronologie.
- Un objectif de plus de 24 heures n’est pas copié dans une chronologie. Le navigateur d’un visiteur resté hors ligne pendant une journée renvoie sa visite intacte, sans déclencher avec un jour de retard des automations du type « vous venez de faire ceci ».
- Un objectif est rejeté s’il a une valeur supérieure à 1e12, un nom de plus de 100 octets, des propriétés avec plus de 50 clés, plus de 1024 octets dans une valeur ou plus de 8 Ko au total avec leurs clés, une propriété qui contient un objet ou un tableau, ou un caractère NUL (
\u0000) dans son nom ou ses propriétés. Seul l’objectif est rejeté, jamais le reste de la visite.
Remarques
- Les objectifs des visiteurs anonymes sont enregistrés et comptés dans les rapports normalement. Seule la copie dans la chronologie demande une identité.
- Les événements copiés portent le contexte de la visite comme propriétés (identifiant de session, chemin, chemin d’atterrissage, source, medium et campagne UTM, appareil et pays) à côté des vôtres. Ces clés sont définies par Notifuse et écrasent les propriétés de même nom.
- Une devise, un numéro de commande ou toute autre information liée à la conversion va dans
properties, qui sont envoyées et stockées. Il n’y a pas de champcurrencydédié :goal_valueest un simple nombre. Si vous enregistrez plusieurs devises, regroupez vos rapports par la propriété de devise au lieu d’additionner des valeurs de devises différentes. - Référence de l’API
