Utilisez le tag de déclenchement Skeepers pour intégrer des questionnaires interactifs dans vos sites internet (sous forme de pop-ins, pop-unders, boutons, etc.).
Généré par défaut, ce tag JavaScript est personnalisable pour répondre au mieux à vos besoins et limitations RGPD. Dans cet article, nous vous présentons les étapes nécessaires pour accéder à ces tags sur la plateforme et à comment les intégrer dans vos sites/gestionnaires de tags.
Qu'est-ce que le tag de déclenchement ?
Si vous souhaitez mettre en place des questionnaires destinés à être affichés sur vos sites internet, il est nécessaire d'opter pour des diffusions de type Site Web, InPage ou Bouton.
Le tag de déclenchement vous permet de déclencher et d’afficher correctement ces types de questionnaires sur votre site web dans le respect des règles que vous avez définies au préalable dans vos diffusions.
Ce tag Javascript vous permet également de capturer de l’information sur le comportement du visiteur nécessaire à l’évaluation des conditions d'affichage de vos questionnaires (pages visitées, temps passé, informations sur le visiteur).
Il a pour but de déclencher vos questionnaires aux moments les plus opportuns lors d'une visite sur votre site web.
Où trouver le tag de déclenchement ?
Vous trouverez votre tag de déclenchement en vous rendant dans l'onglet "Paramètres" depuis le menu latéral gauche de la plateforme. Dans la section "Diffusions" au sein de vos paramètres, sélectionnez "Tag de déclenchement".
Assurez-vous d'avoir créé vos domaines avant de configurer vos tags de déclenchement, sans quoi vous ne serez pas en mesure de le faire.
Le tag Javascript Skeepers contrôle l’affichage des questionnaires en fonction des règles configurées dans vos diffusions de type site web. Il collecte des données sur le comportement des visiteurs (pages consultées, durée de navigation, informations sur le visiteur, etc.) afin d’évaluer les conditions d’affichage de vos questionnaires.
Nous vous conseillons de faire appel à un développeur de votre équipe technique pour l'intégration du code.
Il est recommandé d'utiliser un outil de gestion de tag (Google Tag Manager, Tealium, etc.) pour son installation.
Mise en place du tag de déclenchement
Intégration du tag sur un site web standard (MPA)
Insérez le code, disponible dans les paramètres de votre compte, sur l'ensemble des pages du site correspondant au nom de domaine associé au tag. Ce code doit être positionné juste avant la fermeture de la balise "body".
Lors de l'intégration, les valeurs marquées “undefined” doivent être valorisées dynamiquement à l'aide du système de variables du site ou du dataLayer pour chaque variable définie.
Sur chaque page, une ressource JavaScript est chargée de manière asynchrone. Une fois cette ressource téléchargée, les règles de déclenchement sont automatiquement analysées et appliquées.
Intégration du tag sur un site web Single Page Application (SPA)
Insérez le code, disponible dans les paramètres de votre compte, sur la page principale de l'application correspondant au nom de domaine associé au tag. Ce code doit être placé juste avant la fermeture de la balise "body".
Lors de l'intégration, les valeurs marquées comme “undefined” doivent être valorisées dynamiquement via le système de variables du site ou le dataLayer pour chaque variable définie.
Lorsque l'application se charge, une ressource JavaScript est chargée de manière asynchrone. Une fois cette ressource téléchargée, les règles de déclenchement sont automatiquement évaluées.
Pour permettre l'évaluation des règles de déclenchement lors d'un changement d'écran ou de contexte, il est nécessaire de mettre à jour les propriétés de la variable "_Mfb_ud", puis de lancer l'évaluation en appelant une fonction JavaScript fournie par le tag.
Mise à jour de la variable "_Mfb_ud"
Evaluation des règles de déclenchement
Mieux comprendre le contenu du tag de déclenchement
Pour en apprendre davantage, voici un exemple de tag de déclenchement (à titre informatif uniquement, ne l’utilisez pas sur votre site) :
Variables de sites et attributs
window._Mfb_ud = {
var1 : undefined,
var2 : undefined,
varN : undefined,
A l'intégration du code, les propriétés ("var1", "var2", dans l’exemple etc.) définies comme “undefined" au premier niveau de l’objet "_Mfb_ud" doivent être valorisées dynamiquement via le système de variables du site ou du dataLayer.
Ces propriétés vont permettre de définir les règles d’affichage des questionnaires et sont associées aux réponses des répondants si elles sont déclarées comme des attributs au sein de la solution.
Le nom des variables est défini à l’intégration et doit correspondre au nom système déclaré dans la solution s’il s’agit d’une attribut.
Ces données peuvent être exploitées dans les conditions de déclenchement "Attribut" ou "Variable de site" au sein de vos diffusions.
Gestion de la langue
lang : undefined, // You can force the language of the survey.
Ce bloc permet de gérer les traductions lorsque votre campagne est traduite en plusieurs langues (plus d'information sur la traduction de campagnes ici). Si le contenu de ce bloc est laissé en "undefined", la langue utilisée sera celle qui sera gérée en priorité selon les configurations de votre diffusion. Nous détaillons l'ordre de priorité de la gestion des langues dans cet article : Gérer la langue d'affichage des questionnaires et éléments partagés.
Si vous souhaitez gérer la langue à travers le tag de déclenchement, le placeholder "undefined" doit être remplacé par le code de la langue au format ISO 639-1 (par exemple, "nl"), auquel peut s'ajouter le code pays au format ISO 3166-1 si nécessaire (par exemple, "nl-BE").
Gestion de l'historique de navigation
_page : {
url : location.pathname,
storageDuration : 30
// remove this if not used
pageProperties : {
property1 : undefined,
property2 : undefined
}
}
Ce bloc permet de configurer la collecte de l’historique de navigation des visiteurs, sur lequel les règles de déclenchement peuvent s’appuyer.
- "url" : Correspond à l’URL des pages visitées. Par défaut, le tag s’appuie sur la fonction JavaScript standard pour valoriser cette propriété. Il est possible de la valoriser avec une variable spécifique de votre datalayer si la gestion de vos pages est spécifique.
- "storageDuration" : Définit la durée de conservation de l’historique de navigation, exprimée en jours. La valeur acceptée est comprise entre 0 et 30, 30 étant le maximum.
- "pageProperties" : Permet d’ajouter des propriétés spécifiques à chaque page, qui seront également conservées dans l’historique. Ces propriétés peuvent être utilisées dans les règles de déclenchement basées sur l’historique de navigation. Cet objet peut être supprimé s’il n’est pas utilisé.
Si vous définissez le paramètre "storageDuration" à 0, aucun historique ne sera conservé dans cette clé, ce qui convient lorsqu'aucun déclenchement n'est configuré sur un historique de navigation (visites précédentes).
Ces données peuvent être exploitées dans les conditions de déclenchement "Nombre de visites", "Page visitée", ou lorsque l’historique de navigation est pris en compte au sein de vos diffusions.
Partage d’information entre 2 sous-domaine
window._Mfb_useCookie : true;
Par défaut, le tag de déclenchement utilise un cookie pour partager certaines informations, sur lesquelles s'appuient les conditions de déclenchement, entre les sous-domaines d’un même site.
Si votre site se limite à un seul sous-domaine, ce cookie n’est pas nécessaire. Vous pouvez désactiver son utilisation en valorisant ce paramètre à "false".
window._Mfb_useCookie : false;
Privacy mode
privacyMode : false
Ce paramètre permet d’ajuster le fonctionnement des traceurs utilisés par le tag en tenant compte des préférences de consentement de l’internaute concernant l’utilisation des cookies. Nous détaillons les traceurs dans l'article suivant : Quels sont les cookies déposés par un dispositif de collecte Skeepers ?
Lorsque le “privacyMode” est activé, les données stockées par les traceurs ne seront pas accessibles lors des visites ultérieures de l’internaute sur le site, à l’exception des informations techniques essentielles au bon fonctionnement du dispositif (notamment pour gérer la sollicitation).
Le paramètre “privacyMode” est désactivé par défaut.
Pour l’activer vous pouvez valoriser ce paramètre avec la valeur “true”.
privacyMode : true
Lorsque le paramètre privacyMode est activé, l'historique de navigation n'est plus conservé (StorageDuration: 0), et le partage d'informations entre sous-domaines est désactivé (window._Mfb_useCookie: false).
Par conséquent, les conditions de déclenchement basées sur l'historique de navigation (comme "Page visitée sur un historique de navigation" ou "Nombre de visites sur les N derniers jours") ne déclencheront aucun questionnaire.
Si votre questionnaire intégré dans votre site web ne s'affiche pas correctement, nous vous invitons à consulter notre documentation à ce sujet.
Si vous souhaitez en savoir plus sur la gestion des cookies par le tag de déclenchement Skeepers, consultez notre article dédiée.
Si vous avez des questions, n'hésitez pas à contacter notre équipe Customer Care.