Connecteur sortant Qualtrics

À propos du connecteur de sortie Qualtrics

Le connecteur sortant Qualtrics vous permet d’effectuer les actions suivantes dans votre compte Qualtrics :

• Déclenchez un événement de flux de travail JSON et utilisez les données XM Discover dans les flux de travail Qualtrics.
• Exporter les réponses avec XM Découvrez les enrichissements de XM Discover et importez-les dans un ensemble de données d’enquête Qualtrics.

Conditions

Avant de configurer la connexion, vous aurez besoin des informations suivantes de votre compte Qualtrics :

• Votre identifiant de centre de données Qualtrics.
• Votre jeton API Qualtrics.
• Votre point de terminaison de l’API XM Discover Export.

Tâches d’événement JSON

Pour déclencher un événement JSON avec le connecteur sortant Qualtrics, vous aurez besoin du point de terminaison de l’événement JSON. Vous pouvez copier le point de terminaison en cliquant sur Copier l’URL lors de la modification de l’événement JSON dans votre flux de travail Qualtrics.

Tâche d’exportation des réponses

Si vous exportez des réponses vers un ensemble de données d’enquête Qualtrics, vous devez vous assurer que vos données remplissent les conditions suivantes :

• Votre ensemble de données d’enquête doit contenir des champs qui correspondent aux enrichissements XM Discover que vous souhaitez exporter. Si ces champs n’existent pas, vous pouvez les ajouter en tant que données intégrées ou les créer à l’aide de champs personnalisés.
• Les documents que vous exportez depuis XM Discover doivent comporter un champ qui correspond à l’ID d’enquête de l’enquête dans laquelle vous souhaitez importer les réponses.

Création d’une tâche de connecteur sortant Qualtrics

1. Sur la page Tâches, cliquez sur Nouvelle tâche.
   
2. Sélectionnez le connecteur sortant Qualtrics.
   
3. Donnez un nom à votre job pour pouvoir l’identifier.
   
4. Sélectionnez le projet dans lequel charger les données.
5. Donnez une description de votre travail pour connaître son objectif.
6. Cliquez sur Suivant.
7. Choisissez le type de données Qualtrics que vous souhaitez exporter :
   
   • Enquête : exportez les données de réponse à importer dans un ensemble de données d’enquête.
   • Événement JSON : exporter les données pour déclencher un événement de workflow JSON.
8. Cliquez sur Suivant.
9. Utilisez la liste déroulante pour sélectionner une connexion Qualtrics existante ou sélectionnez Ajouter pour en créer une nouvelle.
   
   Astuce Qualtrics : pour modifier ou supprimer une connexion existante, accédez aux paramètres de votre compte.
10. Lors de l’ajout d’une nouvelle connexion, indiquez les éléments suivants :
    • Nom de la connexion : Donnez un nom à la connexion pour pouvoir l’identifier ultérieurement.
    • Identifiant du centre de données Qualtrics : saisissez votre identifiant de centre de données Qualtrics.
    • Jeton API Qualtrics : saisissez le jeton API de votre compte Qualtrics.
11. Si vous souhaitez que la connexion expire au bout d’un certain temps, activez l’option Envoyer des notifications d’expiration. Utilisez le champ Date d’expiration pour choisir la date d’expiration des identifiants. Dans la zone Jours avant l’expiration, saisissez jusqu’à 100 jours si vous souhaitez être informé de l’expiration de la connexion.
12. Cliquez sur Suivant.
13. Indiquez votre point de terminaison de l’API d’exportation XM Discover.
    
14. Cliquez sur Suivant.
15. Sélectionnez le niveau de données que vous souhaitez exporter :
    
    • Phrases : utilisez des données au niveau de la phrase.
    • Documents : utilisez les données au niveau du document.
      Astuce Qualtrics : les étapes restantes sur la page Configuration de la requête sont facultatives et vous aideront à affiner les données exportées.
16. Fournissez une requêtede recherche pour filtrer les données sortantes. Utilisez la même syntaxe que celle utilisée pour rechercher des données dans Designer. Laissez cette zone vide pour inclure toutes les données.
    Exemple : vous pouvez indiquer un ou plusieurs ID d’enquête pour mettre à jour uniquement les enregistrements d’enquête sélectionnés à l’aide de la syntaxe suivante:surveyid:sv_01
17. Saisissez le nom du filtre de votre projet que vous souhaitez appliquer aux données sortantes. Ne renseignez pas cette zone si vous ne voulez pas filtrer vos données.
18. Sélectionnez les enregistrements que vous souhaitez importer :
    • Charger de nouveaux enregistrements : enregistrements créés depuis la dernière exécution du job de sortie.
    • Charger les enregistrements nouveaux et mis à jour : enregistrements créés ou mis à jour depuis la dernière exécution du job de sortie.
    • Charger les enregistrements mis à jour : enregistrements mis à jour depuis la dernière exécution du job de sortie.
