InMy.Live

Le Analyse de chasse-neige le modèle de tag personnalisé est un officiel modèle de balise pour la galerie de modèles communautaires de Google Tag Manager.

Description

Ce modèle implémente le tracker JavaScript Snowplow Analytics. Le modèle prend en charge l’ensemble des fonctionnalités du tracker, à quelques exceptions près en raison des limitations du JavaScript en bac à sable des modèles personnalisés.

Installer le modèle

Pour installer le modèleaccédez à Modèles dans l’interface utilisateur de Google Tag Manager.

Sous Modèles de balisesCliquez sur Rechercher dans la galerieet tapez snowplow dans la barre de recherche superposée de la galerie.

Clique le Analyse de chasse-neige nom du modèle, puis cliquez sur Ajouter à l’espace de travail dans l’écran suivant. Vérifiez les autorisations et cliquez sur Ajouter pour finaliser l’importation.

Après avoir importé le modèle, vous pouvez suivre le processus normal de création d’un nouvelle étiquette dans Google Tag Manager, et le Analyse de chasse-neige modèle sera répertorié parmi les Coutume types de balises parmi lesquels vous pouvez choisir.

Mises en garde

Pour commencer, quelques-unes des mises en garde concernant l’utilisation du modèle personnalisé.

• Toutes les méthodes qui nécessitent l’analyse des éléments HTML (par exemple, les fonctions de filtre de suivi des liens) ne fonctionneront pas et sont donc désactivées.
• Le suivi automatique des erreurs ne fonctionne pas en raison du manque de prise en charge du ErrorEvent API.
• Il n’y a pas d’implémentation pour les événements de commerce électronique standard. Les utilisateurs sont encouragés à mettre en œuvre la configuration de commerce électronique améliorée à la place.

Instructions

Voici des instructions de base sur la façon d’instrumenter le tracker JavaScript. Nous vous encourageons à consulter la documentation technique pour plus d’informations sur chaque fonctionnalité individuelle.

En général, lorsque la balise se déclenche, elle vérifie d’abord si la bibliothèque JavaScript Snowplow a été chargée à partir de l’URL auto-hébergée fournie dans les paramètres du modèle (plus d’informations ci-dessous). Ensuite, la balise vérifie si un tracker avec le Nom du suivi a déjà été initialisé. Si ce n’est pas le cas, il procède à l’initialisation du nouveau tracker.

Enfin, la balise regroupe un commande à partir des paramètres de la balise, et l’envoie à la donnée Point de terminaison du collecteur.

Nom du suivi

Le premier champ vous demande d’ajouter le nom du traceur. La raison pour laquelle plusieurs noms de tracker peuvent être générés sur le site est si vous avez différents objets de configuration ou points de terminaison de suivi auxquels vous souhaitez envoyer des commandes.

Lorsque la balise s’exécute, elle vérifie d’abord si une balise portant ce nom a déjà été initialisée. Si c’est le cas, il procède ensuite à l’envoi de la commande à ce nom de tracker. Si un traceur portant ce nom a pas initialisé, un nouveau tracker est initialisé avec la configuration du tracker dérivée de la balise (ou de la variable liée Snowplow Analytics Settings).

Cela signifie qu’une configuration de suivi est appliquée juste une fois au traqueur. Ainsi, si vous avez plusieurs balises en cours d’exécution sur le site, chacune avec le même nom de tracker mais des configurations de tracker différentes, seule la configuration de la balise qui se déclenche d’abord sera appliqué au tracker.

Nom d’hôte du point de terminaison du collecteur

Cela doit être défini sur le nom d’hôte (par exemple www.domain.com) sur lequel vous avez configuré le collecteur Snowplow Analytics.

Configuration avancée

En sautant à la fin du modèle, le Configuration avancée groupe a deux paramètres importants :

1. Nom de la méthode globale: Si vous souhaitez modifier l’espace de noms global de snowplow à autre chose (en raison d’un conflit, par exemple), modifiez la valeur de ce champ.
2. URL de la bibliothèque auto-hébergée: Vous devez héberger vous-même la bibliothèque JavaScript Snowplow. Définissez ce champ sur l’URL à partir de laquelle le navigateur téléchargera la bibliothèque JavaScript.

