Application mono-page

À propos des applications à page unique

Les applications à page unique (SPA) sont un type spécial d’application Web. Un SPA chargera une seule page lorsque vous accéderez à un site Web et, à partir de là, chargera tout le contenu suivant sur cette même page lorsque vous naviguez. Cela semble fonctionner comme un site Web normal, mais lorsque vous passez d’une page à l’autre, la page ne se recharge pas.

Par défaut, le code de déploiement s’exécute dès le chargement d’une page Web. Cependant, comme les SPA ne s’actualisent pas lors de la navigation entre les pages, le code de déploiement ne sera pas réévalué lorsque vous naviguez entre les pages. En utilisant les techniques décrites ci-dessous, vous pouvez permettre au code de déploiement de fonctionner en toute transparence sur votre site SPA.

Réévaluation automatique de la logique d’interception lors du changement d’URL

Si votre application à page unique dépend de l’acheminement côté client pour la navigation utilisateur, vous pouvez forcer la réévaluation des intercepts lors des modifications ultérieures de l’URL en activant la logique de réévaluation de l’intercept lorsque le paramètre de l’URL change au niveau du projet Feedback de site Web. Si vous cochez cette option, l’évaluation de la logique d’interception sera possible en plus de l’évaluation qui se produit lors du chargement initial de la page.

Pour activer la réévaluation automatique de la logique d’intercept, suivez les étapes ci-dessous :

1. Dans votre projet de Feedback de site Web, accédez aux Paramètres.
2. Cliquez sur Gérer le projet.
3. Sélectionnez Options du projet dans le menu déroulant.
4. Assurez-vous que Réévaluer la logique de l’intercept lorsque les modifications d’URL sont cochées dans la section Prise en charge de l’application Single Page (SPA).

QSI.API.run();

Implémentation manuelle avec l’API JavaScript

Cette méthode décrit comment changer votre code de déploiement pour qu’il s’exécute manuellement.  Cela signifie que le code de déploiement n’exécutera ni n’évaluera la logique associée tant que la requête d’API JavaScript appropriée n’aura pas été lancée.

À implémenter manuellement

1. Accédez à l’onglet Options.
   
2. Cliquez sur le menu déroulant Gérer un projet.
3. Sélectionnez Options du projet.
4. Activez l’option Charger projet manuellement.
   
5. Revenez à l’onglet Intercepts et, si vous le souhaitez, définissez une logique pour votre Intercept ou l’ Ensemble d’actions.
   
6. Placez le code de déploiement sur votre site Web, de préférence dans un en-tête ou un pied de page global afin qu’il se charge sur toutes les pages.
7. Ajoutez les demandes d’API JavaScript appropriées en fonction du nombre de fois où vous souhaitez que votre site Web référence l’Intercept. Voir la section ci-dessous pour ces demandes.

Demandes d’API JavaScript

Si vous souhaitez que Qualtrics évalue votre projet en une seule instance, utilisez ces deux requêtes :

1. Cette demande charge le code de déploiement pour tous les Intercepts et Creatives sur la page. L’API de “chargement” est identique au rechargement d’une page comportant un code.

   QSI.API.load();

   Astuce Qualtrics : si Charger projet manuellement est activé dans les paramètres de votre projet, vous n’aurez pas besoin d’appeler cette API pour charger le code de déploiement lors du chargement initial de la page. Il sera uniquement nécessaire de forcer le chargement pour tenir compte des changements d’état sur la page qui se produisent sans rechargement.
2. Cela lance l’évaluation du code de déploiement et fait apparaître tout Creative s’il remplit les conditions d’affichage.

   QSI.API.run() ;

Si vous souhaitez que Qualtrics évalue le code de votre projet plusieurs fois sur la même page, répétez les trois étapes suivantes à chaque fois :

1. Cette demande supprime le code de déploiement pour tous les Intercepts ou Creatives présents sur la page.

   QSI.API.décharger();

2. Cela charge le code de déploiement pour tous les Intercepts ou Creatives sur la page. Cela revient à recharger la page.

   QSI.API.load() ;

3. Cela lance l’évaluation du code de déploiement et fait apparaître tout Creative s’il remplit les conditions d’affichage.

   QSI.API.run() ;

FAQ