Créer des visualisations personnalisées dans Looker Studio

1. Introduction

Looker Studio vous permet de créer sans frais des tableaux de bord interactifs en direct avec de superbes visualisations des données. Récupérez vos données à partir de différentes sources et créez un nombre illimité de rapports dans Looker Studio, avec des fonctionnalités complètes d'édition et de partage. La capture d'écran suivante est un exemple de rapport Looker Studio:

ec3de192ad28e93e.png

( Cliquez ici pour afficher cet exemple de rapport dans Looker Studio).

Looker Studio propose plusieurs types de graphiques intégrés, y compris les graphiques en courbes, les graphiques à barres, les graphiques à secteurs et les graphiques à nuage de points. Les visualisations de la communauté vous permettent de créer et d'utiliser vos propres visualisations JavaScript personnalisées dans Looker Studio. Vous pouvez également partager les visualisations de votre communauté avec d'autres personnes afin qu'elles puissent les utiliser avec leurs propres données.

Points abordés

Dans cet atelier de programmation, vous allez apprendre à:

  • Fonctionnement d'une visualisation de la communauté Looker Studio
  • Créer une visualisation de la communauté à l'aide de la bibliothèque d'aide ds-component (dscc)
  • Utiliser la visualisation de votre communauté dans un rapport Looker Studio

Prérequis

Pour réaliser cet atelier de programmation, vous devez disposer des éléments suivants:

  • Accès à Internet et à un navigateur Web.
  • Un compte Google.
  • Accès à un bucket de stockage Google Cloud Platform.
  • Bonne connaissance de JavaScript.

2. Enquête rapide

Pourquoi avez-vous choisi cet atelier de programmation ?

<ph type="x-smartling-placeholder"></ph> Je m'intéresse à la visualisation des données en général. Je souhaite en savoir plus sur Looker Studio. Je souhaite créer ma propre visualisation de la communauté. J'essaie d'intégrer Looker Studio à une autre plate-forme. Je suis intéressé par les solutions Google Cloud.

Comment prévoyez-vous d'utiliser cet atelier de programmation/ce tutoriel ?

<ph type="x-smartling-placeholder"></ph> Parcourez uniquement. Lisez-le et effectuez les exercices.

Comment évalueriez-vous votre expérience avec Looker Studio ?

<ph type="x-smartling-placeholder"></ph> Je n'en ai jamais entendu parler. Je sais à quoi il sert, mais je ne l'utilise pas. Je l'utilise occasionnellement. Je l'utilise régulièrement. Je suis un utilisateur expérimenté.

Qu'est-ce qui décrit le mieux votre parcours ?

<ph type="x-smartling-placeholder"></ph> Développeur. Concepteur / Spécialiste UX. Analyste commercial / de données / financier. Data scientist / Ingénieur de données. Spécialiste du marketing, des réseaux sociaux et du digital analytics. Autre :

Quelles bibliothèques de visualisation JavaScript souhaitez-vous utiliser ?

<ph type="x-smartling-placeholder"></ph> D3.js Graphiques Google Chart.js Brochette Highcharts Plot.ly Autre
.

Passez à la page suivante pour envoyer les informations de l'enquête.

3. Présentation des visualisations de la communauté

Les visualisations de la communauté Looker Studio vous permettent de créer et d'utiliser des visualisations JavaScript personnalisées dans vos tableaux de bord.

Dans cet atelier de programmation, vous allez créer une visualisation de la communauté sous forme de tableau compatible avec une dimension, une métrique et un style d'en-tête de tableau.

cde32c0546ea89af.gif

4. Workflow de développement de visualisations de la communauté

Pour créer une visualisation de la communauté, vous avez besoin des fichiers suivants dans un bucket de stockage Google Cloud Platform, que vous créerez ultérieurement:

Nom de fichier

Type de fichier

Objectif

manifest.json*

JSON

Métadonnées sur la visualisation et les emplacements de toutes les ressources de visualisation.

viz-codelab.json

JSON

Options de configuration des données et des styles pour le panneau "Propriétés"

viz-codelab.js

JavaScript

