Mobile Session Replay Setup and Configuration

This page is not yet available in Spanish. We are working on its translation.
If you have any questions or feedback about our current translation project, feel free to reach out to us!

Configuración

Puedes encontrar todas las versiones de SDK de Session Replay en el repositorio de snapshots de Maven.

Para configurar Session Replay para móviles en Android:

  1. Asegúrate de haber configurado e inicializado el SDK Android de Datadog RUM con la instrumentación de vistas habilitada.

  2. Declara Datadog Session Replay como dependencia:

build.gradle

    implementation("com.datadoghq:dd-sdk-android-rum:[datadog_version]")
    implementation("com.datadoghq:dd-sdk-android-session-replay:[datadog_version]")
    // en caso de que necesites asistencia material
    implementation("com.datadoghq:dd-sdk-android-session-replay-material:[datadog_version]")
   
  1. Habilita Session Replay en tu aplicación:

Application.kt

   val sessionReplayConfig = SessionReplayConfiguration.Builder([sampleRate])
    // en caso de que necesites soporte de ampliación de material
    .addExtensionSupport(MaterialExtensionSupport()) 
    .build()
   SessionReplay.enable(sessionReplayConfig)
   

Para configurar Session Replay para móviles en iOS:

  1. Asegúrate de haber configurado e inicializado el SDK iOS de Datadog RUM con la instrumentación de vistas habilitada.

  2. Vincula la biblioteca Session Replay de Datadog con tu proyecto, en función de tu gestor de paquetes:

    Gestor de paquetesEtapa de instalación
    CocoaPodsAñade pod 'DatadogSessionReplay' a tu Podfile.
    Swift paquete ManagerAñade la biblioteca DatadogSessionReplay como dependencia a tu aplicación de destino.
    CarthageAñade DatadogSessionReplay.xcframework como dependencia a tu aplicación de destino.
  3. Habilita Session Replay en tu aplicación:

AppDelegate.swift

   import DatadogSessionReplay

   SessionReplay.enable(
       with: SessionReplay.Configuration(
           replaySampleRate: sampleRate
       )
   )
   

Instrumentación de vistas web

Puedes grabar todo el recorrido del usuario tanto en vistas web como nativas en iOS o Android y verlo en una única reproducción de sesión.

La reproducción de la sesión se graba en el SDK del navegador y luego el SDK móvil se encarga de la agrupación y carga de la grabación de la vista web.

Para instrumentar tu web consolidada y las vistas nativas Session Replay para Android:

  1. Asegúrate de que estás utilizando la versión 2.8.0 o posterior del SDK de Android.
  2. Habilita el rastreo de vistas web para tu aplicación móvil.
  3. Habilita Session Replay para tu aplicación web.
  4. Habilita la reproducción de la sesiones para tu aplicación móvil (consulta las instrucciones de configuración anteriores).

Para instrumentar tu web consolidada y las vistas nativas Session Replay para iOS:

  1. Asegúrate de que estás utilizando la versión 2.13.0 o posterior del SDK de iOS.
  2. Habilita el rastreo de vistas web para tu aplicación móvil.
  3. Habilita Session Replay para tu aplicación web.
  4. Habilita la reproducción de la sesiones para tu aplicación móvil (consulta las instrucciones de configuración anteriores).

Configuración adicional

Configuración de la frecuencia de muestreo para las sesiones grabadas

La frecuencia de muestreo es un parámetro obligatorio en la configuración de Session Replay. Debe ser un número entre 0.0 y 100.0, donde 0 significa que no se graban repeticiones y 100 significa que todas las sesiones RUM contienen repeticiones.

Esta frecuencia de muestreo se aplica además de la frecuencia de muestreo de RUM. Por ejemplo, si RUM utiliza una frecuencia de muestreo del 80% y Session Replay utiliza una frecuencia de muestreo del 20%, significa que, de todas las sesiones de usuario, el 80% están incluidas en RUM, y que, dentro de esas sesiones, sólo el 20% tienen repeticiones.

Application.kt

val sessionReplayConfig = SessionReplayConfiguration.Builder([sampleRate])
 ...
.build()

AppDelegate.swift

var sessionReplayConfig = SessionReplay.Configuration(
    replaySampleRate: sampleRate
)

Confirmar si se están enviando datos de Session Replay

Para confirmar si los datos de Session Replay se están enviando desde la aplicación, puedes habilitar la opción de depuración en el SDK de Datadog:

Application.kt

Datadog.setVerbosity(Log.DEBUG)

AppDelegate.swift

Datadog.verbosityLevel = .debug

Si todo va bien, deberían aparecer los siguientes logs en la consola de depuración Xcode, unos 30 segundos después de iniciar la aplicación:

Xcode console

[SDK DATADOG] 🐶 → 10:21:29.812 ⏳ (session-replay) Carga de lote en curso...
[SDK DATADOG] 🐶 → 10:21:30.442    → (session-replay) aceptado, no se volverá a transmitir: [código de la respuesta: 202 (aceptado), ID de la solicitud: BD445EA-...-8AFCD3F3D16]

Opciones de privacidad

Consulta Opciones de privacidad.

Referencias adicionales