Depuración de Target con el SDK web de Platform
Creado para:
- Intermedio
- Experimentado
- Desarrollador
Verificar las actividades de Target y depurar el SDK web para solucionar problemas de implementación, entrega de contenido o calificación de audiencia. En esta página de la guía de migración se explican las diferencias entre la depuración con at.js y el SDK web de Platform.
La tabla siguiente resume las funciones y la compatibilidad con los enfoques de prueba y depuración.
| Función o herramienta | Compatibilidad con at.js | Compatibilidad con SDK web de Platform |
|---|---|---|
| URL de QA de actividad | Sí | Sí |
mboxDisable parámetro de URL | Sí | Consulte la siguiente información para deshabilitar la funcionalidad de Target |
mboxDebug parámetro de URL | Sí | Usar parámetro alloy_debug para información de depuración similar |
mboxTrace parámetro de URL | Sí | Utilice la extensión del explorador de Experience Platform Debugger. |
| extensión de Adobe Experience Platform Debugger | Sí | Sí |
alloy_debug parámetro de URL | No aplicable | Sí |
| Adobe Experience Platform Assurance | No aplicable | Sí |
extensión del explorador de Adobe Experience Platform Debugger
La extensión de Adobe Experience Platform Debugger para Chrome y Firefox examina sus páginas web y le ayuda a validar las implementaciones de Adobe Experience Cloud.
Puede ejecutar Platform Debugger en cualquier página web y la extensión tendrá acceso a los datos públicos. Para acceder a datos que no son públicos mediante la extensión, como la información de seguimiento de Target, debe autenticarse en el Experience Cloud a través del vínculo Iniciar sesión.
Obtención e instalación del Adobe Experience Platform Debugger
El Adobe Experience Platform Debugger se puede instalar en navegadores Google Chrome o Mozilla Firefox. Siga el vínculo adecuado a continuación para instalar la extensión en su explorador preferido:
Después de instalar la extensión de Chrome o el complemento de Firefox, se agrega un icono (
Consulte la guía especializada para obtener más información sobre la extensión de Adobe Experience Platform Debugger y cómo depurar todas las aplicaciones web de Adobe.
Previsualización de actividades de Target con direcciones URL de control de calidad
Tanto at.js como el SDK web de Platform le permiten previsualizar actividades de Target mediante direcciones URL de control de calidad de Target, y ambos métodos de implementación admiten las mismas funciones de control de calidad.
Direcciones URL de control de calidad de Target que funcionan indicando a at.js o al SDK web de Platform que escriban una cookie específica en el explorador denominada at_qa_mode. Esta cookie se utiliza para forzar la calificación para una actividad y experiencia en particular.
CAUTIONxdm.web.webPageDetails.URL pasado en la llamada sendEvent. Cualquier modificación en este valor, como la reversión en minúsculas de todos los caracteres, puede impedir que el modo de control de calidad de Target funcione correctamente.Consulte la guía dedicada para obtener más información sobre el control de calidad de la actividad de Target.
Implementación de Debug Target
En la tabla siguiente se describen las diferencias entre at.js y las tácticas de depuración del SDK web de Platform:
| Función at.js | Equivalente de SDK web de Platform |
|---|---|
| Mbox Disable - deshabilitar Target para que no recupere ni procese para comprobar si la página está dañada sin interacciones de Target Cargar página con parámetro de URL: mboxDisable=true | No hay equivalente directo. Puede bloquear todas las solicitudes del SDK web de Platform con las herramientas para desarrolladores del explorador. |
| Depuración de mbox: registra todas las acciones de at.js en la consola del explorador para solucionar los problemas de procesamiento Cargar página con parámetro de URL: mboxDebug=true | Alloy Debug: registra acciones detalladas del SDK, incluidas, entre otras, las acciones de personalización de Target. Cargar página con parámetro de URL: alloy_debug=trueO ejecutar alloy("setDebug", { "enabled": true }); en la consola de desarrollador |
Seguimiento de Target: con un token de seguimiento de mbox generado en la interfaz de usuario de Target, hay disponible un objeto de seguimiento con detalles que participaron en el proceso de toma de decisiones en el objeto window.___target_trace.Cargar página con el parámetro de URL: mboxTrace=window&authorization={TOKEN} | Utilice la extensión de Adobe Experience Platform Debugger o Platform Assurance. |
NOTEDeshabilitar funcionalidad de Target
En la actualidad, el SDK web de Platform no tiene una función para suprimir selectivamente las respuestas de Target. Sin embargo, es posible suprimir las solicitudes del SDK web de Platform con las herramientas para desarrolladores del explorador, varias extensiones del explorador o aplicaciones de terceros. Por ejemplo, para bloquear el SDK web de Platform con Google Chrome:
- Haga clic con el botón derecho en cualquier lugar de la página y seleccione Inspect
- Seleccione la ficha Red
- Filtre por la cadena
//ee//para ver solo las llamadas del SDK web de Platform - Volver a cargar la página
- Haga clic con el botón derecho en una de las solicitudes de red filtradas y seleccione Bloquear dominio de solicitud
- Vuelva a cargar la página y observe que la solicitud de red está bloqueada
- Cuando haya terminado de depurar, haga clic con el botón derecho en la solicitud de red bloqueada y seleccione Desbloquear o cierre el panel Herramientas para desarrolladores
Ver registro de depuración
El registro de depuración para at.js mediante el parámetro de URL mboxDebug=true muestra información detallada sobre cada solicitud, respuesta e intento de Target de procesar el contenido en la página. El SDK web de Platform tiene un registro de depuración similar que utiliza el parámetro de URL alloy_debug=true.
mboxDebug=true)alloy_debug=true)AT:[alloy]NOTEVer seguimientos de Target
Los seguimientos de Target proporcionan información detallada sobre las cualificaciones de la actividad y el perfil de Target del visitante. Dado que los seguimientos de Target contienen información que no está disponible públicamente, su visualización requiere un token de autorización o autenticación dentro de la ventana de extensión del explorador de Adobe Experience Platform Debugger.
mboxTrace parámetro de URLPara ver los seguimientos de Target del SDK web de Platform con el Adobe Experience Platform Debugger, haga lo siguiente:
- Vaya a una página del sitio que tenga Target implementado con el SDK web de Platform
- Abra la extensión de Adobe Experience Platform Debugger seleccionando el icono (
- Seleccione el vínculo Iniciar sesión
- Autentique con su inicio de sesión en Adobe Experience Cloud
- Seleccione la ficha Registros a la izquierda
- Seleccione la ficha Edge en la parte superior
- Si lo desea, asigne un nombre a la sesión de depuración y haga clic en el botón Conectar
- Vuelva a cargar la página, y el registro debe rellenarse con información detallada acerca de las interacciones de red perimetral
- Céntrese en las entradas de registro que comienzan con "Seguimiento de destino" en la descripción y seleccione Ver para ver los detalles de seguimiento de destino
Después de seleccionar Ver, aparecerá una superposición que le permitirá ver la siguiente información relacionada con la solicitud:
- Actividades coincidentes
- Actividades no coincidentes
- Solicitar detalles
- Instantánea de perfil
Consulte la guía dedicada sobre depuración de la entrega de contenido de Target para obtener más información sobre los seguimientos de Target.
Solucionar problemas con Assurance
La información de seguimiento de Target se puede ver tanto en la extensión del explorador de Adobe Experience Platform Debugger como en la aplicación Assurance (anteriormente conocida como Project Griffon). Para ver los seguimientos de Target en Assurance, haga lo siguiente:
- Abra la extensión del explorador de Adobe Experience Platform Debugger y conecte una sesión de depuración remota como se ha descrito anteriormente
- Seleccione el vínculo con el nombre de la sesión sobre el registro de depuración
- Platform Assurance carga y muestra el registro detallado de todas las aplicaciones de Adobe configuradas en el flujo de datos de su implementación
- Filtrar el registro por
adobe.target - Seleccione una entrada de registro con el tipo
com.adobe.target.trace - Expanda los detalles de la carga útil y vea la información en
context > targetTrace
Examinar solicitud y respuesta de red
La carga útil de solicitud y la respuesta de las llamadas del SDK web de Platform sendEvent difieren de at.js. La descripción siguiente le ayudará a comprender la estructura de la solicitud y la respuesta mientras examina las llamadas de red con las herramientas para desarrolladores del explorador.
Carga útil de solicitud de contenido
- El perfil, la entidad y otros parámetros que no son de mbox se pasan en la matriz de eventos en
data.__adobe.target - Los ámbitos de decisión se encuentran en la matriz de eventos en
query.personalization.decisionScopes - Los datos XDM asignados a parámetros de mbox descendentes se encuentran en la matriz de eventos en
xdm
Cuerpo de respuesta de contenido
- El SDK web de Platform devuelve acciones para todas las aplicaciones de Adobe bajo el objeto
handle - La acción
personalization:decisionssignifica una respuesta del offer decisioning o destinatario - Las propuestas de destino se presentan como una matriz, cada una con un identificador de propuesta único con el prefijo
AT: - El ámbito de decisión y los detalles de la actividad se encuentran en la matriz de propuestas
- Los detalles de la oferta se encuentran en la matriz
itemsendata - Los tokens de respuesta se encuentran en la matriz
itemsenmeta
Carga útil de evento de propuesta
- Los eventos específicos de SDK de destino son
decisioning.propositionDisplaypara una impresión odecisioning.propositionInteractpara una interacción, como un clic - Los detalles del evento de propuesta se encuentran en la matriz de eventos bajo
xdm._experience.decisioning - El ID de propuesta del evento de visualización o interacción debe coincidir con el ID de propuesta del contenido devuelto desde Target
¡Felicidades, ha llegado al final del tutorial! ¡Buena suerte al migrar su implementación de Adobe Target al SDK web!
NOTE