Trouver le code Widget
Sources → Enquêtes → Partager → Widget dynamique web
Sélectionner le bouton cliquer pour copier pour copier le code widget.
Vous avez la possibilité de personnaliser le design du widget ainsi que ses opérations de base sur cette page.
Le code widget se compose de deux parties :
Élément de widget, utilisez-le où vous préférez, cela n'a pas d'importance.
Balise <script> de l'API Feedier pour faire fonctionner le widget. Ajoutez ceci à la fin de votre balisage ou juste après la balise </body>.
Cliquez sur le bouton 'Enregistrer et Prévisualiser' pour voir vos modifications et prévisualiser le widget.
Ajout d'attributs de contexte au widget
Vous souhaiterez attacher des métadonnées que vous collectez sur votre site web/application afin de fournir un meilleur contexte aux retours que vous recueillez. Quelques exemples pourraient être :
En ajoutant des attributs, lorsque votre utilisateur laisse un feedback, leurs métadonnées sont automatiquement attachées à leur feedback, vous permettant d'analyser cela sur la plateforme, de créer des cohortes et de développer des tendances.
Voici à quoi pourrait ressembler l'ajout d'un attribut : Code de widget standard :
<script id="feedier-widget-script" src="https://feedier.com/js/widgets/v2/widgets.js?form-id=13&public-key=cb6c6eb920a84638d90e557d988193f8&no_header=true" type="text/javascript" async></script>
Code du widget avec les attributs de contexte 'Identifiant de l'utilisateur', 'Rôle', 'Inscrit' ajoutés :
<script id="feedier-widget-script" src="https://feedier.com/js/widgets/v2/widgets.js?form-id=13&public-key=cb6c6eb920a84638d90e557d988193f8&no_header=true&user_id=1234&role=Premium&signed_up=14.02.21" async></script>
Test du Widget
Ouvrez votre console (CTRL/CMD + SHIFT + I) → Application → Stockage (ou Storage) → Stockage local (ou Local Storage) → Feedier.widget → Supprimez les cookies du widget.
Afin de vous assurer que le widget fonctionne comme vous le souhaitez, vous devrez effacer les cookies pour effectuer un nouveau test sur votre page web.
Paramètres avancés
Gérez le widget à l'aide de l'API JavaScript
Objet: FeedierWidget
.toggle();
FeedierWidget.toggle();
Cette méthode ouvre ou ferme le contenu du widget de feedback en fonction de l'état actuel. Elle affiche soit le formulaire, soit le ferme.
Pour que cette option fonctionne, il faut que le délai d’affichage soit à 0.
.init(options);
FeedierWidget.init({ form_id: 123, attributes: { department: marketing }, forced: true });
Cette méthode initialise le widget en fonction de l'objet d'options fourni.
Nom de l’option | type | description |
---|---|---|
form_id | int | Identifiant de l'enquête Feedier. Il peut être trouvé dans l'API ou dans Enquête -> Options -> Gestion du formulaire. |
attributes | object | Attributs à attacher au feedback sur Feedier. Les attributs sont des données contextuelles provenant du côté client. |
forced | boolean | Si défini sur true, le widget sera affiché même si l'utilisateur a déjà répondu au sondage précédemment. |
Exemple d'ajout d'attributs via JavaScript :
Les attributs sont personnalisables selon votre propre contexte. Il est possible d'attacher tout type de données du côté client en utilisant JavaScript (ES6/Jquery/Vue/React). Les attributs sont utilisés dans Feedier pour apporter du contexte et pour les rapports.
FeedierWidget.init({ form_id: 123, attributes: { browser: navigator.userAgent, // Attach the client's browser screen_width: window.innerWidth, // Attach the client's browser width page: window.location, // Attach the client's URL user_id: $('#user-id').val() // Attach the user ID using Jquery if set in the DOM with ID user-id }, });
Lors de la sélection des données attributaires, essayez de choisir des ensembles de données qui vous aident à mesurer vos indicateurs de performance clés (KPI).
Événement JavaScript
Lorsque le widget est affiché sur la page, le script du widget Feedier déclenchera un événement 'FeedierWidget.built'. Il peut être utilisé automatiquement pour ouvrir le widget ou effectuer d'autres actions côté frontend.
document.addEventListener('FeedierWidget.built', function(e) { FeedierWidget.toggle(); });
JavaScript
Exemple : Afficher le widget Feedier lors d'un clic sur un bouton personnalisé à l'aide de JavaScript.
Sources → Enquêtes → Partager → Widget dynamique web → Visibilité
Désactivez l’option “Afficher à l’initialisation”
Ajoutez dans l’option “JavaScript personnalisé chargé” : FeedierWidget.toggle()
Dans le DOM:
<a href="#" id="feedback-start" class="btn btn-primary"> Feedback </a>
HTML
Exemple JavaScript pour déclencher le bouton avec jQuery :
<script id="feedier-widget-script" src="https://feedier.com/js/widgets/v2/widgets.min.js?form-id=770&public-key={PUBLIC_KEY}&no_header=true" type="text/javascript" async></script> <script type="text/javascript"> $(document).ready(function() { $('#feedback-start').on('click', function () { FeedierWidget.init({ form_id: 770, forced: true }); }); }); </script>
JavaScript
Exemple : Fermer le widget après la fin du feedback
window.addEventListener('message', function(event) { if (event.data.eventName === 'feedback_completed') { $('.feedier-widget').hide() }; });
JavaScript
Changer le style du widget en utilisant le CSS
Il existe deux types de modifications CSS :
CSS à l'intérieur du formulaire :
Enquête → Marque → Custom CSS
Plus d'informations sur des exemples CSS.
CSS sur le widget:
Enquête → Partage→ Widget → Design
Le CSS peut être ajouté à votre application OU dans la section Design de la page du widget.
Les classes CSS peuvent être explorées via l'inspecteur, les plus remarquables étant
CSS class | Description |
---|---|
.feedier-widget__caller | Widget feedback button |
.feedier-widget__popup | Widget iframe wrapper |
Exemple d'ajout de CSS au widget :
L'exemple suivant définira la couleur du bouton du widget en rouge, changera sa police et supprimera la bordure autour du sondage :
.feedier-widget__caller { background: #ce0707; color: #FFF; border: 0; font-family: Arial; } .feedier-widget__popup { padding: 0; }
CSS
Affichage du widget à des événements spécifiques en utilisant Google Tag Manager
Il existe plusieurs avantages à utiliser un gestionnaire de balises, notamment : aucune nécessité de temps de développement, la possibilité de fournir des retours proactifs en utilisant des événements déclenchés, et une facilité d'ajout d'attributs.
Créez une nouvelle balise dans Google Tag Manager.
Tag Manager → Add a new tag → Tag configuration → Coller le code Widget Feedier
Assurez-vous de publier une nouvelle version de GTM lorsque vous apportez des modifications à votre configuration (par exemple, lorsque vous modifiez la méthode de déclenchement).
Then, add an explicit Tag name like “Feedback Widget Feedier” and click the Tag Configuration icon:
En utilisant le HTML personnalisé sous la configuration de la balise, vous pouvez attacher des attributs via GTM. GTM remplacera automatiquement les variables définies à l'aide de leur couche de données. Par exemple, role={{user.role}}&plan={{user.plan}} devient role=directeur&plan=entreprise.
Déclenchez GTM en fonction d'un événement
Dans les paramètres de configuration de la balise, cliquez sur “Triggering”. Ensuite, cliquez sur l'icône + pour configurer quand déclencher le widget.
Quelques exemples de moments où vous pourriez souhaiter déclencher le widget :
Demander un feedback après l'inscription
Demander un feedback après la 5e visite
Demander un feedback avant de quitter l'application
Demander un feedback après avoir atteint un objectif produit (commande, réservation, création, mise à jour…)
Demander un feedback après qu'un utilisateur n'a pas suivi un flux attendu.
Assurez-vous que jQuery est chargé sur la page. C'est une erreur courante. Si votre widget ne se charge pas et que vous ne savez pas pourquoi, vous pouvez facilement déterminer si jQuery est en cause. Ouvrez la console (clic droit sur la page > "Inspecter la page"). Vous verrez l'erreur indiquant que jQuery n'est pas chargé.
Add Comment