Intégration à Qualtrics Social Connect

À propos de l’intégration à Qualtrics Social Connect

L’intégration à Qualtrics Social Connect vous permet de consolider et d’analyser l’ensemble des commentaires de vos clients numériques au même endroit. Vous pouvez ensuite analyser vos données à l’aide de n’importe quelle méthode d’analyse Qualtrics, y compris Text iQ dans un tableau de bord expérience client.

Étape 1 : création de l’en-tête d’autorisation

Cette section explique comment créer l’en-tête d’autorisation pour l’intégration. Vous en aurez besoin pour configurer l’intégration avec Qualtrics Social Connect.

1. Accédez à Paramètres du compte.
2. Accédez à la section ID Qualtrics de votre compte et copiez votre jeton API. Si vous disposez déjà d’un jeton API, n’en générez pas un nouveau.
3. Notez votre nom d’utilisateur Qualtrics. En règle générale, il s’agit de l’adresse e-mail que vous utilisez pour vous connecter à Qualtrics. Si vous ne connaissez pas votre nom d’utilisateur Qualtrics, contactez votre Administrateur d’entreprise.
4. À l’aide de votre nom d’utilisateur Qualtrics, créez une chaîne d’identifiants au format suivant :
   <Votre nom d’utilisateur Qualtrics> :<Votre jeton d’API Qualtrics>.
   Astuce Qualtrics : si vous utilisez l’authentification unique (SSO) pour vous connecter à Qualtrics, assurez-vous d’inclure le composant # de votre nom d’utilisateur.

   Exemple : Un exemple de chaîne de référence est :

   barnaby@qualtrics.com:63V9BuO9wMyvgo9HOf1OpeTOrhkvYGiRx1yMGrki

5. Encoder la chaîne d’identifiants avec l’encodage en base64. Pour ce faire, vous pouvez utiliser n’importe quel encodeur base64 en ligne.

   Exemple : Ma chaîne de référence encodée en base64 est :

   YmFybmFieUBxdWFsdHJpY3MuY29tOjYzVjhCdU85V015dmcwOUlPZjFPcDhUT3Joa3ZZR2lSeDF5TUdaa2k=

6. Créez l’en-tête d’autorisation au format suivant : Basic <identifiants encodés en base64>. Notez l’espace entre “Basic” et les identifiants.

   Exemple : Mon en-tête d’autorisation final est :

   Basic YmFybmFieUBxdWFsdHJpY3MuY29tOjYzVjhCdU85V015dmcwOUlPZjFPcDhUT3Joa3ZZR2lSeDF5TUdaa2k=

Vous aurez besoin de cet identifiant d’autorisation dans la section suivante. Copiez-le quelque part facilement accessible.

Étape 2 : Créer une automatisation dans Qualtrics Social Connect

Cette section couvre la configuration initiale que vous devrez effectuer dans Qualtrics Social Connect pour configurer l’intégration. Pour commencer la configuration, vous devez d’abord créer un flux d’opérations dans Qualtrics.

Astuce Qualtrics : pour obtenir de l’aide concernant Qualtrics Social Connect, contactez l’équipe en vous connectant à votre compte Qualtrics Social Connect, en cliquant sur l’icône de profil et en sélectionnant Contacter l’assistance.

1. Dans Qualtrics, accédez à Flux de travail.
2. Cliquez sur Créer un workflow, puis sur Lancé par un événement.
3. Sélectionnez l’onglet Évènement JSON.
4. Cliquez sur Copier URL pour copier le point de terminaison de l’événement. Vous aurez besoin de ce point final d’événement pour terminer la configuration dans Qualtrics Social Connect. Sauvegardez-le quelque part où vous pourrez y accéder ultérieurement.
5. Dans un nouvel onglet du navigateur, connectez-vous à Qualtrics Social Connect.
   Astuce Qualtrics Social Connect utilise des identifiants distincts de votre compte Qualtrics. Contactez l’équipe d’assistance Social Connect si vous avez des questions sur l’accès à Qualtrics Social Connect.
   
6. Accédez à Paramètres du compte.
7. Dans l’onglet Synthèse, sélectionnez Automatisation Recettes.
8. Dans la section Lors de la mise à jour de cas, cliquez sur Ajouter une recette d’automatisation.
9. Donnez un nom à votre procédure de fabrication d’automatisation.
10. Assurez-vous que Mention est sélectionné dans la section Déclencheur et sélectionnez A été créé(e) dans le menu déroulant.
11. Cliquez sur le signe plus (+ ) pour sélectionner une ou plusieurs rubriques à surveiller.
12. Dans la section Filtre, configurez les règles de filtrage pour les mentions que vous souhaitez surveiller.
13. Dans la section Action, sélectionnez Déclencher Webhook dans le menu déroulant.
14. Dans la zone URL, collez le point d’extrémité de l’événement que vous avez copié à l’étape 4.
15. Dans la zone En-tête d’autorisation, collez l‘en-tête d’autorisation que vous avez créé précédemment.
16. Si vous utilisez un appel d’API pour récupérer des balises, activez l’option Retarder. Il est recommandé de définir un délai minimum de 10 minutes pour s’assurer que les étiquettes ont eu le temps d’être attachées aux mentions.
17. Cliquez sur Ajouter pour terminer la configuration.

