# Clients

## Clients

La section Clients est présentée sous forme de widgets par défaut, ainsi que d’un générateur de widgets vous permettant d’afficher toutes les données nécessaires. Cette section se compose des sous-sections suivantes :

Dans la section Clients, vous pouvez voir un résumé des newsletters, des messages envoyés et reçus, ainsi que le ratio de clients dans un graphique en secteurs par canaux connectés.

<div data-with-frame="true"><figure><img src="/files/13208d10b73fb5d101959d51bee4fd523c14ad2e" alt=""><figcaption></figcaption></figure></div>

Par défaut, il y a trois widgets dans la section "Analytics" - "Clients", qui seront décrits plus en détail ci-dessous.

Les widgets peuvent être remplacés les uns par les autres : pour cela, faites glisser le widget grâce à ce bouton.

<div data-with-frame="true"><figure><img src="/files/2b0226d8dd55bd2a0e236a5a9c1651c7bad4aa6e" alt="" width="563"><figcaption></figcaption></figure></div>

Placez ensuite le widget à l’emplacement souhaité.

<div data-with-frame="true"><figure><img src="/files/efd6f747f0f5b77356142064e084b2e0603acbb4" alt=""><figcaption></figcaption></figure></div>

### Widgets par défaut

#### Widget de résumé

<div data-with-frame="true"><figure><img src="/files/fc066172dd15c829b0f7bc06a9c3f37666cad2b4" alt="" width="563"><figcaption></figcaption></figure></div>

Le widget par défaut "Résumé" est un résumé des analyses clients, subdivisé en plusieurs parties :

* Aperçu du nombre de nouveaux clients par canal sur une période donnée.

L’exemple ci-dessus montre combien de clients et depuis quels messageries (canaux) ils sont arrivés pour la période sélectionnée.

* Il existe des données sur les newsletters et les messages, où vous pouvez voir le nombre de messages envoyés et reçus par messageries ainsi que le nombre d’envois réalisés :
* Données pour la période sélectionnée.

Si vous souhaitez afficher le résumé pour une autre période (jour actuel ou précédent ; mois, année ou autre période), cliquez sur l’icône du calendrier, puis sélectionnez la période appropriée.

<div data-with-frame="true"><figure><img src="/files/47c91327d3f5d77d7caaeac104f51a7b8da42db7" alt=""><figcaption></figcaption></figure></div>

Lorsque vous consultez les statistiques dans les widgets, vous pouvez remarquer un cercle vert devant les chiffres mis en noir et indiquant le nombre total de messages/e-mails pour toute la période - il s’agit des données pour la période sélectionnée.

<div data-with-frame="true"><figure><img src="/files/bce1d5e12319e5a8968016225c82c0b33a39e925" alt="" width="563"><figcaption></figcaption></figure></div>

#### Widget Clients

<div data-with-frame="true"><figure><img src="/files/b093893f5667068965bf9a50d6215039df0da2dd" alt="" width="563"><figcaption></figcaption></figure></div>

Ce widget peut également être divisé de manière conditionnelle en deux composants :

a) Nombre total de clients par an et par mois affiché en haut du graphique.

b) Un graphique à barres montrant la période de janvier à décembre.

Le mois comptable en cours dans le graphique, pour lequel le nombre de nouveaux clients est calculé et affiché en haut du widget, est mis en bleu, les autres sous-mois comptables - en bleu clair.

Dans ce widget, vous pouvez également modifier les couleurs des colonnes pour une meilleure visibilité.

<div data-with-frame="true"><figure><img src="/files/ab96cd6560f515eba81b772d4f0f5d9b6208bdb0" alt=""><figcaption></figcaption></figure></div>

Ici, dans les paramètres du widget, vous pouvez également appliquer d’autres filtres pour l’affichage des statistiques :

* Par listes et tags.

Pour sélectionner les listes et étiquettes souhaitées, cliquez sur la coche à côté de chaque élément désiré.

