Aplicación de página única
Contenidos de la página
Acerca de las aplicaciones de página única
Las aplicaciones de página única (SPA) son un tipo especial de aplicación web. Una SPA carga una sola página cuando ingresas a un sitio web y, a partir de ese momento, carga todo el contenido posterior en esa misma página mientras navegas. Esto parecerá funcionar como un sitio web normal, pero al cambiar entre “páginas”, la página en realidad no se recarga.
De forma predeterminada, el código de implementación se ejecuta tan pronto como se carga una página web. Sin embargo, debido a que las SPA no se actualizan al navegar entre páginas, el código de implementación no se volverá a evaluar a medida que navega entre páginas. Al utilizar las técnicas que se describen a continuación, puede permitir que el código de implementación funcione en su sitio SPA sin problemas.
Consejo Q : Algunas de estas técnicas utilizan la API de JavaScript de Opinión del sitio web. Para obtener documentación detallada sobre la API de JavaScript para Qualtrics Website Información, consulte esta página.
Atención: La siguiente documentación requiere conocimientos de programación para implementarla. Recomendamos pasar esta información al equipo que implementará su código de implementación. Nuestro equipo de soporte técnico no ofrece asistencia ni consultoría sobre programación personalizada. En su lugar, puede preguntar a los usuarios especializados de nuestra comunidad. Si desea obtener más información sobre nuestros servicios de codificación personalizados que puede contratar, contacto con su Qualtrics. Ejecutivo de Cuenta.
Consejo Q: Javascript no está incluido en todas las licencias de Qualtrics . Comuníquese con su Qualtrics. Ejecutivo de Cuenta Si estás interesado en obtener acceso.
Reevaluación de la lógica de Intercept y seguimiento de la actividad tras el cambio de URL
Si su aplicación de página única depende del enrutamiento del lado del cliente para la navegación del usuario, puede forzar la reevaluación de las intercepciones en los cambios de URL posteriores habilitando la opción Reevaluar la lógica de intercept cuando cambia la URL configuración. Al marcar esta configuración se permitirá la evaluación de la lógica de intercept además de la evaluación que se produce durante la carga inicial de la página.
Consejo Q: Esta configuración afecta a todas las intersecciones del proyecto.
Atención: Si decide utilizar esta configuración de SPA junto con la opción de nivel de intercepción para Mostrar con código Javascript personalizado (manualmente), entonces todavía necesitarás llamar al
QSI.API.run();método para lograr que la intercept se muestre en cada página de SPA.
Implementación manual con API de JavaScript
Consejo Q: Para obtener documentación detallada sobre la API de JavaScript para los opinión del sitio web de Qualtrics , consulte Esta página.
Este método describe cómo cambiar el código de implementación para que se ejecute manualmente. Esto significa que el código de implementación no se ejecutará ni evaluará el código asociado. lógica hasta que se inicie la solicitud de API de JavaScript adecuada.
Para implementar manualmente
Solicitudes de API de JavaScript
Consejo Q: Para obtener documentación detallada sobre la API de JavaScript para los opinión del sitio web de Qualtrics , consulte Esta página.
Si desea que Qualtrics evalúe su proyecto en una sola instancia, utilice estas dos solicitudes:
API(); Consejo Q: Si tienes Cargar proyecto manualmente habilitado en la configuración de su proyecto, no necesitará llamar a esta API para cargar el código de implementación en la carga inicial de la página. Solo será necesario forzar la carga para cuenta los cambios de estado en la página que se producen sin recarga.
API(); Si desea que Qualtrics evalúe el código de su proyecto más de una vez en la misma página, repita los siguientes tres pasos cada vez:
Preguntas frequentes
Activé mi intercept, pero no aparece en mi sitio. ¿Por qué no?
Activé mi intercept, pero no aparece en mi sitio. ¿Por qué no?
- Lógica: lógica de objetivo de intercept y lógica del conjunto de acciones son las condiciones que deben cumplirse para que una intercept se muestre a un visitante. Comprobar esta lógica será útil para descubrir por qué Intercept no se muestra en una página.
- Conjuntos lógicos que utilizan “Contiene”:Una causa común de error lógico es el uso de “Contiene” vs. "Es." Decir que una condición “Contiene” significa que el parámetro en el que se basa la lógica (es decir, URL actual) tendrá presente el valor especificado además de más información. Por ejemplo, si tuviera una lógica que dijera que la URL actual contiene ' qualtrics', esto provocaría que la intercept se mostrara en cualquier URL que tenga la palabra qualtrics presente. La otra opción que tienes es usar la URL actual es [URL]. Esta condición depende de que la URL visitada coincida exactamente. Cualquier diferencia o carácter adicional impedirá que pase la lógica de intercept .
- Revisiones de Intercept:Al realizar modificaciones en las intersecciones, los cambios no se realizan en vivo hasta que Se publica la intercept. Al publicar una Intercept, se guarda una versión de la intercept, o una “revisión”. Revisando las revisiones que se han realizado es muy útil para identificar cualquier cambio que pueda haber impedido repentinamente que aparezca la intercept .
- Ventana de depuración:La ventana de depuración es una herramienta invaluable para probar por qué una intercept no se muestra en una página particular.
Para intersecciones cuyas código de implementación Se implementó antes de marzo de 2019 para habilitar la ventana de depuración y agregar una cadena de consulta a cualquier URL dada llamada Q_DEBUG. Esto debe tener como prefijo un ? o un & como en los siguientes ejemplos: https://www.qualtrics.com?Q_DEBUG, https://www.qualtrics.com/blog?item=value&Q_DEBUG.
Para las intercepciones cuyo código de implementación se implementó después de marzo de 2019, ejecute el siguiente fragmento de JavaScript en la consola de su página web:QSI. API.descargar(); QSI.isDebug = verdadero; QSI. API.cargar(); QSI. API.ejecutar();La ventana de depuración desglosa todas las condiciones necesarias para que aparezcan las intercepciones que se ejecutan en la URL . Si descubre que no aparece una intercept , ubíquela en la ventana de depuración e identifique las advertencias de error en rojo.Consejo Q:El depurador de Website Información no funciona si el código se implementó mediante un gerente de etiquetas. Además, si la URL ya tiene una cadena de consulta con un ?, entonces el depurador requerirá un & en su lugar. - Solicitud de red:La mayoría de los navegadores poseen un menú de herramientas para desarrolladores que permite al usuario ver el código fuente, los recurso, las cookies y las llamadas de red de un sitio. Website Información tiene una presencia destacada en la sección Red de estas herramientas. Para comprobar si estos scripts se están ejecutando, abra las herramientas para desarrolladores y navegue a la sección Red. Una vez aquí, vuelva a cargar la página web y el menú debería comenzar a llenarse con todas las solicitudes de red realizadas por el sitio web. Para identificar el código de Website Información , busque llamadas que comiencen con ?Q_ZID o ?Q_SID. Este es el código en sí mismo ejecutando comprobaciones en la lógica sofisticada. Si no puede encontrar nada que coincida con este formato, entonces hay un problema con la implementación del código de su proyecto. Puede consultar nuestra página de soporte en implementación para obtener asesoramiento sobre dónde es mejor colocar el código.
- Cuestiones de política de seguridad de contenidos:Si recibe un registro de consola que viola una Política de seguridad de contenido, lo más probable es que exista una restricción en su sitio web que impide la implementación de nuestras intercepciones. Le recomendamos ponerse en contacto con su equipo de desarrollo web para resolverlo. Para garantizar que sus intercepciones funcionen, generalmente recomendamos incluir en la lista de permitidos los siguientes elementos en los encabezados de su Política de seguridad de contenido:
- connect-src https: qualtrics
- fuente del marco qualtrics://*.qualtrics.com
- Fuente de la imagen: qualtrics
- fuente del script qualtrics://*.qualtrics.com
- Manejo de URL de SPA: Si su sitio utiliza un marco de aplicación de página única (SPA), asegúrese de que su código se active history.pushState() Al navegar entre vistas. Algunos marcos pueden volver a renderizar o actualizar la URL sin enviar una nueva entrada de historial, lo que puede impedir que se activen las intercepciones. Si estas usando useEffect o ganchos de lifecycle similares, asegúrese de que su lógica de intercept se ejecute después La navegación está completa.
He creado mi intercept pero me gustaría probarlo antes de la activación. ¿Cómo puedo hacer eso?
He creado mi intercept pero me gustaría probarlo antes de la activación. ¿Cómo puedo hacer eso?
¡Genial! ¡Gracias por tus comentarios!
¡Gracias por tus comentarios!