Trabajar con eventos

Un evento es uno de los tres elementos de la configuración de Interact en el entorno de diseño que interactúa directamente con la API de Interact. Al codificar su punto de encuentro para trabajar con la API de Interact, utilice el método publicaraEvento para hacer referencia a los eventos. El nombre del suceso que se utiliza en la API de Interact debe coincidir con el nombre del evento tal y como está configurado en el entorno de diseño. Este nombre no es sensible a mayúsculas y minúsculas.

Un evento desencadena una o más de las siguientes acciones predefinidas:

Desencadenante de la resegmentación El entorno de ejecución ejecuta todos los diagramas de flujo interactivos para el nivel de audiencia actual asociado con el canal interactivo de nuevo, utilizando los datos actuales en la sesión del visitante.

Al diseñar la interacción, recuerde que a menos que se especifique un diagrama de flujo específico, la resegmentación vuelve a ejecutar todos los diagramas de flujo interactivos asociados con este canal interactivo con el actual nivel de audiencia, y que cualquier solicitud de ofertas espera hasta que hayan finalizado todos los diagramas de flujo. Una resegmentación excesiva en una sola visita puede afectar al rendimiento del punto de encuentro de forma visible para el cliente.

Debe colocar al cliente en los segmentos nuevos después de haber añadido nuevos datos significativos al objeto de sesión de ejecución. Estos nuevos datos pueden proceder de la API de Interact (como modificar la audiencia) o las acciones de cliente (así como añadir nuevos elementos a una lista de deseos o un carrito de la compra).

Registrar oferta en contacto El entorno de ejecución marca las ofertas recomendadas para el servicio de base de datos para registrar las ofertas en el historial de contactos.

Para integraciones web, la mejor práctica es registrar el contacto de la oferta en la misma llamada donde puede solicitar ofertas para minimizar el número de solicitudes entre el punto de encuentro y el servidor de ejecución.

Si el punto de encuentro no devuelve los códigos de tratamiento de las ofertas que se presentaron al visitante, el entorno de ejecución registra la última lista de ofertas recomendada.

Registrar aceptación de oferta El entorno de ejecución marca la oferta seleccionada para el servicio de base de datos para registrarla en el historial de contactos.

Registrar rechazo de oferta El entorno de ejecución marca la oferta seleccionada para el servicio de base de datos para registrarla en el historial de contactos.

Si crea un evento con más de un registro de acción de oferta, recuerde que la API de Interact realiza la misma acción para la oferta asociada. Por lo tanto, no debe crear un evento que registra tanto la aceptación como el rechazo de la oferta puesto que se contradicen entre sí. No obstante, crear un solo evento para registrar el contacto y la aceptación de la oferta o el contacto y el rechazo de la oferta puede ser útil en su entorno.

De forma predeterminada, el entorno de ejecución puede realizar el seguimiento de dos tipos de respuestas, aceptar y rechazar la oferta. Puede modificar los tipos de respuesta que registran los eventos Registrar aceptación de oferta y Registrar rechazo de oferta, utilizando las propiedades de configuración aceptar y rechazar.

La API de Interact también puede utilizar eventos para desencadenar acciones que define el usuario utilizando parámetros de evento en la API. Estos eventos incluyen el registro en una tabla personalizada, el seguimiento de varios tipos de respuestas y especificar que se ejecute un diagrama de flujo determinado. Es posible que tenga que crear algunos eventos sin una reacción de sistema definido, o varios con la misma Reacción de sistema, como Registrar contacto, para utilizarlo con los parámetros de evento reservados.

Es posible que quiera crear distintos eventos con la acción Registrar aceptación de oferta, una para cada tipo de respuesta que quiere registrar o un solo evento con la acción Registrar aceptación de oferta que utiliza para cada llamada publicarEvento que utiliza para registrar tipos de respuesta.

Por ejemplo, cree un evento con la acción Registrar aceptación de oferta para cada tipo de respuesta. Puede definir las siguientes respuestas personalizadas en la tabla UA_TipoRespuestaUsuario [como Nombre (código)]: Explore (EXP), Considere (CON) y Confirme (CMT). A continuación, cree tres eventos y denomínelos RegistroAceptar_Explore, RegistroAceptar_Considere y RegistroAceptar_Confirme. Todos los tres eventos son exactamente iguales (tienen la acción Registrar aceptación de oferta), pero los nombres son diferentes, de modo que la persona que trabaja con la API de Interact pueda distinguirlos.

O podría crear un solo evento con la acción Registrar aceptación de oferta para todos los tipos de respuesta personalizados. Por ejemplo, el nombre RegistrarRespuestaPersonalizada.

Al trabajar con la API de Interact, no hay ninguna diferencia funcional entre los eventos, pero las convenciones de formación de nombres pueden hacer que el código sea más claro. Asimismo, si le asigna un nombre distinto a cada respuesta personalizada, el informe Resumen de actividad del evento del canal mostrará información más precisa.

Para obtener más información sobre los parámetros reservados y el método publicarEvento, consulte la publicación Guía del administrador de Interact.

Eventos definidos por el sistema

La pestaña Eventos contiene la categoría predeterminada Categoría definida por el sistema. No puede editar, añadir ni suprimir eventos de esta categoría. Esta categoría contiene eventos que se corresponden con la API de Interact. Puede supervisar la frecuencia con que todos estos eventos se producen en el punto de encuentro con el informe Resumen de actividad de eventos de canal.

Estos eventos incluyen:

Fin de sesión — Marcar el fin de la sesión interactiva del visitante.

Obtener oferta — Solicitar una lista de ofertas recomendadas para ofrecer a un visitante.

Obtener perfil — Solicitar los datos del perfil del visitante almacenados en la sesión; esto incluye los datos temporales, así como los datos leídos en la tabla del perfil.

Establecer audiencia — Modificar un nivel de audiencia del visitante en su sesión interactiva.

Establecer depuración — Sobrescribir el nivel de registro actual para una sesión interactiva del visitante.

Iniciar sesión — Marcar el inicio de una sesión interactiva del visitante.