Documentación técnica de Web/App Insights
¿Qué es un proyecto de información de sitio web/aplicación y por qué lo estamos utilizando en nuestro sitio?
Qualtrics Website/App Insights ayuda a las organizaciones a medir y mejorar la experiencia que tiene un visitante web en sus medios digitales. Presente gráficos geniales en su sitio web con enlaces y encuestas incorporadas para obtener comentarios sobre la experiencia de sus visitantes, comuníqueles sus últimas ofertas y promociones, ¡y más!
Usted y sus colegas tienen poder sobre la apariencia del gráfico (también conocido como creativo), las condiciones en las que aparece (el intercept) y el código utilizado para desplegarlo.
Una vez que el código para su proyecto se haya añadido a su sitio web, puede realizar todo tipo de cambios sin tener que cambiar el código o alertar a su equipo de TI. Simplemente haga el trabajo en Qualtrics, y los diseños e intercepts de sus sitios web cambiarán en consecuencia.
¿Es seguro?
No transferimos ningún dato a los servidores de Qualtrics a menos que sea necesario para la lógica de direccionamiento. Dicho esto, no almacenamos ninguno de estos datos en nuestro sistema.
Para asegurar estos datos a través del cable y protegerlos de ataques de intermediario, Qualtrics siempre utiliza el protocolo “HTTPS”. El protocolo se refiere a cómo se entrega el contenido al navegador web de los visitantes.
¿Dónde puedo encontrar el código del proyecto para implantarlo?
El código de implementación (o el código de implementación del proyecto) se puede encontrar en la pestaña Implementación de su proyecto. Puede simplemente copiar el código y enviarlo a su equipo de desarrollo web para su implementación. No es necesario realizar modificaciones en el código.
El código de implementación muestra cualquier intercept que se haya creado dentro de todo el proyecto.
¿Cómo funciona el código?
El código de despliegue es asincrónico, lo que significa que solo se ejecuta después de que se haya cargado todo lo demás en la página. Esto significa que el código de implementación no impedirá que se cargue ningún otro aspecto de su página porque solo se ejecutará una vez que se desencadene el evento onLoad.
Repasemos el proceso de lo que sucede cuando un visitante ve una página que contiene el código de implementación:
- Un visitante del sitio web verá una página en su navegador que contiene el código de implementación.
- El código de despliegue (normalmente colocado en el encabezado HTML) se ejecutará inmediatamente al cargar la página e insertará otra <script>etiqueta al final del cuerpo Html cuando se active el evento onLoad de la página.
- Esta <script>etiqueta solicitará el código JavaScript (Orchestrator) de los servidores de Qualtrics que se almacena en caché en una red de entrega de contenido (CDN).
- El orquestador realiza una llamada selectiva a los servidores de Qualtrics para determinar qué diseños mostrar. Esta llamada no se almacena en caché en CDN.
- Si es necesario, se envía una segunda solicitud de direccionamiento a los servidores para obtener los datos necesarios (por ejemplo: expresión JavaScript o cookie targeting).
- Qualtrics obtiene la definición de Información de página web/aplicación de la base de datos y crea el código de forma adecuada.
- Según la respuesta de direccionamiento, el orquestador realiza llamadas adicionales para obtener el contenido diferente necesario para renderizar en la página. El número de solicitudes realizadas varía en función del número de diseños para mostrar que pasan la lógica de direccionamiento. Todo este contenido se almacena en caché en la CDN, por lo que será rápido de cargar.
- Los diseños aparecen en la página.
El código también es dinámico, lo que significa que los cambios realizados en los intercepts y diseños desde la interfaz del proyecto Sitio web/Análisis de aplicaciones no harán que el código en sí cambie. Por lo tanto, se pueden realizar cambios en los proyectos de Website / App Insights desde dentro de una cuenta, y no será necesario intercambiar código en el sitio web para que se vean los cambios.
¿Cómo implemento un proyecto de Web/App Insights?
Atención: para garantizar que sus intercepts funcionen, debe incluir en la lista de elementos autorizados los siguientes elementos en las cabeceras de su política de seguridad de contenido:
- Connect-src https://*.qualtrics.com
- https://*.qualtrics.com marco
- Img-src https://*.qualtrics.com
-
Script-src https://*.qualtrics.com
Si su política de seguridad de contenido bloquea estos elementos de forma predeterminada, Web/App Insights no funcionará de forma fiable en su sitio. Si utiliza una Solución de gestión de seguridad del sitio web, como Ensighten, incluya el dominio *qualtrics.com en la lista de elementos autorizados siguiendo la documentación que proporcionan. Estas soluciones pueden evitar que la etiqueta Qualtrics cargue los recursos necesarios y es posible que el sitio Web/Información de la aplicación no funcione de forma fiable en su sitio. Además, si utiliza variables de JavaScript, deberá permitir “unsafe-eval” en su Política de seguridad de contenido; de lo contrario, Website / App Insights no podrá capturar los valores de JavaScript.
1. Agregue código directamente a sus páginas web
El código de despliegue se puede añadir en cualquier lugar de una página web. Debido a que el código se ejecuta de forma asíncrona, sólo se iniciará la carga una vez que una página web haya cargado completamente todo el contenido (incluyendo imágenes, archivos de secuencias de comandos, archivos CSS, etc.).
Nuestras solicitudes comienzan una vez que se desencadena el evento onLoad: https://www.w3schools.com/jsref/event_onload.asp
Además, la ubicación donde realmente aparecen los diseños en la página web viene determinada por la configuración determinada dentro de la interfaz de Qualtrics. (Consulte la información sobre Posición personalizada.) Por lo tanto, la ubicación del código dentro de la página no afecta dónde aparecerá el contenido de la página.
2. Cabecera/Pie de página global (recomendado)
Le recomendamos que agregue un código de implementación al Encabezado global o al Pie de página. Esto aplica el código globalmente en todo el sitio a la vez. Este método es la forma más fácil de implementar porque no necesita agregar código repetidamente a más páginas sobre la marcha, lo que puede ser un proceso largo. Si el código se ha añadido globalmente a su sitio de esta manera, puede utilizar la lógica de URL actual dentro de un intercept para controlar en qué páginas aparece realmente un intercept.
3. Utilizar gestores de etiquetas
Otra opción para implementar Website / App Insights en su sitio es añadirlo a un sistema de gestión de etiquetas, en lugar de aplicarlo directamente al código del sitio. El código se puede copiar y pegar desde la interfaz de Qualtrics directamente en un Administrador de etiquetas.
Los sistemas comunes de gestión de etiquetas que nuestros clientes utilizan junto con Website / App Insights son Adobe Launch, Tealium, Ensighten y Google Tag Manager. Tealium en particular tiene un asistente creado que permite una fácil implementación de Website / App Insights. Solo necesitará el ID de zona para el proyecto que está implementando y su ID de organización.
Para obtener el ID de organización, vaya al menú Configuración de cuenta y seleccione la pestaña ID de Qualtrics.
El ID de zona empezará por ZN_ y se puede encontrar:
¿Quién suele estar involucrado en la implementación del sitio web/análisis de aplicaciones?
Alguien de su organización que tiene acceso para agregar contenido al sitio web de su empresa. Normalmente, se trata de personas que forman parte de un equipo de TI, un equipo de contenido web, etc.
¿El sitio Web/App Insights ralentizará nuestro sitio?
El código de despliegue es asincrónico, lo que significa que solo se ejecuta después de que se haya cargado todo lo demás en la página. Esto significa que el código de implementación no impedirá que se cargue ningún otro aspecto de su página porque solo se ejecutará una vez que se desencadene el evento onLoad.
¿Y si Qualtrics no funciona? ¿Eso causará problemas con nuestro sitio web?
Si Qualtrics experimenta interrupciones o problemas, los intercepts simplemente no aparecerán en la página. Más allá de eso, no habrá impacto en la experiencia del visitante en sus sitios.
¿Con qué rapidez se ejecutará el código en mi sitio web?
Esperamos que el código de despliegue se cargue en 300 milisegundos para más del 50% de las solicitudes y en 750 milisegundos para más del 90% de las solicitudes. La velocidad variará en función de la ubicación geográfica del usuario y de la cantidad de intercepts y diseños que tenga un proyecto.
Consejos para la resolución de problemas
Lógica de intercept y lógica de conjunto de acciones
- Asegúrese de que los valores son correctos.
- Examine su uso de “Is” vs. “Contiene”.
- Examine su uso de la lógica Y/O.
- Preste atención a los espacios en los valores.
Historial de revisiones
Asegúrese de que la versión publicada es la más reciente (o la versión que esperaría).
Buscar la solicitud de red de información de sitio web/aplicación
- Abra Herramientas de desarrollador en su navegador.
- ¿Ver la solicitud de red para?Q_ZID etc.
- Ninguna solicitud de red: La implementación no funciona.
- Solicitud de red: Verifique los parámetros de la solicitud en busca de inconsistencias. A veces el código se implementa utilizando un sistema de gestión de etiquetas. Hay casos en los que esta implementación se comete con los parámetros de nuestra solicitud de URL actual, etc.
- Solicitud de red con un error: Compruebe si su proyecto está activado.
Busque otras solicitudes de scripts colgantes que puedan estar interfiriendo con nuestro script
- Haga clic con el botón derecho del ratón en cualquier lugar de su navegador.
- Seleccione Inspeccionar elemento.
- Seleccione Consola (es donde aparecen errores).