* Par canal.
* Par bloc du tunnel.
* Par clients.
* Par tag.

Le tag est une variable système. Vous pouvez le trouver dans la conversation avec un client.

### Widget Clients par canaux

<div data-with-frame="true"><figure><img src="/files/d33321748d4ecd67cea5ff3e0f423f848e0be464" alt="" width="563"><figcaption></figcaption></figure></div>

Ce widget est présenté sous forme de graphique en secteurs montrant le ratio du nombre de clients sur différents canaux (messageries) entre eux.

À partir du widget présenté en exemple, vous pouvez voir :

a) le nombre total de nouveaux clients pour la période de reporting ;

b) un diagramme montrant les ratios du nombre de clients par différentes messageries ;

c) les messageries pour lesquelles les statistiques sont échantillonnées et le nombre de clients par rapport au nom du canal (messagerie) ;

d) la période de reporting (en cliquant sur l’icône du calendrier, vous pouvez sélectionner le jour actuel ou précédent, le mois, l’année ou une autre période).

### Création de widget

Afin de créer votre widget, vous devez cliquer sur le bouton "Ajouter un widget", où vous pouvez appliquer les fonctionnalités souhaitées et tout afficher comme vous le souhaitez.

<div data-with-frame="true"><figure><img src="/files/3ede4ecee37bf455d5e1aec269b90c70336e6859" alt="" width="563"><figcaption></figcaption></figure></div>

Dans ce cas, une fenêtre supplémentaire du générateur de widgets s’ouvrira où.

<div data-with-frame="true"><figure><img src="/files/53d035e34e4c2d5bf9bea98c16021d5d960b3338" alt="" width="563"><figcaption></figcaption></figure></div>

1. Vous choisissez la période à afficher dans les statistiques : cela peut être un jour (actuel ou précédent) ; un mois, une année ou toute autre période de votre choix.
2. Vous pouvez également personnaliser l’apparence du widget à votre convenance :

* Choix du type d’icône du widget : par exemple, pour comptabiliser le nombre de messages, vous pouvez choisir l’icône de dialogue ; si c’est pour la formation - l’icône avec confédéré, etc.
* Type de diagramme pour l’affichage des statistiques : camembert, barres, ligne et simplifié.

Dans le générateur de widgets, vous pouvez personnaliser l’affichage par variable et également utiliser la conversion séparément.

#### Variables

Dans l’onglet "Variables", vous devez indiquer les valeurs de la variable à prendre en compte pour les statistiques.

<div data-with-frame="true"><figure><img src="/files/52c86985426a73c8d64ddcfa762c1c9bedbf21a8" alt="" width="563"><figcaption></figcaption></figure></div>

Dans l’exemple ci-dessus, nous avons spécifié la variable d’âge, qui est utilisée pour enregistrer l’âge du client dans le bot. Comme nous avons spécifié "Par variables client", le système lira les valeurs des clients selon cette variable et ne prendra en compte que ceux qui ont 18 ans et plus.

Dans votre projet, vous pouvez utiliser diverses variables existant dans votre projet : il peut s’agir du montant des paiements, par exemple si vous souhaitez calculer des statistiques pour un certain tarif ; la ville de résidence, etc.

{% hint style="warning" %}
Chaque ligne du widget affiché correspond à la valeur de la variable que vous avez indiquée lors de sa configuration.

**Le nombre maximal de lignes (valeurs de variables) est de 6**
{% endhint %}

#### Opérateurs AND et OR

<div data-with-frame="true"><figure><img src="/files/b2886ce48bba43b17cfda890a7df0e162f58b169" alt="" width="563"><figcaption></figcaption></figure></div>

Si vous transmettez une seule valeur pour l’analyse, vous pouvez choisir l’un des opérateurs. Cependant, si vous transmettez plusieurs valeurs pour l’analyse, il convient de comprendre la différence entre ces filtres :

