Dans ce guide étape par étape, je vais vous montrer comment créer un Générateur de table de consultation dans Google Sheets, en utilisant Apps Script et l’API Google Tag Manager.
L’objectif du générateur de table de consultation est d’automatiser la tâche souvent fastidieuse consistant à ajouter de très nombreuses lignes à une table de consultation dans l’interface utilisateur de Google Tag Manager. Il existe d’autres solutions pour cela, mais aucune (pour autant que je sache) qui utilise l’API Google Tag Manager.
De plus, l’utilisation de Google Sheets est une évidence, en raison des similitudes entre la variable Lookup Table et une feuille de calcul. Les deux sont organisés en colonnes et en lignes. Google Sheets a une merveilleuse intégration Apps Script, donc l’interaction avec l’API GTM a été faite très Facile.
Cet outil a été inspiré par le travail que j’ai effectué avec Swappie, une entreprise finlandaise qui remet à neuf des smartphones d’occasion et dispose d’un marché qui rend l’achat et la vente de ces téléphones faciles et sûrs. L’un de leurs cas d’utilisation pour l’analyse Web consiste à collecter marge du produit des informations dans leurs rapports de commerce électronique, ce qui nécessite une fiche technique mise à jour quotidiennement dans laquelle les SKU des produits sont mappés sur leurs marges de produit actuelles.
Récupérer le modèle de feuille
La première chose que vous voudrez faire est de récupérer le modèle de feuille. Visitez cette URL :
https://docs.google.com/spreadsheets/d/1LDJ6NOtMMx_5vwRBdPAx9V0gTLnce-7aglQzSm-Ja7M/
Ensuite, cliquez sur le Dossier menu et sélectionnez Faire une copie.
Cela crée une copie de la feuille dans votre lecteur, et cette nouvelle feuille est ce sur quoi vous allez travailler.
Configurer la feuille
Ensuite, configurez la feuille. Pour que le générateur de table de consultation fonctionne de manière optimale, vous aurez besoin des éléments suivants :
- Vous devez créer un nouvel espace de travail uniquement pour la sortie de la table de consultation. De cette façon, vous n’avez pas à vous soucier de jouer avec l’espace de travail par défaut (qui devrait rarement, voire jamais, être utilisé).
- Vous devez créer la variable Lookup Table dans l’espace de travail.
Une fois ces deux éléments en place, vous devez collecter les identifiant de compte, Identifiant du conteneur, ID de l’espace de travailet ID de variable de la table de consultation. La façon la plus simple de le faire est de naviguer jusqu’à variables dans l’interface utilisateur GTM, puis clic-droit la variable Lookup Table et copiez son adresse de lien.
Si vous explorez cette URL, elle ressemblera à ceci :
.../accounts/23019854/containers/8060344/workspaces/1000128/variables/730
Les identifiant de compte est le première numéro dans cette URL, c’est-à-dire 23019854.
Les Identifiant du conteneur est le seconde numéro dans cette URL, c’est-à-dire 8060344.
Les ID de l’espace de travail est le troisième numéro dans cette URL, c’est-à-dire 1000128.
Les ID variable est le Quatrième numéro dans cette URL, c’est-à-dire 730.
Ajoutez-les à la feuille aux endroits appropriés. Note! Vous pouvez également taper default comme ID d’espace de travail, et il récupérera automatiquement votre espace de travail par défaut, en supposant qu’il s’agit de l’espace de travail dans lequel vous souhaitez travailler. Encore une fois, je déconseille cette pratique. Ce n’est pas la façon dont les espaces de travail doivent être utilisés.
Ajouter le code AppsScript
Ensuite, dans Google Sheet, lancez le Éditeur de scripts. Cliquez sur Outils puis choisissez Éditeur de scripts.
Si c’est la première fois que vous utilisez l’éditeur de scripts, vous devrez peut-être passer par quelques étapes, mais vous devriez éventuellement voir ceci :
La prochaine chose à faire est de Renommer le projet. Clique le Untitled project texte dans le coin supérieur gauche, et renommez le projet par exemple Lookup Table Generator. Une fois que vous avez cliqué D’ACCORDle projet sera enregistré et vous pourrez accéder à ses détails via script.google.com.
Maintenant, effacer tout le code dans l’éditeur, et remplacez-le par le code copié-collé de cet essentiel.
N’oubliez pas de cliquer sur le Brut pour obtenir le code au format texte brut, prêt à être copié-collé dans l’éditeur de script.
Procédure pas à pas de code
Je ne vais pas vous expliquer étape par étape le code, mais je vais brièvement vous présenter ce que chaque méthode Est-ce que.
| Méthode | La description |
|---|---|
getIds | Analyse la feuille Google pour les ID (ID de compte, ID de conteneur, ID d’espace de travail, ID de variable) que l’utilisateur a ajoutés aux emplacements appropriés. |
getDefaultWorkspaceId | Si l’utilisateur a tapé default comme ID d’espace de travail, ou si l’ID d’espace de travail qu’ils ont donné n’existe pas, la feuille revient à « l’espace de travail par défaut ». Cette méthode récupère son ID d’espace de travail. |
getLookupTable | Cette méthode utilise l’API Google Tag Manager pour récupérer la variable de table de consultation vers laquelle pointe l’ID de variable. |
sendData | Les données de la feuille de calcul Google sont collectées, mappées au format de ressource d’API approprié et envoyées à Google Tag Manager. Le contenu de la feuille est utilisé pour mettre à jour (c’est-à-dire remplacer) le contenu de la variable Lookup Table dans le conteneur GTM. |
populateSheet | Cette méthode utilise les identifiants (de getIds) pour récupérer le contenu actuel de la variable Lookup Table dans Google Sheet. |
Finaliser la configuration d’Apps Script
En plus du code, vous devez également activer l’accès à l’API dans l’éditeur de script. Cliquez sur Ressources et sélectionnez Services Google avancés...
Dans la superposition qui s’ouvre, faites défiler jusqu’à Tagmanagerassurez-vous qu’il a v2 sélectionné comme version, puis activez-le en cliquant sur la bascule à la fin.
Cliquez sur D’ACCORD lorsque vous avez terminé.
Test avec la récupération de données
Pour tester rapidement si le code fonctionne, sélectionnez le populateSheet fonction dans le menu approprié de l’éditeur de script.
Ensuite, appuyez sur la Jouer juste à gauche de l’icône “Bug” dans la barre d’outils de l’éditeur de script.
Le script devrait maintenant demander une autorisation. Cliquez sur Autorisations de révision.
Suivez les invites de connexion jusqu’à ce que vous voyiez l’invite “Cette application n’est pas vérifiée”. Cet écran signifie que Google n’a pas vérifié cette application encore. Il utilise des API qui peuvent être dangereuses entre de mauvaises mains, c’est pourquoi Google met en garde contre cette application.
Puisque nous le construisons pour un usage interne uniquement, vous n’avez pas à vous soucier de cette invite. Vous pouvez cliquer sur le Avancé lien puis le Aller à votre projet (peu sûr) lien.
Enfin, cliquez sur le Permettre bouton en bas du dernier écran du flux.
À ce stade, le script s’exécutera. Une fois qu’il est terminé, vous pouvez revenir dans votre feuille de calcul Google pour la voir remplie avec le contenu de la variable Lookup Table.
Test avec la mise à jour des données
Essayons de mettre à jour la variable avec les données de la feuille.
Effectuez d’abord les modifications souhaitées avec le contenu de la feuille.
Note! Ne touchez pas le Contribution et Sortir en-têtes. Commencez à modifier la feuille à partir de la ligne après celles-ci.
Ensuite, retournez à Script Editor, et cette fois choisissez sendData dans la liste des fonctions à exécuter. Cliquez à nouveau sur le bouton Lecture.
Si tout fonctionne bien, vous devriez maintenant pouvoir voir la variable de table de consultation modifiée dans l’espace de travail de l’interface utilisateur de Google Tag Manager.
Mappez les boutons dans la feuille
Enfin, pour rendre la feuille un peu plus facile à utiliser, mappons les deux boutons de la feuille à leurs fonctions correspondantes.
Faites un clic droit sur le Récupérer des données bouton, cliquez sur le petit menu d’action dans le coin supérieur droit et choisissez Attribuer un script.
Taper populateSheet dans l’invite qui s’ouvre et cliquez sur OK.
Ensuite, faites de même pour le Mettre à jour les données bouton, mais au lieu de populateSheet taper sendData dans l’invite avant de cliquer sur OK.
Maintenant, chaque fois que quelqu’un clique sur le Récupérer des données bouton, le script remplira la feuille avec les détails de la variable (en supposant que l’utilisateur qui clique sur le bouton dispose d’un accès autorisé à Google Tag Manager). Chaque fois que quelqu’un clique sur le Mettre à jour les données le script mettra à jour la variable Lookup Table dans Google Tag Manager avec le contenu de la feuille.
Si vous souhaitez modifier à nouveau le bouton, vous devez faites un clic droit dessuscar un clic gauche exécutera simplement le script.
Résumé
J’espère que cette preuve de concept a été facile à suivre. Avec ces étapes, vous pouvez créer un générateur de table de consultation à usage interne.
Il y a des limites à combien le script peut être exécuté sans vérification. Vous voudrez jeter un œil à cette documentation pour comprendre les étapes à suivre si vous souhaitez vous débarrasser des avertissements de sécurité.
Fondamentalement, si le script n’est destiné qu’à une utilisation occasionnelle par le développeur (vous), ou si le script est destiné à être utilisé uniquement par les utilisateurs de votre Organisation G Suitevous n’avez pas besoin de vérifier l’application.
Pour tout autre type d’utilisation prolongée, l’application doit être vérifiéet il s’agit d’un processus complexe et souvent fastidieux.
Google Sheets + Google Apps Script est l’un des flux d’automatisation les plus puissants et les plus facilement accessibles. Cela nécessite une compréhension minimale de Google Cloud Platform, car presque tout est abstrait dans le bac à sable Apps Script.
