Datos embebidos en el sitio web/información estratégica de la aplicación

Acerca de los datos embebidos en el sitio web/información de aplicaciones

Cualquier información que pueda ser rastreada por el sitio web/App Insights también se puede enviar a su página web o encuesta objetivo. Por ejemplo, si su objetivo es una encuesta de satisfacción del sitio web, puede optar por guardar información sobre cuánto tiempo estuvo el participante en el sitio web o cuántas páginas ha visitado. Esta información no se guarda dentro del intercept o el diseño, sino que se transfiere a su sitio web o encuesta.

Puede transferir información a encuestas o a su sitio configurando datos embebidos. Los datos embebidos son variables personalizadas que se pueden nombrar y establecer iguales a cualquier valor que desee. Por ejemplo, puede tener datos embebidos llamados Ubicación que pueden tener un valor de Estados Unidos, Canadá, Irlanda, etc.

When is Embedded Data Captured?

By default, embedded data is captured immediately before the survey is displayed to the respondent.

However, certain creative types and configurations change this behavior:

• Botón para proporcionar una opinión: Embedded data is collected when the feedback button is clicked by the site visitor.
• Diálogo de respuesta: The “display survey directly in dialog” option changes how embedded data is collected:
  • When enabled, the survey is embedded directly in the creative, and embedded data is captured as soon as the creative loads.
  • When disabled, the creative displays a button to open a new window for the survey, and data is captured when this new window loads.
• Creative Targets: For custom embedded feedback, pop over creatives, pop under creatives, slider creatives, and info bar creatives, the creative target controls how embedded data is collected:
  • Embedded survey: When the survey is embedded in the creative, embedded data will be captured as soon as the creative is displayed.
  • Linked survey: When the survey is opened by a link or button, embedded data will be captured when the link or button is clicked.
    Qtip: For pop under creatives, if the survey session starts on page change or site exit, then embedded data will be captured before the pop under window is opened.
• Templated embeddedOpinión de : As soon as the first question in the templated embedded feedback creative is submitted, embedded data will be captured. For example, an embedded feedback creative that asks a “Was this helpful” question followed by a free-form input question will capture embedded data once the user clicks “Yes” or “No” to the first question.

Updating Embedded Data After Opening the Survey

Some creatives will continuously update embedded data if it is updated on your website while the intercept survey is open. For example, if the intercept triggers a survey to open in a new window, and the site visitor navigates to a new page on your site, then the embedded data that is associated with that open survey session will be updated to reflect that new page.

Additionally, intercepts are not the only way to collect embedded data. Embedded data values are collected in the following order:

1. Intercept embedded data is collected first. See the When is Embedded Data Captured? section for specific information depending on the intercept’s creative.
2. Survey flow embedded data is collected after the survey response is submitted. Consulte Datos embebidos para obtener más información.
3. XM Directory embedded data is applied last, if the intercept is linked with XM Directory and the contact already exists in the directory.

If there are any identical embedded data keys in these 3 steps, then the values that are collected last will be recorded in the survey response. For example, if a field called “customerId” is set by the intercept, survey flow, and XM Directory, then the XM Directory contact value will be saved for the “customerId” in the survey response.

Configuración de datos embebidos

Normalmente se especifican datos embebidos para acciones individuales en su intercept. Por ejemplo, supongamos que está aleatorizando 2 conjuntos de acciones diferentes. En una acción puede añadir un campo de datos embebidos llamado “Condición” con un valor de “Versión 1” y en otra acción puede añadir un campo de datos embebidos llamado “Condición” con un valor de “Versión 2”.

Para establecer datos embebidos en cualquier acción

1. En cualquier acción, haga clic en Opciones.
   
2. Seleccione Datos embebidos.
3. Introduzca un nombre para su primer campo de datos embebidos.
   
