Plantilla de artículo
Acerca de la integración con Qualtrics Social Connect
Integración con Conexión social de Qualtrics Le permite consolidar y analizar todos los opinión de sus clientes digitales en un solo lugar. Luego puede analizar sus datos utilizando cualquier método de análisis de Qualtrics , incluido Text iQ en un Tablero de CX .
Paso 1: Creación del encabezado de autorización
Esta sección cubre cómo crear el encabezado de autorización para la integración. Necesitará esto para configurar la integración con Qualtrics Social Connect.
- Ir a Configuraciones de la Cuenta .
- Navegar hasta el Identificaciones de Qualtrics sección de su cuenta y Copia tu token de API . Si ya tiene un token de API, no genere uno nuevo.
- Tome nota de su nombre de usuario de Qualtrics . Generalmente, 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 , contacto con su Administrador de Marca/organización .
- Usando su nombre de usuario de Qualtrics , construya una cadena de credenciales usando el siguiente formato:
< Su nombre de usuario de Qualtrics > : < Su token API de Qualtrics >.Consejo Q: Si utilizas 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:
qualtrics:63V9BuO9wMyvgo9HOf1OpeTOrhkvYGiRx1yMGrki
- Codifique la cadena de credenciales con codificación base64 . Puede utilizar cualquier codificador base64 en línea para lograr esto.
Ejemplo: Mi cadena de credenciales codificada en base64 es:
YmFybmFieUBxdWFsdHJpY3MuY29tOjYzVjhCdU85V015dmcwOUlPZjFPcDhUT3Joa3ZZR2lSeDF5TUdaa2k=
- Construya el encabezado de autorización en el siguiente formato: Básico < credenciales codificadas en base64 >. Tenga en cuenta el espacio entre “Básico” y las credenciales.
Ejemplo: Mi encabezado de autorización final es:
Básico YmFybmFieUBxdWFsdHJpY3MuY29tOjYzVjhCdU85V015dmcwOUlPZjFPcDhUT3Joa3ZZR2lSeDF5TUdaa2k=
Necesitará esta credencial de autorización en la siguiente sección. Cópielo en algún lugar de fácil acceso.
Paso 2: Creación de 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 comenzar la configuración, primero deberá crear un flujo de trabajo en Qualtrics.
- En Qualtrics, vaya a Flujos de trabajo.
- Hacer clic Crear un flujo de trabajo y luego Iniciado por un evento .
- Elige el Evento JSON.
- Hacer clic Copiar URL para copiar el punto final del evento . Necesitará este punto final de evento para completar la configuración en Qualtrics Social Connect. Guárdalo en algún lugar donde puedas acceder a él más tarde.
- En una nueva pestaña del navegador, Inicie sesión en Qualtrics Social Connect .
- Ir a Configuraciones de la Cuenta .
- En el Descripción general pestaña, seleccionar Recetas de automatización .
- En la sección Actualización del caso, haga clic en Agregar receta de automatización .
- Dale un toque especial a tu receta de automatización. nombre.
- Asegurar Mencionar se selecciona en el Activador sección y seleccionar Fue creado desde el menú desplegable.
- Haga clic en el signo más ( + ) para elegir uno o más temas para monitorear.
- En el Filtro Sección, configura las reglas de filtrado para las menciones que deseas monitorear.
- En el Acción sección, seleccionar Webhook de Activador desde el menú desplegable.
- En el campo URL , pegue el punto final del evento que copió en el paso 4.
- En el Encabezado de autorización campo, pegar el encabezado de autorización que creaste anteriormente .
- Si está utilizando una llamada API para recuperar etiquetas, habilite la Demora opción. Se recomienda establecer un retraso mínimo de 10 minutos para garantizar que las etiquetas hayan tenido tiempo de adjuntarse a las menciones.
- Hacer clic Agregar 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). Alternativamente, puedes esperar a la siguiente publicación cuando suceda de forma natural. Una vez que se haya generado la nueva mención, abra el evento JSON en su flujo de trabajo de Qualtrics y observe las propiedades JSON que capturó el evento:
Paso 3: Creación del 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 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:
rizo -X PUBLICACIÓN https:// Identificación de marca qualtrics/ API/v3/datasets -H "Tipo de contenido: aplicación/ json" -H "X- API -TOKEN: Su token API de Qualtrics " -d '{ "nombre": " Elija un nombre para su conjunto de datos ", "clave primaria": " Elija el nombre de la columna ID ", "crearProyecto": verdadero, "campos": [ { "nombre": " El mismo nombre de columna de ID que el anterior ", "tipo": "cadena" } ] }'
- En el comando API anterior, debe reemplazar los siguientes valores:
- Identificación de marca :Tu Qualtrics Identificación de la organización .
- Su token API de Qualtrics : Su token de API .
- Elija un nombre para su conjunto de datos :Ingrese un nombre para el conjunto de datos.
- Elija el nombre de la columna ID :Especifique el nombre del campo que contendrá la clave de identificación de su proyecto. Recomendamos utilizar “uniqueId”.
- Abra el Terminal en su computadora y pegue el comando. Prensa Ingresar para ejecutar el comando.
- Copiar el ID del conjunto de datos del resultado. Necesitarás esto más tarde. El resultado de la llamada API tendrá el siguiente formato:
{"resultado":{"nombre":<Name of your dataset> ","clave primaria": "<id field that you defined> ","ID del conjunto de datos": ID del conjunto de datos, esto es lo que necesitas copiar ","campos":[<list of fields that you defined> ]},"meta":{"identificador de solicitud":<internal request ID> ","httpEstado": "200 - OK"}}
- Una vez que haya creado su conjunto de datos, estará disponible en Qualtrics Página de Proyectos como un proyecto de datos importados . Haga clic en su proyecto para abrirlo.
- Después de abrir el proyecto de datos importados, puede utilizar el editor de campo en el Datos y análisis Pestaña para agregar los campos que desea importar desde Social Connect. Ver Campos de conexión social comunes para obtener más información sobre los campos disponibles para usted. Al agregar 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, es momento de asignar los datos de Qualtrics Social Connect a su conjunto de datos.
- Abra el flujo de trabajo que creó anteriormente.
- Haga clic en el signo más ( + ) y seleccione Tarea .
- Elige el Servicio Web tarea .
- Seleccionar Servicio web autenticado .
- Haga clic en Siguiente.
- Hacer clic Agregar una cuenta de usuario.
- Dale un toque a tu cuenta Nombre . Esto es para sus propios fines organizativos.
- Elegir OAuth para el tipo de conexión.
- Elegir Credenciales del cliente para el tipo de subvención.
- Ingresa tu Identificación del cliente y Secreto del cliente . Ver API OAuth para obtener más información sobre cómo crearlos.
- Pegue la siguiente URL en el Punto final del token : https:// Identificación de marca .DatacenterID.qualtrics.com/oauth2/token
- Reemplace el texto en negrita de arriba con los identificadores correspondientes:
- Identificación de marca :Tu Qualtrics Identificación de la organización .
- ID del centro de datos :Tu Qualtrics ID del centro de datos .
- Hacer clic Conectar cuenta .
- Seleccione su cuenta recién agregada.
- Hacer clic Siguiente.
- Seleccionar CORREO para el tipo de solicitud.
- Introduzca la URL en el siguiente formato:
https://brandID.qualtrics.com/API/v3/datasets/DatasetID/data
Dónde brandID es tu Identificación de marca/organización de Qualtrics y DatasetID es el ID del conjunto de datos que copiaste anteriormente .
- En la sección Encabezados, agregue Autorización como una clave.
- Para el Valor, ingrese Portador y añadir un espacio final .
- Haga clic en el icono de texto dinámico , {a} y elija su cuenta QSC.
- En la sección Cuerpo, seleccione Pares clave-valor JSON y comience a mapear sus campos. Para la clave, ingrese el nombre del campo. Para el valor, utilice texto dinámico para seleccionar el campo que viene directamente del evento JSON . El Campos de conexión social comunes La sección tiene el código de texto dinámico para datos no transformados de Social Connect.
- Cuando haya terminado, haga clic en Ahorrar.
Paso 5: Análisis de los datos de Qualtrics Social Connect
Esta sección cubre cómo analizar sus datos de Qualtrics Social Connect en los paneles de CX y Text iQ.
Visualización de datos de conexión social en los paneles de CX
- Crear un nuevo Tablero en un proyecto de Tablero de CX .
- Hacer clic Agregar fuente , pasa el cursor sobre Fuentes de datos externas y luego seleccione el proyecto que contiene sus datos de conexión social.
- Ajustar el tipos de campo para sus campos importados. Ver Campos de conexión social comunes para obtener más información sobre el tipo de campo sugerido para cada campo del conjunto de datos.
- Ahorrar sus cambios cuando haya terminado.
Editar su Tablero es lo mismo que editar cualquier Tablero de CX . Consulte las siguientes páginas de soporte para obtener más información:
- Introducción a los tableros de CX
- Paso 1: Crear su proyecto y agregar un Tablero
- Paso 2: Asignación de una fuente de datos del Tablero
- Paso 3: Planificación del diseño del Tablero
- Paso 4: Crea tu Tablero
- Paso 5: Personalización adicional del Tablero
- Paso 6: Compartir y administrar usuarios
Uso de Text iQ
Le recomendamos que utilice Text iQ en su Tablero de CX . Esto garantizará que todos sus datos estén en un solo lugar y sus campos de Text iQ se asignarán automáticamente a su Tablero si los analiza a través de Tablero. Cuando esté listo para comenzar, haga clic en el Analizar en Text iQ botón en su Tablero.
La mayoría de los campos de mención no serán útiles para el análisis de texto (por ejemplo, autor, fuente, id, etc.). Al elegir los datos que desea importar a Text iQ, asegúrese de seleccionar el campo de contenido del mensaje.
El uso de Text iQ para obtener datos de conexión social funciona de la misma manera que analizar el texto de las respuestas de la encuesta en Qualtrics. Consulte las siguientes páginas de soporte para obtener más información:
Importación de enriquecimientos de XM Discover
Esta sección cubre cómo importar enriquecimientos de XM Discover a su conjunto de datos. Si bien no es obligatorio integrarlo con Qualtrics Social Connect, los enriquecimientos de XM Discover lo ayudan a analizar sus menciones en tiempo real etiquetándolas según el contenido de la mención.
- En Social Connect, vaya a Etiquetas .
- Hacer clic Añadir enriquecimiento de XM Discover .
- Seleccione el(los) tema(s) a los que desea agregar enriquecimientos.
- Haga clic en Siguiente.
- Seleccione los modelos de categoría que desea utilizar.
- Para Enriquecimiento en tiempo real , seleccionar Sí .
Atención: Si no habilita el enriquecimiento en tiempo real, los enriquecimientos de XM Discover se procesarán con un retraso de 7 minutos o más 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.
Regrese a su flujo de trabajo en Qualtrics. Asegúrese de Asigne un mapa de sus campos en su flujo de trabajo de Qualtrics para guardar los enriquecimientos de XM Discover en su conjunto de datos de Qualtrics . Estos se guardan como etiquetas campo .
Dado que los enriquecimientos de XM Discover se exportan como una lista separada por comas, deberá especificar el delimitador de campo en su Tablero mediante el uso de editor de recodificación . Asegúrese de seleccionar Coma como su delimitador. También puedes cambiar el nombre de tus campos usando el editor de recodificación para que sean más fáciles de ver en el Tablero.
Campos de conexión social comunes
Esta sección contiene una tabla de términos comúnmente utilizados. campos de Social Connect , su código de texto dinámico para crear su mapeo, el tipo de campo en el que debe guardarlos en Qualtrics y cualquier nota especial sobre el campo.
Nombre del campo del conjunto de datos | Ruta de texto canalizada (para mapeo de flujo de trabajo ) | Tablero Tipo de campo | 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). |
Identificación única | ~{aed://identificación_única} | Valor de texto | Identificador específico de Qualtrics Social Connect para esta mención. |
nombredelautor | ~{aed://nombredelautor} | Valor de texto | Nombre de usuario o login del autor de la mención. |
autorNombre completo | ~{aed://autor.nombrecompleto} | Valor de texto | Nombre completo del autor de la mención. |
ID del autor | ~{aed://autor.id} | Valor de texto | Identificador específico del servicio del autor (por ejemplo. Identificador único de Twitter) |
nombredelautororiginal | ~{aed://nombre_del_autor_original} | Valor de texto | Nombre de usuario o identificador del autor original de la mención. (En caso de que esto sea un retweet, repin, …) |
Nombre completo del autor original | ~{aed://autor_original.nombre_completo} | Valor de texto | Nombre completo del autor original de la mención. |
ID de autor original | ~{aed://identificación_del_autor_original} | Valor de texto | Identificador específico del servicio del autor original (por ejemplo, (UID de Twitter). |
Título del mensaje | ~{aed://mensaje.titulo} | Texto libre | |
mensajeContenido | ~{aed://mensaje.contenido} | Texto libre | El contenido está en formato HTML . Es posible que desees utilizar una tarea de código para eliminar cualquier HTML o emoji. |
mensajeIdioma | ~{aed://mensaje.idioma} | Conjunto de texto | ISO 639-1 código de idioma del idioma en el que está este mensaje. |
mensajeSentimiento | ~{aed: sentimiento} | Conjunto de texto | Cualquiera de positivo, negativo, neutral o no establecido. |
tipo de mensaje | ~{aed://tipo.mensaje} | Conjunto de texto | Tipo de mensaje.
Valores posibles: “publicación”, “mensaje privado”, “video”, “checkin”, “foto”, “texto”, “cita”, “enlace”, “chat”, “audio”, “correo electrónico”, “revisión”, “aplausos”, “me gusta”, “retweet”, “compartido”, “repintar”, “favorito del usuario”, “reblog”, “compromiso”, “comentario”, “responder”, “consejos”, “pregunta”, “respuesta”, “postal”, “enumerado”, “caso”, “chat en vivo”, “documento”, “tuit del usuario”, “mención del usuario”, “normal”, “otro”. |
FuenteCategoría | ~{aed://fuente.categoría} | Conjunto de texto | Categoría en la que se puede clasificar esta mención.
Valores posibles: “social”, “social_videos”, “social_photos”, “microblogs”, “foros”, “blogs”, “podcasts”, “comentarios”, “noticias”, “noticias_académicas”, “noticias_consumidor”, “noticias_corporativas”, “noticias_gobierno”, “noticias_diario”, “noticias_locales”, “noticias_nacionales”, “organización_de_noticias”, “noticias_presswire”, “noticias_comerciales”, “wikis”, “reseñas”, “qa”, “ubicaciones”, “aplicaciones”, “productos”, “tiendas”, “clasificados”, “correo electrónico”, “caso”. |
FuenteServicio | ~{aed://fuente.servicio} | Conjunto de texto | ¿De qué fuente de “servicio conectado” proviene la mención?
Valores posibles: “twitter”, “facebook”, “facebook_ads”, “foursquare_venue”, “googleplus”, “instagram”, “instagram_hashtag”, “instagram_ads”, “linkedin_group”, “pinterest”, “rss”, “youtube”, “mixcloud”, “telegram_bot”, “tripadvisor”, “tumblr_blog”, “soundcloud”, “vimeo”, “linkedin_company”, “lithium”, “yelp_business”, “keywordsearch”, “mailservice”, “telligent_forum”, “instagram_business_profile”, “instagram_business_profile_hashtag”, “wechat”, “twilio”, “web”, “whatsapp”, “viber”, “linkedin_company_v2”, “apple_business_chat”, “gominga_locations”, “gominga_apps”, “gominga_products”, “gominga_shops”, “email_mailbox”, “ditto_brand”, “social_case”, “social_document”, “ios”, “android”, “personalizado”. |
tipo de fuente | ~{aed://fuente.tipo} | Conjunto de texto | ¿De qué fuente proviene la mención? (Nombre interno para filtrado.)
Valores posibles: “SearchProviderFacebook”, “SearchProviderFacebookAds”, “SearchProviderTwitter”, “SearchProviderGoogle”, “SearchProviderGooglePlus”, “SearchProviderFoursquare”, “SearchProviderInstagram”, “SearchProviderInstagramBusinessProfile”, “SearchProviderInstagramAds”, “SearchProviderInstagramHashtags”, “SearchProviderLinkedInGroups”, “SearchProviderLinkedInCompanies”, “SearchProviderLinkedInCompaniesV2”, “SearchProviderRss”, “SearchProviderOmgili”, “SearchProviderMoreOver”, “SearchProviderTrendiction”, “SearchProviderYahoo”, “SearchProviderWordpress”, “SearchProviderBing”, “SearchProviderYoutube”, “SearchProviderCustom”, “SearchProviderApi”, “SearchProviderPinterest”, “SearchProviderMixCloud”, “SearchProviderTripadvisor”, “SearchProviderTumblr”, “SearchProviderVimeo”, “SearchProviderSoundCloud”, “SearchProviderEmail”, “SearchProviderLithium”, “SearchProviderYelp”, “SearchProviderCase”, “SearchProviderDocument”, “SearchProviderTelegramBot”, “SearchProviderTelligent”, “SearchProviderWeChat”, “SearchProviderTwilio”, “SearchProviderWeb”, “SearchProviderWhatsApp”, “SearchProviderViber”, “SearchProviderAppleBusinessChat”, “SearchProviderGomingaLocations”, “SearchProviderGomingaApps”, “SearchProviderGomingaProducts”, “SearchProviderGomingaShops”, “Proveedor de búsquedaIos”, “Proveedor de búsquedaAndroid”. |
Identificación de origen | ~{aed://fuente.id} | Valor de texto | Identificación de este mensaje en el servicio del que proviene. (Por ejemplo, el ID del tweet de un mensaje de Twitter). |
URL de origen | ~{aed: url} | Valor de texto | La URL del mensaje en el servicio del que proviene. (Por ejemplo, el enlace al comentario en el propio Facebook). |
UbicaciónContinente | ~{aed://ubicación.continente} | Conjunto de texto | Código del continente. |
UbicaciónPaís | ~{aed://ubicación.país} | Conjunto de texto | ISO 3166-1 código del país. |
UbicaciónCiudad | ~{aed://ubicación.ciudad} | Valor de texto | Nombre completo de la ciudad. |
UbicaciónRegión | ~{aed://ubicación.región} | Valor de texto | |
etiquetas | ~{aed://etiquetas} | Conjunto de textos de respuesta múltiple | Matriz de cadenas; etiquetas (inteligentes) agregadas a esta mención. |
Id. del tema | ~{aed://tema.id} | Valor de texto | |
Nombre del tema | ~{aed://tema.nombre} | Valor de texto | |
estado | ~{aed://estado} | Conjunto de texto | El estado corresponde a la etapa del flujo de trabajo en la que se encuentra actualmente una mención/caso.
Valores posibles: “hecho”, “pendiente”, “nuevo”. |
enlace permanente | ~{aed://enlace permanente} | Valor de texto | URL específica de Qualtrics Social Connect exclusiva para esta mención. |
Fecha agregada | ~{aed://fecha.añadida} | Valor de texto | Marca de tiempo UNIX (en UTC) de cuándo la publicación fue indexada por Qualtrics Social Connect.
Si utiliza este campo, deberá 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 de registro predeterminada que se creará cuando se importe la publicación a Qualtrics, ya que la fecha y hora será aproximadamente la misma. |
Fecha de publicación | ~{aed://fecha.publicada} | Valor de texto | Marca de tiempo UNIX (en UTC) de cuando se publicó la publicación.
Probablemente desees utilizar el texto dinámico de la tarea de código con fecha formateada. |
prioridad | ~{aed://prioridad} | 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 la carga útil del objeto Mención. Sólo se pueden recuperar mediante una llamada API . |