1. Le filtrage par l’opérateur "AND" désigne l’inclusion des valeurs de toutes les variables.

Autrement dit, si vous sélectionnez "And", le système recherchera et inclura dans les statistiques uniquement ceux qui ont plusieurs valeurs de variables sélectionnées à la fois.

Par exemple, si vous sélectionnez la variable d’âge (valeur de 18) et la variable de genre (valeur masculin), puis le filtre "AND", le système ne prendra en compte que les clients masculins de plus de 18 ans.

De manière conditionnelle, le système comprend que vous avez besoin d’un client qui a à la fois plus de 18 ans et qui est masculin. Le système n’inclura pas d’autres clients dans les statistiques.

#### **Comment fonctionne AND**

Vous pouvez également effectuer une recherche avec une seule variable.

<div data-with-frame="true"><figure><img src="/files/cf419e402b14b62fffe2ea0f58172f1e24caf11d" alt="" width="563"><figcaption></figcaption></figure></div>

Si vous écrivez var1 = 1, var2 = 2, le système renverra 0. Cela permet de définir certaines conditions comme var1 != 1 AND var1 > 0 - dans ce cas, le système renverra les clients dont les variables ne sont pas égales à un ou supérieures à zéro (avec des valeurs 2, 3, 4, etc.).

{% hint style="warning" %}
Veuillez noter !

Le nom de variable pour l’instruction AND doit être le même pour toutes les lignes.

Par exemple :

* per1 = 1 AND pre2 = 2 - est FAUX !
* per1 < 400 AND per1 > 4 est l’écriture correcte des variables.
  {% endhint %}

{% hint style="warning" %}
Si vous devez utiliser les variables comme suit :

per1 = 1 AND pre2 = 2, alors utilisez l’opérateur OR.
{% endhint %}

2. Le filtrage par l’opérateur OR implique une ou plusieurs valeurs (ou plus).

Un tel filtre est utilisé si vous avez besoin d’un échantillon de clients ayant différentes valeurs de variables : par exemple, vous avez besoin de clients âgés de plus de 18 ans ou vivant à New York.

Alors l’opérateur OR inclura dans l’échantillon tous ceux qui ont l’une des deux variables : âge ou ville.

Le système comprend donc de manière conditionnelle que nous avons besoin de ceux qui ont soit plus de 18 ans, soit qui vivent à New York.

**Comment fonctionne OR**

<div data-with-frame="true"><figure><img src="/files/7ad944bcb13d01f2959ee925cf728f9a15b7ad9b" alt="" width="563"><figcaption></figcaption></figure></div>

Variables : var1 = 1, var2 = 2, où le système recherche tout client dont au moins l’une d’elles correspond à la valeur sélectionnée (vous pouvez la transmettre sans valeur - dans ce cas, le système recherche simplement sa présence).

{% hint style="info" %}
Lisez ce que sont les variables et comment les utiliser dans l’ [Variables](/doc/fr/chatbot/functions/variables.md) article.&#x20;
{% endhint %}

Vous pouvez ensuite sélectionner les canaux dont les statistiques seront prises en compte dans ce widget.

<div data-with-frame="true"><figure><img src="/files/fdffa94844cda6bd40d3d9ed0a2c1799617a1cfc" alt="" width="563"><figcaption></figcaption></figure></div>

Vous pouvez suivre les statistiques par listes et tags spécifiques attribués aux clients.

<div data-with-frame="true"><figure><img src="/files/453d62384d487480fee2e3a86a279bcb3a81f0b2" alt="" width="563"><figcaption></figcaption></figure></div>

Bien sûr, vous pouvez également utiliser le générateur de schéma pour prendre en compte les clients qui se trouvent dans un certain état du tunnel.

<div data-with-frame="true"><figure><img src="/files/b8debee3d5420df4fca503bb88c1f3e2cf0cf30e" alt="" width="563"><figcaption></figcaption></figure></div>