19. Utilisez le menu déroulant pour sélectionner les modèles de classification que vous souhaitez inclure dans vos données. Cochez la case Tous les modèles pour inclure les données de classification pour tous les modèles disponibles dans le projet.
20. Sélectionnez la manière dont vous souhaitez que les classifications aient un impact sur le filtrage des données :
    • Ignorer : aucun filtrage n’est appliqué en fonction du ou des modèles sélectionnés.
    • Actuellement classifié : renvoie les enregistrements qui ont été classés par le(s) modèle(s) sélectionné(s) lors de l’exécution de classification la plus récente.
    • Toujours classifié : renvoie les enregistrements qui ont été classés par le(s) modèle(s) sélectionné(s) à tout moment.
21. Sélectionnez les options d’exportation supplémentaires que vous souhaitez utiliser :
    • Indique si les ID de catégorie (vrai) doivent être renvoyés au lieu des noms de catégorie (faux) : exporter les ID de catégories au lieu des noms de catégories
    • Filtre les résultats en appliquant une requête de filtre avec tous les chemins de nœuds feuille : ajoute plusieurs modèles avec le paramètre “leaf _only flag” à l’appel d’API d’exportation.
    • Ignorer les valeurs vides : ignorez la mise à jour d’un document d’enquête si toutes ses valeurs sortantes sont vides.
22. Cliquez sur Suivant.
23. L’étape suivante dépend de si vous exportez des données d’enquête ou si vous envoyez des données vers un point de terminaison JSON pour déclencher un workflow :
    • Enquête : sélectionnez l’enquête vers laquelle vous souhaitez exporter les données et cliquez sur Suivant.
      
      Ensuite, sélectionnez l’attribut XM Discover qui contient votre ID d’enquête Qualtrics.
      
      Astuce Qualtrics : seuls les documents dont l’ID d’enquête correspond à l’enquête sélectionnée à l’étape précédente seront mis à jour.
    • Événement JSON : saisissez le point de terminaison JSON de l’événement JSON.
      
24. Mappez les champs de XM Discover à Qualtrics. Cliquez sur la case vide et choisissez l’attribut XM Discover que vous souhaitez envoyer à Qualtrics.
    
25. Sélectionnez le type de données sous lequel le champ doit être exporté, qui correspond au type de variable de données intégrées du champ dans Qualtrics :
    
    • Ne pas mapper : aucun type de variable spécifié.
    • Attribut numérique : type de variable Nombre.
    • Attribut de texte : type de variable de set de texte.
    • Attribut de date : type de variable de date.
    • Verbatim : type de variable de texte.
26. Saisissez le nom du champ intégré de Qualtrics qui doit être renseigné avec les valeurs de l’attribut XM Discover sélectionné.
27. Utilisez les signes plus (+ ) et moins ( – ) pour ajouter et supprimer des zones si nécessaire.
28. Cliquez sur Suivant.
29. Si vous le souhaitez, vous pouvez ajouter un filtre de connecteur pour filtrer les données entrantes afin de limiter les données importées.
    
30. Vous pouvez également limiter le nombre d’enregistrements importés dans un seul job en saisissant un nombre dans la zone Spécifier la limite d’enregistrement. Saisissez « Tout » si vous souhaitez importer tous les enregistrements.
    Astuce Qualtrics : pour les données conversationnelles, la limite est appliquée en fonction des conversations plutôt que des lignes.
31. Cliquez sur Suivant.
32. Choisissez quand vous souhaitez recevoir une notification. Pour plus d’informations, voir Notifications de jobs.
    
33. Cliquez sur Suivant.
34. Sélectionnez le moment d’exécution de votre job. Vous pouvez effectuer une extraction unique ou configurer une extraction de données récurrente. Pour plus d’informations, voir Planification des jobs.
    
35. Cliquez sur Suivant.
36. Vérifiez votre configuration. Si vous devez modifier un paramètre spécifique, cliquez sur le bouton Modifier pour accéder à cette étape dans la configuration du connecteur.
    
37. Cliquez sur Terminer pour sauvegarder le job.

Une fois votre tâche enregistrée, les données que vous avez spécifiées seront exportées vers Qualtrics en fonction de la planification que vous avez définie. Si vous déclenchez un événement JSON, assurez-vous de compiler le reste de votre flux d’opérations, ce qui inclut l’ajout de conditions pour limiter la date d’exécution du flux d’opérations et les tâches pour déterminer la sortie du flux d’opérations.