> ## Documentation Index
> Fetch the complete documentation index at: https://www.notifuse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Objectifs

> Enregistrez les conversions de votre site web et utilisez-les dans les segments et les automations.

![Section Objectifs avec une carte par objectif, qui donne le nombre, le taux de conversion, la valeur totale et la valeur médiane par rapport à la période précédente](https://www.notifuse.com/docs/assets/screenshots/web_analytics/goals.png)

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

```javascript
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.

> [!WARNING]
>
> 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](https://www.notifuse.com/fr/docs/features/custom-events.md) 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 `value` passé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 renvoie `parseFloat('€49.90')`), à un nombre infini, à `null` ou à 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 `properties` sont stockés comme chaînes, et une `Date` comme sa chaîne ISO. `null`, `NaN`, un nombre infini et une `Date` invalide sont stockés comme chaîne vide, et une entrée `undefined` est ignorée.
- Quand `properties` vaut `false`, `''` ou `0`, comme le donne `coupon && { 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.

![Tableau de bord de l'objectif add_to_cart : les boutons objectif précédent et suivant, la période comparée, la bande Nombre, Taux de conv., Valeur totale et Valeur médiane, un graphique quotidien annoté, une heatmap par jour et par heure, et les cartes Principales sources, Principales campagnes et Appareils](https://www.notifuse.com/docs/assets/screenshots/web_analytics/goal_dashboard.png)

- **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](https://www.notifuse.com/fr/docs/web-analytics/annotations.md). 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](https://www.notifuse.com/fr/docs/web-analytics/identifying-visitors.md).

## 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.

> [!WARNING]
>
> 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](https://www.notifuse.com/fr/docs/features/custom-events.md), 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 champ `currency` dédié : `goal_value` est 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](https://www.notifuse.com/docs/api-reference.md)
