Création de métriques personnalisées dans Insights

Si vous créez des rapports Insights qui n'incluent pas d'éléments prédéfinis, vous devrez peut-être créer une métrique personnalisée. Vous pouvez écrire le MAQL (langage de requête analytique multidimensionnel) dans l'éditeur avancé de métriques d'Insights pour créer des métriques personnalisées.

Cette astuce fournit un aperçu de la création de vos propres métriques personnalisées Pour plus d'informations sur l'utilisation de l'éditeur de métriques avancées, voir la documentation de GoodData. Commencez à utiliser MAQL pour écrire des métriques. Pour obtenir des ressources supplémentaires sur l'utilisation d’Insights, voir Ressources Insights (Professionnel et Entreprise).

Cet article contient les sections suivantes :

• Navigation vers l'Éditeur de métrique avancé
• Écrire des métrique personnalisées
• Éviter des erreurs communes

Navigation vers l'Éditeur de métrique avancé

Cette section vous montre comment ouvrir l'Éditeur de métrique avancé dans GoodData.

1. Cliquez sur l’icône Rapports () dans l’interface d’agent, puis ouvrez l’onglet Insights.
2. Cliquez sur le lien GoodData dans le coin supérieur droit.
3. Cliquez sur Reports.
4. Cliquez sur Créer le rapport.
5. Dans le menu What, cliquez sur le lien (avancé) à côté de Ajouter une nouvelle métrique.

   

6. Sélectionnez la métrique personnalisée.

Vous serez maintenant redirigé vers l'éditeur de métrique avancé.

Écrire des métrique personnalisées

Cette section montre comment saisir des formules dans l'éditeur Advanced mesure. Après avoir cliqué sur la métrique personnalisée, vous serez redirigé vers l'Éditeur de métrique avancé comme indiqué ci-dessous.

1. Entrez un nom pour votre métrique dans la zone de texte Nom de votre métrique.
2. Cochez la case Ajouter aux métriques globales pour accéder à votre métrique dans l'un de vos rapports. Si vous souhaitez que la métrique soit disponible dans le rapport actuel, ne pas cocher.

   Si vous cochez Ajouter aux métriques globales, choisissez un dossier dans lequel stocker la métrique. Vous pouvez ensuite modifier le format de votre métrique dans la boîte indiquée Formt. Vous pouvez définir le nombre de décimales ou ajouter un suffixe pour formater la métrique en pourcentage.

3. Entrez votre formule MAQL dans le volet Éditeur directement sous Ajouter aux statistiques globales. Si vous n'êtes pas familiarisé avec l'écriture de MAQL dans le volet Éditeur, reportez-vous à la section Utilisation du volet Éditeur ci-dessous.
4. Cliquez sur Ajouter.

Utilisation du volet Éditeur

Dans le volet Éditeur, vous pouvez entrer votre MAQL pour créer votre métrique personnalisée. Toutes les métriques commencent par SELECT.

Sous le volet Éditeur, vous trouverez une liste de fonctions que vous pouvez appliquer aux faits, aux métriques et aux attributs de votre métrique. Chaque fonction contient une définition et vous pouvez cliquer sur une fonction pour l'ajouter à votre rapport.

Vous ne pouvez pas saisir directement vos faits, métriques et attributs, il faut les sélectionner dans le menu Éléments.

Le menu Éléments contient les dossiers suivants :

• Faits : les chiffres bruts de vos données

• Métriques : requêtes existantes

• Attributs : champs de date et champs de texte

• Valeurs d'attribut : Un choix pour un attribut. Par exemple, la couleur de l'attribut pourrait contenir des valeurs d'attribut telles que Rouge, Vert ou Bleu.

• Étiquettes d'attribut : Le nom du champ d'attribut. Dans l'exemple ci-dessus, l'étiquette serait "Couleur".

• Variables : ces métriques permettent d'être dynamiques, en fonction de l'utilisateur qui consulte la métrique.

Une fois qu'un élément est ajouté à la formule métrique personnalisée, il sera automatiquement codé en couleurs. Les faits seront en bleu, les métriques seront en vert, les attributs et les étiquettes d'attributs seront en violet, les valeurs d'attribut seront en orange et les variables en marron clair.

Pour obtenir une liste complète des métriques et des objets Zendesk Insights, voir Référence des statistiques Insights et Référence des objets Insights

Pour ajouter un élément à votre rapport

1. Cliquez sur le dossier contenant l'élément que vous souhaitez ajouter.
2. Choisissez l'élément ou les éléments à ajouter.
3. Cliquez sur le bouton + Ajouter une sélection en haut du panneau ou double-cliquez sur l'élément.

Remarque : Si vous cliquez sur le bouton Ajouter en bas du rapport, vous recevrez un message d'erreur. Le bouton Ajouter est destiné à ajouter la méthode de mesure complète, pas un élément.

Éviter des erreurs communes

Vous trouverez ci-dessous quelques erreurs fréquemment commises par les utilisateurs lors de la création de métriques personnalisées et de la manière de les éviter.

Lors de la création de métriques personnalisées, une erreur fréquente consiste à copier et coller des formules directement à partir d'un document en texte brut. Pour une méthode personnalisée pour travailler, vous devez choisir vos métriques et attributs à partir du volet Éléments. Saisir des noms d'éléments ou copier et coller à partir d'une source différente ne fonctionnera pas.

L'image ci-dessous affiche une formule copiée et collée. Cette formule est incorrecte.

L'image ci-dessous affiche une formule qui utilise le menu Éléments pour ajouter des objets. Cette formule est correcte.

Une autre erreur fréquente est l'absence de parenthèses correspondantes. Si vous créez une requête plus compliquée qu'une seule action agrégée, vous devez faire attention à vos parenthèses et vous assurer que les sous-requêtes sont correctement imbriquées. Si votre requête contient des parenthèses manquantes, elle sera interprétée incorrectement. Si vous créez une métrique personnalisée compliquée, il peut être plus facile de décomposer vos métriques personnalisées en morceaux.

La dernière erreur courante dans la création de vos métriques personnalisées concerne la syntaxe. Si vous recevez un message d'erreur rouge quand il est en bas dans le bouton Ajouter en bas de l'éditeur, vous devriez vérifier votre syntaxe pour tous caractères et espaces supplémentaires, parenthèses manquantes ou éléments incorrects. Par exemple, des hashtags supplémentaires ou des virgules mal placées sont des erreurs courantes. Avant de soumettre et d'enregistrer votre métrique, vous devez vérifier attentivement votre syntaxe, rechercher des caractères et des espaces supplémentaires, vous assurer que vous avez les bonnes parenthèses et avoir choisi les bonnes valeurs du côté droit.

Pour obtenir des exemples d'exemples de rapports, voir Référence des recettes Insights. Vous pouvez utiliser ces recettes pour développer et répliquer des métriques personnalisées. Pour les définitions de tous les éléments Insights disponibles, voir Référence des objets Insights et Référence des métriques Insights.