Captura de URL de reproducción de sesiones para registro externo

Acerca de la captura de URL de reproducción de sesiones para el registro externo

Además de ver repeticiones de sesiones Dentro de la plataforma Qualtrics , es posible que desee vincular sesiones de usuario específicas directamente con sus sistemas de registro (como Splunk o Datadog), herramientas de seguimiento de errores (como New Relic) o tickets de soporte al cliente.

Aprovechando una sencilla API de Qualtrics , puedes recuperar mediante programación la URL de reproducción de sesión única para la sesión actual de un visitante y pasársela a tu equipo de ingeniería para agilizar la depuración y la resolución de problemas. Esto ayuda a habilitar casos de uso comunes como: 

• Solución de problemas intermitentes del sitio: Pase la URL a herramientas como Splunk, LogRocket o New Relic para correlacionar los registros del servidor con el comportamiento visual del cliente.
• Soporte al cliente: Incluir automáticamente el enlace de reproducción en los tickets generados a través de CRM como Zendesk y Salesforce.

Atención:Las funciones de codificación personalizadas se proporcionan tal como están y requieren conocimientos de programación para implementarlas. El soporte técnico de Qualtrics no ofrece asistencia o consultoría sobre codificación personalizada. Siempre puedes intentar preguntar a nuestros comunidad de usuarios dedicados en cambio. Si desea obtener más información sobre nuestros servicios de codificación personalizada, póngase en contacto con su Ejecutivo de Cuenta de Qualtrics.

Prerrequisitos

Antes de utilizar esta API, asegúrese de lo siguiente:

• Análisis de la experiencia digital Está habilitado para su organización.
• Repetición de la sesión está activo dentro de tu proyecto digital .
• El El código JavaScript del proyecto Qualtrics está correctamente implementado. en su sitio web.
• Tu equipo de ingeniería tiene acceso a una cuenta de usuario de Qualtrics con la " API de acceso". permiso del usuario y la “Sesión” permiso para compartir dentro de tu proyecto digital .

Implementación de la API

Por favor vea nuestra documentación de la API para detalles técnicos.

Para capturar la URL y enviarla a una herramienta externa, debe envolver la llamada en una comprobación para garantizar que Qualtrics JavaScript (QSI) y el Repetición de sesión (SR) Los módulos se han cargado.

Ejemplo: Registro en una herramienta de seguimiento de errores

Si su sitio web encuentra un error de JavaScript, puede adjuntar la URL de reproducción de la sesión al informe de error para que sus ingenieros puedan ver exactamente qué hizo el usuario antes de que se produjera el fallo.

ventana.addEventListener('error', función() {
  si (window.QSI && QSI. API) {
    constante replayUrl = QSI. API.SessionRecording.getSessionSync().playbackUrl;
   
    // Ejemplo: Enviar a una herramienta como Sentry o un registrador personalizado
    console.log("Error detectado. Vea la repetición de la sesión aquí: + URL de reproducción);
   // myLoggingTool.captureMessage("Error de usuario", { extra: { sessionUrl: replayUrl } });
  }
});

Ejemplo: Almacenar la URL en un formulario de soporte

Si un usuario envía un formulario de "Contacto " o de "Informe de errores" en su sitio web, puede ocultar la URL de reproducción para proporcionar al agente de soporte el contexto inmediato. Tenga en cuenta que si utiliza una encuesta de Qualtrics para su formulario de soporte, capturará automáticamente la URL de reproducción.

constante formulario = documento.querySelector('#support-form');
formulario.addEventListener('submit', función() {
    si (ventana.QSI && QSI. API.SessionRecording.getSessionSync()) {
        constante replayUrl = QSI. API.SessionRecording.getSessionSync().playbackUrl;
       document.querySelector('#hidden-replay-input').value = replayUrl || "No hay repetición disponible";
    }
});

Ejemplo: Enviar la información de la sesión a su capa de datos

Si utiliza una plataforma de análisis de terceros, es posible que desee enviar el ID de sesión y las URL de reproducción a ese sistema para que le resulte más fácil correlacionar las reproducciones de las sesiones de Qualtrics en diferentes plataformas.

// Esperar a que Qualtrics se cargue
window.addEventListener('qsi_js_loaded', función asíncrona() {
  intentar {
    // Esperar a que se inicialice la sesión y obtener la información de la sesión.
    constante sesión = esperar ventana.QSI. API.SessionRecording.getSession();
   
    // Inicializa dataLayer si no existe
    ventana.dataLayer = ventana.dataLayer || [];
   
    // Enviar información de sesión a Google dataLayer
    ventana.dataLayer.push({
      ' evento': 'dxa_session_started',
      'dxa_session_id': session.sessionId,
      'dxa_playback_url': session.playbackUrl
    });
  } atrapar (error) {
    console.error('No se pudo obtener la información de la sesión DXA:', error);
  }
});

Consideraciones importantes

Temporizador

El QSI. API.SessionRecording.getSessionSync() La API devolverá "null" si se llama inmediatamente al cargar la página, antes de que la sesión tenga la oportunidad de comenzar. Se recomienda llamar a esta API dentro de un detector de evento (como un clic de botón o un activador de error).

QSI. API.SessionRecording.getSession() Los gestores esperan a que comience la sesión, pero tenga en cuenta que puede que nunca se resuelva. Por ejemplo, si su proyecto está configurado para esperar a que su página llame a la API de inicio cuando el usuario dé su consentimiento, y el usuario nunca da dicho consentimiento, getSession() nunca se completará.

Privacidad y permisos

• Control de acceso: Solo usuarios de Qualtrics con las "Sesiones" permiso En el proyecto digital se podrá ver la sesión a través de la URL. Si un usuario no autorizado hace clic en el enlace, se le pedirá que inicie sesión en su cuenta de Qualtrics y solo podrá acceder a la sesión si su cuenta tiene los permisos necesarios.
• Enmascaramiento: La reproducción visualizada a través de esta URL seguirá respetando todos los datos. enmascaramiento reglas (protección de información personal identificable) configuradas en la configuración de su proyecto.
• Muestreo: Si se selecciona un usuario para una grabación en función de su proyecto frecuencia de muestreo, la API no devolverá una URL.

Resolución de problemas

Esta sección abarca los problemas más comunes y sus causas: