La galerie de modèles de la communauté Google Tag Manager permet à votre organisation de créer et de gérer des modèles de balises et de variables qui s'intègrent de façon native à Google Tag Manager. Votre organisation peut créer un modèle, publier le référentiel de modèles sur GitHub, puis l'envoyer dans la galerie de modèles de la communauté pour le mettre à la disposition des utilisateurs du monde entier. Voici quelques-uns des avantages dont bénéficient votre organisation:
- Vos clients pourront facilement ajouter et utiliser vos modèles.
- Les utilisateurs de Tag Manager seront exposés à la marque de votre organisation.
- Vos clients pourront déployer vos balises en quelques minutes, au lieu de plusieurs mois.
- Vous pouvez publier des mises à jour de vos modèles et les mettre automatiquement à la disposition de vos clients.
Voici les principales étapes à suivre pour envoyer un nouveau modèle dans la galerie de modèles de la communauté:
- Créer votre modèle
- Préparer les fichiers de votre projet
- Importer vos fichiers sur GitHub
- Envoyer votre modèle
Créer votre modèle
Pour commencer, créez votre modèle dans Google Tag Manager en tant que modèle personnalisé. Assurez-vous que votre modèle a été minutieusement testé, que son contenu est conforme au guide de style et que vous avez mis en place un plan ou un processus d'entretien et de mise à jour de votre modèle pour une utilisation ultérieure.
Conditions d'utilisation
Chaque nouveau modèle envoyé doit accepter les conditions d'utilisation de la galerie de modèles de la communauté Google Tag Manager. Pour confirmer que vous acceptez les conditions d'utilisation de votre modèle:
- Consultez les Conditions d'utilisation de la galerie de modèles de la communauté Google Tag Manager.
- Dans l'éditeur de modèles, ouvrez votre modèle pour le modifier et cochez la case dans l'onglet Infos intitulé Accepter les conditions d'utilisation de la galerie de modèles de la communauté.
Exporter votre modèle
Une fois votre modèle terminé, exportez le fichier de modèle sur votre ordinateur local et renommez le fichier template.tpl
.
Préparer les fichiers de votre projet
L'étape suivante consiste à préparer votre dépôt pour la publication sur GitHub. Chaque dépôt doit contenir les fichiers suivants:
- Un fichier de modèle exporté nommé
template.tpl
. Vous devez mettre à jour ce fichier pour ajouter une entréecategories
. - Un fichier
metadata.yaml
. - Un fichier
LICENSE
. Le nom du fichier doit être écrit TOUT EN MAJUSCULES et le contenu du fichier de licence ne doit contenir que d'Apache 2.0. - Ajoutez un fichier
README.md
(facultatif, mais recommandé).
Ajouter des catégories à template.tpl
Mettez à jour votre fichier template.tpl
avec une entrée categories
dans la section INFO
, puis fournissez au moins une valeur de catégorie pertinente sélectionnée dans le tableau suivant. Si vous pouvez indiquer plusieurs catégories, vous pouvez indiquer jusqu'à trois valeurs, classées de la plus pertinente à la moins pertinente.
Exemple :
___INFO___
{
"displayName": "Example Template",
"categories": ["AFFILIATE_MARKETING", "ADVERTISING"],
// additional template properties, etc...
}
Tableau des valeurs de catégorie acceptées:
Catégorie | Description |
---|---|
PUBLICITÉ | Publicité |
AFFILIATE_MARKETING | Affiliation |
ANALYTICS | Analyse |
ATTRIBUTION | Attribution |
CHAT | Chat |
CONVERSIONS | Mesure des conversions |
DATA_WAREHOUSING | Entreposage de données |
EMAIL_MARKETING | Marketing par e-mail |
EXPÉRIMENTATION | Tests A/B et optimisation du contenu |
HEAT_MAP | Cartes thermiques |
LEAD_GENERATION | Génération de prospects |
MARKETING | Marketing |
PERSONNALISATION | Personnalisation |
REMARKETING | Remarketing |
PROMOTIONS | Ventes et CRM |
SESSION_RECORDING | Enregistrements de sessions |
SOCIAL | Réseau social |
ENQUÊTE | Enquêtes |
TAG_MANAGEMENT | Systèmes de gestion de balises |
EFFICACITÉ | Utilitaires Google Tag Manager |
metadata.yaml
Le fichier metadata.yaml
contient des informations sur votre modèle, y compris des liens vers la page d'accueil de votre organisation, la documentation du modèle et des informations sur la version. Chaque version est indiquée par un numéro de modification, également appelé numéro SHA, qui correspond au numéro de modification associé au commit Git. Le champ changeNotes
est facultatif, mais recommandé, pour informer vos utilisateurs des modifications incluses dans la version.
Pour configurer votre fichier metadata.yaml
:
- Ajoutez une entrée
homepage
. Il doit s'agir d'une URL qui pointe vers la page d'accueil de votre organisation. - Ajoutez une entrée pour
documentation
. Cette URL doit rediriger vers la documentation de votre modèle. - Dans GitHub, recherchez le commit qui inclut les modifications que vous souhaitez transférer pour la version initiale de votre modèle, puis copiez le numéro SHA. Pour obtenir facilement le numéro SHA dans GitHub, vous pouvez accéder à une vue commit et cliquer sur l'icône du presse-papiers (). Le numéro SHA sera alors copié entièrement dans votre presse-papiers. Collez ce nombre en tant que valeur de l'entrée
sha
en tant qu'enfant du nœudversions
, comme indiqué ci-dessous. - Ajoutez une entrée
changeNotes
au nœudversions
pour décrire brièvement les modifications incluses dans cette nouvelle version.
homepage: "https://www.example.com"
documentation: "https://www.example.com/documentation"
versions:
- sha: 5f02a788b90ae804f86b04aa24af8937e567874a
changeNotes: Initial release.
Importer dans GitHub
L'étape suivante consiste à importer vos fichiers sur GitHub. Créez un dépôt GitHub avec les fichiers et la structure appropriés, comme indiqué ci-dessus.
Les fichiers template.tpl
, metadata.yaml
et LICENSE
doivent se trouver au niveau racine du dépôt Git dans les dépôts de modèles. Chaque dépôt Git ne doit contenir qu'un seul fichier template.tpl
. Toutes les ressources doivent se trouver dans la branche principale de votre dépôt GitHub. Tout dépôt de modèles qui ne correspond pas à cette structure sera supprimé de la galerie.
Chaque entrée de la galerie de modèles de la communauté renvoie vers la section Issues (Problèmes) du dépôt GitHub du modèle, afin que les utilisateurs puissent vous faire savoir s'ils ont détecté un bug. Assurez-vous que les problèmes n'ont pas été désactivés pour le dépôt GitHub de votre modèle afin de pouvoir examiner et résoudre les éventuels problèmes.
Envoyer votre modèle
Une fois votre dépôt de modèles hébergé sur GitHub, vous pouvez envoyer votre modèle dans la galerie de modèles de la communauté. Pour envoyer votre modèle, procédez comme suit:
- Assurez-vous d'être connecté à GitHub avec un compte ayant accès au dépôt de modèles que vous souhaitez ajouter à la galerie.
- Accédez à la galerie de modèles de la communauté à l'adresse tagmanager.google.com/gallery.
- Cliquez sur more_vert, puis sélectionnez Envoyer le modèle.
- Indiquez l'URL du dépôt dans le champ prévu à cet effet, puis cliquez sur Envoyer.
Mettre à jour votre modèle
Après avoir publié un modèle, vous pouvez le mettre à jour de temps en temps. Les utilisateurs de votre modèle seront avertis en cas de mise à jour et auront la possibilité de mettre à jour le modèle vers la dernière version.
Le fichier metadata.yaml
permet de déterminer la version de votre modèle à utiliser dans la galerie. Pour publier de nouvelles versions, vous devez ajouter le numéro de modification (numéro SHA) à la section versions
de votre fichier metadata.yaml
.
- Recherchez le commit qui contient les modifications que vous souhaitez transférer et copiez le numéro SHA. Dans GitHub, un moyen simple est d'accéder à une vue de commit et de cliquer sur l'icône du presse-papiers (). Le numéro SHA sera alors copié entièrement dans votre presse-papiers.
- Ajoutez une nouvelle entrée
sha
en haut de votre listeversions
dansmetadata.yaml
. (voir l'exemple ci-dessous). - Ajout de
changeNotes
pour décrire brièvement les modifications apportées à cette nouvelle version. Si vous le souhaitez, vous pouvez créer des commentaires multilignes. (voir l'exemple ci-dessous). - Validez la modification dans
metadata.yaml
. Votre mise à jour apparaîtra dans la galerie sous deux à trois jours (en général).
Cet exemple montre comment ajouter des informations de nouvelle version, y compris le numéro SHA et des notes de modification:
homepage: "https://www.example.com"
documentation: "https://www.example.com/documentation"
versions:
# Latest version
- sha: 5f02a788b90ae804f86b04aa24af8937e567874c
changeNotes: |2
Fix bug with the whatsamajig.
Improve menu options.
Update API calls.
# Older versions
- sha: 5f02a788b90ae804f86b04aa24af8937e567874b
changeNotes: Adds eject button.
- sha: 5f02a788b90ae804f86b04aa24af8937e567874a
changeNotes: Initial release.