Flujo de datos de la API de Interact
La siguiente figura se muestra una implementación simple de la API de Interact. Un visitante inicia la sesión en un sitio web y navega a una página que muestra las ofertas. El visitante selecciona una oferta y cierra la sesión. Mientras la interacción es simple, se producen varios eventos en el punto de encuentro y el servidor de ejecución.
Cuando un visitante inicia la sesión, se desencadena una startSession.
Diagrama que muestra la implementación simple del flujo de datos de la API de Interact
En este ejemplo, el método startSession realiza cuatro acciones. En primer lugar, crea una nueva sesión de ejecución. En segundo lugar, envía una solicitud para los datos de perfil del cliente en la sesión. En tercer lugar, envía una solicitud para utilizar los datos del perfil e iniciar un diagrama de flujo interactivo para incluir el cliente en segmentos. Esta ejecución de diagrama de flujo es asíncrona. En cuarto lugar, el entorno de ejecución carga la supresión de ofertas y la información de tratamiento de ofertas individuales y globales en la sesión. Los datos de sesión se mantienen en la memoria el tiempo que dura la sesión.
El visitante navega por el sitio hasta que llega a un punto de interacción predefinido. En la figura, el segundo punto de interacción (Seleccionar opción) es el lugar donde el visitante pulsa un enlace que presenta un conjunto de ofertas. El gestor de puntos de encuentro ha configurado el enlace para desencadenar un método executeBatch.
Diagrama de la llamada a la API que desencadena el método executeBatch
El método executeBatch permite llamar a más de un método en una sola llamada al servidor de ejecución. Estas llamadas a executeBatch llaman a dos otros métodos, getOffers y postEvent. El método getOffers solicita una lista de ofertas. El tiempo de ejecución utiliza los datos de segmentación, la lista de supresión de ofertas, las reglas de tratamiento y el módulo de aprendizaje para proponer un conjunto de ofertas. El tiempo de ejecución devuelve un conjunto de ofertas que se muestran en la página de contenidos.
El método postEvent desencadena uno de los eventos definidos en el entorno de diseño. En este caso concreto, el evento envía una solicitud para registrar las ofertas presentadas al historial de contactos.
El visitante selecciona una de las ofertas (Seleccionar oferta).
Diagrama que muestra el método postEvent
El botón asociado con la selección de la oferta está configurado para enviar otro método postEvent. Este evento envía una solicitud para registrar la aceptación de la oferta en el historial de respuestas.
El visitante, después de seleccionar la oferta, termina con el sitio web y cierra la sesión. El comando de cerrar sesión está enlazado con el método endSession.
Diagrama que muestra el final del flujo de trabajo de la API (el método endSession)
El método endSession cierra la sesión. Si el visitante olvida cerrar la sesión, existe un tiempo de espera de sesión configurable para garantizar que finalicen todas las sesiones al final. Si desea mantener algunos de los datos pasados a la sesión como, por ejemplo, la información incluida en los parámetros en los métodos startSession o setAudience, trabaje con la persona que crea los diagramas de flujo interactivos. La persona que crea un diagrama de flujo interactivo puede utilizar el proceso Instantánea para escribir esos datos en una base de datos antes de la sesión finalice y se pierdan los datos. A continuación, puede utilizar el método postEvent para llamar al diagrama de flujo interactivo que contiene el proceso Instantánea.
Este ejemplo es muy simple (el visitante sólo realiza cuatro acciones —iniciar la sesión, ir a la página que muestra las ofertas, seleccionar una oferta y cerrar la sesión—, que es una interacción simple) para mostrar los conceptos básicos sobre cómo funciona la API entre su punto de encuentro y el entorno de ejecución. Puede diseñar la integración para que sea lo complicada que desee (dentro de los límites de sus requisitos de rendimiento).