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

Integración de XM Directory con Digital Intercepts


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!


Acerca de la integración de XM Directory con Digital Intercepts

Atención: Para utilizar esta funcionalidad, su organización de Qualtrics debe estar en la nueva infraestructura de XM Directory y también debe tener acceso a Información estratégica del sitio web/de la aplicación. Para verificar el estado de su organización y solicitar esta función, póngase en contacto con su XM Success Manager.

XM Directory le permite crear su propio panel interno con perfiles completos de sus clientes y clientes potenciales. Tener un directorio de contactos de toda la organización le permite ver los perfiles de muchos puntos de contacto de los contactos con su organización, lo que hace que sea más fácil que nunca descubrir información sobre su experiencia con su organización.

La integración del sitio web/información de aplicaciones con XM Directory le permite utilizar los beneficios de XM Directory con los visitantes de su sitio web. Puede configurar la frecuencia de contacto omnicanal, asegurándose de que los visitantes de su sitio web no reciban una invitación por correo electrónico si ya han recibido un intercept de web, y viceversa. También puede orientar la visualización de intercepts de sitio web y de aplicación a segmentos específicos de usuarios, así como obtener información específica de segmentos y viajes

Antes de poder utilizar esta función, necesita acceso a lo siguiente:

  1. Acceso a XM Directory.
  2. Acceso a Opinión de página web/aplicación.
  3. Contactos o segmentos dentro de 1 de sus directorios.

Configuración de la integración

XM Directory

La integración con intercepts de sitio web utilizará su configuración de XM Directory existente. Si aún no ha configurado su directorio, consulte Introducción a XM Directory.

Para aprovechar al máximo la integración, siga estas mejores prácticas:

Consejo Q: Cada uno de esos contactos necesitará que se especifique el campo ID de referencia (ExternalDataReference). Este valor deberá estar disponible dentro de la sesión de inicio de sesión para los visitantes en su sitio web y se utilizará para determinar si se muestra el intercept.

Intercepts

Atención: La siguiente documentación requiere conocimientos de programación para su implementación. Le recomendamos que transmita 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 personalizada que puede encargar, póngase en contacto con su Account Executive de Qualtrics.

Para acceder a los beneficios de XM Directory desde su proyecto de información de sitio web/aplicaciones, primero deberá asegurarse de que Qualtrics sepa quién está visitando su sitio web y que pueda vincular esa información con sus contactos existentes. Para ello, deberá especificar la expresión JavaScript que se evalúa en la sesión de inicio de sesión del usuario para obtener el ID de referencia externa para el contacto.

Atención: la integración entre XM Directory e intercepts digitales funciona mejor cuando sus contactos son únicos. El valor que vincula a cada usuario debe ser único e identificativo para todos los contactos de su sitio web. Para evitar muchos contactos duplicados, no rellene, utilice un valor de marcador de posición para valores desconocidos y utilice solo valores estáticos en las pruebas.
Ejemplo: El almacenamiento del campo ID de referencia externa a través de JavaScript, una cookie o HTML en su sitio le permite hacer coincidir a cada visitante en función de los ID de referencia de extensión almacenados en XM Directory.

A continuación, tendrá que transmitir información sobre sus visitantes a Qualtrics. Los pasos son diferentes si utiliza un sitio web frente a una aplicación móvil.

Si utiliza un sitio web, trabaje con su equipo de desarrollo web para agregar el siguiente fragmento de código a su sitio web, además del código de implementación del proyecto. El fragmento transfiere el ID de referencia externa del usuario a Qualtrics para asociar el visitante de la página web con un contacto en XM Directory. Coloque este fragmento de código en la carga de la página, asegurándose de que el valor del ID ya se haya recuperado.

Haga clic aquí para ver el fragmento de código.
if(typeof QSI === "unlimited") {

     QSI = {};

     QSI.config = {

       externalReference: extRef

     };

 }
Atención: El fragmento de código para establecer el ID externalReference debe estar por encima del código de implementación del proyecto JavaScript en el código de su sitio. This snippet should be included on each page of the your site where you target visitors with intercepts.
Atención: Asegúrese de que en lugar de extRef especifique la expresión JavaScript que se debe evaluar para obtener el ID de referencia externa adecuado (por ejemplo, “UserID”). Esta expresión puede ser tan simple como una variable JavaScript o una expresión JavaScript para evaluar una cookie específica.

Si está utilizando una aplicación móvil, colabore con su equipo de desarrollo de aplicaciones móviles para integrarla con la última versión del SDK de la aplicación móvil de Qualtrics. Consulte la documentación de la API para obtener más información.

