DocumentaciónExperience PlatformMigración de Target de at.js 2.x a SDK web

Comparación de at.js con el SDK web de Platform

Last update: Thu Oct 03 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Temas:

Creado para:

  • Intermedio
  • Experimentado
  • Desarrollador

La biblioteca independiente at.js de Adobe Target difiere considerablemente del SDK web de Platform. Las siguientes tablas son una referencia para ayudarle a evaluar las áreas de la implementación en las que puede que tenga que centrarse durante el proceso de migración.

Después de revisar la información que aparece a continuación y evaluar su implementación técnica actual de at.js, debería poder comprender lo siguiente:

  • Qué funciones de Target son compatibles con el SDK web de Platform
  • Qué funciones de at.js tienen equivalentes del SDK web de Platform
  • Aplicación de la configuración de Target con el SDK web de Platform
  • Diferencias entre el flujo de datos de at.js y el SDK web de Platform

Si es nuevo en el SDK web de Platform, no se preocupe: los elementos siguientes se tratan con más detalle a lo largo de este tutorial.

Comparación de características

Target at.js 2.x
SDK web de Platform
Actualizar perfil de Target
Admitido
Admitido
Vista de déclencheur SPA para la
Admitido
Admitido
Target Recommendations
Admitido
Admitido
Buscar ofertas basadas en formularios
Admitido
Admitido
Seguimiento de eventos
Admitido
Admitido
A4T: aplicación de una sola página
Admitido
Admitido
A4T: rastreo de clics
Admitido
Admitido
A4T: Registro en el lado del cliente
Admitido
Admitido
A4T: Registro en el servidor
Admitido
Admitido
Aplicar ofertas
Admitido
Admitido
SPA Volver a procesar la vista en los informes de sin notificaciones
Admitido
Admitido
Aplicaciones híbridas
Admitido
Admitido
URL de QA
Admitido
Admitido
ID de terceros de Mbox
Admitido
Admitido
Atributos del cliente
Admitido
Admitido
Ofertas remotas
Admitido
Admitido
Ofertas de redirección
Admitido
Compatible. Sin embargo, no se admite el redireccionamiento de una página con el SDK web de Platform a una página con at.js (y en la dirección opuesta).
Toma de decisiones en el dispositivo
Admitido
Actualmente no es compatible
Mboxes de recuperación previa
SPA Admitido para ámbitos personalizados y VEC de
La recuperación previa es el modo predeterminado para el SDK web
Eventos personalizados
Admitido
No compatible. Consulte la hoja de ruta pública para ver el estado actual.
Tokens de respuesta
Admitido
Compatible. Consulte la documentación de tokens de respuesta dedicados para ver ejemplos de código y diferencias entre at.js y el SDK web de Platform
Proveedores de datos
Admitido
No compatible. Se puede usar código personalizado para almacenar en déclencheur un comando del SDK web de Platform sendEvent después de recuperar datos de otro proveedor.

Llamadas dignas de mención

Target at.js 2.x
SDK web de Platform
Mitigación de parpadeo
El fragmento preocultado para implementaciones asincrónicas usa un id. de estilo de at-body-style. at.js busca este ID de elemento para eliminar el estilo una vez que se reciba una respuesta.
El fragmento preocultado predeterminado utiliza un identificador de estilo de alloy-prehiding. El SDK web no es compatible con el fragmento preocultado de at.js, por lo que debe cambiarse como parte del proceso de migración.
Representación automática del contenido al cargar la página
Se controla con una configuración global de Target. Se habilitó cuando pageLoadEnabled está establecido en true.
Especificado en el comando sendEvent del SDK web de Platform. Se habilitó al establecer la opción renderDecisions en true.
Representación manual del contenido
Las funciones applyOffer() y applyOffers() solo admiten el HTML de configuración
El comando applyPropositions admite la configuración, el reemplazo o la adición del HTML para una mayor flexibilidad
Seguimiento de eventos personalizados
Compatible con las funciones trackEvent() y sendNotifications(). Estas funciones son específicas de Target y no afectan a las métricas de Adobe Analytics.
Todos los datos de las llamadas del SDK web de Platform sendEvent se reenvían a Target. Los datos adicionales necesarios específicamente para Target deben incluirse con el comando sendEvent con un eventType de decisioning.propositionDisplay o decisioning.propositionInteract para garantizar que las métricas de Adobe Analytics no se vean afectadas.
CNAME de Target
Compatible. Es independiente del CNAME utilizado para Analytics y del servicio de ID de Experience Cloud.
Ya no es relevante. Se puede utilizar un único CNAME para todas las llamadas al SDK web de Platform.
Depuración
Los parámetros de URL mboxDisable, mboxDebug y mboxTrace se pueden usar para la depuración con las herramientas para desarrolladores del explorador.

