Les options de données et de style d'une visualisation de la communauté sont définies dans un fichier de configuration JSON. La configuration data
définit le nombre de dimensions et de métriques acceptées par la visualisation. La configuration style
définit les sélecteurs de style disponibles dans le panneau des propriétés.
Configuration des données
La configuration data
définit les éléments DIMENSION et METRIC que Looker Studio affiche dans le panneau des propriétés. Chaque élément correspond à des champs de dimension et d'élément que l'utilisateur final fournit en tant qu'entrées dans la visualisation.
Exemple d'élément de données:
{
"id": "twoDimensionsPlease",
"label": "Dimension Element Heading",
"type": "DIMENSION",
"options": {
"min": 2,
"max": 2,
}
}
La id
que vous définissez dans l'élément de données est incluse dans les informations avec lesquelles Looker Studio répond. Le label
définit le texte que les utilisateurs voient au-dessus de la section des données, tandis que le type
détermine s'il s'agit d'une dimension ou d'une métrique. L'objet options
définit les nombres minimal et maximal de champs qu'un utilisateur peut ajouter à l'élément de données.
Dans un élément de données DIMENSION, l'objet options
accepte une clé supportedTypes
facultative. S'il est défini, Looker Studio limite le type des champs de dimension pouvant être ajoutés à l'élément. La valeur de supportedTypes
est un tableau qui peut contenir n'importe quelle combinaison de "DEFAULT", "TIME" et "GEO".
Une section de données regroupe plusieurs éléments de données. Looker Studio affiche la label
sous la forme d'un en-tête pour plusieurs éléments de données.
Section "Exemple de données" :
{
"id": "dimensionSection1",
"label": "Dimension Section Heading",
"elements":[
// array of data elements
]
}
Cette capture d'écran montre comment Looker Studio affiche la section des données et l'élément de données ci-dessus:
Configuration du style
La configuration du style définit les sélecteurs de style affichés dans le panneau des propriétés.
Exemple d'élément de style:
{
"id": "linkOpacity",
"label": "Link opacity",
"type": "OPACITY",
"defaultValue": "0.2"
}
label
définit le texte que les utilisateurs voient sous forme d'info-bulle, tandis que type
définit le type de sélecteur de style affiché par Looker Studio. Si vous le souhaitez, defaultValue
définit une valeur par défaut pour chaque élément de style.
Comme pour les éléments de données, les éléments de style sont définis dans des sections, qui fournissent des en-têtes et des regroupements logiques. Pour afficher la liste complète des sélecteurs disponibles, consultez la documentation de référence sur les configurations.
Exemple de section de style:
{
"id": "styleGroup1",
"label": "Header for style group",
"elements": [
// insert Style Elements here
]
}
La capture d'écran suivante montre un exemple de panneau de style avec un sélecteur d'opacité, avec l'info-bulle "Opacité du lien" correspondant à label
dans l'élément de style.
Configuration des interactions
La configuration interaction
définit le fonctionnement des interactions dans les graphiques pour une visualisation de la communauté. Cette opération est facultative.
Exemple :
{
"id": "onClick",
"supportedActions": ["FILTER"]
}
Pour le moment, seul le type FILTER
est compatible. Si vous configurez des interactions, une case à cocher s'affiche dans le panneau des propriétés.
Configuration des fonctionnalités
La configuration features
permet d'activer ou de désactiver différentes fonctionnalités dans votre visualisation de la communauté. Cette rubrique est facultative. La liste des fonctionnalités est disponible dans la documentation de référence.
Exemple :
"features": {
"enableComparisonDateRange": true
}
Exemple
Pour voir un exemple de configuration de visualisation, consultez l'exemple de configuration.
Étapes suivantes
Une fois que vous avez défini votre configuration, écrivez la visualisation.