Cómo migrar de mbox.js a at.js

La migración de mbox.js a at.js en Adobe Target es un proceso directo.

Siga estos pasos para migrar de mbox.js a at.js y para comprobar la migración:

  1. Determine los requisitos de compatibilidad con exploradores de su organización.

  2. Compruebe si hay funciones que mbox.js no admite en la implementación de at.js actual de su sitio web.

    Cuando audite su implementación, busque lo siguiente:

    ¿Qué tipos de mboxes usa actualmente?

    Tipo Detalles
    Mbox global creado automáticamente El mbox global creado automáticamente se crea cuando la única línea del código de Target en su sitio es el archivo mbox.js. Ese archivo genera automáticamente una llamada de mbox.
    mboxCreate global y vacío Se recomienda cambiar al mbox global creado automáticamente.
    Envolver mboxCreate La migración debería ser sencilla, siempre y cuando su mboxCreate() esté precedida por <div class="mboxDefault"></div>.
    mboxUpdate La migración debería ser sencilla cuando mboxUpdate() se usa junto con mboxDefine() o mboxCreate(). mboxUpdate() no actualiza el mbox global creado automáticamente ni un mbox creado originalmente por getOffer(). En estas circunstancias, se debería usar una combinación de getOffer() y applyOffer() para reemplazar a mboxUpdate() al migrar a at.js.
    Mboxes personalizados de rastreo de clics, incluido mboxTrack Le recomendamos que actualice el código para que use trackEvent().
    NOTA

    Para obtener más información sobre las diversas funciones mencionadas en la tabla anterior, consulte funciones de at.js.

    ¿Tiene personalizaciones para el archivo mbox.js?

    • mboxParameters()
    • mboxSupported()
    • mboxCookieDomain()
    • JavaScript extra
    • Otras ubicaciones

    La mayoría de los objetos y métodos de mbox.js (como mbox, mboxCurrent, mboxFactoryDefault, mboxFactories, etc.) no son compatibles. Tal vez pueda usar otros métodos para lograr lo que está intentando hacer.

    ¿Tiene el archivo mbox.js en alguna de sus páginas web?

    Los archivos at.js y mbox.js no se pueden usar a la vez en la misma página web. Sin embargo, puede usar las dos bibliotecas de JavaScript en dos páginas distintas del mismo sitio web.

    La cookie de mbox es el principal medio que tiene Adobe de llevar al visitante de un sitio a otro. En el proceso de control de calidad, debe confirmar que la cookie se conserva y se lee correctamente cuando el visitante va y vuelve entre las páginas que tienen at.js y las que tienen mbox.js. Asegúrese de que se pasan los mismos valores de mboxPC y mboxSession en las llamadas de mbox independientemente de la sección del sitio (at.js o mbox.js) que el visitante vea primero y de la sección que establece la cookie originalmente. Si usa cookies de terceros en la implementación, debe cerciorarse de que estos valores permanecen inmutables al navegar por el sitio.

    ¿Integra Target con otras soluciones de Adobe?

    • Analytics (A4T)
    • Analytics (integración anterior)
    • AAM (servidor)
    • AAM (front-end anterior)
    • AEM
    • Data Workbench:

    Algunas de las integraciones heredadas no son compatibles con at.js. Para obtener más información, consulte la página Integraciones.

    ¿Integra Target con herramientas de terceros?

    • Otras herramientas de Analytics
    • Otos DMP
    • Demandbase
    • Click-tale
    • Otro:

    Puede que haya que ajustar estas integraciones para que funcionen con at.js. Para obtener más información, consulte la página Integraciones.

    ¿Usa un administrador de etiquetas?

    • Adobe Experience Platform Launch
    • Ensighten
    • Tealium
    • Signal/BrightTag

    Para obtener más información, consulte Integraciones de at.js.

    NOTA

    Si actualmente no usa un administrador de etiquetas para implementar Target, este puede ser un buen momento para planteárselo.

    Platform Launch es la plataforma de administración de etiquetas de próxima generación de Adobe y es el método preferido para implementar Adobe Target. Platform Launch ofrece a los clientes una alternativa sencilla para implementar y gestionar las etiquetas de análisis, marketing y publicidad necesarias para ofrecer al cliente experiencias más relevantes.

    Para obtener más información, consulte Implementar Target utilizando Adobe Platform Launch.

  3. Compruebe que todas las actividades e integraciones actuales funcionan correctamente.

    Estas son algunas acciones que puede realizar mientras prueba para confirmar que at.js funciona tal como se espera:

    • Asegúrese de que todas las actividades actuales funcionen con la nueva biblioteca JavaScript.
    • Confirme que todas las Las integraciones y complementos funcionan según lo esperado.
    • Asegúrese de estar cómodo con la depuración de los enfoques disponibles con at.js.

Posibles problemas al migrar a at.js Algunos clientes han informado de los siguientes problemas después de realizar la migración a at.js:

  • Es posible que se deban actualizar algunas actividades del VEC generadas en una página con mbox.js para que funcionen con at.js.

    Este problema ocurre principalmente en los sitios web que no utilizan muchos atributos de ID o de clase en los elementos HTML. Para comprobar si tiene este problema, cargue la página y determine si la experiencia se ofrece según lo previsto cargando la página con ?mboxDebug=true y revisando los registros de la consola.


    En estos casos, los selectores de elementos podrían iniciarse con algo parecido a

    HTML > BODY > DIV:nth-of-type(2)
    

    y se han generado con la idea de que mbox.js agregó un elemento adicional de <div> al inicio de la página. Dado que at.js no agrega ningún elemento de <div> al inicio de la página, este selector no funcionaría con at.js.

    Este problema se puede resolver recreando la actividad en el VEC en la URL que utiliza at.js o actualizando el selector de forma manual mediante la opción Código </> > Modificaciones en el VEC.

    Para resolver este problema, debe restar 1 del número nth-of-type en el primer elemento DIV después de BODY. En el ejemplo anterior, el código editado sería:

    HTML > BODY > DIV:nth-of-type(1)
    

    Para obtener más información sobre cómo utilizar el editor de código para hacer esto, consulte Editor de código.

  • Como todos los mboxes ahora son asincrónicos, no bloquearán el procesamiento de páginas ni devolverán el orden en que se activaron. Para obtener más información, consulte “Consideraciones asincrónicas” en Limitaciones de at.js.

En esta página