Conector de salida de Qualtrics
Acerca del conector de salida de Qualtrics
El conector de salida de Qualtrics le permite realizar las siguientes acciones en su cuenta de Qualtrics:
- Desencadenar un evento de flujo de trabajo JSON y utilizar datos de XM Discover en flujos de trabajo de Qualtrics.
- Exporte respuestas con enriquecimientos de XM Discover de XM Discover e impórtelos en un conjunto de datos de encuesta de Qualtrics.
Requisitos
Antes de configurar la conexión, necesitará la siguiente información de su cuenta de Qualtrics:
- Su ID de centro de datos de Qualtrics.
- Su token de API de Qualtrics.
- Su punto de acceso de la API de exportación de XM Discover.
Jobs de evento JSON
Para desencadenar un evento JSON con el conector de salida de Qualtrics, necesitará el punto final del evento JSON. Puede copiar el extremo haciendo clic en Copiar URL cuando edite el evento JSON en su flujo de trabajo de Qualtrics.
Proceso de exportación de respuestas
Si exporta respuestas a un conjunto de datos de encuesta de Qualtrics, debe asegurarse de que sus datos cumplan los siguientes requisitos:
- Su conjunto de datos de encuesta debe tener campos que correspondan a los enriquecimientos de XM Discover que desea exportar. Si estos campos no existen, puede añadirlos como datos embebidos o crearlos utilizando campos personalizados.
- Los documentos que exporte desde XM Discover deben tener un campo que se corresponda con el ID de encuesta de la encuesta a la que desea importar respuestas.
Creación de un job de conector de salida de Qualtrics
- En la página Jobs, haga clic en Job nuevo.
- Seleccione el conector de salida de Qualtrics.
- Asigne un nombre a su trabajo para que pueda identificarlo.
- Seleccione el proyecto en el que desea cargar los datos.
- Dele una descripción a su trabajo para que conozca su propósito.
- Haga clic en Siguiente.
- Elija el tipo de datos de Qualtrics que desea exportar:
- Encuesta: Exporte los datos de respuesta para importarlos a un conjunto de datos de la encuesta.
- Evento JSON: Exporte datos para desencadenar un evento de flujo de trabajo JSON.
- Haga clic en Siguiente.
- Utilice el menú desplegable para seleccionar una conexión de Qualtrics existente o seleccione Añadir nuevo para crear una nueva.
Consejo Q: Para editar o eliminar una conexión existente, vaya a la configuración de su cuenta. - Al agregar una nueva conexión, proporcione lo siguiente:
- Nombre de conexión: Asigne un nombre a la conexión para que pueda identificarla más tarde.
- ID de centro de datos de Qualtrics: Introduzca su ID de centro de datos de Qualtrics.
- Token de API de Qualtrics: Introduzca el token de API de su cuenta de Qualtrics.
- Si desea que la conexión venza después de un período de tiempo, active la opción Enviar notificaciones de expiración. Utilice el campo Fecha de vencimiento para elegir cuándo vencen las credenciales. En el cuadro Días antes del vencimiento, introduzca la anticipación con la que desea que se le notifique el vencimiento de la conexión, hasta 100 días.
- Haga clic en Siguiente.
- Proporcione su punto de acceso de la API de exportación de XM Discover.
- Haga clic en Siguiente.
- Seleccione el nivel de datos que desea exportar:
- Sentencias: Utilice datos a nivel de frase.
- Documentos: Utilice datos a nivel de documento.
Consejo Q: Los pasos restantes de la página Configuración de consulta son opcionales y le ayudarán a limitar los datos que se exportan.
- Proporcione una consulta debúsqueda para filtrar los datos salientes. Utilice la misma sintaxis utilizada para buscar datos en Designer. Deje este campo vacío para incluir todos los datos.
Ejemplo: Puede especificar uno o más ID de encuesta para actualizar solo los registros de encuesta seleccionados con la siguiente sintaxis:Surveyid:sv_01
- Introduzca el nombre del filtro de su proyecto que desea que se aplique a los datos de salida. Deje este campo en blanco si no desea filtrar los datos.
- Elija qué registros desea importar:
- Cargar registros nuevos: registros que se crearon desde la última vez que se ejecutó el job de salida.
- Cargar registros nuevos y actualizados: registros que se crearon o actualizaron desde la última vez que se ejecutó el job de salida.
- Cargar registros actualizados: registros que se actualizaron desde la última vez que se ejecutó el job de salida.
- Utilice el menú desplegable para seleccionar los modelos de clasificación que desea incluir en sus datos. Marque la casilla de selección Todos los modelos para incluir los datos de clasificación para todos los modelos disponibles en el proyecto.
- Seleccione cómo desea que las clasificaciones afecten al filtrado de datos:
- Ignorar: No se aplica ningún filtrado basado en los modelos seleccionados.
- Clasificado actualmente: Devuelve los registros clasificados por los modelos seleccionados durante la ejecución de clasificación más reciente.
- Siempre clasificado: Devuelve los registros que han sido clasificados por los modelos seleccionados en cualquier momento.
- Seleccione las opciones de exportación adicionales que desea utilizar:
- Si se devuelven los ID de categoría (verdadero) en lugar de los nombres de categoría (falso): Exportar los ID de categoría en lugar de los nombres de categoría
- Filtra los resultados aplicando la consulta de filtro con todas las rutas de los nodos finales: añade varios modelos con el parámetro “flex_only flag” a la llamada de API de exportación.
- Ignorar valores vacíos: Omita la actualización de un documento de encuesta si todos sus valores salientes están vacíos.
- Haga clic en Siguiente.
- El siguiente paso depende de si está exportando datos de encuesta o enviando datos a un punto final JSON para desencadenar un flujo de trabajo:
- Encuesta: seleccione la encuesta a la que desea exportar datos y haga clic en Siguiente.
A continuación, seleccione el atributo XM Discover que contiene su ID de encuesta de Qualtrics.
Consejo Q: Solo se actualizarán los documentos con ID de encuesta que coincidan con la encuesta seleccionada en el paso anterior. - Evento JSON: introduzca el punto final JSON del evento JSON.
- Encuesta: seleccione la encuesta a la que desea exportar datos y haga clic en Siguiente.
- Asigne campos de XM Discover a Qualtrics. Haga clic en el cuadro vacío y seleccione el atributo XM Discover que desea enviar a Qualtrics.
- Seleccione el tipo de datos que el campo debe exportarse como, que corresponde al tipo de variable de datos embebidos del campo en Qualtrics:
- No asignar: No se especificó ningún tipo de variable.
- Atributo de número: tipo de variable de número.
- Atributo de texto: Tipo de variable de conjunto de texto.
- Atributo de fecha: Tipo de variable de fecha.
- Verbatim: Tipo de variable de texto.
- Introduzca el nombre del campo integrado de Qualtrics que debe rellenarse con los valores del atributo XM Discover seleccionado.
- Utilice los signos más (+ ) y menos ( – ) para añadir y eliminar campos según sea necesario.
- Haga clic en Siguiente.
- Si lo desea, puede añadir un filtro de conector para filtrar los datos entrantes para limitar los datos que se importan.
- También puede limitar el número de registros importados en un solo job introduciendo un número en el cuadro Especificar límite de registros. Introduzca “Todos” si desea importar todos los registros.
Consejo Q: Para los datos conversacionales, el límite se aplica en función de las conversaciones en lugar de las filas.
- Haga clic en Siguiente.
- Elija cuándo desea que se le notifique. Consulte Notificaciones de job para obtener más información.
- Haga clic en Siguiente.
- Seleccione cuándo se ejecuta el job. Puede realizar una extracción única o configurar una extracción de datos recurrentes. Consulte Programación de jobs para obtener más información.
- Haga clic en Siguiente.
- Revise su configuración. Si necesita cambiar una configuración específica, haga clic en el botón Editar para ir a ese paso en la configuración del conector.
- Haga clic en Finalizar para grabar el job.
Una vez guardada la tarea, los datos especificados se exportarán a Qualtrics en función de la programación que establezca. Si está desencadenando un evento JSON, asegúrese de crear el resto del workflow, que incluye añadir condiciones para limitar cuándo se ejecuta el workflow y tareas para determinar la salida del workflow.