Acerca de la API de Interact
Utilice esta sección para aprender a configurar Interact para que funcione con su punto de encuentro.
La configuración de Interact para trabajar con su punto de encuentro consta de dos componentes principales:
*
Configuración de Interact en el entorno de diseño.
*
Aunque estos dos componentes de la configuración son de dos áreas distintas, están relacionados. La API de Interact debe hacer referencia a varios de los elementos de configuración dentro del entorno de diseño. Usted y la persona que trabaja con la API de Interact deben trabajar conjuntamente para acordar los convenios de denominación, el objetivo del elemento, etc. Se trata de un proceso iterativo y cooperativo. Como persona que trabaja con la API de Interact y el punto de encuentro, puede que sea necesario crear más eventos y puntos de interacción. Puesto que diseña la interacción en el entorno de diseño, puede tener más requisitos que la persona que trabaje con la API.
Existen varios elementos de la configuración de Interact a los que hace referencia la API de Interact. Sin embargo, sólo se hace referencia a los siguientes tres elementos por el nombre:
*
*
*
Al trabajar con las API de Interact, debe hacer referencia a estos elementos por su nombre. Estos nombres deben coincidir, aunque son sensibles a mayúsculas y minúsculas. Los nombres myinteract, myInteract y mYiNtErAcT coinciden.
Existen otros elementos de la configuración de Interact que puede utilizar en la API de Interact para mejorar su interacción, incluyendo segmentos inteligentes, fechas de inicio y de finalización de campañas, ofertas y diagramas de flujo interactivos.
Durante el tiempo de ejecución, la API de Interact no solicita información de los diagramas de flujo interactivos y las reglas de tratamiento, sin embargo la API llama dicha información indirectamente. Por ejemplo, la API nunca llama un diagrama de flujo interactivo. No obstante, la API llama un evento solicitando una resegmentación, que ejecuta todos los diagramas de flujo interactivos asociados con el canal interactivo. Del mismo modo, cuando la API solicita ofertas con el método obtenerOfertas, se inicia una secuencia de eventos que incluye referencias a las reglas de tratamiento.
La API de Interact referencia los siguientes elementos de Campaign:
*
*
*
*
*
*
*
*
*
Dado que estos elementos se comparten en todo el entorno de diseño, debe decidir las normas para estos elementos de toda su organización. Debe proporcionar parte de esta información para llamar la API de Interact correctamente, como el ID de audiencia, y el resto la solicita con la API, como los atributos de la oferta.
También puede hacer referencia a la puntuación para una oferta con la API de Interact. En general, esta es la puntuación de marketing asignada en la pestaña de estrategia de interacción. Esta puntuación solo es relevante para Interact, no para todo el entorno de Campaign. Puede modificar o sobrescribir la puntuación de marketing de la pestaña de estrategia de interacción. Para obtener más información sobre la API de Interact, consulte la Guía del administrador de Interact.
Tiempo de ejecución de Interact
La siguiente sección proporciona una breve descripción general de lo que sucede en el servidor de ejecución durante una interacción.
Cuando una sesión de ejecución se inicia, es decir, cuando el visitante inicia un contacto, la API de Interact desencadena un inicioSesión. Esta llamada puede incluir los siguientes pasos.
1.
Una sesión de ejecución es una instancia del servidor de ejecución que contiene todos los datos asociados con el visitante. Esto incluye todos los datos del perfil conocidos y los resultados de cualquier solicitud al tiempo de ejecución, como pertenencia al segmento o una lista de ofertas.
2.
3.
Cuando el visitante interactúa con el punto de encuentro, la API de Interact puede realizar diferentes acciones incluido el desencadenamiento de eventos, solicitando información del perfil y modificando el nivel de audiencia del visitante. Cuando el visitante alcanza un punto de interacción en el punto de encuentro, la API de Interact puede solicitar una o más ofertas o desencadenar un evento. Cuando el visitante deja el punto de encuentro cerrando la sesión, colgando, o cuando acaba el tiempo, el servidor de ejecución finaliza la sesión de ejecución.
Esta es una descripción general básica. Existen muchas características opcionales que puede habilitar que le permiten influir a la hora de recomendar la oferta, por ejemplo, el módulo de aprendizaje. Para obtener más información sobre estas características opcionales, consulte la Guía del administrador de Interact.