El Adobe Experience Platform Debugger también es una herramienta de depuración compatible.
No se admiten los parámetros de dirección URL mboxDisable, mboxDebug y mboxTrace.

Puede activar la depuración del SDK web agregando alloy_debug=true a su cadena de consulta o ejecutando alloy("setDebug", { "enabled": true }); en su consola para desarrolladores.

La extensión del explorador de Adobe Experience Platform Debugger se puede usar para iniciar un seguimiento de Edge para la depuración.

Consulte la documentación de depuración del SDK web de Platform para obtener más información.
Analytics para Target (A4T)
Utiliza valores SDID para unir las llamadas de Target y Analytics
Compatible de forma nativa sin necesidad de vinculación
NOTE
No se admite la migración de Target al SDK web de Platform mientras se mantiene una implementación de Adobe Analytics de AppMeasurement existente para una página determinada.
Es posible migrar la implementación de at.js (y AppMeasurement.js) al SDK web de Platform de una en una. Si adopta este enfoque, es mejor establecer las opciones idMigrationEnabled y targetMigrationEnabled en true con el comando configure.

Funciones de at.js y equivalentes del SDK web de Platform

Muchas funciones de at.js tienen un enfoque equivalente al utilizar el SDK web de Platform que se describe en la siguiente tabla. Para obtener más información sobre las funciones de at.js, consulte la Guía para desarrolladores de Adobe Target.

Función at.js 2.x
Equivalente de SDK web de Platform
getOffer() y getOffers()
Para solicitar y procesar automáticamente experiencias basadas en VEC de Target, use el comando sendEvent y establezca la opción renderDecisions en true.

Para solicitar experiencias basadas en formularios o procesar contenido manualmente, especifique una matriz de decisionScopes (mboxes) con el comando sendEvent.
applyOffer() y applyOffers()
Utilice el comando applyPropositions para aplicar contenido. Puede elegir establecer, reemplazar o anexar el HTML a un selector específico.
triggerView()
El SDK web de Platform almacena automáticamente en déclencheur SPA un cambio de vista a los efectos del VEC de si la propiedad web.webPageDetails.viewName está establecida en la opción xdm del comando sendEvent.
trackEvent() y sendNotifications()
Usar el comando sendEvent con un conjunto specific eventType:

decisioning.propositionDisplay indica la representación de una actividad

decisioning.propositionInteract indica una interacción del usuario con una actividad, como un clic del mouse (ratón).
targetGlobalSettings()
No hay equivalente directo. Consulte la comparación de la configuración de Target para obtener más detalles.
targetPageParams() y targetPageParamsAll()
Todos los datos pasados en la opción xdm del comando sendEvent se asignan a parámetros de mbox de Target. Dado que los parámetros de mbox se denominan con notación de puntos serializada, la migración al SDK web de Platform puede requerir la actualización de las audiencias y actividades existentes para utilizar los nuevos nombres de parámetros de mbox.

Los datos pasados como parte de data.__adobe.target del comando sendEvent se han asignado a perfil de Target y a parámetros específicos de Recommendations.
Eventos personalizados de at.js
No compatible. Consulte la hoja de ruta pública para ver el estado actual. Los tokens de respuesta se exponen como parte de propositions en la respuesta de la llamada a sendEvent.

Configuración de at.js y equivalentes del SDK web de Platform

