Passer au contenu principal

Formules de KPI (KPI personnalisés)

Créer vos propres KPI : fonctions, paramètres, opérateurs, formules prêtes à l'emploi (taux de réponse, détracteurs, CSAT, délai de résolution) et dépannage.

F
Écrit par François Forest

Menu → Paramètres → Formules de KPI

En bref : un KPI personnalisé est une formule écrite une fois et réutilisée partout où l'on choisit un KPI : rapports, graphiques, tableaux de scores, benchmarks. Il est recalculé en direct selon les filtres, la période et l'équipe de la page, et peut s'appuyer sur les thèmes et le sentiment calculés par l'IA.

Créer un KPI

  1. Allez dans Paramètres → Formules de KPI et cliquez sur Ajouter une formule.

  2. Renseignez le Nom, une Description et la Formule.

  3. Choisissez un Suffixe (%, /5, h, une devise…) et un Format (0, 0.0, 0.00…).

  4. Activez Plus bas est mieux si une baisse est une bonne nouvelle (détracteurs, délais, effort).

  5. Réglez la Visibilité pour vos équipes, puis enregistrez.

La formule est testée à l'enregistrement. Si elle ne peut pas être calculée, le message « Cette formule est invalide. » s'affiche. Voir Dépannage.

Bonnes pratiques : un nom compris de tous, une description dès que le périmètre n'est pas évident, toujours un suffixe, et un KPI simple par question plutôt qu'une formule qui fait tout.

La syntaxe

Une formule combine des fonctions. Chaque fonction peut être restreinte par des conditions, toujours écrites en groupe de trois :

fonction("parametre.propriete", "operateur", "valeur")

Règle

Exemple

Une condition

feedback("import.type", "=", "trustpilot")

Plusieurs conditions = ET

feedback("survey.id", "=", "1526", "nps.profile", "=", "promoter")

Plusieurs valeurs (tableau) = OU

feedback("team.id", "=", ["1234", "323"])

Aucune condition = tout le périmètre

feedback()

Combiner avec + - * / ^ % et des parenthèses

feedback("nps.profile", "=", "detractor") / feedback() * 100

Les guillemets droits sont obligatoires autour du paramètre, de l'opérateur et de la valeur (sauf nombres et booléens dans un tableau). Le nombre d'arguments d'une fonction est toujours un multiple de trois.

Une division par zéro renvoie 0. Une formule ne renvoie jamais de données qu'un utilisateur n'a pas le droit de voir.

Les fonctions

Fonction

Renvoie

Unité

Paramètres acceptés

feedback()

Nombre de feedbacks

Compte

Tous les paramètres standard*

response()

Nombre de feedbacks ayant au moins une réponse correspondante

Compte

Standard*

push()

Nombre d'invitations envoyées (e-mail et SMS)

Compte

push, survey ; opérateur = uniquement

nps()

Net Promoter Score

−100 à 100

Standard*

satisfaction()

Taux de satisfaction (intègre le sentiment des réponses texte)

0 à 100

Standard*

sentiment()

Sentiment moyen, calculé par l'IA

0 à 100

Standard*

ces()

Customer Effort Score

Échelle de la question

Standard*

ratings() / ratingsTable()

Moyenne des notes / des tableaux de notes

Échelle de la question

Standard*

time()

Temps moyen pour compléter une enquête

Minutes

feedback, import, nps, question, segment, survey

resolutionTime()

Temps moyen de résolution (feedbacks assignés uniquement)

Secondes

Idem time()

financial()

Impact financier : (opportunités − risques) × valeur moyenne client

Devise

financial uniquement

attribute_avg/sum/min/max/qty()

Agrégation d'un attribut numérique

Unité de l'attribut

aggregate_attribute (obligatoire) + standard* sauf question

url()

Une valeur lue depuis une API externe

Libre

link uniquement

* Paramètres standard : attribute, feedback, import, nps, question, response, segment, survey, team, topic.

push() ne compte que les invitations des enquêtes Feedier : il renvoie 0 sans connexion Feedier Survey ou sans source d'enquête dans le périmètre. financial() utilise la valeur moyenne du client réglée dans Paramètres → Équipes → Avancé ; sans elle, il renvoie 0.

Des KPI qui s'appuient sur l'IA

Brique

Calculée par l'IA

Exemple de KPI

sentiment()

Le sentiment de chaque passage

Sentiment des avis Google sur la livraison : sentiment("import.type", "=", "google_review", "topic.name", "==", "Livraison")

topic.name

Le classement de chaque verbatim dans vos thèmes

Part des feedbacks qui parlent d'attente : feedback("topic.name", "=", "Attente") / feedback() * 100

satisfaction()

La moitié qualitative du taux (sentiment des textes)

Les paramètres

Paramètre

Valeurs

À savoir

attribute.id / attribute.name

"city" ou "city:Berlin"

Avec :valeur, ne garde que cette valeur

aggregate_attribute.id / .name

L'attribut à agréger

Pour les fonctions attribute_*() ; ce n'est pas un filtre

feedback.id

Un identifiant

—

feedback.type

completed, incomplete

Enquêtes Feedier uniquement : les feedbacks importés sont exclus

financial.type

risk, opportunity

Pour financial()

import.type

feedier_survey, csv, trustpilot, google_review, google_reviews_competitor, google_play_reviews, apple_app_store_reviews, amazon_reviews, avis_verifies, glassdoor, indeed, homeviews, facebook, instagram, hubspot, salesforce, zendesk, easiware, bigquery…