Par exemple, d’après l’image ci-dessus, nous pouvons prendre en compte les clients qui ont supprimé un rendez-vous puis consulter le pourcentage de transactions réussies, ce qui vous aidera à comprendre précisément comment améliorer la qualité de votre activité et à agir.

Ensuite, vous pouvez appliquer un filtre pour afficher les clients désabonnés ou, au contraire, les exclure de l’affichage.

<div data-with-frame="true"><figure><img src="/files/f67d7365e22c05dafe6891a3b072036fa5a18732" alt="" width="563"><figcaption></figcaption></figure></div>

Le critère suivant selon lequel vous pouvez afficher les statistiques est le tag.

Un tag est une variable système que l’on peut trouver dans la conversation client (elle ne peut pas être modifiée).

Le tag doit être saisi dans le champ approprié.

#### Tags UTM

<div data-with-frame="true"><figure><img src="/files/dedf876986f73ee57e01163d7a7f9d3eb3b4803a" alt="" width="375"><figcaption></figcaption></figure></div>

{% hint style="info" %}
Pour savoir ce que sont les tags UTM et comment les utiliser, nous vous recommandons de lire l’article “[Comment transmettre des paramètres et des tags UTM](/doc/fr/faq/questions/...transferer-les-etiquettes-utm.md)”.
{% endhint %}

Dans le premier champ « Nom de la valeur », vous écrivez le nom nécessaire pour afficher les résultats dans le diagramme.

Ensuite, dans le champ de sélection des tags UTM, les tags déjà existants dans le projet vous seront présentés.

<div data-with-frame="true"><figure><img src="/files/6bf99fa8f2f755161699b4d10d8b17e226d9d3d0" alt="" width="299"><figcaption></figcaption></figure></div>

Saisissez ensuite la valeur d’étiquette souhaitée - cela peut être n’importe quelle valeur attribuée à ces étiquettes.

<div data-with-frame="true"><figure><img src="/files/9e6ca5cc8819723449d69bc5dd9adacdac2b01fe" alt="" width="563"><figcaption></figcaption></figure></div>

De la même manière que pour la création d’un widget basé sur des variables, il existe un choix de filtrage "toutes les valeurs" et "une des valeurs"

{% hint style="success" %}
Si vous créez un widget basé sur plusieurs tags UTM et que vous avez besoin que le résultat final inclue TOUTES les valeurs, utilisez l’opérateur "Toutes les valeurs".

Si vous devez afficher les résultats selon une des valeurs, utilisez l’opérateur "Une des valeurs".
{% endhint %}

Lorsque vous saisissez une valeur pour une étiquette, vous pouvez définir une correspondance :

1. égal à ;
2. différent de ;
3. supérieur à ;
4. supérieur ou égal à ;
5. inférieur à ;
6. inférieur ou égal à.

<div data-with-frame="true"><figure><img src="/files/cabc3e12a16498a4ee1f6a5ff7227be5c5e484a1" alt=""><figcaption></figcaption></figure></div>

{% hint style="warning" %}
Au total, 6 valeurs peuvent être transmises dans un seul widget, pas plus.
{% endhint %}

Ensuite, choisissez quels canaux utiliser pour les tags UTM dans les statistiques.

Vous pouvez sélectionner plusieurs canaux à la fois ou un seul, selon votre convenance.

Vous pouvez également n’utiliser que les clients inclus dans une liste ou auxquels une étiquette (NON UTM) a été attribuée pour l’affichage dans le widget.

#### Conversion

Pour calculer la conversion, utilisez l’onglet du même nom dans le générateur de widgets.

<div data-with-frame="true"><figure><img src="/files/902f1b5f1436470dae4479e46280341f651d85fc" alt="" width="563"><figcaption></figcaption></figure></div>

Le champ “Ce qu’il faut compter” vous aidera à afficher le taux de conversion selon 4 critères :

