Flux de données de l'API Interact
La figure suivante montre une implémentation simple de l'API Interact. Un visiteur se connecte à un site Web et accède à une page qui affiche des offres. Le visiteur sélectionne une offre et se déconnecte. Alors que l'interaction est simple, plusieurs événements se produisent à la fois dans le point de liaison et sur le serveur d'exécution.
Lorsqu'un visiteur se connecte, cela déclenche un startSession.
Diagramme illustrant une implémentation simple du flux de données de l'API Interact
Dans cet exemple, la méthode startSession exécute quatre opérations. Elle crée tout d'abord une nouvelle session d'exécution. Elle envoie ensuite une requête de chargement des données du profil client dans la session. Elle envoie ensuite une requête d'utilisation des données du profil et démarre un organigramme interactif pour placer le client dans des segments. Cette exécution de l'organigramme s'exécute en mode asynchrone. Pour terminer, l'exécution charge les informations de suppression d'offre et les informations de traitement globales et individuelles des offres dans la session. Les données de session sont conservées en mémoire pendant toute la durée de la session.
Le visiteur navigue dans le site jusqu'à ce qu'il atteigne un point d'interaction prédéfini. Dans la figure, le deuxième point d'interaction (choix Sélectionner) est un emplacement dans lequel le visiteur clique sur un lien qui lui présente un ensemble d'offres. Le gestionnaire de point de contact a configuré le lien de façon à ce qu'il déclenche une méthode executeBatch.
Diagramme de l'appel API qui déclenche la méthode executeBatch
La méthode executeBatch permet d'appeler plus d'une méthode dans un seul appel au serveur d'exécution. Cette méthode executeBatch appelle deux autres méthodes, getOffers et postEvent. La méthode getOffers demande une liste d'offres. L'exécution utilise les données de segmentation, la liste de suppression des offres, les règles de traitement et le module d'apprentissage pour proposer un ensemble d'offres. L'exécution renvoie un ensemble d'offres qui s'affichent dans la page de contenu.
La méthode postEvent déclenche l'un des événements définis dans l'environnement de conception. Dans ce cas particulier, l'événement envoie une demande de journalisation des offres présentées à l'historique des contacts.
Le visiteur sélectionne l'un des offres (offre Sélect.)
Diagramme représentant la méthode postEvent
Le bouton associé à la sélection de l'offre est configuré pour envoyer une autre méthode postEvent. Cet événement envoie une demande de journalisation de l'acceptation de l'offre dans l'historique des réponses.
Le visiteur, après avoir sélectionné l'offre, a terminé sa transaction sur le site Web et se déconnecte. La commande de déconnexion est liée à la méthode endSession.
Diagramme représentant la fin du workflow de l'API (méthode endSession)
La méthode endSession termine la session. Si le visiteur oublie de se déconnecter, un délai d'expiration de session configurable permet de faire prendre fin à toutes les sessions. Si vous souhaitez conserver des données transmises à la session, telles que les informations incluses dans les paramètres des méthodes startSession ou setAudience, collaborez avec la personne chargée de créer les organigrammes interactifs. Cette dernière peut utiliser le processus Extraction pour écrire ces données dans une base de données avant que la fin de la session et la perte des données. Vous pouvez alors utiliser la méthode postEvent pour appeler l'organigramme interactif contenant le processus Extraction.
Cet exemple est très simple. Le visiteur exécute seulement quatre actions : connexion, accès à la page affichant les offres, sélection d'une offre et déconnexion. C'est donc une interaction simple. Il illustre les principes fondamentaux qui régissent le fonctionnement de l'API entre votre point de contact et l'environnement d'exécution. Vous pouvez concevoir une intégration beaucoup plus complexe si nécessaire, à condition de respecter vos contraintes en termes d'exigences de performances.