Métodos de página de Target por versión de biblioteca mbox.js

La manera en que Target hace y responde llamadas desde la página depende de la versión de la biblioteca de Target que está usando, de si la implementación del ID de visitante de Experience Cloud está presente y de si existe el ID de visitante.

IMPORTANTE

Fin de vida útil de mbox.js: Desde el 31 de marzo de 2021, Adobe Target no es compatible con la biblioteca mbox.js . Después del 31 de marzo de 2021, todas las llamadas realizadas desde mbox.js producirán errores y afectarán a las páginas que tengan actividades Target ejecutándose al servir contenido predeterminado.

Recomendamos que todos los clientes migren a la versión más reciente de la nueva Adobe Experience Platform Web SDK o la biblioteca JavaScript at.js antes de esta fecha para evitar cualquier problema potencial con sus sitios. Para obtener más información, consulte Información general: implementar Target para la web del lado del cliente.

NOTA

Si usa at.js, todas las llamadas se realizan con JSON. Esta página proporciona detalles sobre las versiones de la biblioteca mbox.js. Los comportamientos que se describen en los casos siguientes no se aplican a at.js.

En esta sección se proporciona información sobre cómo cada versión de la biblioteca de Target responde a la llamada de Target desde la página en cada uno de los casos siguientes.

Existen varios tipos de extremos, según la implementación y la versión de la biblioteca. Debe conocer cada tipo para entender cómo Target responde a las llamadas en cada escenario.

Tipo/Extremo Llamar a método Contenido de la respuesta
crear automáticamente mbox global: sincrónico document.write para realizar llamada JavaScript sin document.write()
crear automáticamente mbox global: asincrónico createElement() para anexar llamada a cuerpo JavaScript sin document.write()
standard document.write para realizar llamada JavaScript con document.write()
ajax createElement() para anexar llamada a cuerpo JavaScript sin document.write()
json XMLHTTPrequest() para realizar llamada devuelve respuesta de JSON
IMPORTANTE

Para cualquier tipo, excepto estándar, todos los códigos personalizados y las ofertas deben escribirse para admitir un entorno ajax. Por ejemplo, si se usa un JavaScript que incluye document.write(), el script no funcionará como se espera.

Sin implementación de ID de visitante

Si usa Target Standard o Premium con mbox.js y habilitó Crear mbox global para su cuenta, se realizará el tipo de llamada y respuesta crear automáticamente mbox global sincrónico, independientemente de la versión de mbox.js.

Si escribe su propio código personalizado en lugar de usar las acciones del Compositor de experiencias visuales, asegúrese de que el código sea adecuado para un entorno ajax. Por ejemplo, si se usa un JavaScript que incluye document.write(), el script no funcionará como se espera.

NOTA

Varias llamadas de mbox ajax con el mismo nombre de mbox pero parámetros diferentes no funcionarán en la misma página. Solo se realizará la primera llamada.

Si usa “crear automáticamente mbox global” pero también tiene llamadas mboxCreate en su página; por ejemplo, si está implementando Target Standard o Premium en una página que anteriormente usaba una implementación heredada, las llamadas de mbox global se realizan con el extremo “crear automáticamente mbox global: estándar” y las llamadas mboxCreate se realizan con el extremo estándar. El extremo estándar usa document.write() para realizar y responder la llamada. Esto bloquea la carga de la página, incluido el contenido entregado en la respuesta ajax, hasta que se descargue toda la información.

Si usa solamente mboxCreate, por ejemplo en páginas creadas con Target Classic, la página funciona como siempre.

Método de creación mbox.js v57 mbox.js v58 mbox.js v59 mbox.js v60
crear automáticamente mbox global crear automáticamente mbox global: sincrónico crear automáticamente mbox global: sincrónico crear automáticamente mbox global: sincrónico crear automáticamente mbox global: sincrónico
mboxCreate standard standard standard standard

Con implementación de ID de visitante, pero sin ID de visitante establecido

Si no se estableció ningún ID de visitante, no hay ninguna cookie de visitante de Experience Cloud para el usuario. La página llama al servicio de ID de visitante para obtener el ID del visitante. espera la respuesta mientras el ID realiza la llamada a TargetTarget.

NOTA

Se recomienda usar la versión 58 de Mbox.js para garantizar que el ID de visitante se devuelva antes de realizar la llamada de Target.

Si está usando la versión 57 de mbox.js en este caso, todo funciona como si no hubiera implementación de ID de visitante, tal como se describió en el caso anterior. A partir de la versión 58 de mbox.js, el servicio Experience Cloud Visitor ID regresa con un ID de visitante antes de realizar llamadas de Target. Así, los datos de audiencia que se comparten a través del servicio principal de Perfiles y Audiencias están disponibles para la primera llamada de Target en la sesión del visitante. Para evitar que el contenido predeterminado parpadee antes de que se devuelva el contenido de la prueba, Target oculta la etiqueta <BODY> hasta que se devuelve el servicio de ID de visitante. En la versión 58, se usa display:none para ocultar la página. Esto crea algunos problemas con sitios adaptables, por lo que a partir de la versión 59, se usa opacity:0 para ocultar el contenido.

Método de creación mbox.js v57 mbox.js v58 mbox.js v59 mbox.js v60
crear automáticamente mbox global crear automáticamente mbox global: sincrónico crear automáticamente mbox global: asincrónico crear automáticamente mbox global: asincrónico crear automáticamente mbox global: asincrónico
mboxCreate standard ajax ajax ajax

Con implementación de ID de visitante, y existe el ID de visitante

Si existe la cookie del ID de visitante, Target no necesita realizar una llamada al servicio de ID de visitante. En este caso, no es necesario esperar el servicio de ID de visitante antes de mostrar el contenido. Para las versiones 57 a 59, se usa el tipo crear automáticamente mbox global: sincrónico, de modo que la página espera a que se devuelva la llamada a Target antes de seguir cargándose. Esto garantiza que no sea vean parpadeos en el contenido predeterminado. Con la versión 60, se usa el tipo mbox global: asincrónico para garantizar que Target espere a que responda el servicio de exclusión de Experience Cloud. El servicio de exclusión forma parte de la inclusión de datos en el otoño de 2016. Como todas las llamadas se devuelven mediante ajax, document.write() no debería usarse con la versión 60 de mbox.js.

Método de creación mbox.js v57 mbox.js v58 mbox.js v59 mbox.js v60
crear automáticamente mbox global crear automáticamente mbox global: sincrónico crear automáticamente mbox global: sincrónico crear automáticamente mbox global: sincrónico crear automáticamente mbox global: asincrónico (para admitir el desarrollo de la inclusión de datos, que se lanzará más tarde en 2016)
mboxCreate standard standard standard ajax

En esta página

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now