1. Quantité — comptage du nombre de clients pour une période donnée et pour un événement/catégorie ou site spécifique.

<div data-with-frame="true"><figure><img src="/files/eaba8a8d908f5f076e5a6cc87f51b20404a98ff7" alt="" width="350"><figcaption></figcaption></figure></div>

Lors du comptage du nombre, vous pouvez choisir comment compter les valeurs pour les clients :

a) Tous les passages clients

b) passage unique - comptage des utilisateurs uniques ayant franchi le tunnel pour la première fois (ce bloc où Analytics est configuré).

<div data-with-frame="true"><figure><img src="/files/03f205a51b04dde384d8b3b93fca2cf53691a29f" alt="" width="563"><figcaption></figcaption></figure></div>

1. **Somme des valeurs** - le système additionne les quantités des valeurs à prendre en compte pour les statistiques ;
2. **Valeur moyenne** - la somme de toutes les valeurs des nombres divisée par leur nombre. Voici, par exemple, trois paiements : le premier paiement - 1999, le deuxième paiement -2455, et le troisième paiement -3455. La valeur médiane serait de 2 636 (on additionne les trois paiements et on divise par leur nombre - trois).&#x20;
3. **La valeur médiane** est le nombre qui correspond à la valeur centrale d’un ensemble de nombres. Prenons l’exemple des versements avec les valeurs précédentes, où le premier versement est de 1999, le deuxième de 2455 et le troisième de 3455. La valeur médiane dans ce cas sera le nombre 2455, se trouvant strictement au milieu de l’ensemble des nombres.

Dans le champ “Comment compter”, vous choisissez de compter les pourcentages soit à partir de la première étape, soit à partir de l’étape précédente.

Quelle que soit la méthode de calcul choisie, les paramètres de l’étape apparaîtront ensuite.

<div data-with-frame="true"><figure><img src="/files/f2706576304c58074b4589a6c2df5f329e4209fb" alt="" width="563"><figcaption></figcaption></figure></div>

Ici, vous pouvez choisir de compter les données par tunnel ou par site.

Pour que la conversion fonctionne selon le tunnel, vous devez installer des blocs avec “Analytics” avec les paramètres des catégories d’événements et des événements dans le schéma du générateur.

<div data-with-frame="true"><figure><img src="/files/663b3d8e21c5f795a6f306f094a007876b62019f" alt=""><figcaption></figcaption></figure></div>

{% hint style="success" %}
Lisez-en plus dans l’article “Ce que signifie chaque champ dans l’éditeur” dans la section '[onglet Analytics](/doc/fr/chatbot/builder/setting/analytique.md)' .
{% endhint %}

<div data-with-frame="true"><figure><img src="/files/90f115d7d79907717171046b2d3693c5bf1a0dc6" alt="" width="563"><figcaption></figcaption></figure></div>

La case à cocher “Afficher les étapes pour toutes les valeurs” est nécessaire pour afficher complètement les valeurs lors du calcul des statistiques dans le graphique, si vous avez besoin d’informations plus détaillées dans le widget.

Si vous souhaitez afficher la conversion par site, vous pouvez indiquer le nom nécessaire dans le champ “Nom de l’étape” (ou le laisser par défaut - le nom sera alors généré automatiquement) et sélectionner le site nécessaire.

<div data-with-frame="true"><figure><img src="/files/c9554f5ff5b80ccc301914519119618047973063" alt="" width="563"><figcaption></figcaption></figure></div>

Pour que les statistiques du site soient prises en compte, vous devez cocher la case d’enregistrement des données dans les paramètres de la page du site dans la section “Analytics”.

<div data-with-frame="true"><figure><img src="/files/3a19d66d4bc3c9d245e1b97ffb8a75c5a35f2cb4" alt="" width="563"><figcaption></figcaption></figure></div>

Dans ce cas, les statistiques prendront en compte le nombre de visites sur le site (et NON les clients uniques).