Consejo Q: Si un usuario final inicia sesión en su sitio con un ID de referencia externa que no se encuentra actualmente en XM Directory (es decir, este registro de usuario aún no está en XM Directory), el intercept no aparecerá para este usuario. Puede utilizar Creación automática de contactos para añadir este usuario al directorio.

Vinculación con XM Directory

Link with XM Directory allows you to set up a link between your Digital project and a directory from XM Directory. Cuando se selecciona esta opción, los datos embebidos de contacto de los usuarios se añadirán automáticamente a su respuesta a la encuesta. Para obtener más información, consulte Uso de datos embebidos con XM Directory. Además, se creará un evento en la cronología de los puntos de contacto de XM Directory de los visitantes cada vez que se les muestre su intercept.

Linking XM Directory with Website & App Insight Project

1 Website & App Insight project can only link to 1 directory. Esto ayuda a garantizar que no haya problemas con las reglas de frecuencia de contacto, especialmente si el mismo contacto existe en diferentes directorios con diferentes reglas de frecuencia. También consolida todos los puntos de contacto digitales en un único lugar para organizar y mantener.

To link a Website & App Insight project to a directory, go to the project’s Settings tab, enable Link to XM Directory, and choose the directory from the dropdown list.enabling the Link to XM Directory option in the WAF project settings

After the project is linked to a directory, you can link an intercept to a directory by going to Intercept Options and selecting Link this intercept to XM Directory.enabling the link with XM Directory option in the intercept options

Consejo Q: Para intercepts guiados, vaya a Mostrar frecuencia y XM Directory en lugar de a Opciones.
Atención: A partir de mayo de 2024, los proyectos no pueden vincularse a múltiples directorios.

Creación automática de contactos

Atención: Deberá trabajar con su equipo de desarrollo de sitios web para añadir código con el fin de enviar información de contacto al directorio mediante API. Para obtener más información, consulte nuestra documentación de API sobre la creación de un contacto del directorio o la creación de un contacto en una lista de distribución.

XM Directory contacts can be created each time users visit web pages with Qualtrics Website & App Insights project deployment code on them. This option enables adding contacts automatically when Website & App Insights project deployment code runs on the webpage, eliminating the need for manual file uploads or SFTP based automations.

Consejo Q: No es necesario mostrar un intercept para que funcione la creación de contactos; el código de implementación solo debe ejecutarse en la página. Para obtener más información, consulte Vistas de página.

To enable automatic contact creation, you must first link the Website & App Insights project to the XM Directory in the Project Settings tab. Then, click the checkmark next to the option that says If the contact doesn’t exist in your directory, add it automatically.
turning on the create contact option in project settings

Puede añadir la siguiente información para cada contacto:

Nombre
Apellido
Idioma
Pares clave/valor adicionales (p.ej. “Ubicación”:”Seattle”,”Género”:”Femenino”). Puede añadir hasta 200 pares

Consejo Q: Qualtrics creará un contacto la primera vez que se cargue el código de implementación. En todas las páginas siguientes, se contarán como un usuario conocido en XM Directory.
Consejo Q: Otra funcionalidad de XM Directory, como la segmentación de segmentos o las reglas de frecuencia de contacto, no funcionará dentro de la misma carga de página que la que se creó el perfil de contacto. Una vez que se crea un contacto, cualquier intercept posterior evaluará la frecuencia de contacto y las reglas de segmentación de segmentos.

Configuración de reglas de frecuencia de contacto para intercepts

Consejo Q: Para ver una demostración en vídeo de cómo utilizar esta función y verla en acción, consulte esta publicación en la Comunidad de Qualtrics.
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.

Las reglas de frecuencia de contacto se pueden configurar para limitar la frecuencia con la que se muestra un intercept. Puede utilizar reglas de directorio generales, así como reglas personalizadas para encuestas específicas. Para las encuestas que pueden verse en muchos dispositivos o navegadores, como los intercepts de opinión pasiva, recomendamos no utilizar la frecuencia de contacto.

