Saltar al contenido principal
Loading...
Skip to article
  • Qualtrics Platform
    Qualtrics Platform
  • Customer Journey Optimizer
    Customer Journey Optimizer
  • XM Discover
    XM Discover
  • Qualtrics Social Connect
    Qualtrics Social Connect

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


Was this helpful?


This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.

The feedback you submit here is used only to help improve this page.

That’s great! Thank you for your feedback!

Thank you for your feedback!


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

un intercept de sitio web en un sitio web minorista que pregunta a los clientes por qué decidieron elegir esta empresa

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.

Código de despliegue en la sección Despliegue

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.

Atención: Para mantener los niveles de servicio adecuados en todos los clientes, Qualtrics puede restringir el tráfico a nuestros servidores en casos excepcionales cuando se producen picos inesperadamente grandes.

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

Atención: Para garantizar que sus intercepts funcionen, debe incluir los siguientes elementos en las cabeceras de la 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, enumere el dominio *qualtrics.com siguiendo la documentación que proporcionan. Estas soluciones pueden evitar que la etiqueta de Qualtrics cargue los recursos necesarios y es posible que el sitio Web/App Insights no funcione de forma fiable en su sitio. Además, si está utilizando variables de JavaScript, tendrá que permitir “poco seguro” en su Política de seguridad de contenido; de lo contrario, Análisis de sitio web/aplicación 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 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.

Atención: Si desea limitar las vistas de página, considere colocar el código de implementación solo en páginas específicas o utilizar muestras. Consulte Prácticas recomendadas para minimizar vistas de página para obtener más información.

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.

Consejo Q: Qualtrics tiene actualmente una extensión con Adobe Launch como sistema de gestión de etiquetas. Consulte Adobe Launch Extension para obtener más información.
Consejo Q: Qualtrics no puede solucionar completamente los problemas con el código aplicado a los administradores de etiquetas, ya que no podemos ver la configuración que se ha activado en su totalidad. Consulte nuestra página Uso de administradores de etiquetas para obtener consejos sobre la resolución de problemas.

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.

Encontrar el ID de organización en la sección ID de Qualtrics de la Configuración

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

  1. En la URL del proyecto cuando esté dentro de él, o
    El ID de zona que empieza por ZN se puede encontrar en la URL
  2. En el código de despliegue del proyecto.
    ID de zona en el código de implementación del proyecto, empezando por ZN

¿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.
the debugger window showing the display conditions and if they passed or failed

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

Attention: The debug window does not function if the code has been implemented using a tag manager.

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:

Example:
https://www.qualtrics.com?Q_DEBUG
https://www.qualtrics.com/blog?item=value&Q_DEBUG
Qtip: If the URL already contains a query string with a ?, the query string will require an & instead.

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).
Consejo Q: También querrá hacer clic con el botón derecho y seleccionar Ver origen de página para verificar que su código de implementación se encuentra realmente en la página.
Atención: Si recibe un registro de la consola que infringe una política de seguridad de contenido, es probable que haya una restricción en su sitio web que bloquee el despliegue de nuestros intercepts. Le recomendamos que se ponga en contacto con su equipo de desarrollo web para resolverlo.

Preguntas frecuentes

Muchas de las páginas de este sitio han sido traducidas del inglés original utilizando la traducción automática. Aunque en Qualtrics hemos realizado nuestra diligencia debida para obtener las mejores traducciones automáticas posibles, la traducción automática nunca es perfecta. El texto original en inglés se considera la versión oficial, y cualquier discrepancia entre el inglés original y las traducciones automáticas no son legalmente vinculantes.