La biblioteca at.js se puede configurar y descargar con varias opciones en la interfaz de usuario de Target. Esta configuración también se puede actualizar con la función targetGlobalSettings(). La siguiente tabla compara estas configuraciones con las disponibles con el SDK web de Platform.

Configuración de at.js
Equivalente de SDK web de Platform
bodyHiddenStyle
Establecer prehidingStyle con el comando configure
bodyHidingEnabled
Si se define un(a) prehidingStyle con el comando configure, entonces esta característica está habilitada. Si no se define un estilo, el SDK web de Platform no intenta ocultar ningún contenido.
clientCode
Configurado automáticamente
cookieDomain
No aplicable
crossDomain
Establezca la opción thirdPartyCookiesEnabled en true con el comando configure para habilitar las cookies de origen y de terceros en los casos de uso entre dominios
cspScriptNonce y cspStyleNonce
Consulte la documentación para configurar un CSP
dataProviders
No compatible
decisioningMethod
Todos los comandos del SDK web de Platform sendEvent utilizan la toma de decisiones en el lado del servidor. No se admite la toma de decisiones híbrida y en el dispositivo.
defaultContentHiddenStyle y defaultContentVisibleStyle
Solo se aplica con at.js 1.x. Al igual que at.js 2.x, cualquier mitigación de parpadeo para experiencias basadas en formularios se puede realizar mediante código personalizado.
deviceIdLifetime
No compatible. Si targetMigrationEnabled se establece en true con el comando configure, la cookie mbox se establece con la duración del dispositivo establecida en 2 años. Este valor no se puede configurar.
enabled
La funcionalidad de Target se habilita o deshabilita con la configuración del flujo de datos
globalMboxAutoCreate
Establezca la opción renderDecisions en true con el comando sendEvent para recuperar y procesar automáticamente experiencias basadas en VEC.

Solicite un decisionScope para __view__ si prefiere procesar manualmente experiencias basadas en VEC.
imsOrgId
Establecer orgId con el comando configure
optinEnabled y optoutEnabled
Consulte las opciones de privacidad del SDK web de Platform. La opción defaultConsent se aplica a todas las soluciones de Adobe que admite el SDK web de Platform.
overrideMboxEdgeServer y overrideMboxEdgeServerTimeout
No aplicable. Todas las solicitudes del SDK web de Platform utilizan la red de Adobe Experience Platform Edge.
pageLoadEnabled
Establecer la opción renderDecisions en true con el comando sendEvent
secureOnly
No compatible. El SDK web de Platform establece todas las cookies con los atributos secure y sameSite="none".
selectorsPollingTimeout
No compatible. El SDK web de Platform utiliza un valor de 5 segundos. El código personalizado se puede utilizar para procesar contenido manualmente si es necesario.
serverDomain
Usar la configuración edgeDomain con el comando configure
telemetryEnabled
No aplicable
timeout
No compatible. Se recomienda asegurarse de que cualquier código de mitigación de parpadeo incluya un tiempo de espera adecuado.
viewsEnabled
No compatible. El contenido de las vistas de Target siempre se recupera en la primera llamada de sendEvent() si renderDecisions se establece en true o si __view__ decisionScope se incluye en la solicitud.
visitorApiTimeout
No aplicable

Comparación del diagrama del sistema

Los siguientes diagramas le ayudarán a comprender las diferencias del flujo de datos entre una implementación de Target con at.js y una implementación con el SDK web de Platform.

Diagrama del sistema de at.js 2.x

comportamiento de at.js 2.0 al cargar la página {modal="regular"}