Atención: En este momento, no se admiten las reglas personalizadas que se aplican a las listas. Si varios intercepts en la misma página utilizan reglas de XM Directory basadas en listas (mismo directorio o directorios diferentes), solo mostraremos 1 de esos intercepts. El intercept mostrado será el más antiguo.
  1. Abra un proyecto de Opinión de página web/aplicación existente o cree un proyecto nuevo.
  2. Abra un intercept existente o cree uno nuevo.
  3. Edite las opciones Mostrar frecuencia y XM Directory.
    Editar opciones de frecuencia de visualización en la configuración de intercept digital.
  4. Activar enlace con XM Directory.
    Settings tab with directory settings options

    Consejo Q: Cuando se selecciona esta opción, los datos embebidos de contacto de los usuarios que realicen esta encuesta se añadirán automáticamente a la respuesta de su encuesta. Consulte Uso de datos embebidos con XM Directory
  5. Confirm the directory selected, which is set from the Settings page.
  6. Enable Contact frequency rules.
  7. Grabe las modificaciones.
  8. Los siguientes pasos difieren en función de si está implementando esta funcionalidad en un sitio web o una aplicación móvil.
    • Sitio web: En su sitio web donde iniciará el intercept, especifique la expresión JavaScript que se evaluará en la sesión de inicio de sesión del usuario para obtener el ID de referencia externa para el contacto. Este ID de referencia externa se utiliza para buscar al visitante en XM Directory y rastrear si han visto su intercept.
    • Aplicación: En la aplicación en la que iniciará el intercept, deberá actualizar el SDK de su aplicación móvil para recuperar el ID de referencia. Consulte la documentación de API.
Consejo Q: Si no recupera un ID de referencia, el intercept se comportará como si las reglas de frecuencia de contacto no estuvieran activadas. Si recupera un ID de referencia que no coincide con ningún ID de su directorio, el intercept no se mostrará.

Configuración de segmentos para Intercept Targeting

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.
Atención: Solo los usuarios que tienen activado el permiso Gestionar directorio pueden crear y editar segmentos. Cualquier usuario con el permiso Acceder a contactos puede distribuir a segmentos existentes.

Una vez que haya creado segmentos en XM Directory, puede usarlos en Qualtrics en muchos de los lugares donde pueden hacerlo las listas de distribución y muestras, incluso con Información estratégica de sitio web/aplicación. La combinación de XM Directory y Website/App Insights le permite orientar la visualización de intercepts de sitios web y aplicaciones a segmentos específicos de usuarios, así como obtener información estratégica específica de segmentos y viajes.

Consejo Q: Si el intercept se muestra al visitante de su sitio web, este punto de contacto también se mostrará en la línea de tiempo del punto de contacto de XM Directory.
Ejemplo: Mientras los contactos se han dado de baja del directorio no verán ningún correo electrónico adicional, aún pueden ver intercepts. Para asegurarse de que a los usuarios excluidos no se les muestre ningún intercept, utilice el estado de exclusión cuando configure los criterios de segmento y, a continuación, utilice la lógica de segmentación por segmentos.
  1. Crear un intercept en un proyecto de Opinión de página web/aplicación existente o nueva.
    Consejo Q: Si, en lugar de crear un intercept independiente, le gustaría obtener ayuda durante todo el proceso, no dude en utilizar nuestra configuración guiada para proyectos de Opinión de página web/aplicación. Si utiliza la configuración guiada, se le pedirá que añada un diseño, conecte su encuesta y configure su intercept. Para obtener más información sobre la configuración guiada, visite Elegir cómo desea recopilar feedback.
  2. Vaya a Opciones de intercept.
    la ficha de opciones de intercepción. la opción de vínculo al directorio xm está habilitada y el directorio predeterminado está seleccionado

    Consejo Q: Los pasos son los mismos en los intercepts de la aplicación móvil, pero verá menos opciones de intercept.
  3. Activar “Enlace al XM Directory” marcando la casilla de selección.
  4. Confirm the directory selected, which is set from the Settings page.
  5. Vuelva al editor de intercept y añada la lógica de targeting que contiene su segmento de XM Directory.
    Por ejemplo, XM Directory Segment Is High-Value-Users.
    Consejo Q: En intercepts del sitio web, puede probar el intercept utilizando el marcador tanto con contactos que están en el segmento como con contactos que no están en el segmento. Durante las pruebas, tendrá que imitar la configuración del ID de referencia externa en su navegador para que Qualtrics pueda identificar al contacto.
  6. Los siguientes pasos difieren en función de si está implementando esta funcionalidad en un sitio web o una aplicación móvil.
    • Sitio web: En su sitio web donde iniciará el intercept, especifique la expresión JavaScript que se evaluará en la sesión de inicio de sesión del usuario para obtener el ID de referencia externa para el contacto. Este ID de referencia externa se utiliza para buscar al visitante en XM Directory y rastrear si han visto su intercept. Consulte la sección anterior para obtener más detalles sobre la expresión JavaScript.
    • Aplicación: En la aplicación en la que iniciará el intercept, deberá actualizar el SDK de su aplicación móvil para recuperar el ID de referencia. Consulte la documentación de API.