Code JavaScript pour le rendu de la visualisation.

viz-codelab.css (facultatif)

CSS

Styles CSS pour la visualisation.

*Le fichier manifeste est le seul fichier dont le nom est obligatoire. Les autres fichiers peuvent être nommés différemment, à condition que leur nom/emplacement soit spécifié dans le fichier manifeste.

5. Écrivez un message "Hello, world!" visualisation

Dans cette section, vous allez ajouter le code requis pour afficher un simple "Hello, world!" la visualisation.

Écrire la source JavaScript de la visualisation

Étape 1:Téléchargez le fichier dscc.min.js à partir de la page Bibliothèque de composants de la communauté Looker Studio (dscc) et copiez-le dans votre répertoire de travail.

Étape 2:Copiez le code suivant dans un éditeur de texte et enregistrez-le sous le nom viz-codelab-src.js dans votre répertoire de travail local.

viz-codelab-src.js

function drawViz(data) {

  // Container setup.
  let container = document.getElementById('container');
  if (container) {
    container.textContent = '';
  } else {
    container = document.createElement('div')
    container.id = 'container'
    document.body.appendChild(container);
  }

  // Render the viz.
  container.textContent = 'Hello, viz world!';

}

// Subscribe to data and style changes. Use the table format for data.
dscc.subscribeToData(drawViz, { transform: dscc.tableTransform });

Préparer le fichier du groupe JavaScript

Étape 3:Combinez tous les éléments JavaScript requis dans un seul fichier en copiant le contenu de la bibliothèque d'aide à la visualisation (dscc.min.js) et votre fichier viz-codelab-src.js dans un nouveau fichier nommé viz-codelab.js. Vous pouvez exécuter les commandes suivantes pour concaténer les fichiers. Répétez cette étape chaque fois que vous mettez à jour le code de la visualisation source.

Script de concaténation Linux/Mac OS

cat dscc.min.js > viz-codelab.js
echo >> viz-codelab.js
cat viz-codelab-src.js >> viz-codelab.js

Script de concaténation Windows

del viz-codelab.js
type nul > viz-codelab.js
type dscc.min.js >> viz-codelab.js
echo.>> viz-codelab.js
type viz-codelab-src.js >> viz-codelab.js

6. Écrire le code CSS de la visualisation

Le fichier CSS est facultatif et définit le style de votre visualisation. Copiez le code CSS suivant et enregistrez-le sous le nom viz-codelab.css..

viz-codelab.css

table {
    width: 100%;
    border-collapse: collapse;
}

tr {
    border-bottom: 1pt solid #d1d1d1;
}

th, td {
    padding: 8px;
    text-align: left;
}

7. Écrire la configuration JSON

La configuration de la visualisation définit les attributs de données et de style pris en charge et requis par votre visualisation. Cette visualisation de cet atelier de programmation nécessite une dimension et une métrique, et comporte un élément de style pour sélectionner une couleur de remplissage. En savoir plus sur les dimensions et les métriques

Copiez le code suivant et enregistrez-le sous le nom viz-codelab.json.. Pour en savoir plus sur les propriétés que vous pouvez configurer, consultez la documentation de référence sur la configuration de la visualisation de la communauté.

viz-codelab.json

{
    "data": [
        {
            "id": "concepts",
            "label": "Concepts",
            "elements": [
                {
                    "id": "tableDimension",
                    "label": "Dimension",
                    "type": "DIMENSION",
                    "options": {
                        "min": 1,
                        "max": 1
                    }
                },
                {
                    "id": "tableMetric",
                    "label": "Metric",
                    "type": "METRIC",
                    "options": {
                        "min": 1,
                        "max": 1
                    }
                }
            ]
        }
    ],
    "style": [
        {
            "id": "header",
            "label": "Table Header",
            "elements": [
                {
                    "type": "FILL_COLOR",
                    "id": "headerBg",
                    "label": "Header Background Color",
                    "defaultValue": "#e0e0e0"
                }
            ]
        }
    ]
}

8. Créer un projet et un bucket Cloud Storage