4. Seleccione el tipo de valor.
   Consejo Q: Un valor estático significa que el valor del campo de datos embebidos será el mismo para cada visitante que reciba esta acción (por ejemplo, asignando 1 acción “Condición” con un valor de 1 y la otra “Condición” con un valor de 2). Las otras opciones de valor de datos embebidos son dinámicas, lo que significa que se ajustarán en función del visitante en particular (por ejemplo, qué página estaba viendo el visitante cuando vio el diseño).
5. Si se proporciona un campo, introduzca un valor para sus datos embebidos.
   
6. Si desea añadir campos de datos embebidos adicionales, haga clic en el signo más (+) a la derecha del primer campo y repita los pasos 4 a 6.
7. Haga clic en Guardar.

Varios campos de datos embebidos

Existe un límite de 20 KB para grabar datos embebidos. Ciertos campos (como Historial de sitios registrados) ocuparán más de este espacio que otros. Si no hay suficiente espacio para enviar todos los campos de datos embebidos al sitio web de destino, se priorizarán los campos en la parte superior de la lista.

Puede fijar la prioridad de los campos de datos embebidos simplemente haciendo clic en los puntos a la izquierda de cualquier campo y moviendo el elemento hacia arriba o hacia abajo en la lista.

Configurar los datos embebidos en un diseño

Los pasos anteriores describen cómo guardar datos integrados para una acción específica. Sin embargo, si desea que todas las acciones que utilizan un diseño determinado tengan los mismos datos embebidos, también puede establecer datos embebidos en el propio diseño. Los pasos serán exactamente los mismos, pero encontrará el menú de datos embebidos haciendo clic con el botón derecho en el objetivo de su diseño, haciendo clic en la flecha desplegable de la barra de herramientas anterior y seleccionando Datos embebidos.

Esto también se puede encontrar en la sección Editar de su diseño.

Configuración de datos embebidos para varios destinos con JavaScript

A veces, es posible que desee establecer valores de datos embebidos en varias imágenes u objetivos dentro de su diseño; sin embargo, el campo de datos embebidos no puede tener varios destinos en el diseño. Lo que puede hacer para capturar y transmitir información es utilizar JavaScript para crear varios campos de datos embebidos que cada uno tiene su propio valor.

<div onclick="window._qLastClicked = 'Happy';">

In order to allow the greatest flexibility when passing embedded data and choosing targeting conditions for displaying intercepts, Qualtrics leverages the browser’s built-in eval functionality for JavaScript expressions. If your site’s security policy does not permit the use of eval, you may see an error like “Refused to evaluate a string as JavaScript because ‘unsafe-eval’ is not an allowed source of script in the following Content Security Policy directive” in your browser console.

If you see that error and you are unable to update your site’s Content Security Policy settings, you’ll need to work with your engineering team to run the following code block before Qualtrics loads:

window.QSI = window.QSI || {};
window.QSI.config = window.QSI.config || {};
window.QSI.global = window.QSI.global || {};
window.QSI.config.enableSecureVariables = true;
window.QSI.global.enableJSSanitization = true;

After you run this code block, you’ll be able to use a limited subset of JavaScript in your targeting conditions and embedded data fields. This subset of JavaScript only permits variable access using dot (“.”) and bracket (“[]”) operators, which will allow you to gather variable context without worrying about security concerns around function execution. You cannot use function calls, such as document.querySelector().

Tipos de valores de datos embebidos

Cuando fija el valor de sus datos embebidos, puede elegir qué tipo de variable son estos datos embebidos. A continuación, encontrará una explicación de lo que captura cada tipo de datos embebidos y las condiciones de interceptación relacionadas.

• Estático: Cree datos integrados personalizados y defina sus valores.
• ID de intercept: captura el ID interno del intercept. Este ID se puede utilizar para ver qué intercepción vio un visitante si tiene varios intercepts que se vinculan con el mismo sitio/encuesta.
• ID de diseño: captura el ID interno del diseño. Este ID se puede utilizar para ver el diseño que ha visto un visitante si tiene varios diseños que se vinculan al mismo sitio/encuesta.
• Historia del sitio registrado: Esto captura todos los sitios que su visitante ha visitado y que tienen el código de proyecto en la página. Esta información se almacena en una cookie, que el sitio web/App Insights coloca en el navegador.
  Consejo Q: la cantidad de historial registrado depende de los límites establecidos en esta cookie. El límite se establece en la página Administración.