Mettre à jour les autorisations

Si vous changez le Nom de la méthode globale depuis snowplow à toute autre chose, vous devez faire un passer au modèle. Ouvrez le modèle pour le modifier (à partir de la section “Modèles” du conteneur) et accédez au Autorisations languette. Sous Accède aux variables globalesmodifiez les quatre autorisations commençant par le nom snowplow.

Changer le texte snowplow quel que soit votre nom de méthode préféré (il doit correspondre au nom défini dans la balise une fois que vous l’avez créée). N’oubliez pas de laisser tout le reste tel quel : autorisations et suffixes. Voici à quoi ressemblerait la liste modifiée si le nom de la méthode était remplacé par some_other_snowplow:

MISE À JOUR 18 mai 2020: Le modèle a été mis à jour pour avoir AWS Cloud Front et Stockage en nuage Google destinations prises en charge par défaut (https://*.cloudfront.net/* et https://storage.cloud.google.com/*). Si vous chargez la bibliothèque à partir de l’un ou l’autre emplacement, vous pas besoin de mettre à jour les autorisations pour injectScript!

Ensuite, une fois que vous avez la bibliothèque Snowplow auto-hébergée, vous devez mettre à jour le Injecte des scripts l’autorisation de refléter le nouvel emplacement. Supprimer le contenu du Modèles de correspondance d’URL autorisés champ, et tapez l’URL complète de la bibliothèque ici. Encore une fois, il doit correspondre à ce que vous avez saisi dans la balise elle-même lors de sa création.

Malheureusement, la modification des autorisations rompt le lien de la galerie et vous ne serez plus informé des mises à jour du modèle. Pouvoir modifier les autorisations sans avoir la rupture de lien est une demande de fonctionnalité qui, je l’espère, sera résolue très bientôt.

Type de balise

Sous Type de balise, vous pouvez choisir quel type de commande est compilé et envoyé au point de terminaison. Les types de balises sont divisés ici en trois groupes : les commandes qui utilisent un paramètres objet, les commandes qui ont conditions spécialeset commandes personnalisées.

Balises avec un objet paramètre

Les balises qui peuvent dériver leurs paramètres d’une variable Google Tag Manager sont :

• Suivi des annonces
• Suivi du panier
• Suivi des erreurs
• Consentement
• Événement auto-descriptif
• Recherche du site
• Interaction sociale
• Événement structuré
• Horaire

Vous pouvez régler le Récupérer les paramètres de la variable paramètre sur une variable Google Tag Manager. Ce paramètre devoir retourner un objet. Dans l’objet, les paires clé-valeur doivent refléter les paramètres nommés dans la documentation de l’événement. Par exemple, pour que la variable remplisse un événement d’erreur, vous pouvez utiliser une variable JavaScript personnalisée comme celle-ci :

function() {
  return {
    message: 'Some Error Happened',
    filename: 'somefile.js',
    lineno: 5,
    colno: 236,
    error: null
  }
}

Vous pouvez également définir la liste déroulante sur la valeur Noet ajoutez les paramètres manuellement à la place :

Certains types de balises ajouteront des sélections supplémentaires à cette section. Suivez la documentation officielle du tracker pour plus d’informations sur ce que fait chaque option.

Balises spéciales

Certains types de balises ont des conditions spéciales et ont été séparés dans leurs propres configurations.

Commerce électronique amélioré

Lorsque vous sélectionnez Enhanced Ecommerce, il vous reste deux options : Utiliser la couche de données ou Choisissez Variable. La façon dont cela fonctionne est très similaire à Enhanced Ecommerce dans Google Analytics.

Si vous choisissez le premier, le modèle se penchera sur le dataLayer structure pour la plus récemment poussé l’objet Enhanced Ecommerce et mappez cet objet à la demande à Snowplow Analytics.

Si vous avez sélectionné Choisissez Variablevous devez fournir une variable GTM qui renvoie un objet dans le format correct attendu.

Suivi des formulaires

Le suivi des formulaires n’a que deux options, car filtres et transformations ne fonctionnera pas avec le modèle personnalisé (en raison du manque de prise en charge du traitement des éléments HTML). Les options sont de définir le formulaire et/ou le champ listes noires et listes blanches.

Les listes noires et les listes blanches pour les formulaires sont une liste de noms de classes HTML séparés par des virgules. S’il est sur liste noire, tout élément de formulaire avec une classe répertoriée ne déclenchera pas l’événement de formulaire. Si en liste blanche, alors seul les éléments de formulaire avec un nom de classe répertorié seront suivis.

Pour les champs, les listes noires et les listes blanches fonctionnent de la même manière, sauf qu’elles utilisent le name attribut plutôt que la classe.

Suivi des clics sur les liens

Le Suivre le clic sur le lien est similaire aux événements classiques basés sur des paramètres, car il vous permet d’ajouter des paramètres et de suivre un clic sur un lien en tant qu’appel encodé manuellement.

Le Activer le suivi automatique des clics sur les liens ajoute des auditeurs à la page, qui suivra les clics sur les liens leur permettant d’adhérer aux noms de classe sur liste noire/blanche que vous pouvez éventuellement fournir.

Le Correction du suivi du clic central ajoute un correctif pour certains navigateurs où les clics du milieu n’étaient pas suivis correctement.

Si vous cochez Suivre le contenu HTML du lien cliquéle contenu du texte intégral de l’élément de lien sera également envoyé à Snowplow.

Affichage des pages

Vous pouvez fournir un Titre de page personnalisé si vous le souhaitez, et vous pouvez ajouter une fonction de contexte personnalisée à la requête.

Si vous activez Suivi de l’activité des pagesla balise configurera un battement de coeur tracker et envoyer des pings de page à Snowplow à des intervalles que vous pouvez spécifier.

Le Fonction de rappel est quelque chose que vous pouvez définir sur une fonction JavaScript. Si vous définissez le rappel, au lieu d’envoyer le ping de page à Snowplow, la fonction est invoquée à la place.

Commandes personnalisées

Voici la liste des commandes personnalisées que vous pouvez exécuter, avec des détails sur les arguments (le cas échéant).

Paramètres de suivi supplémentaires

Vous pouvez choisir une variable Google Tag Manager dans le menu déroulant intitulé Ajouter des contextes personnalisés. Cela vous permet d’ajouter des contextes personnalisés au hit actuel. La variable devoir renvoie un tableau d’objets de contexte valides.

Vous pouvez également choisir de remplacer l’horodatage de l’appareil par le Définir un horodatage personnalisé champ. Le format doit être l’heure UNIX en millisecondes.

Paramètres de configuration du suivi

Dans ce groupe, vous pouvez établir la configuration du tracker qui est appliquée lors de la première création du tracker.

NOTE! Si vous ajoutez des configurations à un tracker déjà créé, les champs de configuration ne feront rien.

Tu as trois manières d’appliquer la configuration :

1. Utilisation uniquement d’une variable de paramètres Snowplow Analytics.
2. Utiliser uniquement des paramètres ajoutés manuellement.
3. En utilisant une combinaison des deux.

Si vous choisissez d’utiliser une variable Paramètres Snowplow Analytics, vous devez sélectionner la variable dans le menu déroulant. Si vous choisissez une variable qui est pas une variable “Paramètres Snowplow Analytics”, la balise échouerdonc sois prudent.

Vous pouvez également vérifier le Activer les paramètres de remplacement pour cette balise option. Cela développe un champ de paramètre dans lequel vous pouvez ajouter des paires clé-valeur de champs de configuration de suivi individuels. Consultez la documentation pour connaître les champs disponibles.

Si vous choisissez d’utiliser à la fois une variable Paramètres Snowplow Analytics et les paramètres saisis manuellement, tout conflit entre les deux sera résolu en faveur du paramètres saisis manuellement. Par exemple, nous utilisons ici une variable Snowplow Analytics Settings, mais nous avons décidé de remplacer certains champs dans la configuration.

Configuration avancée

Voir au dessus.

Notes de version