Configuration de la prise en charge de la messagerie web in-app dans le SDK web

Les messages in-app sont des notifications que vous pouvez envoyer aux utilisateurs dans votre application web, en les guidant vers des points ciblés spécifiques.

Vous pouvez utiliser ces notifications à différentes fins, par exemple pour promouvoir de nouvelles fonctionnalités, présenter des offres spéciales ou faciliter l’intégration des utilisateurs.

En utilisant les messages in-app, vous pouvez interagir efficacement avec votre audience et l’orienter vers des aspects importants de votre application.

Conditions préalables prerequisites

Version de l’extension de balise SDK Web extension-version

La fonctionnalité de messagerie in-app web requiert la dernière version de l’extension de balise SDK web.

Configuration d’une CSP pour la messagerie web in-app csp

Lorsque vous configurez la messagerie in-app web, vous devez inclure la directive suivante dans votre CSP :

default-src  blob:;

Pour plus d’informations sur la configuration d’une CSP, consultez la documentation dédiée.

Configuration de la messagerie web in-app à l’aide de l’extension de balise SDK web tag-extension

Reportez-vous à la page de configuration de l’extension de balise SDK Web pour savoir où trouver les paramètres décrits ci-dessous.

Une fois installé sur l’extension de balise SDK Web, suivez les étapes ci-dessous pour configurer l’extension pour la messagerie in-app web.

Dans la section Personalization , cochez l'option Activer le stockage de personnalisation . Cette option permet au SDK Web de suivre les expériences qui ont été vues par l’utilisateur lors du chargement d’une page.

La messagerie web in-app prend en charge deux types de déclencheurs :

Reportez-vous aux sections suivantes pour configurer l’extension de balise du SDK Web en fonction des déclencheurs que vous souhaitez utiliser.

Étapes de configuration du déclencheur Envoyer des données à Platform send-data-platform

Sélectionnez la propriété de balise qui contient votre extension SDK Web et créez une règle avec les paramètres suivants :

Vous devez ensuite ajouter une action à la règle que vous avez créée.

Vous devez ensuite ajouter la règle nouvellement créée à la bibliothèque de propriétés de balise. Pour ce faire, accédez à Flux de publication et sélectionnez la règle que vous avez créée précédemment.

Après avoir ajouté la règle à la bibliothèque, sélectionnez Enregistrer et créer dans le développement.

Le processus de configuration est maintenant terminé et votre message est prêt à être présenté à vos utilisateurs.

Étapes de configuration pour l’utilisation de déclencheurs manuels manual-trigger

Sélectionnez la propriété de balise qui contient votre extension SDK Web et créez une règle avec les paramètres suivants :

Vous devez ensuite ajouter une action à la règle que vous avez créée.

Vous devez ensuite ajouter la règle nouvellement créée à la bibliothèque de propriétés de balise. Pour ce faire, accédez à Flux de publication et sélectionnez la règle que vous avez créée précédemment.

Après avoir ajouté la règle à la bibliothèque, sélectionnez Enregistrer et créer dans le développement.

Le processus de configuration est maintenant terminé et votre message est prêt à être présenté à vos utilisateurs.

Configuration de la messagerie web in-app à l’aide de la bibliothèque JavaScript SDK web js-library

Au lieu d’utiliser l’extension de balise du SDK Web, vous pouvez également configurer la messagerie web in-app directement à partir de la bibliothèque JavaScript du SDK Web.

Vous pouvez afficher les messages web in-app à partir de Adobe Journey Optimizer de deux manières.

Méthode 1 : récupération automatique du contenu de personnalisation automatic

Pour que le SDK Web récupère automatiquement le contenu de personnalisation au chargement de la page, utilisez la commande sendEvent, comme illustré dans l’exemple ci-dessous.

  alloy("sendEvent", {
      renderDecisions: true,
      personalization: {
          surfaces: ['#welcome']
      }
  });

Méthode 2 : récupération manuelle du contenu de personnalisation selon l’action de l’utilisateur manual

Pour afficher le contenu de personnalisation uniquement une fois que l’utilisateur a effectué une action spécifique, utilisez la commande evaluateRulesets comme illustré dans l’exemple ci-dessous.

Dans cet exemple, le contenu de personnalisation s’affiche lorsqu’un utilisateur clique sur le bouton Acheter maintenant de votre site web.

 alloy("evaluateRulesets", {
     renderDecisions: true,
     personalization: {
         decisionContext: {
             "userAction": "buy_now"
         }
     }
 });

Configuration du stockage de personnalisation personalization-storage

Vous pouvez choisir d’afficher les messages in-app aux utilisateurs pour un nombre défini de fois, ou chaque fois qu’ils visitent une page, par le biais de l’option de configuration personalizationStorageEnabled.

Dans la configuration du SDK Web, définissez l’option personalizationStorageEnabled en fonction de vos besoins :