Pour tester la connexion, générez une nouvelle mention (la façon de générer la mention dépendra de votre source, comme la création d’un nouveau tweet ou la sortie d’un commentaire). Vous pouvez également attendre la publication suivante lorsque cela se produit naturellement. Une fois la nouvelle mention générée, ouvrez l’événement JSON dans votre flux d’opérations Qualtrics et consultez les propriétés JSON qui ont été capturées par l’événement :

Étape 3 : Création du jeu de données Qualtrics

Pour enregistrer les données dans Qualtrics, vous devez créer un jeu de données Qualtrics. Vous pouvez créer un jeu de données Qualtrics en appelant l’API de jeu de données directement à partir de la ligne de commande.

1. Ouvrez un éditeur de texte et créez la commande API. Le format général est le suivant :

   curl -X POST https://brandID.qualtrics.com/API/v3/datasets -H "Content-Type: application/json" -H "X-API-TOKEN: Your Qualtrics API Token" -d '{
   
   "nom": "Choisissez un nom pour votre jeu de données",
   
   "primaryKey": "Sélectionner nom de colonne d'ID",
   
   "createProject" : vrai,
   
   "champs" : [
   
   {
   
   "nom" : "Même nom de colonne d'ID que ci-dessus",
   
   "type" : "chaîne"
   
   }
   
   ]
   
   }'

2. Dans la commande API ci-dessus, vous devez remplacer les valeurs suivantes :
   • brandID : ID de votre organisation Qualtrics.
   • Votre jeton d’API Qualtrics : votre jeton API.
   • Choisissez un nom pour votre jeu de données : Saisissez un nom pour donner le jeu de données.
   • Sélectionnez ID column name : indiquez le nom de zone qui contiendra la clé d’identification de votre projet. Nous vous recommandons d’utiliser “uniqueId”.