• Seguimiento de eventos: le permite configurar el seguimiento de eventos.
• Adobe Analytics: Consulte Adobe Analytics.
• Adobe Experience ID: Consulte Adobe Analytics.
• Recuento de páginas visitadas únicas: captura el número de páginas diferentes que el usuario ha visitado en su sitio. Por ejemplo, visitar la misma página dos veces cuenta como 1 página. Consulte Condiciones de recuento de páginas.
• Recuento total de páginas visitadas: captura el número total de páginas que el usuario visitó en su sitio. Consulte Condiciones de recuento de páginas.
• Tiempo gastado en el sitio: El tiempo dedicado en el sitio registra 2 métricas: el tiempo dedicado en el sitio y el tiempo enfocado en el sitio. El tiempo dedicado al sitio hace referencia al tiempo que el visitante ha tenido su sitio web abierto en una ventana del navegador. Time Focused On Site se refiere a cuánto tiempo el visitante ha tenido su sitio web abierto como la ventana “en el foco” de su computadora.  Consulte Tiempo dedicado en el sitio o Tiempo enfocado en el sitio.
  Consejo Q: En sus datos, el Tiempo dedicado al sitio y el Tiempo centrado en el sitio se guardarán juntos como 2 números separados por una línea vertical. El número en el lado izquierdo de la línea es el tiempo dedicado en el sitio, mientras que el número a la derecha de la línea es el tiempo centrado en el sitio.
  
• URL de página actual: La página en la que está el visitante cuando aparece el intercept. Consulte URL de la página actual.
• HTML en el sitio: Especifique el HTML en la página para la que desea capturar el valor. Por ejemplo, puede tener un elemento para su carrito de compra y querer saber cuántos artículos hay en el carrito del visitante. Véase HTML en el sitio Web.
• Valor de la Cookie: Capture el valor de una cookie específica en su sitio. Por ejemplo, puede tener una cookie llamada Return_visitor que captura si alguien ha visitado su sitio antes o no. Consulte la condición de Cookie.
• Parámetro URL: Si su sitio web tiene parámetros añadidos a las URL, esta opción le permite capturar el valor de cualquier parámetro que desee.
• URL Regex: captura la codificación Regex.
  Consejo Q: Regex es una función de codificación personalizada. Lamentablemente, el soporte técnico de Qualtrics no puede aconsejarle acerca de la codificación personalizada. En su lugar, puede preguntar a los usuarios especializados de nuestra comunidad.
• Valor de JavaScript: esta opción captura JavaScript personalizado de su sitio. El valor especificado debe ser una expresión/llamada JavaScript.
  Consejo Q: JavaScript es una función de codificación personalizada. Lamentablemente, el soporte técnico de Qualtrics no puede aconsejarle acerca de la codificación personalizada. En su lugar, puede preguntar a los usuarios especializados de nuestra comunidad.
• Referente de página: La página en la que estaba el visitante antes de llegar a la página con su intercept. Consulte Referencia de página.
• Sitio referrer: El sitio web en el que estaba el visitante antes de llegar a su sitio web. Consulte Referencia del sitio.
• Término de búsqueda: captura el término que el visitante buscó para llegar a su sitio web. Véase Concepto de búsqueda.
• Valor de Google Data Layer: esta opción captura variables personalizadas de Google Data Layer de su sitio. Consulte Uso de Google Analytics en el sitio web / App Insights.

Guardar datos embebidos en una encuesta de Qualtrics

Si su objetivo es una encuesta de Qualtrics, los datos embebidos que se le envíen estarán disponibles para su uso en la lógica de la encuesta sin necesidad de realizar ninguna acción adicional. Sin embargo, si desea guardar estos datos embebidos en los resultados de la encuesta, tendrá que añadirlos al flujo de la encuesta.