#### Filtres

Le widget de filtre vous aidera à afficher les données filtrées d’une certaine manière selon les valeurs définies.

<div data-with-frame="true"><figure><img src="/files/c073592d782c206d39a6deb5324f8c613a37476e" alt="" width="375"><figcaption></figcaption></figure></div>

Par exemple, vous avez plusieurs listes qui incluent des clients. Ce type de widget vous aidera à afficher le nombre exact de clients présents dans chacune des listes et à les afficher dans le widget.

#### Comment personnaliser le widget ?

Tout d’abord, vous devez ajouter le nombre requis de valeurs pour afficher les données dans le widget.

<div data-with-frame="true"><figure><img src="/files/9def86b31978c036b660f9fc976c715a07ea3868" alt="" width="375"><figcaption></figcaption></figure></div>

{% hint style="success" %}
Le widget peut accepter au maximum 6 valeurs au total.
{% endhint %}

Après cela, sélectionnez le filtre nécessaire pour afficher le nombre de clients.

<div data-with-frame="true"><figure><img src="/files/0208bfe0b7726218b5ab4fa624502c090868bb32" alt="" width="563"><figcaption></figcaption></figure></div>

Si vous ne définissez pas de nom d’étape, il sera par défaut « Étape 1 », « Étape 2 », etc.

Ensuite, sélectionnez les filtres nécessaires à afficher :

1. Canaux - le nombre de clients provenant d’un certain canal sera affiché.

Par exemple, si plusieurs canaux sont connectés dans votre projet, vous pouvez en afficher plusieurs ou tous dans le filtre en cochant ceux qui sont nécessaires selon votre convenance.

2. Listes et étiquettes - La valeur affiche le nombre de clients respectivement dans les listes et étiquettes que vous avez définies.

<div data-with-frame="true"><figure><img src="/files/4560dbaee975ff2e2823c140226449a308063cab" alt="" width="563"><figcaption></figcaption></figure></div>

C’est similaire aux canaux. Vous pouvez également sélectionner plusieurs listes/étiquettes à la fois pour afficher le client par filtres.

3. Bloc du tunnel - l’étape exprimera le nombre de clients selon le ou les blocs du tunnel correspondants.

<div data-with-frame="true"><figure><img src="/files/a297175a1d83760a527e09c8f5c9cb983d0e0125" alt="" width="563"><figcaption></figcaption></figure></div>

3. Par clients : désabonnés, en les excluant ou en les affichant tous.

Vous pouvez l’appliquer comme filtre supplémentaire dans la valeur pour les clients : par exemple, pour consulter les données des clients désabonnés dans certains canaux.

{% hint style="danger" %}
Veuillez noter !

Lors de l’utilisation du filtre "Afficher uniquement les désabonnés", les clients ajoutés pendant la période spécifiée seront affichés avec le statut "Désabonnement", quelle que soit la date à laquelle ils se sont désabonnés.
{% endhint %}

5. Les clients ajoutés avec le statut Désabonnement seront affichés, quelle que soit la date à laquelle l’utilisateur s’est désabonné.
6. Par tag, la variable système attribuée au client.

<div data-with-frame="true"><figure><img src="/files/8a425edddce3d71c10ce09cf5838613122345655" alt="" width="563"><figcaption></figcaption></figure></div>

### Comment supprimer un widget

Pour supprimer ou dupliquer un widget, vous devez trouver l’icône correspondante sur le widget lui-même.

<div data-with-frame="true"><figure><img src="/files/ec337b23d588a6982b822a05ed5e7d45c6c125c8" alt=""><figcaption></figcaption></figure></div>

En cliquant sur le bouton, vous verrez un menu avec la suppression ou la duplication du widget :

{% hint style="success" %}
Vous savez maintenant comment créer des widgets et leur appliquer les indicateurs nécessaires.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mavibot.ai/doc/fr/analytics/customers.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.