Información sobre at.js custom events
, le avisa cuando una oferta o una solicitud de mbox se procesa correcta o incorrectamente.
Históricamente, mbox.js impedía a otros códigos de JavaScript que se ejecutaban en la página saber lo que pasaba entre bastidores. Con el adelanto de at.js, tuvimos una oportunidad única de arreglar este problema.
Nuestros clientes nos han contado que les gustaría recibir notificación sobre varias situaciones, entre otras:
Los eventos predefinidos tienen una estructura que permite extraer los datos necesarios según el tipo de evento.
Para asegurarse de que los eventos se puedan usar en distintos casos, los eventos personalizados tienen un objeto de carga útil que se asigna a la propiedad de detalle del objeto del evento (que se pasa al controlador). Además, para evitar pasar cadenas como nombres de eventos, los eventos se exponen como constantes usando el espacio de nombres de adobe.target.event
.
Clave | Tipo | Descripción |
---|---|---|
type | Cadena | Hay varios escenarios en los que le gustaría recibir notificaciones para ayudarlo a rastrear, depurar y personalizar la interacción con at.js. Cada evento personalizado enumerado a continuación tiene dos formatos: una “constante” y un “valor de cadena”.
Constante: adobe.target.event.REQUEST_FAILED Valor de cadena: at-request-failed Descripción: Error en una solicitud de mbox debido al tiempo de espera, código de estado incorrecto, error de análisis de JSON, etc. Solicitud exitosa Constante: adobe.target.event.REQUEST_SUCCEEDED Valor de cadena: at-request-succeeded Descripción: se realizó una solicitud de mbox correctamente. Representación de contenido fallida Constante: adobe.target.event.CONTENT_RENDERING_FAILED Valor de cadena: at-content-rendering-failed Descripción: la representación de ofertas falló debido a que falta un elemento mbox envolvente, el selector no se puede encontrar, etc. Representación de contenido exitosa Constante: adobe.target.event.CONTENT_RENDERING_SUCCEEDED Valor de cadena: at-content-rendering-succeeded Descripción: la representación de ofertas se realizó correctamente. Los cambios del DOM se han aplicado. Biblioteca cargada Constante: adobe.target.event.LIBRARY_LOADED Valor de cadena: at-library-loaded Descripción: este evento es ideal para rastrear cuándo at.js se ha cargado completamente. Puede usar este evento para personalizar la ejecución global de mbox. También puede usar este evento para deshabilitar el mbox global y luego escuchar este evento para lanzar el mbox global más tarde. Inicio de solicitud Constante: adobe.target.event.REQUEST_START Valor de cadena: at-request-start Descripción: este evento se activa antes de ejecutar una solicitud HTTP. Puede usar este evento para las mediciones de rendimiento usando API Resource Timing. Inicio de representación de contenido Constante: adobe.target.event.CONTENT_RENDERING_START Valor de cadena: at-content-rendering-start Descripción: este evento se activa antes de que se inicie el selector de sondeos y de que se represente el contenido en la página. Puede usar este evento para seguir el progreso del procesamiento de contenido. Representación de contenido sin ofertas Constante: adobe.target.event.CONTENT_RENDERING_NO_OFFERS Valor de cadena: at-content-rendering-no-offers Descripción: este evento se activa cuando no se devuelven ofertas. Redireccionamiento de representación de contenido Constante: adobe.target.event.CONTENT_RENDERING_REDIRECT Valor de cadena: at-content-rendering-redirect Descripción: este evento se activa cuando una oferta es redireccionada y Target la redirecciona a otra URL. |
mbox | Cadena | nombre de mbox |
message | Cadena | Contiene una descripción legible por humanos, como lo que sucedió, el mensaje de error, etc. |
seguimiento | Objeto | Contiene el sessionId y deviceId . En algunos casos, el deviceId podría no estar porque Target no lo pudo recuperar del servidor Edge. |
document.addEventListener(adobe.target.event.REQUEST_SUCCEEDED, function(event) {
console.log('Event', event);
});
Vea el siguiente vídeo para aprender a utilizar los tokens de respuesta y los eventos personalizados de at.js con el fin de compartir información de perfil de Target con sistemas de terceros.