Probar la integración de XM Directory con intercepts de sitio web

Antes de iniciar su intercept en su página web, debe probarlo para asegurarse de que la frecuencia de contacto, la segmentación de segmentos o la creación de contactos se hayan implementado correctamente.

En su implementación real, el ID de referencia externa del visitante de su sitio estará disponible en el contexto de su sesión registrada a través de una expresión de JavaScript o una cookie.

Los siguientes pasos le permiten realizar un escenario integral utilizando datos de prueba y soluciones alternativas del navegador web.

Frecuencia de contacto de prueba

  1. En su XM Directory, cree un nuevo contacto y especifique un ID de referencia único para ese contacto.
    Ejemplo: Utilizaremos aaa123 como ID de referencia de ejemplo. Cada vez que vea el número de ID en estos pasos, sustitúyalo por el ID de referencia que ha especificado.
  2. Siga los pasos de la sección Configuración de segmentos para intercept targeting para configurar un intercept para seguir el segmento de destino.
  3. Ir a Probar Intercept.
    Probar la sección Intercept del intercept con el marcador indicado
  4. Arrastre el marcador a la barra de marcadores del navegador.
  5. Vaya a una página web que desee utilizar para realizar pruebas.
  6. Vaya a la consola de desarrollador. Dependiendo de su navegador web, lo alcanzará de manera diferente:
    • Google Chrome: En la barra de menús de Chrome, vaya a Ver → Desarrollador → Herramientas de desarrollador. En la ventana que aparece, vaya a la Consola
    • Apple Safari: Asegúrese de que el menú Desarrollar esté habilitado para Safari. Para ello, vaya a Preferencias → Avanzado → Mostrar el menú Desarrollar en la barra de menús. Haga clic en Desarrollar en el menú Safari y seleccione Mostrar Web Inspector. En la ventana que aparece, vaya a la Consola
    • Mozilla Firefox: Haga clic en el icono del menú y luego seleccione Desarrollador web. En el menú Desarrollador web, seleccione la Consola
    • Microsoft Edge: En la barra de menús, vaya a Herramientas → Desarrollador → Herramientas de desarrollador. En la ventana que se abre, vaya a la Consola
    • Internet Explorer: Haga clic en el icono Engranaje y seleccione Herramientas del desarrollador. En la ventana que se abre, vaya a la Consola
  7. En el menú Consola, escriba esta expresión y, a continuación, pulse Intro:
    UserID="aaa123"
    introduciendo el ID de usuario en la pestaña de la consola del sitio web en el que se encuentra el intercept

    Consejo Q: aaa123 es nuestro valor de ID de referencia de ejemplo y debe sustituirse por el valor que ha asignado al contacto en el paso 1.
  8. Pegue el fragmento de JavaScript a continuación para configurar la variable JavaScript externalReference para que sea su expresión JavaScript.
    introduciendo la expresión javascript para recuperar el ID de usuario

    if(typeof QSI === "unlimited") {
         QSI = {};
         QSI.config = {
             externalReference: UserID
         };
     }
  9. Pulse Intro.
  10. Haga clic en el marcador y verá que el objetivo del segmento se respetará adecuadamente para determinar si el intercept se debe o no mostrar.
    Consejo Q: Por motivos de seguridad, la línea lógica de direccionamiento que incluye el segmento solo incluirá el ID de segmento. Para hacer coincidir un ID de segmento con un nombre de segmento, vaya a XM Directory y edite su segmento. La URL tendrá el ID de segmento, que está en negrita en la siguiente URL de ejemplo: https://dxdemo.co1.qualtrics.com/iq-directory/#/POOL_2QRmx18nJXf6kuR/segments/SG_1hHhxvjX3PAZ34k

Para repetir estos pasos para pruebas adicionales, haga lo siguiente entre las pruebas:

  1. Actualice su navegador cada vez.
  2. Configure la expresión JavaScript en su consola.
  3. Ejecute su marcador de nuevo.
  4. Navegue a XM Directory y valide que el contacto se haya creado con los valores de entrada.

