À propos de l’API d’Interact

Pour configurer Interact de façon à ce qu’il fonctionne avec votre point de contact, vous devez effectuer les deux opérations suivantes :

Configurer Interact dans l’environnement de conception.

Configurer votre point de contact afin qu’il fonctionne avec l’environnement d’exécution à l’aide de l’API d’Interact.

Même si ces deux éléments de configuration ne concernent pas les mêmes composants, elles sont liées. L’API d’Interact doit faire référence à plusieurs éléments de configuration dans l’environnement de conception. Vous devez vous accorder avec la personne chargée de l’API d’Interact, notamment sur les conventions d’appellation et l’objectif des éléments. Ce processus est itératif et collaboratif. Étant donné que vous travaillez avec l’API d’Interact et le point de contact, vous pouvez avoir besoin de créer davantage d’événements et de points d’interaction. Au cours de la conception de l’interaction dans l’environnement de conception, vous demanderez peut-être à la personne chargée de l’API de respecter plus d’exigences.

L’API d’Interact doit faire référence à plusieurs éléments de la configuration Interact. Toutefois, seuls les trois éléments suivants sont référencés par leur nom :

Canaux interactifs

Points d’interaction

événements

Lorsque vous utilisez l’API d’Interact, vous devez faire référence à ces éléments par leur nom. Les noms doivent être identiques, mais ils ne sont pas sensibles à la casse. Les noms myinteract, myInteract et mYiNtErAcT doivent correspondre.

D’autres éléments de la configuration Interact peuvent être utilisés dans l’API d’Interact afin d’améliorer votre interaction, notamment des segments dynamiques, les dates de début et de fin des campagnes, des offres et des diagrammes temps réel.

Au cours de l’exécution, l’API d’Interact demande des informations aux diagrammes temps réel et aux règles de traitement, mais ces demandes sont indirectes. Par exemple, l’API n’appelle jamais de diagramme temps réel. En revanche, elle appelle un événement et demande une resegmentation, ce qui entraîne l’exécution de tous les diagrammes temps réel associés au canal interactif. De même, lorsque l’API demande des offres à l’aide de la méthode getOffers, une séquence d’événements incluant le référencement des règles de traitement démarre.

L’API d’Interact fait référence aux éléments suivants de Campaign :

ID référentiel

Référentiel

Attributs d’offres personnalisées

Code d’offre

Description de l’offre

Date d’entrée en vigueur de l’offre

Date d’expiration de l’offre

Nom de l’offre

Code de traitement de l’offre

Étant donné que ces éléments sont partagés dans l’ensemble de l’environnement de conception, vous devez les normaliser au sein de votre organisation. Vous devez fournir certaines de ces informations pour appeler l’API d’Interact correctement (ID référentiel par exemple) et vous devez en demander d’autres à l’aide de l’API (attributs d’offres par exemple).

L’API d’Interact permet également de référencer le score d’une offre. Il s’agit en général du score marketing affecté dans l’onglet Stratégie d’interaction. Ce score ne concerne qu’Interact et non l’ensemble de votre environnement Campaign. Vous pouvez modifier ou remplacer le score marketing dans l’onglet Stratégie d’interaction. Pour en savoir plus sur l’API d’Interact, consultez le Guide administrateur d’Interact.

Exécution d’Interact

Voici une brève description de ce qu’il se passe sur le serveur d’exécution au cours d’une interaction.

Au démarrage d’une session d’exécution, c’est-à-dire lorsque le visiteur initie un contact, l’API d’Interact déclenche un événement startSession. Ceci comprend les étapes suivantes.

1.	Création d’une nouvelle session d’exécution.

Une session d’exécution correspond à une instance sur le serveur d’exécution qui contient toutes les données associées au visiteur. Ces données incluent toutes les données de profil connues et les résultats de toutes les demandes parvenues à l’exécution, comme l’appartenance à un segment ou une liste d’offres.

2.	Chargement des données associées au profil du visiteur dans la session d’exécution.

3.	Exécution de tous les diagrammes temps réel associés à un canal interactif et placement du visiteur dans des segments.

Lorsque le visiteur interagit avec le point de contact, l’API d’Interact peut procéder à plusieurs actions, notamment déclencher des événements, demander des informations de profil et modifier le référentiel du visiteur. Lorsque le visiteur atteint un point d’interaction du point de contact, l’API d’Interact peut demander une ou plusieurs offres ou encore déclencher un événement. Lorsque le visiteur quitte le point de contact (en se déconnectant, en raccrochant ou en raison d’un délai d’expiration), le serveur d’exécution met fin à la session d’exécution.

Ceci est une présentation de base. Il existe de nombreuses fonctionnalités que vous pouvez activer pour influencer les recommandations d’offres, comme par exemple le module d’apprentissage. Pour en savoir plus sur ces fonctionnalités facultatives, consultez le Guide administrateur d’Interact.