Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents
minLevel1
maxLevel6
outlinefalse
styledisc
typelist
printablefalse

Trouver le code Widget

Info

SourcesEnquêtes Partager → Widget dynamique web

Sélectionner le bouton cliquer pour copier pour copier le code widget.

Image RemovedImage Added

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 : 

  1. L'élément de widget, utilisez le à l’endroit qui vous conviens le plus, cela n'a pas d'importance.

  2. 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 pouvez attacher des métadonnées que vous collectez sur votre site web/application afin de fournir un meilleur contexte aux retours que vous recueillez. Voici quelques exemples :

Service de l'entreprise

Rôle de l'utilisateur

Niveau de direction

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

Info

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();

Code Block
FeedierWidget.toggle();

Cette méthode ouvre ou ferme le contenu du widget de feedback en fonction de l'état actuel. Elle affiche le formulaire, ou le ferme.

Pour que cette option fonctionne, il faut que le délai d’affichage soit égal à 0.

.init(options);

Code Block
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 créer des rapports concrets.

Code Block
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 des attributs, 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.

Code Block
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.

Info

SourcesEnquêtes Partager → Widget dynamique web → Visibilité

  • Désactivez l’option “Affichage du Widget au chargement”

  • Ajoutez dans l’option “JavaScript personnalisé chargé à l’initialisation” : FeedierWidget.toggle()

Dans le DOM:

Code Block
<a href="#" id="feedback-start" class="btn btn-primary">
      Feedback
</a>

HTML

Exemple JavaScript pour déclencher le bouton avec jQuery : 

Code Block
<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

Code Block
 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 :

Info

Enquête → Marque → CSS personnalisé

Plus d'informations sur des exemples CSS.

CSS sur le widget: 

Info

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 :

Code Block
.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 : 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.

Info

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).

Ensuite, ajoutez un Nom de tag explicite comme : “Widget de Feedback Feedier” et cliquez sur l’icone Configuration du Tag.

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é.