3. Ouvrez le terminal sur votre ordinateur et collez la commande. Appuyez sur Entrée pour exécuter la commande.
4. Copiez l’ID du jeu de données à partir du résultat. Vous en aurez besoin ultérieurement. Le résultat de l’appel d’API sera au format suivant :

   {"result":{"name":"","primaryKey":"","datasetId":"ID du jeu de données, c'est ce que vous devez copier","fields":[]},"meta":{"requestId":"","httpStatus":"httpStatus":

5. Une fois que vous avez créé votre jeu de données, il sera disponible sur la page Projets Qualtrics en tant que projet de données importé. Cliquez sur votre projet pour l’ouvrir.
6. Après avoir ouvert votre projet de données importé, vous pouvez ensuite utiliser l’éditeur de champs dans l’onglet Données et analyse pour ajouter les zones que vous souhaitez importer depuis Social Connect. Pour plus d’informations sur les zones disponibles, voir Champs de SAP Common Social Connect. Lorsque vous ajoutez vos champs, nous vous recommandons de les enregistrer en tant que type de texte libre dans votre jeu de données.

Étape 4 : Terminer le workflow

Maintenant que vous avez établi une connexion avec Qualtrics Social Connect et créé votre jeu de données, il est temps de mapper les données de Qualtrics Social Connect à votre jeu de données.

1. Ouvrez le workflow que vous avez créé précédemment.
2. Cliquez sur le signe plus (+) et sélectionnez Tâche.
3. Sélectionnez l’onglet Service Web tâche.
   
4. Sélectionnez Service Web authentifié.
   
5. Cliquez sur Suivant.
6. Cliquez sur Ajouter un compte utilisateur.
7. Donnez un Nom à votre compte. Cela répond à vos besoins organisationnels.
8. Sélectionnez OAuth pour le type de connexion.
9. Sélectionnez Identifiants client pour le type d’attribution.
10. Saisissez votre ID client et votre clé secrète client. Voir API OAuth pour plus d’informations sur la manière de les créer.
11. Collez l’URL suivante dans le point de terminaison du jeton : https://BrandID.DatacenterID.qualtrics.com/oauth2/token
    • Remplacez le texte en gras ci-dessus par les ID correspondants :
    • BrandID : ID de votre organisation Qualtrics.
    • DatacenterID : votre ID de centre de données Qualtrics.
12. Cliquez sur Connecter un compte.
13. Sélectionnez le compte que vous venez d’ajouter.
14. Cliquez sur Suivant.
15. Sélectionnez POST pour le type de demande.
16. Saisissez l’URL au format suivant :

    https://brandID.qualtrics.com/API/v3/datasets/DatasetID/data

    où brandID est votre ID de marque Qualtrics et DatasetID est l’ID de jeu de données que vous avez copié précédemment.

17. Dans la section En-têtes, ajoutez Autorisation comme clé.
18. Pour la Valeur, saisissez Porteur et ajoutez un espace de fin.
19. Cliquez sur l’icône de texte inséré {a} et sélectionnez votre compte QSC.
20. Dans la section Corps, sélectionnez des paires clé-valeur JSON et commencez à mapper vos zones. Pour la clé, saisissez le nom de zone. Pour la valeur, utilisez du texte inséré pour sélectionner le champ provenant directement de l’événement JSON. La section Champs Common Social Connect contient le code de texte inséré pour les données non transformées de Social Connect.
21. Lorsque vous avez terminé, cliquez sur Enregistrer.

Étape 5 : analyse des données de connexion via les réseaux sociaux de Qualtrics

Cette section explique comment analyser vos données Qualtrics Social Connect dans les tableaux de bord CX et Text iQ.

Affichage des données SAP Social Connect dans les tableaux de bord expérience client

1. Créez un tableau de bord dans un projet de tableau de bord CX.
2. Cliquez sur Ajouter une source, placez le curseur sur Sources de données externes, puis sélectionnez le projet contenant vos données de connexion via les réseaux sociaux.
3. Ajustez les types de zones pour vos zones importées. Pour plus d’informations sur le type de champ suggéré pour chaque champ de jeu de données, voir Champs Common Social Connect.
4. Sauvegardez vos modifications lorsque vous avez terminé.

La modification de votre tableau de bord est identique à la modification d’un tableau de bord expérience client. Consultez les pages d’assistance suivantes pour en savoir plus :

• Démarrer avec les tableaux de bord CX
• Étape 1 : Création de votre projet et ajout d’un tableau de bord
• Étape 2 : Mappage d’une source de données de tableau de bord
• Étape 3 : Planification de Dashboard Design
• Étape 4 : Création de votre tableau de bord
• Étape 5 : personnalisation du tableau de bord supplémentaire
• Étape 6 : Partage et administration de l’utilisateur

Utilisation de Text iQ

Nous vous recommandons d’utiliser Text iQ dans votre tableau de bord CX. Cela garantira que toutes vos données se trouvent au même endroit et que vos champs Text iQ seront automatiquement mappés à votre tableau de bord si vous les analysez via le tableau de bord. Lorsque vous êtes prêt à commencer, cliquez sur le bouton Analyser dans Text iQ de votre tableau de bord.

La plupart des champs de mention ne seront pas utiles pour l’analyse de texte (par exemple, auteur, source, ID, etc.). Lorsque vous choisissez les données à importer dans Text iQ, assurez-vous de sélectionner le champ de contenu du message.

L’utilisation de Text iQ pour les données de connexion sociale fonctionne de la même manière que l’analyse du texte des réponses à l’enquête dans Qualtrics. Consultez les pages d’assistance suivantes pour en savoir plus :

• Fonctionnalité Text iQ
• Rubriques dans Text iQ
• Analyse des sentiments
• Text iQ dans les tableaux de bord CX

Importation d’enrichissements XM Discover

Cette section explique comment importer des enrichissements XM Discover dans votre jeu de données. Bien qu’il ne soit pas obligatoire de s’intégrer à Qualtrics Social Connect, XM Discover enrichments vous aide à analyser vos mentions en temps réel en les marquant en fonction du contenu de la mention.

1. Dans SAP Social Connect, accédez à Mots-clés.
2. Cliquez sur Ajouter un enrichissement XM Discover.
3. Sélectionnez la ou les rubriques pour lesquelles vous souhaitez ajouter des enrichissements.
4. Cliquez sur Suivant.
5. Sélectionnez les modèles de catégorie que vous souhaitez utiliser.
   Astuce Qualtrics : il existe une limite de 2 catégories par sujet. Si vous avez besoin de plus, contactez l’équipe Social Connect en vous connectant à votre compte Qualtrics Social Connect, en cliquant sur l’icône de profil et en sélectionnant Contacter l’assistance.
   .
6. Pour Enrichissement en temps réel, sélectionnez Oui.
   Attention : si vous n’activez pas l’enrichissement en temps réel, les enrichissements XM Discover seront traités dans un délai de 7 minutes ou plus après la création de la mention dans Social Connect et les balises correspondantes ne seront donc pas disponibles dans votre flux d’opérations Qualtrics.
7. Cliquez sur Enregistrer.

Revenez à votre flux d’opérations dans Qualtrics. Assurez-vous de mapper vos champs dans votre flux d’opérations Qualtrics pour enregistrer les enrichissements XM Discover dans votre jeu de données Qualtrics. Elles sont sauvegardées comme zone de balises.

Dans la mesure où XM Discover Enrichments est exporté sous forme de liste séparée par des virgules, vous devrez spécifier le séparateur de champs dans votre tableau de bord à l’aide de l’éditeur de recodage. Assurez-vous de sélectionner Virgule comme séparateur. Vous pouvez également renommer vos champs à l’aide de l’éditeur de recodage pour les rendre plus faciles à afficher dans le tableau de bord.

Zones communes de SAP Social Connect

Cette section contient un tableau des champs couramment utilisés de Social Connect, leur code de texte inséré pour créer votre mappage, le type de champ que vous devez enregistrer sous Qualtrics et toute remarque spéciale sur le champ.