Llamada
Detalles
1
La llamada devuelve el ID del Experience Cloud (ECID). Si el usuario está autenticado, otra llamada sincroniza el ID de cliente.
2
La biblioteca at.js se carga sincrónicamente y oculta el cuerpo del documento (at.js también se puede cargar asincrónicamente con un fragmento de ocultamiento previo opcional implementado en la página).
3
Se realiza una solicitud de carga de página que incluye todos los parámetros configurados, ECID, SDID y el ID de cliente.
4
Los scripts de perfil se ejecutan y se alimentan del Almacenamiento de perfiles. El Almacenamiento solicita audiencias de la Biblioteca de audiencias que cumplan los requisitos (por ejemplo, audiencias compartidas de Analytics, Audience Manager, etc.). Los atributos del cliente se envían al Almacenamiento de perfiles en un proceso por lotes.
5
En función de la dirección URL, los parámetros de solicitud y los datos de perfil, Target decide qué actividades y experiencias vuelven al visitante para la página actual y las vistas futuras.
6
Contenido dirigido devuelto a la página, incluyendo, de manera opcional, los valores de perfil para una personalización adicional.

El contenido dirigido en la página actual se muestra lo más rápido posible y sin parpadeo del contenido predeterminado.

El contenido dirigido para vistas futuras de una aplicación de una sola página se almacena en caché en el explorador, por lo que se puede aplicar instantáneamente sin una llamada al servidor adicional cuando se activan las vistas.
7
Datos de Analytics enviados desde la página a los servidores de recopilación de datos.
8
Se comparan los datos de Target con los datos de Analytics mediante el SDID y se procesan en el almacén de informes de Analytics. Por lo tanto, los datos de Analytics se pueden visualizar tanto en Analytics como en Target mediante los informes de A4T.

Consulte la guía para desarrolladores para obtener más información sobre cómo implementar Target mediante at.js para aplicaciones de una sola página.

Diagrama del sistema del SDK web de Platform

Diagrama de la toma de decisiones perimetral de Adobe Target con el SDK web de Platform

Llamada
Detalles
1
El dispositivo carga el SDK web de Platform. El SDK web de Platform envía una solicitud a la red perimetral con datos XDM, el ID de entorno de flujos de datos, los parámetros pasados y el ID de cliente (opcional). La página (o los contenedores) está preoculta.
2
La red perimetral envía la solicitud a los servicios Edge para enriquecerla con el ID de visitante, el consentimiento y otra información de contexto del visitante, como la geolocalización y los nombres descriptivos del dispositivo.
3
La red perimetral envía la solicitud de personalización enriquecida al perímetro de Target con el ID de visitante y los parámetros pasados.
4
Se ejecutan los scripts de perfil y se incluyen en el almacenamiento de perfiles de Target. El almacenamiento de perfiles recupera segmentos de la biblioteca de audiencias (por ejemplo, segmentos compartidos de Adobe Analytics, Adobe Audience Manager y Adobe Experience Platform).
5
En función de los parámetros de la solicitud de la URL y los datos de perfil, Target determina qué actividades y experiencias se mostrarán al visitante en la vista de página actual y en futuras vistas recuperadas previamente. A continuación, Target lo devuelve a la red perimetral.
6
a. La red perimetral envía la respuesta de personalización de vuelta a la página, incluyendo, de forma opcional, los valores de perfil para una personalización adicional. El contenido personalizado de la página actual se muestra lo más rápido posible y sin parpadeo del contenido predeterminado.

b. SPA El contenido personalizado para vistas que se muestran como resultado de acciones del usuario en una aplicación de una sola página () se almacena en caché para un procesamiento instantáneo sin llamadas al servidor adicionales.

c. La red perimetral envía el ID de visitante y otros valores en cookies (por ejemplo, consentimiento, ID de sesión, identidad, comprobación de cookies, personalización, etc.).
7
La red perimetral reenvía detalles de Analytics for Target (A4T) (metadatos de actividad, experiencia y conversión) al perímetro de Analytics.

Consulte la guía para desarrolladores para obtener más información sobre cómo implementar Target mediante el SDK web de Platform para aplicaciones de una sola página.

Después de tener una buena comprensión técnica de su implementación actual de Target y de las características que utiliza, el siguiente paso es realizar la configuración inicial.

NOTE
Nos comprometemos a ayudarle a tener éxito con su migración de Target de at.js al SDK web. Si encuentra obstáculos con la migración o cree que falta información esencial en esta guía, comuníquenoslo publicando en esta discusión de la comunidad.
recommendation-more-help
a69e1b51-9545-4d8a-822d-319242c29110