Créer un tableau de bord
Créez des tableaux de bord d'équipe ou d'initiative, organisez des graphiques dispersés, bâtissez des rapports exécutifs ou mettez en place des tableaux de bord de revue périodique.
Instructions
Étape 0 : Découverte (si la fonctionnalité n'est pas familière)
Avant de construire, comprenez ce que vous suivez :
- Recherchez les tableaux de bord/graphiques existants liés au sujet
- Recherchez les événements pertinents :
Amplitude:searchavec entityTypes : ["EVENT", "CUSTOM_EVENT"] - Utilisez
get_event_propertiespour comprendre les propriétés disponibles pour la segmentation - Demandez des précisions à l'utilisateur sur les objectifs principaux, les segments clés ou les horizons temporels
Étape 1 : Définir l'objectif du tableau de bord
Clarifiez :
- Quel est le public ?
- Quelles décisions va-t-il éclairer ?
- À quelle fréquence sera-t-il revu ?
- Quelle est la structure narrative ?
Étape 2 : Rassembler ou créer des graphiques
Si des graphiques existants sont trouvés (>5 pertinents) :
- Utilisez
Amplitude:searchpour trouver les graphiques existants pertinents - Utilisez
Amplitude:get_chartspour récupérer leurs définitions - Identifiez les lacunes qui nécessitent de nouveaux graphiques
Si peu ou pas de graphiques existent (<5 pertinents) :
- Passez en mode "construction intégrale"
- Utilisez
Amplitude:query_datasetpour créer les graphiques nécessaires - Enregistrez tous les graphiques avec
Amplitude:save_chart_editsavant de construire le tableau de bord - Envisagez de rechercher d'abord les événements pertinents avec entityTypes : ["EVENT", "CUSTOM_EVENT"]
Création de nouveaux graphiques :
- Prototypez avec
query_datasetpour vérifier les données - Enregistrez par lots en utilisant
save_chart_edits(plus efficace) - Collectez tous les IDs de graphiques avant de créer le tableau de bord
Étape 3 : Planifier la mise en page
Organisez en sections logiques :
- Ligne de résumé : Indicateurs clés en un coup d'œil (vue d'ensemble)
- Section tendances : Comment les choses évoluent
- Section répartition : Segments et dimensions
- Section détails : Analyses de support
Étape 4 : Créer le tableau de bord
Utilisez Amplitude:create_dashboard avec :
- Un nom clair et descriptif
- Des lignes avec des hauteurs appropriées (375, 500, 625 ou 750px)
- Des graphiques dimensionnés correctement (3-12 colonnes)
- Des en-têtes de section en texte enrichi
- Des configurations d'affichage des graphiques dans chartMetas :
metric_only: KPI principaux (nombre unique)series: Lignes de tendance (vue par défaut)converted: Entonnoirs (vue de conversion)table: Tableaux de données
Étape 5 : Ajouter du contexte
Incluez des blocs de texte enrichi pour :
- L'objectif et le public du tableau de bord
- Comment interpréter les indicateurs clés
- Des liens vers des ressources connexes
- La date de dernière mise à jour ou le calendrier de revue
Directives de mise en page
| Type de contenu | Largeur suggérée | Hauteur suggérée |
|---|---|---|
| Indicateur clé | 3-4 colonnes | 375px |
| Graphique tendance | 6-12 colonnes | 500px |
| Graphique comparatif | 6 colonnes | 500px |
| Tableau détaillé | 12 colonnes | 625px |
| En-tête de section | 12 colonnes | 375px |
Bonnes pratiques
- Placez les indicateurs les plus importants au-dessus de la ligne de flottaison
- Utilisez des tailles de graphiques cohérentes dans les lignes
- Regroupez les indicateurs connexes ensemble
- Ajoutez du texte explicatif pour les indicateurs complexes
- Demandez à l'utilisateur les domaines d'intérêt si plusieurs approches valides existent
- Créez les graphiques par lots pour minimiser les appels d'outils
Problèmes courants
Erreurs de requête (500/400) :
- Simplifiez : supprimez les groupBy complexes, réduisez les plages de dates, évitez les propriétés imbriquées
- Vérifiez d'abord l'existence des événements/propriétés avec la recherche
- Utilisez eventsSegmentation avec groupBy au lieu de dataTableV2 pour les listes des N premiers
Aucune donnée retournée :
- Vérifiez que les noms d'événements correspondent exactement (sensible à la casse)
- Vérifiez que la plage de dates couvre la période où les événements ont été suivis
- Confirmez que les segments d'utilisateurs ne sont pas trop restrictifs