Pas de valeur "all" : appelez la fonction sans condition

nps.profile

promoter, passive, detractor

passive, pas « neutral »

push.canal

email, sms

Pour push()

push.status

scheduled, requested, processed, delivered, opened, clicked, bounce, dropped, deferred, spamreport, unsubscribe

bounce, pas « bounced »

push.includeFollowUps

true, false

Inclut les relances

question.id / question.name

Un identifiant ou le libellé exact

Accents et ponctuation compris

question.type

nps, textarea, ratings, ratingsTable, ces, choices, order, smiley

Pas de type slider

question.option_id / .option_name

Un choix ou une ligne de tableau

—

response.value

"5" ou [4, 5]

À combiner avec une condition question.*

segment.id, survey.id, team.id

Un identifiant

Visible dans l'URL de la page correspondante

topic.name

Le nom exact d'un thème

Thème de votre taxonomie, attribué par l'IA

link.link

Une URL

Pour url()

Les valeurs sont vérifiées dans votre espace de travail : un identifiant, un thème ou un libellé inconnu rend toute la formule invalide.

Les opérateurs

Opérateur

Portée

Effet

=

Feedback entier

Garde les feedbacks qui remplissent la condition

!=

Feedback entier

Exclut ces feedbacks

==

Élément (réponse, verbatim, thème)

La condition doit être remplie par un même élément

!==

Élément

Retire ces éléments du calcul, garde le reste du feedback

Les opérateurs stricts == et !== ne s'utilisent qu'avec question, response et topic. Exemple avec le sentiment d'un thème :

Formule

Ce qui est mesuré

sentiment("topic.name", "=", "Emballage")

Les feedbacks entiers qui parlent d'emballage, y compris le reste de ce qu'ils disent

sentiment("topic.name", "==", "Emballage")

Uniquement les passages qui parlent d'emballage

sentiment("topic.name", "!=", "Emballage")

Les feedbacks qui ne parlent jamais d'emballage

sentiment("topic.name", "!==", "Emballage")

Tous les feedbacks, moins ce qu'ils disent de l'emballage

Formules prêtes à l'emploi

KPI

Formule

Réglages

Taux de réponse

feedback("import.type", "=", "feedier_survey") / push() * 100

%

Taux de détracteurs

feedback("nps.profile", "=", "detractor") / (feedback("nps.profile", "=", "promoter") + feedback("nps.profile", "=", "passive") + feedback("nps.profile", "=", "detractor")) * 100

%, Plus bas est mieux

Taux de promoteurs

feedback("nps.profile", "=", "promoter") / (feedback("nps.profile", "=", "promoter") + feedback("nps.profile", "=", "passive") + feedback("nps.profile", "=", "detractor")) * 100

%

CSAT (notes de 4 ou 5)

feedback("response.value", "=", [4, 5], "question.type", "=", "ratings") / feedback("question.type", "=", "ratings") * 100

%

Part des avis Google

feedback("import.type", "=", "google_review") / feedback() * 100

%

Part d'une option choisie

feedback("question.option_name", "=", "Option A") / feedback("question.type", "=", "choices") * 100

%

Délai de résolution

resolutionTime() / 3600

h, 0.0, Plus bas est mieux

Chiffre d'affaires à risque

financial("financial.type", "=", "risk")

Devise (valeur négative)

Panier moyen des détracteurs

attribute_avg("aggregate_attribute.name", "=", "order_amount", "nps.profile", "=", "detractor")

Devise

Taux de réponse : seules les enquêtes Feedier génèrent des invitations. Sur une source qui mélange 57 réponses d'enquête et 181 lignes CSV pour 654 invitations, le taux est 57 / 654 = 8,7 % : les lignes CSV sont exclues.

Lire une valeur externe avec url()

url("link.link", "=", "https://exemple.com/api/metric~data.value")

Élément

Rôle

L'URL

Appelée en GET, côté serveur, en http ou https

Le chemin après ~

La clé à lire dans la réponse JSON (par défaut : response)

{fql}

Remplacé par les filtres de la page

{user.id}, {user.email}

Remplacés par l'utilisateur qui consulte le KPI

{apikey}

Remplacé par la clé privée de l'espace de travail

La requête contient votre clé privée : n'appelez que des points d'accès que vous contrôlez. Un point d'accès trop lent fait échouer toute la formule.

Dépannage

Symptôme

Cause

Solution

« Cette formule est invalide. »

Syntaxe, valeur inconnue ou paramètre non accepté

Vérifiez dans cet ordre : guillemets et groupes de trois, valeurs exactes, colonne Paramètres acceptés

Opérateur refusé

== ou !== hors question, response, topic ; ou autre que = dans push()

Revenez à = ou !=

Le KPI affiche 0

Division par zéro, ou rien ne correspond

Créez le numérateur et le dénominateur comme deux KPI pour trouver celui qui est vide

push() renvoie 0

Pas de connexion ou de source Feedier Survey dans le périmètre

Vérifiez la source mesurée

Valeur fausse d'un facteur

resolutionTime() est en secondes, time() en minutes

Convertissez et ajustez le suffixe

url() échoue

Délai dépassé ou chemin JSON inexistant

Testez l'URL hors de Feedier


Dernière vérification : 11 novembre 2026, version 4.23.5.

Avez-vous trouvé la réponse à votre question ?