Depuración y solución de problemas de recopilación de datos

La depuración de la recopilación de datos implica comprobar cómo se comporta la implementación y qué sucede con los datos que envía. Comience con el síntoma y, a continuación, siga el evento a través de cada fase de la recogida hasta encontrar dónde deja de comportarse según lo esperado.

El registro de depuración expone los comandos de SDK, la ejecución de etiquetas, las advertencias y los errores en el explorador o en el tiempo de ejecución de la aplicación. La inspección de solicitudes expone las cargas útiles, las respuestas y, para los flujos de trabajo admitidos, el procesamiento del lado del servidor. Estos enfoques suelen complementarse entre sí: un registro puede explicar por qué se retrasó un evento, mientras que una captura de red puede mostrar si se envió una solicitud.

Siga el evento durante la recopilación diagnostic-workflow

Investigue las siguientes etapas en orden. La evidencia de que una etapa tuvo éxito no establece que las etapas posteriores también tuvieron éxito.

  1. Ejecución de implementación: ¿Se ejecutó el comando de SDK o la regla de etiquetas? Compruebe los mensajes y errores de diagnóstico. Si la administración de consentimiento o identidad retrasa un evento, investigue ese estado antes de buscar una solicitud de red. Consulte Habilitar el registro de depuración.
  2. Solicitud saliente: ¿Se envió la solicitud y contiene los datos esperados? Inspeccione la carga útil y compárela con las entradas de comandos o los elementos de datos. Ver Inspeccionar solicitudes web o Inspeccionar solicitudes móviles y de servidor.
  3. Recepción del servidor: ¿el extremo de recopilación recibió la solicitud? Inspeccione la respuesta donde esté disponible o utilice un seguimiento compatible del lado del servidor. Un registro de cliente que indica que se envió una solicitud no es una confirmación de recepción.
  4. Procesamiento y enrutamiento de Edge: ¿el evento utilizó el conjunto de datos deseado y los servicios configurados? Para Web SDK, el parámetro configId de la solicitud ​ muestra qué secuencia de datos utilizó y Edge Trace muestra cómo Edge Network procesó el evento.
  5. Procesamiento descendente: ¿Aceptó el destino y procesó el evento según lo esperado? Use las instrucciones depuración específica del producto del destino. Una respuesta correcta de Edge Network no prueba que los datos estén disponibles en todos los informes o almacenes posteriores.

Elegir un punto de partida choose-a-starting-point

En la tabla siguiente se identifican pruebas útiles para tareas comunes. Cuando se aplican ambos enfoques, responden a diferentes partes de la investigación. Los mensajes y las herramientas disponibles dependen de SDK, del tiempo de ejecución y de los servicios configurados.

Tarea o síntoma
Registro de Debug
Solicitar inspección
Siguiente comprobación
No aparece un evento esperado
Compruebe la ejecución de comandos o reglas, los errores y los mensajes sobre los retrasos de consentimiento o identidad.
Compruebe si se ha emitido una solicitud e inspeccione su carga útil y respuesta.
Comience por registrar, luego inspeccionar solicitudes. Para ver los síntomas relacionados con la identidad, consulte Solución de problemas de identidad.
Una solicitud contiene datos inesperados
Compare las entradas de los comandos de SDK y la ejecución de las etiquetas con los valores que pretendía enviar.
Inspeccione la carga útil saliente real; compárela con Seguimiento de Edge si hay transformaciones involucradas.
Compruebe los elementos de datos, las entradas de comandos y la configuración de secuencia de datos.
Una solicitud aparece cancelada durante la navegación
Compruebe si SDK intentó enviar el evento o si lo seguía reteniendo.
Inspeccione la solicitud y, si es posible, la respuesta del servidor o el seguimiento de Edge. La etiqueta cancelada del explorador por sí sola no es concluyente.
Ver Solicitudes anuladas y Web SDK documentUnloading.
Las solicitudes aparecen correctamente, pero faltan los datos de destino
Establezca la configuración y las entradas que utiliza la implementación. Los registros de cliente no pueden confirmar el procesamiento descendente.
Utilice Edge Trace, Assurance y diagnósticos específicos de destino.
Compruebe la secuencia de datos, los servicios habilitados, el enrutamiento y el procesamiento de destino. Ver Seguimiento del procesamiento de Edge Network y Depuración específica del producto.
Los eventos aparecen duplicados
Busque llamadas de comando repetidas o ejecución de regla de etiqueta.
Comparar recuentos de solicitudes, cargas útiles e identificadores. Varias solicitudes de cliente no son la única fuente posible de duplicación.
Investigue los reintentos y el envío de al menos una vez, así como la ejecución repetida del cliente. Consulte Gestión de duplicación de eventos.
Una implementación móvil o de servidor se comporta de forma inesperada
Revise el resultado de SDK en el tiempo de ejecución del servidor o la aplicación, en lugar de solo la consola del explorador.
Utilice Assurance para los flujos de trabajo móviles admitidos o inspeccione el tráfico HTTP de la aplicación. Las herramientas del explorador no pueden mostrar las llamadas salientes del servidor.
Consulte Registro de Mobile SDK y Server SDK e Inspeccionar solicitudes de móviles y servidores.

Depuración específica de productos product-specific

Los artículos de esta sección se aplican a toda la recopilación de datos de Experience Platform. Las aplicaciones de Adobe que reciben los datos pueden utilizar sus propios extremos, formatos de solicitud, vistas de validación y procesamiento. Después de confirmar que Edge Network recibió y enrutó un evento, o cuando la implementación envía datos directamente a una aplicación, continúe con las instrucciones de depuración de esa aplicación:

Continúe con la investigación next-steps

Antes de compartir registros, seguimientos o capturas de red, quite credenciales, identificadores de visitantes y otra información confidencial según las directivas de su organización.

recommendation-more-help
experience-platform-help-collection