CREACIÓN DE CONTACTO DE PRUEBA

  1. Open an existing Website / App feedback project.
  2. Navigate to the Settings.
    Editar opciones de frecuencia de visualización en la configuración de intercept digital.
  3. Activar enlace con XM Directory.
  4. Seleccione un directorio de la lista desplegable.
  5. Click the checkbox next to If the contact doesn’t exist in your directory, add it automatically.
  6. Click Apply changes.
  7. Follow the instructions in the Deployment tab to copy the deployment code snippet.
  8. Vaya a una página web que desee utilizar para realizar pruebas.
  9. Vaya a la Consola de desarrollador. Dependiendo de su navegador web, lo alcanzará de forma diferente:
    • Google Chrome: En la barra de menús de Chrome, vaya a VerDesarrolladorHerramientas de desarrollador. En la ventana que aparece, vaya a la Consola
    • Apple Safari: Asegúrese de que el menú Desarrollar esté habilitado para Safari. Para ello, vaya a Preferencias → Avanzado → Mostrar el menú Desarrollar en la barra de menús. Haga clic en Desarrollar en el menú Safari y seleccione Mostrar Web Inspector. En la ventana que aparece, vaya a la Consola
    • Mozilla Firefox: Haga clic en el icono del menú y luego seleccione Desarrollador web. En el menú Desarrollador web, seleccione la Consola
    • Microsoft Edge: En la barra de menús, vaya a HerramientasDesarrolladorHerramientas de desarrollador. En la ventana que se abre, vaya a la Consola
    • Internet Explorer: Haga clic en el icono Engranaje y seleccione Herramientas del desarrollador. En la ventana que se abre, vaya a la Consola
  10. En el menú Consola, escriba esta expresión con valores de contacto de XM Directory de ejemplo y, a continuación, pulse Intro.
    QSI = {config: {externalReference:"test123", contactEmbeddedData: {"Location":"Seattle"}, language:"English", firstName:"Jane", lastName:"Smith"}}

    Entrada de consola para pruebas de intercepción digital.

    Consejo Q: Los valores de esta expresión son ejemplos de valores de contacto que se agregarán al perfil de XM Directory del contacto de prueba. Puede modificar estos valores a lo que desee.
    Atención: No admitimos direcciones de correo electrónico como atributos de perfil para conservar intercepts web altamente seguros. Puede añadir direcciones de correo electrónico manualmente a través del directorio o mediante cargas de archivos y automatizaciones SFTP.
  11. Haga clic en el marcador y verá que se mostrará el intercept.
    Consejo Q: NO es necesario mostrar el intercept para que la creación del contacto funcione. Sólo hay que evaluarlo en la página.
    Consejo Q: Otra funcionalidad de XM Directory, como la segmentación de segmentos o las reglas de frecuencia de contacto, no funcionará como parte de la misma carga de páginas que la del perfil de contacto. Sin embargo, una vez creado el contacto, cualquier intercepto posterior evaluará la frecuencia de contacto y las reglas de direccionamiento de segmento.
  12. Paste the deployment code snippet in the Console and then press Enter.
  13. Navegue al XM Directory indicado en la lista desplegable del paso 3 y valide que el contacto se haya creado con los valores introducidos en el paso 9.
Consejo Q: En intercepts del sitio web, puede probar el intercept utilizando el marcador tanto con contactos que están en el segmento como con contactos que no están en el segmento. Durante las pruebas, tendrá que imitar la configuración del ID de referencia externa en su navegador para que Qualtrics pueda identificar al contacto.

Consejos para la resolución de problemas

Se ha añadido un nuevo usuario a los segmentos, pero no ve un intercept dirigido a su segmento.

Los segmentos se reconstruyen diariamente en XM Directory. Por lo tanto, existe la posibilidad de que el nuevo usuario aún no se haya considerado como miembro del segmento.

La ventana del depurador intercept no muestra los nombres de los segmentos.

Por motivos de seguridad, no mostramos el nombre del segmento en la ventana del depurador para cualquier lógica de direccionamiento que tenga segmentos. Mostraremos el ID de segmento. Para asignar un ID de segmento al nombre de segmento, trate su segmento en XM Directory y mire el URL. La URL tendrá el ID de segmento, que se resalta en la siguiente URL de ejemplo: https://dxdemo.co1.qualtrics.com/iq-directory/#/POOL_2QRmx18nJXf6kuR/segments/SG_1hHhxvjX3PAZ34kAlternately

, puede abrir directamente un intercept y examinar la lógica de segmentación para ver qué segmentos se están dirigiendo.

El intercept tarda en aparecer para los usuarios nuevos.

Por motivos de rendimiento, almacenamos temporalmente la membresía de segmentos en memoria y solo la actualizamos según sea necesario. Si un usuario aún no está en nuestro almacenamiento temporal, el intercept de ese usuario puede tardar un poco más en mostrarse inicialmente.

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.