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 tous vos avis de 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 à l’aide du format suivant :
   <Votre nom d’utilisateur Qualtrics> :<Votre jeton 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 d’identifiants est :

   barnaby@qualtrics.com:63V9BuO9wMyvgo9HOf1OpeTOrhkvYGiRx1yMGrki

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

   Exemple : ma chaîne d’identifiants codée en base64 est :

   YmFybmFieUBxdWFsdHJpY3MuY29tOjYzVjhCdU85V015dmcwOUlPZjFPcDhUT3Joa3ZZR2lSeDF5TUdaa2k=

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

   Exemple : mon en-tête d’autorisation finale est :

   YmFybmFieUBxdWFsdHJpY3MuY29tOjYzVjhCdU85V015dmcwOUlPZjFPcDhUT3Joa3ZZR2lSeDF5TUdaa2k=

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

Étape 2 : Création d’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 devrez d’abord créer un flux de travail dans Qualtrics.

1. Dans Qualtrics, accédez à Workflows.
2. Cliquez sur Créer un workflow, puis sur Lancé par un événement.
3. Sélectionnez l’ événement JSON.
4. Cliquez sur Copier URL pour copier le point de terminaison de l’événement. Vous aurez besoin de ce point d’extrémité de l’é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 ceux de votre compte Qualtrics. Contactez l’assistance à l’adresse support@engagor.com 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 Sur une nouvelle mention/un nouveau cas, cliquez sur Ajouter une recette d’automatisation.
9. Donnez un nom à votre recette d’automatisation.
10. Sélectionnez une ou plusieurs rubriques à surveiller.
11. Configurez les règles de filtrage pour les mentions que vous souhaitez surveiller.
12. Pour l’action d’automatisation, sélectionnez Déclencher un Webhook.
13. Donnez un nom et une description à votre webhook. Il ne s’agit que d’étiquettes internes pour votre propre organisation.
14. Assurez-vous que le verbe HTTP est défini sur POST.
15. Dans le champ URL, collez le point de terminaison de l’événement que vous avez copié à l’étape 4.
16. Dans la section Corps de la demande, choisissez les variables de vos mentions que vous souhaitez importer dans Qualtrics. Vous trouverez des détails sur chaque variable sur cette page d’assistance Qualtrics Connect.
17. Assurez-vous que l’en-tête Content-Type est application/json.
18. Dans la zone En-tête d’autorisation, collez l’en-tête d’autorisation que vous avez créé précédemment.
19. 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 le fait de laisser 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 '{
   
    "name": "Choose a name for your set",
   
    "primaryKey": "Choose ID column name",
   
    "createProject": true,
   
    "fields": [
   
    {
   
   "name":
   
    "Same ID column name as Above", "}
   
   "
   
   ,
   
    "type":

2. Dans la commande API ci-dessus, vous devez remplacer les valeurs suivantes :
   • brandID : Votre ID d’organisation Qualtrics.
   • Votre jeton d’API Qualtrics : votre jeton d’API.
   • Sélectionnez un nom pour votre jeu de données : saisissez un nom pour donner le jeu de données.
   • Sélectionnez le nom de la colonne ID : indiquez le nom de zone qui contiendra la clé d’identification de votre projet. SAP vous recommande d’utiliser « ID ».
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 plus tard. 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":"","OK pStatus":"httpStatus" :

5. Une fois que vous avez créé votre ensemble de données, il sera disponible sur la page Projets Qualtrics en tant que projet de données importées. Cliquez sur votre projet pour l’ouvrir.
6. Après avoir ouvert votre projet de données importé, vous pouvez utiliser l’éditeur de champ dans l’onglet Données et analyse pour ajouter les champs que vous souhaitez importer depuis Social Connect. Pour plus d’informations sur les zones disponibles, voir Champs communs Social Connect. Lorsque vous ajoutez vos zones, nous vous recommandons de les sauvegarder comme 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 ensemble de données.

1. Ouvrez le workflow que vous avez créé précédemment.
2. Click the plus sign (+) and select Task.
3. Sélectionnez la tâche Service Web.
   
4. Sélectionnez Service Web non authentifié.
   
5. Click Next.
6. Sélectionnez POST pour le type de demande.
7. 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.

8. Dans la section En-têtes, ajoutez X-API-TOKEN comme clé et saisissez votre jeton API comme valeur.
9. Dans la section Corps, sélectionnez 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 communs Social Connect contient le code de texte inséré pour les données non transformées issues de Social Connect.
   Attention : si vous avez ajouté une tâche de code pour nettoyer vos données, vous devrez utiliser le menu de texte inséré, {a}, pour sélectionner la sortie dans la tâche de code à la place.
10. Lorsque vous avez terminé, cliquez sur Sauvegarder.

Étape 5 : Analyse des données de Qualtrics Social Connect

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

Affichage des données Social Connect dans les tableaux de bord CX

1. Créer 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 aux 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 d’ensemble de données, voir Champs communs 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. Pour en savoir plus, consultez les pages d’assistance suivantes :

• 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 expérience client. Cela garantira que toutes vos données se trouvent au même endroit et que vos champs Text iQ seront automatiquement mis en correspondance avec 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 sur 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 aux réseaux sociaux fonctionne de la même manière que l’analyse du texte des réponses à l’enquête dans Qualtrics. Pour en savoir plus, consultez les pages d’assistance suivantes :

• 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 que l’intégration à Qualtrics Social Connect ne soit pas obligatoire, les enrichissements XM Discover vous aident à analyser vos mentions en temps réel en les balisant en fonction du contenu de la mention.

1. Dans Social Connect, accédez à Mots-clés.
2. Cliquez sur Ajouter un enrichissement de découverte XM.
3. Sélectionnez la ou les rubriques pour lesquelles vous souhaitez ajouter des enrichissements.
4. Click Next.
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 à l’adresse support@engagor.com.
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 avec un délai de 7 minutes ou plus après la création de la mention dans Social Connect et, par conséquent, les balises correspondantes ne seront pas disponibles dans votre flux de travail Qualtrics.
7. Cliquez sur Enregistrer.

Retournez à votre flux de travail dans Qualtrics. Vous devrez ajouter une tâche de code à votre workflow pour nettoyer vos champs de mots-clés. Ces champs sont entre parenthèses lors de l’exportation depuis Social Connect. Vous devrez donc supprimer le premier et le dernier caractère de la chaîne exportée. Vous trouverez un exemple de la manière de procéder sur cette page externe.

Assurez-vous de mapper vos champs dans votre flux de travail Qualtrics pour enregistrer les enrichissements XM Discover dans votre ensemble de données Qualtrics. Celles-ci sont sauvegardées comme zone de mots-clés.

Étant donné que les enrichissements Découverte XM sont exportés 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. Veillez à sélectionner Virgule comme séparateur. Vous pouvez également renommer vos champs à l’aide de l’éditeur de recodage pour les rendre plus conviviaux pour l’affichage dans le tableau de bord.

Champs Social Connect communs

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