Documentación técnica de información del sitio web/aplicación

¿Qué es un proyecto de Web/App Insights 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 de la web en sus medios digitales. Con un proyecto de Web/App Insights, puede presentar gráficos geniales en su sitio web con enlaces y encuestas integradas para obtener opiniones sobre la experiencia de sus visitantes, informarles sobre sus últimas ofertas y promociones, y mucho 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 despliegue (o código de despliegue de proyecto) se puede encontrar yendo a la ficha Despliegue dentro 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.

Revisemos el proceso de lo que sucede cuando un visitante ve una página en su navegador que contiene el código de implementación:

• El código de despliegue (normalmente colocado en la cabecera HTML) se ejecuta inmediatamente después de la carga de la página e insertará otra etiqueta <script> al final del cuerpo HTML cuando se desencadene el evento onLoad de la página.
• Esta etiqueta <script> solicita 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 del sitio 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 de implementación es dinámico, lo que significa que los cambios realizados en los intercepts y diseños desde la interfaz del proyecto Sitio web/App Insights no provocarán que el código en sí cambie. Por lo tanto, se pueden realizar cambios en los proyectos de Sitio web/App Insights desde dentro de una cuenta, y no será necesario intercambiar el código en el sitio web para que se vean los cambios.

¿Cómo implemento un proyecto de sitio web/App Insights?

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 empiezan a tener lugar una vez que se desencadena el evento onLoad: https://www.w3schools.com/jsref/event_onload.asp

Además, la ubicación de dónde aparecen realmente 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 es agregar el código de implementación a un sistema de administración de etiquetas, en lugar de aplicarlo directamente al código de 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 el sitio web/App Insights son Adobe Launch, Tealium, Ensighten y Google Tag Manager. Tealium en particular tiene un asistente construido que permite la implementación fácil de Web / 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 a Configuración de cuenta y seleccione la pestaña ID de Qualtrics.

El ID de zona empezará por ZN_ y se puede encontrar:

1. En la URL del proyecto cuando esté dentro de él, o
   
2. En el código de despliegue del proyecto.
   

¿Quién suele participar en la implementación del sitio web/información estratégica de la aplicación?

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.

Opening the Debug Window

You can use the debug window to diagnose why an intercept has not displayed on a specific web page. This window shows all conditions required for the intercept to appear and if the conditions passed or failed.

How you open the debug window will depend on when your intercept was implemented.

Intercepts Implemented Before March 2019

For intercepts whose deployment code was implemented prior to March 2019, you can enable the Debug Window by appending the Q_DEBUG query string to the URL. This query string should be appended with either a ? or &, as illustrated in the examples below:

Intercepts Implemented After March 2019

For intercepts whose deployment code was implemented after March 2019, follow these steps to open the debug window:

1. Open your browser’s developer tools.
2. Run the following JavaScript command:
   QSI.API.unload();
QSI.isDebug = true;
QSI.API.load();
QSI.API.run();

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).

Observe la solicitud de red de información del sitio web/aplicación

1. Abra Herramientas de desarrollador en su navegador.
2. ¿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

1. Haga clic con el botón derecho del ratón en cualquier lugar de su navegador.
2. Seleccione Inspeccionar elemento.
3. Seleccione Consola (es donde aparecen errores).

Preguntas frecuentes