Étape 1 : Créez un projet Google Cloud Platform (GCP) ou utilisez un projet existant.

Étape 2 : Créez un bucket GCP. La classe de stockage recommandée est régionale. Pour en savoir plus sur les niveaux sans frais, consultez la page Tarifs de Cloud Storage. Remarque: Il est peu probable que le stockage de vos visualisations engendre des coûts pour la classe de stockage régional.

Étape 3:Notez le nom/le chemin d'accès de votre bucket, en commençant par la section située après Buckets/. Le chemin d'accès est appelé "ID du composant". dans Looker Studio, et permet d'identifier et de déployer une visualisation.

49cd3d8692e6bf51.png

9. Écrire le fichier manifest.json

Le fichier manifeste fournit des informations sur l'emplacement et les ressources de votre visualisation. Il doit être nommé "manifest.json" et se trouver dans le bucket/chemin créé à l'étape précédente (même chemin d'accès que celui utilisé pour votre ID de composant).

Copiez le code suivant dans un éditeur de texte et enregistrez-le sous le nom manifest.json..

Pour en savoir plus sur le fichier manifeste, consultez la documentation de référence associée.

manifest.json

{
    "name": "Community Visualization",
    "logoUrl": "https://raw.githubusercontent.com/googledatastudio/community-visualizations/master/docs/codelab/img/table-chart.png",
    "organization": "Looker Studio Codelab",
    "organizationUrl": "https://url",
    "termsOfServiceUrl": "https://url",
    "supportUrl": "https://url",
    "packageUrl": "https://url",
    "privacyPolicyUrl": "https://url",
    "description": "Community Visualization Codelab",
    "devMode": true,
    "components": [
        {
            "id": "tableChart",
            "name": "Table",
            "iconUrl": "https://raw.githubusercontent.com/googledatastudio/community-visualizations/master/docs/codelab/img/table-chart.png",
            "description": "A simple table chart.",
            "resource": {
                "js": "gs://MY_GOOGLE_CLOUD_STORAGE_BUCKET/viz-codelab.js",
                "config": "gs://MY_GOOGLE_CLOUD_STORAGE_BUCKET/viz-codelab.json",
                "css": "gs://MY_GOOGLE_CLOUD_STORAGE_BUCKET/viz-codelab.css"
            }
        }
    ]
}

10. Importer vos fichiers de visualisation dans Google Cloud Storage

  1. Importez les fichiers manifest.json, viz-codelab.js, viz-codelab.json et viz-codelab.css dans votre bucket Google Cloud Storage à l'aide de l'interface Web ou de l'outil de ligne de commande gsutil. Répétez cette opération chaque fois que vous mettez à jour votre visualisation.

84c15349e32d9fa6.png

Commandes d'importation gsutil

gsutil cp -a public-read manifest.json gs://MY_GOOGLE_CLOUD_STORAGE_BUCKET
gsutil cp -a public-read viz-codelab.* gs://MY_GOOGLE_CLOUD_STORAGE_BUCKET

11. Tester votre visualisation de la communauté dans Looker Studio

5ce4532d02aac5e8.gif

Créer un rapport et ajouter des données

Étape 1:Copiez l'URL de l'exemple d'ensemble de données de visualisation de la communauté. Vous pouvez également utiliser la source de données de votre choix et ignorer les étapes suivantes.

Étape 2 : Connectez-vous à Looker Studio. En haut à gauche, cliquez sur + Créer, puis sélectionnez Rapport.

Étape 3:l'éditeur de rapports s'ouvre, avec le panneau Ajouter des données au rapport ouvert.

Étape 4:Dans l'onglet Associer à des données, sélectionnez le connecteur Google Sheets by Google.

Étape 5:Sélectionnez URL et collez l'URL de la feuille de calcul Google Sheets de l'étape 1.

Étape 6:En bas à droite, cliquez sur Ajouter.

Étape 7: Si vous êtes invité à confirmer l'option Vous êtes sur le point d'ajouter des données à ce rapport,cliquez sur AJOUTER AU RAPPORT. Un rapport sans titre est créé, et un tableau par défaut contenant des exemples de données est ajouté au rapport. Si vous le souhaitez, vous pouvez sélectionner et supprimer le tableau par défaut pour récupérer un rapport vide.

Ajouter la visualisation de votre communauté au rapport

Étape 1:dans la barre d'outils, cliquez sur Composants et visualisations de la communauté 1d6173ab730fc552.png .

Étape 2:Cliquez sur + Explorer plus pour ouvrir la galerie de la communauté.

Étape 3:Cliquez sur Créer votre propre visualisation.

Étape 4:sous Tester et ajouter votre visualisation de la communauté, saisissez le chemin d'accès au fichier manifeste, puis cliquez sur Envoyer. Le chemin d'accès au fichier manifeste correspond au nom du bucket Google Cloud Storage et au chemin d'accès qui pointent vers l'emplacement du fichier manifeste de votre visualisation, précédé de gs://.. Par exemple: gs://community-viz-docs/viz-codelab. Si vous avez saisi un chemin d'accès au fichier manifeste valide, une fiche de visualisation devrait s'afficher.

Étape 5:Cliquez sur la fiche de visualisation pour l'ajouter à votre rapport.

Étape 6:Si vous y êtes invité, autorisez l'affichage de la visualisation.

Étape 7:Vous pouvez éventuellement mettre à jour la dimension et la métrique sélectionnées pour le tableau. Si vous utilisez l'ensemble d'échantillons de données fourni, définissez la dimension sur Pays et la métrique sur Population. Cela n'aura aucun effet sur la visualisation avant la fin de l'atelier de programmation.

Le panneau des propriétés situé à droite reflète les éléments configurés dans viz-codelab.json.

Dans le panneau Configuration, la visualisation comprend une dimension et une métrique.

6ebe61619e340878.png

Sous le panneau Style, la visualisation comporte un seul élément pour appliquer un style à l'en-tête du tableau. À ce stade, la commande de style n'aura aucun effet sur la visualisation tant que le code de la visualisation n'aura pas été mis à jour ultérieurement. Remarque: Vous verrez pour votre visualisation des options de style supplémentaires que vous n'avez pas définies dans le fichier de configuration. C'est normal, car toutes les visualisations ont un ensemble de commandes communes qui sont automatiquement disponibles.

2b78982c01d6359f.png

12. Afficher les données sous forme de table

Dans cette section, vous allez mettre à jour votre visualisation pour afficher l'ensemble de données d'exemple de visualisation de la communauté sous forme de tableau.

Les données à afficher sont disponibles dans l'objet tables et sont structurées en fonction de la transformation spécifiée par votre visualisation. Dans cet atelier de programmation, la visualisation a demandé le format de table (tableTransform), qui comprend un objet headers et un objet rows contenant toutes les données dont nous avons besoin pour afficher une table.

Étape 1:Remplacez le contenu de viz-codelab-src.js par le code ci-dessous.

viz-codelab-src.js

function drawViz(data) {

  // Container setup.
  let container = document.getElementById('container');
  if (container) {
    container.textContent = '';
  } else {
    container = document.createElement('div')
    container.id = 'container'
    document.body.appendChild(container);
  }

  // Create the table.
  const table = document.createElement('table');
  const tableHeader = document.createElement('thead');
  const tableBody = document.createElement('tbody');

  data.tables.DEFAULT.headers.forEach(function (column) {
    const tableColumn = document.createElement('th');
    tableColumn.textContent = column.name;
    tableHeader.appendChild(tableColumn);
  });

  data.tables.DEFAULT.rows.forEach(function(row) {
    const tableRow = document.createElement('tr');
    row.forEach(function(cell) {
      const tableCell = document.createElement('td');
      if (typeof cell == 'number') {
        tableCell.textContent = new Intl.NumberFormat().format(cell);
      } else {
        tableCell.textContent = cell;
      }
      tableRow.appendChild(tableCell);
    });
    tableBody.appendChild(tableRow);
  });
  table.appendChild(tableHeader);
  table.appendChild(tableBody);

  // Render the table.
  container.appendChild(table);

}

// Subscribe to data and style changes. Use the table format for data.
dscc.subscribeToData(drawViz, { transform: dscc.tableTransform });

Étape 2:préparez le fichier de groupe JavaScript, puis importez et écrasez vos fichiers de visualisation dans Google Cloud Storage.

Étape 3:Actualisez le rapport Looker Studio pour actualiser et tester votre visualisation de la communauté. Le tableau affiche désormais les données (c'est-à-dire la feuille de calcul Google Sheets) et affiche les colonnes d'en-tête en fonction de la dimension et de la métrique sélectionnées. Redimensionnez la visualisation pour afficher toutes les lignes.

66db5bde61501b01.png

13. Appliquer dynamiquement les modifications de style

Dans cette section, vous allez mettre à jour la visualisation pour appliquer un style à l'en-tête du tableau en fonction de la couleur de remplissage sélectionnée dans le panneau Style.

L'état de tous les éléments de style est disponible dans l'objet style, où chaque clé d'élément est définie en fonction de la configuration de votre style de visualisation (viz-codelab.json). Pour cette section, vous obtiendrez la couleur de remplissage sélectionnée et vous l'utiliserez pour mettre à jour la couleur d'arrière-plan de l'en-tête du tableau.

Étape 1:Remplacez le code de votre fichier viz-codelab-src.js par le code ci-dessous.

viz-codelab-src.js

function drawViz(data) {

  // Container setup.
  let container = document.getElementById('container');
  if (container) {
    container.textContent = '';
  } else {
    container = document.createElement('div')
    container.id = 'container'
    document.body.appendChild(container);
  }

  // Create the table.
  const table = document.createElement('table');
  const tableHeader = document.createElement('thead');
  const tableBody = document.createElement('tbody');

  data.tables.DEFAULT.headers.forEach(function (column) {
    const tableColumn = document.createElement('th');
    tableColumn.textContent = column.name;
    tableHeader.appendChild(tableColumn);
  });

  data.tables.DEFAULT.rows.forEach(function(row) {
    const tableRow = document.createElement('tr');
    row.forEach(function(cell) {
      const tableCell = document.createElement('td');
      if (typeof cell == 'number') {
        tableCell.textContent = new Intl.NumberFormat().format(cell);
      } else {
        tableCell.textContent = cell;
      }
      tableRow.appendChild(tableCell);
    });
    tableBody.appendChild(tableRow);
  });
  table.appendChild(tableHeader);
  table.appendChild(tableBody);

  // Set header color based on style control.
  tableHeader.style.backgroundColor = data.style.headerBg.value.color;

  // Render the table.
  container.appendChild(table);

}

// Subscribe to data and style changes. Use the table format for data.
dscc.subscribeToData(drawViz, { transform: dscc.tableTransform });

Étape 2:préparez le fichier de groupe JavaScript, puis importez et écrasez vos fichiers de visualisation dans Google Cloud Storage.

Étape 3:Actualisez le rapport Looker Studio pour actualiser et tester votre visualisation de la communauté.

Étape 4:dans le panneau Style, utilisez la commande de style Couleur d'arrière-plan de l'en-tête pour modifier la couleur d'arrière-plan de l'en-tête du tableau.

cde32c0546ea89af.gif

Félicitations ! Vous avez créé une visualisation de la communauté dans Looker Studio. Nous voici arrivés au terme de cet atelier de programmation. Voyons maintenant ce que vous pouvez faire.

14. Étapes suivantes

Étendre votre visualisation

Exploiter tout le potentiel des visualisations de la communauté

Ressources supplémentaires

Vous trouverez ci-dessous différentes ressources qui vous aideront à approfondir les sujets abordés dans cet atelier de programmation.

Type de ressource

Fonctionnalités pour les utilisateurs

Fonctionnalités pour les développeurs

Documentation

Centre d'aide

Documentation pour les développeurs

Actualités et Actualités

S'inscrire dans Looker Studio > Paramètres utilisateur

Liste de diffusion du développeur

Poser des questions

Forum des utilisateurs

Exemples

Galerie de rapports

Dépôt Open Source