Show Menu
TEMAS×

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() .
    Para obtener más información sobre las diversas funciones mencionadas en la tabla anterior, consulte funciones de at.js .
    ¿Tiene personalizaciones para el archivombox.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 archivombox.jsen 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.
    ¿IntegraTargetcon 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 .
    ¿IntegraTargetcon 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?
    • Dynamic Tag Management
    • Ensighten
    • Tealium
    • Signal/BrightTag Para obtener más información, consulte Integraciones de at.js .
    Si actualmente no usa un administrador de etiquetas para implementar Target, este puede ser un buen momento para planteárselo. Dynamic Tag Management de Adobe es una herramienta gratuita para los clientes de Target y es el método recomendado para implementar Target. Para obtener más información, consulte Prácticas recomendadas para implementar Adobe Target mediante Dynamic Tag Management .
  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 &lt;/&gt;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 .