Siga los pasos de la página de soporte de datos embebidos para añadirla al flujo de la encuesta. Para el valor del campo, déjelo como Valor se establecerá desde el panel o la URL.

Uso de datos embebidos con otros objetivos

Aunque su objetivo no sea una encuesta de Qualtrics, aún puede aprovechar los datos embebidos y transferir la información, del mismo modo que lo haría con una encuesta de Qualtrics. Los datos embebidos se transferirán al cuerpo de la solicitud (método POST), de modo que pueda capturar y enviar varios elementos de datos embebidos a la plataforma Qualtrics XM sin tener que verlos en la URL de encuesta visible.

Testing Embedded Data Collection

You can test what embedded data has been collected by running this snippet in the developer console when you would expect embedded data values to be collected by the intercept:

window.QSI.EmbeddedData.getEmbeddedData('YOUR_INTERCEPT_ID')

If the values that are collected are not what you expect or are empty, troubleshooting depends on what type of embedded data you expect to collect:

1. Static: If there are missing or incorrect Static embedded data fields, then you may need to publish the latest version of the intercept.
2. Google Data Layer: If there are missing or incorrect Google Data Layer embedded data fields, then you may have the wrong data layer expression. Alternatively, the value may have been overwritten by a subsequent data layer update. Qualtrics only tracks the latest value in the data layer. See Using Google Analytics with Website/App Insight for more information on integrating the Google Data Layer with an intercept.
3. JavaScript: If there are missing incorrect JavaScript embedded data fields, then you may have the wrong expression. Please work with your development team to confirm that the variable you are looking for is present on the page you are testing.

Troubleshooting Empty or Incorrect Embedded Data in Survey Responses

If the variables do appear when testing, but not in the actual survey response, then there could be a timing issue between when Qualtrics grabs the data and when the data is actually available on the page.

Follow the below steps to troubleshoot:

1. Reload the page and then test your embedded data using the code snippet in the section above.
2. Run the following code in your browser console:
   QSI.API.unload();
QSI.API.load().then(QSI.API.run);
3. Take the survey.
4. A HTTPS request will appear in the website’s network log when a survey session starts via an intercept. This request includes the survey ID and any mapped embedded data from the intercept configuration. Checking the payload of this request can help verify if the session began with embedded data.

If the correct values are now being passed, then this is likely a timing issue and you will need to trigger your intercept after the data values are populated on your page. This can be done via the QSI.API calls, or through using a tag manager. See Project Deployment Code for more information.

Visualización de datos embebidos de intercept en un dashboard

Es posible que desee visualizar su Web/App Insights en un dashboard de CX. En esta sección se describen los pasos generales sobre cómo visualizar los datos embebidos en un formato legible.

1. En su lógica de intercept, añada los campos de datos embebidos que desea visualizar en su dashboard.

   Consejo Q: Los campos comunes incluyen:

   • ID de intercept: para mostrar el ID o el nombre del intercept.
   • ID del diseño: para mostrar el ID o el nombre del diseño.
   • Valor de JavaScript: para visualizar datos de una expresión JavaScript.
   • Variables de Adobe Analytics: para visualizar datos de eVars personalizados de Adobe Analytics.
   • Valor estático: para transferir un valor personalizado, como el nombre del intercept, el nombre creativo o la información sobre su página web.
2. En la encuesta que se muestra en su intercept, añada campos de datos embebidos que coincidan con sus campos de intercept.
   
3. Asigne su encuesta a un dashboard de CX, asegurándose de incluir sus campos de datos embebidos.
4. Si muestra un campo como ID de intercept o ID de diseño, puede recodificar su ID para que muestre el intercept o el nombre del diseño.
   Ejemplo: En el ejemplo anterior, mostramos datos de 2 diseños diferentes en el mismo dashboard. Para facilitar la visualización de datos de diseños individuales, agregamos ID de diseño como campo de datos embebidos y recodificamos los valores de ID individuales para que sean los nombres de los diseños. A continuación, podemos añadir este campo como filtro de dashboard y utilizarlo en widgets.

Preguntas frecuentes