Integración de XM Directory con Digital Intercepts

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

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:

• Mantenga sus contactos actualizados. Esto permite a Qualtrics distinguir si los visitantes de la página web son contactos existentes o nuevos visitantes.
  Ejemplo: Configure una automatización de importación de contactos para mantener XM Directory sincronizado con sus listas de clientes o trabaje con su equipo de desarrollo para crear contactos utilizando Crear un contacto nuevo y actualizar las llamadas a la API de un contacto.
• Fusionar automáticamente contactos duplicados. Puede fusionar solo los contactos recién creados o todos los contactos existentes. Consulte Fusionar contactos duplicados en XM Directory para obtener más información.
  Consejo Q: La fusión de contactos en función del campo Datos de referencia externos garantiza que cada contacto tenga un valor único.

Intercepts

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.

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

     };

 }

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.

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.

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.

Creación automática de contactos

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.

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.

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

Configuración de reglas de frecuencia de contacto para intercepts

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.

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.
   
4. Activar enlace con XM Directory.
   
   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.

Configuración de segmentos para Intercept Targeting

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.

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

   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.
   
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 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
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"}}

    

    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.

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.