Integración con Qualtrics Social Connect
Acerca de la integración con Qualtrics Social Connect
La integración con Qualtrics Social Connect le permite consolidar y analizar todas las opiniones de sus clientes digitales en un solo lugar. A continuación, puede analizar sus datos utilizando cualquier método de análisis de Qualtrics, incluido Text iQ en un dashboard de CX.
Paso 1: Creación de la cabecera de autorización
En esta sección se explica cómo crear la cabecera de autorización para la integración. Necesitará esto para configurar la integración con Qualtrics Social Connect.
- Vaya a Configuración de cuenta.
- Vaya a la sección ID de Qualtrics de su cuenta y copie su token de API. Si ya tiene un token de API, no genere uno nuevo.
- Anote su nombre de usuario de Qualtrics. Normalmente, esta es la dirección de correo electrónico que utiliza para iniciar sesión en Qualtrics. Si no conoce su nombre de usuario de Qualtrics, póngase en contacto con su administrador de organización.
- Con su nombre de usuario de Qualtrics, cree una cadena de credenciales con el siguiente formato:
<Su nombre de usuario de Qualtrics>:<Su token de API de Qualtrics y gt;.Consejo Q: Si utiliza SSO para iniciar sesión en Qualtrics, asegúrese de incluir el componente # de su nombre de usuario.Ejemplo: Un ejemplo de cadena de credenciales es:
barnaby@qualtrics.com:63V9BuO9wMyvgo9HOf1OpeTOrhkvYGiRx1yMGrki
- Codifique la cadena de credenciales con codificación base64. Puede utilizar cualquier codificador base64 en línea para lograrlo.
Ejemplo: Mi cadena de credenciales codificadas base64 es:
YmFybmFieUBxdWFsdHJpY3MuY29tOjYzVjhCdU85V015dmcwOUlPZjFPcDhUT3Joa3ZZR2lSeDF5TUdaa2k=
- Construya la cabecera de autorización en el siguiente formato: Basic <credenciales codificadas en base64>. Tenga en cuenta el espacio entre “Básico” y las credenciales.
Ejemplo: Mi cabecera de autorización final es:
Basic YmFybmFieUBxdWFsdHJpY3MuY29tOjYzVjhCdU85V015dmcwOUlPZjFPcDhUT3Joa3ZR2lSeDF5TUdaa2k=
Necesitará esta credencial de autorización en la siguiente sección. Cópielo en algún lugar de fácil acceso.
Paso 2: Crear una automatización en Qualtrics Social Connect
Esta sección cubre la configuración inicial que deberá completar en Qualtrics Social Connect para configurar la integración. Para iniciar la configuración, primero deberá crear un workflow en Qualtrics.
- En Qualtrics, vaya a Flujos de trabajo.
- Haga clic en Crear un workflow y, a continuación, en Iniciado por un evento.
- Seleccione el botón Evento JSON.
- Haga clic en Copiar URL para copiar el extremo del evento. Necesitará este extremo del evento para completar la configuración en Qualtrics Social Connect. Guárdelo en algún lugar al que pueda acceder más tarde.
- En una nueva pestaña del navegador, inicie sesión en Qualtrics Social Connect.
- Vaya a Configuración de cuenta.
- En la pestaña Resumen, seleccione Recetas de automatización.
- En la sección Actualización en caso, haga clic en Añadir receta de automatización.
- Asigne un nombre a su receta de automatización.
- Asegúrese de que Mención está seleccionado en la sección Desencadenador y seleccione Se ha creado en el menú desplegable.
- Haga clic en el signo más (+ ) para seleccionar uno o más temas para supervisar.
- En la sección Filtro, configure las reglas de filtrado para las menciones que desea supervisar.
- En la sección Acción, seleccione Desencadenar Webhook en el menú desplegable.
- En el campo URL, pegue el punto final de evento que ha copiado en el paso 4.
- En el campo Cabecera de autorización, pegue la cabecera de autorización que ha creado anteriormente.
- Si utiliza una llamada API para recuperar etiquetas, active la opción Retraso. Se recomienda establecer un retraso mínimo de 10 minutos para garantizar que las etiquetas hayan tenido el tiempo necesario para adjuntar a las menciones.
- Haga clic en Añadir para completar la configuración.
Para probar la conexión, genere una nueva mención (la forma de generar la mención dependerá de su fuente, como crear un nuevo tweet o dejar un comentario). Como alternativa, puede esperar a la siguiente publicación cuando ocurra de forma natural. Una vez generada la nueva mención, abra el evento JSON en su workflow de Qualtrics y observe las propiedades JSON capturadas por el evento:
Paso 3: Crear el conjunto de datos de Qualtrics
Para guardar los datos en Qualtrics, debe crear un conjunto de datos de Qualtrics. Puede crear un conjunto de datos de Qualtrics llamando la API de conjunto de datos directamente desde la línea de comandos.
- Abra un editor de texto y construya el comando API. El formato general es el siguiente:
curl -X POST https://brandID.qualtrics.com/API/v3/datasets -H "Content-Type: application/json" -H "X-API-TOKEN: Your Qualtrics API Token" -d '{ "name": "Choose a name for your set", "primaryKey": "Choose ID Column name", "createProject": true, "fields": [ { "name" } Same ID column name as"arriba"
- En el comando API anterior, debe sustituir los siguientes valores:
- brandID: Su ID de organización de Qualtrics.
- Su token de API de Qualtrics: su token de API.
- Seleccione un nombre para su conjunto de datos: Introduzca un nombre para darle al conjunto de datos.
- Elegir nombre de columna de ID: Especifique el nombre de campo que contendrá la clave de identificación de su proyecto. Recomendamos utilizar “uniqueId”.
- Abra la terminal en su ordenador y pegue el comando. Pulse Intro para ejecutar el comando.
- Copie el ID de conjunto de datos del resultado. Necesitará esto más tarde. El resultado de la llamada API tendrá el siguiente formato:
{"result":{"name":"<Name of your dataset> ","primaryKey":"<id field that you defined> ","datasetId":"ID de conjunto de datos, esto es lo que necesita copiar","fields":[<list of fields that you defined> ]},"meta":{"requestId":"<internal request ID> ","httpStatus":"200 - OK"}}
- Una vez creado el conjunto de datos, estará disponible en la página Proyectos de Qualtrics como un proyecto de datos importado. Haga clic en el proyecto para abrirlo.
- Después de abrir el proyecto de datos importados, puede utilizar el editor de campos en la pestaña Datos y análisis para añadir los campos que desea importar desde Social Connect. Consulte Campos comunes de conexión social para obtener más información sobre los campos que tiene a su disposición. Al añadir sus campos, le recomendamos que los guarde como un tipo de texto abierto en su conjunto de datos.
Paso 4: Completar el flujo de trabajo
Ahora que ha establecido una conexión con Qualtrics Social Connect y ha creado su conjunto de datos, ha llegado el momento de asignar datos de Qualtrics Social Connect a su conjunto de datos.
- Abra el workflow que ha creado anteriormente.
- Haga clic en el signo más (+) y seleccione Tarea.
- Seleccione el botón Servicio web tarea.
- Seleccione Servicio web autenticado.
- Haga clic en Siguiente.
- Haga clic en Añadir una cuenta de usuario.
- Asigne un nombre a su cuenta. Esto es para sus propios fines organizativos.
- Seleccione OAuth para el tipo de conexión.
- Seleccione Credenciales de cliente para el tipo de concesión.
- Introduzca el ID de cliente y el secreto de cliente. Consulte API OAuth para obtener más información sobre cómo crearlos.
- Pegue la siguiente URL en el punto de acceso de token: https://BrandID.DatacenterID.qualtrics.com/oauth2/token
- Sustituya el texto en negrita anterior por los ID correspondientes:
- BrandID: su ID de organización de Qualtrics.
- DatacenterID: Su ID de centro de datos de Qualtrics.
- Haga clic en Conectar cuenta.
- Seleccione la cuenta que acaba de añadir.
- Haga clic en Siguiente.
- Seleccione POST para el tipo de solicitud.
- Introduzca la URL en el siguiente formato:
https://brandID.qualtrics.com/API/v3/datasets/DatasetID/data
Donde brandID es su ID de organización de Qualtrics y DatasetID es el ID del conjunto de datos que copió anteriormente.
- En la sección Cabeceras, añada Autorización como clave.
- Para el Valor, introduzca Portador y añada un espacio final.
- Haga clic en el icono de texto dinámico, {a}, y seleccione su cuenta QSC.
- En la sección Cuerpo, seleccione pares de clave-valor JSON y comience a asignar sus campos. Para la Clave, introduzca el nombre de campo. Para el valor, utilice el texto dinámico para seleccionar el campo que proviene directamente del evento JSON. La sección Campos comunes de conexión social tiene el código de texto dinámico para los datos no transformados de Social Connect.
- Cuando termine, haga clic en Guardar.
Paso 5: Analizar los datos de conexión social de Qualtrics
En esta sección se explica cómo analizar sus datos de Qualtrics Social Connect en dashboards de CX y Text iQ.
Visualización de datos de conexión social en dashboards de CX
- Cree un nuevo dashboard en un proyecto de dashboard de CX.
- Haga clic en Añadir fuente, pase el ratón por encima de Fuentes de datos externas y, a continuación, seleccione el proyecto que contiene sus datos de conexión social.
- Ajuste los tipos de campo para sus campos importados. Consulte Campos comunes de conexión social para obtener más información sobre el tipo de campo sugerido para cada campo de conjunto de datos.
- Guarde las modificaciones cuando haya terminado.
La edición del dashboard es la misma que la edición de cualquier dashboard de CX. Consulte las siguientes páginas de soporte técnico para obtener más información:
- Introducción a los tableros de CX
- Paso 1: Creación de su proyecto y amplificador; adición de un dashboard
- Paso 2: Asignación de una fuente de datos de dashboard
- Paso 3: Planificación del diseño de su tablero de control
- Paso 4: Construir su panel
- Paso 5: Personalización adicional del panel
- Paso 6: Compartir y compartir; Administrar usuario
Uso de Text iQ
Le recomendamos que utilice Text iQ en su dashboard de CX. Esto garantizará que todos sus datos se encuentren en un solo lugar y que los campos de Text iQ se asignarán automáticamente a su dashboard si los analiza a través del dashboard. Cuando esté listo para empezar, haga clic en el botón Analizar en Text iQ de su dashboard.
La mayoría de los campos de mención no son útiles para el análisis de texto (por ejemplo, autor, fuente, ID, etc.). Al seleccionar los datos para importar a Text iQ, asegúrese de seleccionar el campo de contenido del mensaje.
El uso de Text iQ para datos de conexión social funciona de la misma manera que el análisis del texto de respuesta de la encuesta en Qualtrics. Consulte las siguientes páginas de soporte técnico para obtener más información:
Importación de enriquecimientos de XM Discover
En esta sección se explica cómo importar enriquecimientos de XM Discover a su conjunto de datos. Aunque no es obligatorio integrarlo con Qualtrics Social Connect, XM Descubra los enriquecimientos que le ayudan a analizar las menciones en tiempo real etiquetándolas en función del contenido de la mención.
- En Conexión social, vaya a Etiquetas.
- Haga clic en Añadir XM Descubrir Enriquecimiento.
- Seleccione los temas para los que desea añadir enriquecimientos.
- Haga clic en Siguiente.
- Seleccione los modelos de categoría que desea utilizar.
- Para Enriquecimiento en tiempo real, seleccione Sí.
Atención: Si no habilita el enriquecimiento en tiempo real, los enriquecimientos de XM Discover se procesarán con un retraso de 7 o más minutos después de que se cree la mención en Social Connect y, por lo tanto, las etiquetas correspondientes no estarán disponibles en su flujo de trabajo de Qualtrics.
- Haga clic en Guardar.
Vuelva a su flujo de trabajo en Qualtrics. Asegúrese de asignar sus campos en su flujo de trabajo de Qualtrics para guardar los enriquecimientos de XM Discover en su conjunto de datos de Qualtrics. Se guardan como el campode etiquetas.
Dado que XM Discover Enrichments se exporta como una lista separada por comas, deberá especificar el delimitador de campos en su dashboard utilizando el editor de recodificación. Asegúrese de seleccionar Coma como delimitador. También puede cambiar el nombre de los campos con el editor de recodificación para que sean más fáciles de visualizar en el dashboard.
Campos comunes de conexión social
Esta sección contiene una tabla de campos de uso común de Social Connect, su código de texto dinámico para crear su asignación, el tipo de campo que debe guardarlos como en Qualtrics y cualquier nota especial sobre el campo.
Nombre de campo de conjunto de datos | Ruta de texto dinámico (para asignación de flujo de trabajo) | Tipo de campo de dashboard | Descripción y notas especiales |
id | ~{aed://id} | Valor de texto | Identificador específico de Qualtrics Social Connect para esta mención (único por tema). |
ID unívoco | ~{aed://unique_id} | Valor de texto | Identificador específico de conexión social de Qualtrics para esta mención. |
Nombre autor. | ~{aed://author.name} | Valor de texto | Nombre de usuario o identificador del autor de la mención. |
authorFullname | ~{aed://author.fullname} | Valor de texto | Nombre completo del autor de la mención. |
ID autoriz. | ~{aed://author.id} | Valor de texto | Identificador específico de servicio del autor (p. ej., UID de Twitter) |
nombre de autorización original | ~{aed://original_author.name} | Valor de texto | Nombre de usuario o identificador del autor original de la mención. (En caso de que se trate de un retuit, repin,…) |
nombre completo de autorización original | ~{aed://original_author.fullname} | Valor de texto | Nombre completo del autor original de la mención. |
originalAuthorId | ~{aed://original_author.id} | Valor de texto | Identificador específico de servicio del autor original (p. ej., UID de Twitter). |
messageTitle | ~{aed://message.title} | Texto libre | |
messageContent | ~{aed://message.content} | Texto libre | El contenido está en formato HTML. Es posible que desee utilizar una tarea de código para eliminar cualquier HTML o emojis. |
messageLanguage | ~{aed://message.language} | Conjunto de texto | Código de idioma ISO 639-1 del idioma en el que se encuentra este mensaje. |
messageSentiment | ~{aed://message.sentiment} | Conjunto de texto | Cualquiera de positivo, negativo, neutral o no fijado. |
messageType | ~{aed://message.type} | Conjunto de texto | Tipo de mensaje.
Valores posibles: “post”, “privatemessage”, “video”, “check in”, “foto”, “texto”, “cita”, “enlace”, “chat”, “audio”, “correo electrónico”, “revisión”, “aplausos”, “como”, “retweet”, “compartido”, “repin”, “usuario_favorito”, “reblog”, “compromiso”, “respuesta”, “otro” “comentario”, “pregunta”, “otro”, “pregunta”, “otro”, “pregunta”, “otro”, “pregunta” |
sourceCategory | ~{aed://source.category} | Conjunto de texto | Categoría en la que se puede clasificar esta mención.
Valores posibles: “social”, “social_videos”, “social_fotos”, “microblogs”, “foros”, “blogs”, “podcasts”, “comentarios”, “noticias”, “noticias_académicas”, “noticias_consumidor”, “noticias_corporativas”, “ventas_gobierno”, “news_journal”, “noticias_locales”, “noticias_nacionales”, “noticias_organizaciones”, “noticias_org”, “noticiares_productos” “noticieros”, “noticios_productos”, “noticias_productos”, “noticias_periodicos”, “noticias_productos”, “noticias_periodicos”, “noticios_productos”, “noticias_periodicos”, “noticias_productos”, “noticias_periodicos”, “noticias_productos”, “noticias_periodicos”, “noticias_periodicos”, “noticias_productos”, “noticias_periodicos”, “noticias_productos”, “noticias_periodicos”, “noticias_productos”, “noticias_periodicos”, “noticias_productos”, “noticias_periodismo”, “noticiares_productos” |
ServicioOrigen | ~{aed://source.service} | Conjunto de texto | De qué fuente de “servicio conectado” proviene la mención.
Valores posibles: “twita_facebook”, “facebook_ads”, “foursquare_place”, “googleplus”, “instagram”, “instagram_hashtag”, “instagrament_ads”, “blyrimeum”, “telegryping_group”, “pinterest”, “youblog”, “blytrimeum”, “telammecompany”, |
TipoOrigen | ~{aed://source.type} | Conjunto de texto | De qué fuente proviene la mención. (Nombre interno para filtrar.)
“SearchProvidProviderProviderProvider”, “SearchProvidProviderProvider,”, “SearchProvichProvider”, “SearchProvichProviderProvider,”, “SearchProvichProvichProvider”, “SearchProvichProvichProvidProvider”, “SearchProvichProvichProvidProviderProvider”, “SearchProvichProvichProvider”, “SearchProvichProvichProvidProvider”, “SearchProvichProvichProvidProviderProviderProvider”, “SearchProvichProvidProviderProviderProvider”, “SearchProvichProvidProviderProviderProvider”, “SearchProvichProvichProvid”, “SearchProvichProvichProvidProviderProviderProvider”, “SearchProvichProvichProvid”, “SearchProvichProvidProviderProvider”, “SearchProvichProvid”, “SearchProvichProvid”, “SearchProvichProvid”, “SearchProvichProvid”, “SearchProvichProvid”, “SearchProvichProvid”, “SearchProvichProvichProvid”, “SearchProvichProvid”, “SearchProvichProvid”, “SearchProvichProvid”, “SearchProvichProvid”, “SearchProvichProvid”, “SearchProvichProvid”, “SearchProvichProvid”, “SearchProvichProvid”, “SearchProvichProvid”, “SearchProvichProvidProviderProviderProvider”, “SearchProvichProvidProviderProvider”, “SearchProvichProvidProviderProvider”, “SearchProvichProviderProvider,”, “SearchProvichProvid,”, “SearchProvidProvichProvid”, “SearchProvichProvidProvid,”, “SearchProvichProvichProvid”, “SearchProvichProvid”, “SearchProvichProvidProviderProvider,”, “SearchProvichProvichProvid”, “SearchProvichProvichProvid”, “SearchProvichProvidProvid”, “SearchProvichProvid”, “SearchProvichProvidProviderProvider”, “SearchProvichProvid”, “SearchProvichProviderProvid”, “SearchProvichProvid”, “SearchProvichOutlook”, “SearchProvichProvid”, “SearchProvichProvid”, “SearchProvichProvid”, “SearchProvidProviderProviderPlus”, “SearchProvichProvid”, “SearchProvichProvid”, “SearchProvidProviderProvider,”, “SearchProvichLinkedIn”, “SearchProvichProvider”, “SearchProvidProviderProvider,”, “SearchProvidProviderProvider,”, “SearchProvichProviderProvider”, “SearchProvichLinkedIn”, “SearchProvidProviderProvider”, “SearchProvichProviderProvider”, “SearchProvichProvid”, “SearchProvichProvid”, “SearchProvichProvid”, “SearchProvichProvid”, “SearchProvichProvid,”, “SearchProvichProviderProvid,”, “SearchProvichProvid,”, “SearchProvichProvid,”, “SearchProvichProvids.com”, “SearchProvichProvid,”, “SearchProvichProvid,”, “SearchProvichProvid,”, “SearchProvichProvid,”, “SearchProvichProvid,”, “SearchProvidProviderProvider,”, “SearchProvichLinkedIn”, “SearchProvichProviderProvider,” “SearchProvichProviderProvider”, “SearchProvidProviderProvider,”, “SearchProvichProvid,”, “SearchProvidProviderProvider,”, “SearchProvichProvid,”, “SearchProvichProvid,” “SearchProvichProviderProvider,”, “SearchProvichProvid”, “SearchProvichProvich”, “SearchProvichProviderProvider”, “SearchProvidProvider”, “SearchProvichProvich”, “SearchProvidProvid”, “SearchProvidProvid,” “SearchProvich”, “SearchProvidProvid,”, “SearchProvidProviderProvider”, “SearchProvichProvid”, “SearchProvidProviderProvider,”, “SearchProvichProvid”, “SearchProvichProvid”, “SearchProvidProviderProvider”, “SearchProvidProviderProvider”, “SearchProvichProvid”, “SearchProvichProvid”, “SearchProvidProvider”, “SearchProvichProvid”, “SearchProvichProvid”, “SearchProvidProviderProvider”, “SearchProvidProviderProvider”, “SearchProvidProviderProvider”, “SearchProvidProvid”, “SearchProvichProviderProvider”, “SearchProvichProvid”, “SearchProvidProviderProvider”, “SearchProvichProvid”, “SearchProvichProviderProvider”, “SearchProvichProvid”, “SearchProvichProvid”, “SearchProvidProvider”, “SearchProvichProvid”, “SearchProvichProvid”, “SearchProvichProvid”, “SearchProvichProviderProviderPlus”, “SearchProvichProvider”, “SearchProvidProvid,”, “SearchProvichProvid”, “SearchProvichProvid”, “SearchProvichProvid”, “SearchProvichProvid”, “SearchProvichProvid”, “SearchProvichProvid”, “SearchProvichProvid”, “SearchProvidProviderProvi |
ID de origen | ~{aed://source.id} | Valor de texto | Identificación de este mensaje en el servicio del que es. (Por ejemplo, el ID de tuit para un mensaje de Twitter). |
sourceUrl | ~{aed://source.url} | Valor de texto | La URL del mensaje en el servicio del que es. (Por ejemplo, el enlace al comentario en el propio Facebook). |
ubicationContinent | ~{aed://location.continente} | Conjunto de texto | Código de continente. |
ubicationCountry | ~{aed://location.country} | Conjunto de texto | Código de país ISO 3166-1. |
LocationCity | ~{aed://location.city} | Valor de texto | Nombre completo de la ciudad. |
LocationRegion | ~{aed://location.region} | Valor de texto | |
etiquetas | ~{aed://tags} | Conjunto de textos de respuesta múltiple | Matriz de cadenas; etiquetas (inteligentes) agregadas a esta mención. |
ID de tema | ~{aed://topic.id} | Valor de texto | |
topicName | ~{aed://topic.name} | Valor de texto | |
estado | ~{aed://status} | Conjunto de texto | El estado corresponde a la etapa del workflow en la que se encuentra actualmente una mención/caso.
Valores posibles: “hecho”, “pendiente”, “nuevo”. |
tinta permaliciosa | ~{aed://permalink} | Valor de texto | URL específica de Qualtrics Social Connect única para esta mención. |
fecha añadida | ~{aed://date.added} | Valor de texto | Sello de fecha UNIX (en UTC) del momento en que Qualtrics Social Connect indexó la publicación.
Si utiliza este campo, querrá utilizar una tarea de código para transformar la fecha en un formato más fácil de usar. Como alternativa, puede utilizar la Fecha registrada predeterminada que se creará cuando se importe la publicación en Qualtrics, ya que la fecha y hora serán aproximadamente las mismas. |
fecha publicada | ~{aed://date.publish} | Valor de texto | Cronomarcador UNIX (en UTC) de cuándo se publicó la publicación.
Probablemente desee utilizar el texto dinámico de la tarea Código con fecha formateada. |
prioridad | ~{aed://Priority} | Conjunto de texto | |
etiquetas | Conjunto de textos de respuesta múltiple | Matriz de cadenas; etiquetas (inteligentes) agregadas a esta mención. Los datos de etiquetas inteligentes no se envían a través de webhooks. No estará en el payload del objeto Mención. Solo se pueden recuperar mediante una llamada API. |