Trabajar con eventos

Un evento es una acción, realizada por un visitante, que desencadena una acción en el entorno de ejecución, como colocar un visitante en un segmento, presentar una oferta, o registrar datos. Dentro del entorno de diseño de Interact, puede crear un evento como uno de los elementos de la configuración que interactúa directamente con la API de Interact.

Al codificar el punto de encuentro para trabajar con la API de Interact, utiliza el método postEvent para hacer referencia a eventos. El nombre del evento que se utiliza en la API de Interact debe coincidir con el nombre del evento configurado en el entorno de diseño. Este nombre no es sensible a mayúsculas y minúsculas.

Por ejemplo, podría crear cualquiera de los eventos siguientes:

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

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

Obtener perfil. Solicitar datos del perfil del visitante almacenados en la sesión, incluyendo los datos temporales y los datos leídos de la tabla de perfil.

Establecer audiencia. Cambiar el nivel de audiencia de un visitante dentro de la sesión interactiva.

Establecer depuración. Modificar el nivel de registro actual de la sesión interactiva de un visitante.

Iniciar sesión. Marcar el inicio de la sesión interactiva de un visitante.

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

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

Al diseñar su interacción, recuerde que, a menos que especifique un diagrama de flujo específico, una acción de resegmentación ejecuta de nuevo todos los diagramas de flujo interactivos asociados a este canal interactivo con el nivel de audiencia actual, y que las solicitudes de oferta que puedan llegar tienen que esperar a que todos los diagramas de flujo hayan finalizado. Una resegmentación excesiva dentro de una sola visita puede afectar al rendimiento del punto de encuentro de forma visible para el cliente.

Ponga el cliente en los nuevos segmentos tras añadir nuevos datos significativos al objeto de sesión de tiempo de ejecución, como por ejemplo nuevos datos procedentes de solicitudes de la API de Interact (por ejemplo, cambiar la audiencia) o de acciones del cliente (por ejemplo, añadir nuevos elementos a una lista de deseos o a un carro de la compra).

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

Para integraciones web, se recomienda registrar el contacto de la oferta en la misma llamada en la que se solicitan 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 Interact ha presentado al visitante, el entorno de ejecución registra la última lista de ofertas recomendadas.

Registrar aceptación de oferta. El entorno de ejecución indica la oferta seleccionada para que el servicio de base de datos la registre en el historial de respuestas.

Registrar rechazo de oferta. El entorno de ejecución indica la oferta seleccionada para que el servicio de base de datos la registre en el historial de respuestas.

Desencadenar expresión de usuario. Una acción de expresión es una acción que puede definir utilizando las macros de Interact, que incluyen funciones, variables y operadores, entre ellos EXTERNALCALLOUT. Puede asignar el valor de retorno de la expresión a cualquier atributo de perfil.

AL pulsar en el icono de edición junto a Desencadenar expresión de usuario, se muestra el diálogo de edición de Expresión de usuario estándar, y puede utilizar este diálogo para especificar el nivel de audiencia, el nombre de campo opcional al que asignar los resultados y la definición de la expresión en sí.

Desencadenar eventos. Puede utilizar la acción Desencadenar eventos para especificar un nombre de evento que desea que se desencadene mediante esta acción. Si especifica un evento que ya está definido, este evento se desencadena cuando se ejecuta esta acción. Si el nombre de evento que especifica no existe, esta acción provoca la creación de ese evento cuando se ejecuta la acción especificada.

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

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 estableciendo las propiedades de configuración accept y reject.

La API de Interact también puede utilizar eventos para desencadenar acciones que se definen mediante los parámetros de eventos 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 definida, o varios con la misma Reacción de sistema, como Registrar contacto, para utilizarlo con los parámetros de evento reservados.

Si lo desea, puede crear varios eventos con la acción Registrar aceptación de oferta, uno para cada tipo de respuesta que desee registrar, o un solo evento con la acción Registrar aceptación de oferta que utiliza para cada llamada postEvent utilizada para registrar tipos de respuesta diferentes.

Por ejemplo, cree un evento con la acción Registrar aceptación de oferta para cada tipo de respuesta. Defina las siguientes propiedades personalizadas en la tabla UA_UsrResponseType [como Nombre (código)]: Explorar (EXP), Considerar (CON) y Confirmar (CMT). A continuación, cree tres eventos y denomínelos LogAccept_Explore, LogAccept_Consider y LogAccept_Commit. Los tres eventos son iguales (tienen la acción Registrar aceptación de oferta), pero los nombres son distintos de forma 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, denomínelo LogCustomResponse.

Al trabajar con la API de Interact, no hay diferencia funcional entre los eventos, pero los convenios de denominación pueden hacer más claro el código. Asimismo, si asigna a cada respuesta personalizada un nombre diferente, el informe Resumen de actividad de eventos de canal muestra 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.

Para supervisar la frecuencia con que ocurren todos estos eventos en su punto de encuentro, consulte el apartado Acerca del Informe de resumen de actividad de eventos de canal.

Referencia de evento

Añadir un evento

Trabajar con categorías y eventos