Connecteur sortant Qualtrics

À propos du connecteur de sortie Qualtrics

Vous pouvez utiliser le connecteur de sortie Qualtrics pour effectuer les tâches répertoriées ci-dessous.

• Mettre à jour les enquêtes Qualtrics existantes avec les enrichissements XM Discover.
• Envoyer des données d’exportation XM Discover à Qualtrics via un événement JSON pour déclencher un flux de travail Qualtrics.

Contactez l’équipe de votre compte Qualtrics si vous avez besoin de conseils supplémentaires.

AVANT DE COMMENCER

Conditions préalables :

Avant de configurer un job à l’aide du connecteur de sortie Qualtrics, assurez-vous que les conditions répertoriées ci-dessous sont remplies.

• Les champs de données pour les enrichissements XM Discover doivent faire partie de l’enregistrement de l’enquête Qualtrics.
  Astuce Qualtrics : pour plus d’informations sur l’ajout de champs de données pour XM Découvrir les enrichissements de vos enquêtes, veuillez consulter Données intégrées.
• Les documents dans XM Discover doivent contenir un champ de données avec des ID d’enquête lorsque vous utilisez le type de connecteur de sortie d’enquête.

Identifiants requis :

Vous aurez besoin des informations suivantes relatives à vos comptes Qualtrics et XM Discover :

• Adresse de votre instance Qualtrics.
• Votre jeton API Qualtrics.
• Votre point de terminaison de l’API XM Discover Export.

CONFIGURATION DE LA CONNEXION

1. Connectez-vous aux connecteurs.
2. Cliquez sur le bouton Nouvelle tâche dans le coin supérieur droit de la page Tâches.
3. Sur la page Connecteurs, accédez à la section SÉLECTIONNER UNE SOURCE.
4. Cliquez sur le bouton Sortie Qualtrics.

Configuration d’une tâche de connecteur de sortie Qualtrics

Après avoir configuré la connexion, suivez les étapes ci-dessous pour configurer un job.

• Étape 1 : indiquez le nom du job
• Étape 2 : Spécifier le projet et la description
• Étape 3 : sélectionnez le type de données Qualtrics
• Étape 4 : Fournissez les identifiants Qualtrics
• Étape 5 : configurer les identifiants d’exportation XM Discover
• Étape 6 : configuration de requête
• Étape 7 : sélectionnez l’enquête pour la configuration (uniquement pour le type de données ENQUÊTE) -OU – Spécifiez le point de terminaison de l’événement JSON (uniquement pour le type de données JSON EVENTdata)
• Étape 8 : configuration de requête sortante
• Étape 9 : mappez les champs souhaités à Qualtrics
• Étape 10 : Spécifier le filtre (facultatif) et la limite d’enregistrements
• Étape 11 : configuration des notifications (facultatif)
• Étape 12 : Configurer des options supplémentaires pour le poste
• Étape 13 : Confirmer tous les paramètres de la tâche

Étape 1 : indiquez le nom du job

1. Saisissez un nom de tâche reconnaissable dans la zone Nom du job en haut à gauche de la page.
   Attention : le nom que vous saisissez dans la zone Nom de la tâche sera ajouté à tous les documents chargés via ce job en tant que valeur codée en dur pour l’attribut job_name.
   Astuce Qualtrics : vous pouvez modifier le nom de la tâche lors de la configuration via le champ Nom de la tâche qui est affiché en haut de chaque page lors de la configuration.
2. Cliquez sur Suivant.

Étape 2 : Spécifier le projet et la description

1. Sur la page Spécifier un projet et une description, sélectionnez un projet à partir duquel télécharger des données à partir du menu déroulant des projets.
   Astuce Qualtrics : vous avez la possibilité de saisir une note sur le poste dans la zone Description du poste. La description du job que vous saisissez dans la zone Description du job est accessible uniquement dans la liste Connecteurs et n’est pas chargée dans le cadre des données d’un job.
2. Cliquez sur Suivant.

Étape 3 : sélectionnez le type de données Qualtrics

1. Sur la page Sélectionner un type de données Qualtrics, sélectionnez l’un des types de données suivants à télécharger.
   • Enquête : sélectionnez ce type de données pour mettre à jour les enquêtes Qualtrics existantes avec les enrichissements XM Discover.
   • Événement JSON : sélectionnez ce type de données pour envoyer des données d’exportation XM Discover vers Qualtrics via un événement JSON afin de déclencher une tâche d’automatisation xFlow à l’aide d’enrichissements XM Discover à partir de n’importe quelle source de données.
     Astuce Qualtrics : pour en savoir plus, voir Événement JSON.
2. Cliquez sur Suivant.

Étape 4 : Fournissez les identifiants Qualtrics

Sur la page Fournir les identifiants Qualtrics, vous pouvez sélectionner un ensemble d’identifiants existant dans le menu déroulant ou ajouter un nouvel ensemble d’identifiants.

1. Pour ajouter un nouvel ensemble d’identifiants, sélectionnez Ajouter nouveau dans le menu déroulant des identifiants et saisissez les paramètres de connexion répertoriés dans le tableau suivant dans les zones correspondantes.
2. Saisissez le nom du nouvel ensemble d’identifiants dans la zone NOM DE LA CONNEXION.
3. Fournissez le jeton API connecté à votre compte Qualtrics dans la case THÈME DE L’API SORTIE QUALTRICS.
4. Saisissez l’adresse de l’instance Qualtrics dans la zone QUALTRICS OUTBOUND DATACENTER ID.
5. Vous pouvez définir l’expiration de vos identifiants après une certaine période (facultatif).
6. Pour définir une date d’expiration pour cet ensemble d’identifiants et définir un rappel pour tous les observateurs de tâches, cochez la case Envoyer des notifications d’expiration. Cela active la zone Jours avant expiration.
7. Saisissez une valeur dans la zone Jours avant l’expiration pour définir combien de jours avant l’expiration les notifications doivent commencer. Les valeurs possibles vont de 1 à 100 jours.
   Astuce Qualtrics : ce rappel se déclenche chaque fois que la tâche s’exécute une fois que la date d’expiration est inférieure au nombre de jours défini dans la zone Jours avant l’expiration.
8. Sélectionnez la date d’expiration dans le sélecteur de date du calendrier. La date d’expiration sera alors ajoutée à la zone Date d’expiration.
9. Cliquez sur Suivant.

Étape 5 : configurer les identifiants d’exportation XM Discover

1. Sur la page Configurer les identifiants d’exportation Discover XM, indiquez votre point de terminaison XM Discover Export API dans la zone HOST.
2. Cliquez sur Suivant.

Étape 6 : configuration de requête

Sur la page Configuration de la requête, vous pouvez spécifier les données à utiliser pour mettre à jour les enquêtes Qualtrics (si vous avez sélectionné ENQUÊTE comme type de données) ou les envoyer à Qualtrics via un événement JSON (si vous avez sélectionné ÉVÉNEMENT JSON comme type de données).

1. Sélectionnez l’une des options suivantes dans le menu déroulant Sélectionner le niveau de données pour sélectionner le niveau de granularité des données associé aux données sortantes :
   • Phrases : utilisez des données au niveau de la phrase.
   • Documents : utilisez les données au niveau du document.
2. Indiquez une requête pour filtrer les données sortantes dans la zone Saisir la requête(facultatif). Utilisez la même syntaxe que celle utilisée pour rechercher des données dans Designer.
   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
3. Indiquez le nom du filtre de votre projet à appliquer aux données sortantes dans la zone Saisir le nom du filtre(facultatif).
4. Pour mettre à jour les enregistrements créés depuis la dernière exécution du job sortant, sélectionnez Par défaut : Charger de nouveaux enregistrements sous Sélectionner les enregistrements que vous voulez récupérer. Pour mettre à jour les enregistrements créés ou mis à jour depuis la dernière exécution du job sortant, sélectionnez Charger les enregistrements nouveaux et mis à jour. Pour mettre à jour uniquement les enregistrements qui ont été mis à jour depuis la dernière exécution du job sortant, sélectionnez Charger les enregistrements mis à jour.
   Astuce Qualtrics : l’exécution ou la réexécution de la catégorisation met à jour un enregistrement dans le système XM Discover.
5. Vous pouvez définir les données de classification à inclure dans les données sortantes (facultatif). Cochez la case Tous les modèles pour inclure les données de classification pour tous les modèles disponibles dans le projet. Ne cochez pas la case Tous les modèles si vous souhaitez uniquement inclure les modèles sélectionnés. Si l’option Tous les modèles n’est pas sélectionnée, vous pouvez sélectionner des modèles spécifiques à inclure dans les données sortantes dans le menu déroulant.
6. Sélectionnez l’une des options suivantes dans le menu déroulant Filtres résultats en appliquant des règles de modèle :
   • Ignorer : aucun filtrage n’est appliqué en fonction du ou des modèles sélectionnés.
   • Actuellement classifié : retourne les phrases/documents qui ont été classifiés par le(s) modèle(s) sélectionné(s) lors de l’exécution de classification la plus récente.
   • Ever Classified: Retourne les phrases/documents qui ont été classifiés par le(s) modèle(s) sélectionné(s) à tout moment.
7. Cochez la case Retourner les ID de catégorie (vrai) au lieu des noms de catégories (faux) pour utiliser les ID de catégorie au lieu des noms de catégories (facultatif).
8. Sélectionnez les résultats Filtres en appliquant une requête de filtre avec tous les chemins des nœuds feuille pour ajouter plusieurs modèles avec le paramètre “Indicateur de feuille uniquement” à l’appel de l’API d’exportation (facultatif).
9. Sélectionnez Ignorer les valeurs vides si vous souhaitez que le connecteur ignore la mise à jour d’un document d’enquête si toutes ses valeurs sortantes sont vides (facultatif).
10. Cliquez sur Suivant.

Étape 7 : sélectionner l’enquête pour la configuration -OR- Spécifier le point de terminaison de l’événement JSON

SÉLECTIONNER UNE ENQUÊTE POUR LA CONFIGURATION

1. Sélectionnez l’une des enquêtes Qualtrics disponibles à mettre à jour.
   Astuce Qualtrics : si vous ne voyez pas l’enquête que vous recherchez, assurez-vous qu’elle est partagée avec le compte qui a généré la clé API à partir de l’environnement Qualtrics.
2. Cliquez sur Suivant.

SPÉCIFIER L’ENDPOINT DE L’ÉVÉNEMENT JSON

1. Spécifiez l’URL du point de terminaison de l’événement JSON pour envoyer les données d’exportation XM Discover vers Qualtrics via un événement JSON.
2. Astuce Qualtrics : pour en savoir plus sur la configuration d’un événement JSON, voir Événement JSON.
3. Cliquez sur Suivant.

Étape 8 : configuration de requête sortante

1. Sélectionnez l’attribut dans le projet XM Discover qui stocke l’identifiant 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.
2. Cliquez sur Suivant.

Étape 9 : Mapper les champs souhaités dans XM Discover

Sur la page Mapper les champs souhaités dans XM Discover, vous pouvez mapper les attributs XM Discover et les résultats de classification aux champs de données intégrées définis dans Qualtrics.

1. Cliquez dans la zone de champ personnalisé vide et sélectionnez le champ XM Discover que vous souhaitez ajouter à une enquête dans Qualtrics.
2. Sélectionnez le type de données d’un champ intégré correspondant créé dans XM Engage dans le menu déroulant Type de données.
3. Saisissez le nom du champ intégré dans XM Engage qui doit être renseigné avec les valeurs du champ XM Discover sélectionné dans la zone Nom d’attribut.
4. Cliquez sur l’icône plus (+) pour ajouter d’autres champs personnalisés et les mapper aux champs Qualtrics intégrés, si nécessaire.
5. Cliquez sur Suivant.

Étape 10 : Spécifier le filtre (facultatif) et la limite d’enregistrements

1. Sur la page Spécifier un filtre, vous pouvez définir une condition de filtre pour qu’un job charge uniquement les enregistrements qui la satisfont (facultatif).
   Astuce Qualtrics : pour plus d’informations sur l’application d’un filtre, voir Filtre de connecteur.
2. Vous pouvez spécifier une limite d’enregistrements dans la zone Spécifier une limite d’enregistrements. Vous pouvez également laisser la limite d’enregistrements par défaut Tout si vous voulez que tous les enregistrements soient renvoyés en un seul push.
   Astuce Qualtrics : la limite d’enregistrements est une limite par exécution de la tâche. Si vous la définissez sur 1 000, le job s’exécutera selon la planification que vous avez définie et s’arrêtera après avoir extrait 1 000 enregistrements. Si vous la définissez sur quotidienne, cela signifie qu’elle s’exécutera une fois par jour et que vous obtiendrez jusqu’à 1 000 enregistrements par jour.
   Astuce Qualtrics : pour les données conversationnelles, la limite est appliquée en fonction des conversations plutôt que des lignes.
3. Cliquez sur Suivant.

Étape 11 : configuration des notifications (facultatif)

1. Sur la page Configuration des notifications, vous pouvez sélectionner les notifications que les observateurs d’une tâche doivent recevoir si l’un des événements répertoriés ci-dessous se produit.
   • Aucun enregistrement n’est chargé dans le projet.
   • Des valeurs manquantes consécutives ont été trouvées.
   • L’exécution d’un job échoue.
   • L’exécution d’un job est partiellement réussie.
   • Un job se termine par un délai d’expiration.
   • Un job échoue.
     Astuce Qualtrics : vous pouvez sélectionner n’importe quelle combinaison de notifications ou décider de ne pas sélectionner de notifications. Dans ce cas, les veilles d’un job ne reçoivent aucune notification.
     Astuce Qualtrics : pour plus d’informations sur les paramètres de configuration des notifications, voir Notifications de poste.
2. Cliquez sur Suivant.

Étape 12 : Configurer des options supplémentaires pour le poste

1. Sur la page Configurer des options supplémentaires pour la tâche, dans la section Planifier un travail historique/incrémentiel, sélectionnez l’une des options suivantes :
   • Planifier des exécutions incrémentielles pour configurer une planification pour les extractions de données incrémentielles.
     Astuce Qualtrics : utilisez l’option Créer une tâche mais ne pas extraire de données si vous souhaitez valider la tâche et ses paramètres avant la mise à jour des données. Pour plus d’informations sur la planification d’exécutions incrémentielles, voir Planification de jobs.
   • Configurez Extraction unique pour effectuer une extraction de données unique.
     Astuce Qualtrics : vous pouvez modifier les paramètres de planification ultérieurement. Pour plus d’informations sur les exécutions ponctuelles, voir Récupération de données et Planification de tâches pour plus d’informations sur les exécutions régulières.
2. Dans la section Données incrémentielles supplémentaires, vous pouvez indiquer la quantité de données supplémentaires (en jours ou en heures) à extraire lors d’une exécution incrémentielle afin de garantir que toutes les données historiques pertinentes sont disponibles pour le transfert sortant (facultatif).
   Astuce Qualtrics : la valeur maximale de ce champ est de 30 jours.
3. Cliquez sur Suivant.

Étape 13 : Confirmer tous les paramètres de la tâche

1. Sur la page Confirmer tous les paramètres de la tâche, vous pouvez afficher un récapitulatif de tous les paramètres d’une tâche et modifier les paramètres, si nécessaire, avant d’exécuter le chargement des données. Pour exécuter le chargement des données, cliquez sur le bouton Terminer lorsque vous êtes prêt à exécuter le chargement des données. Un message de confirmation s’affiche pour confirmer que la tâche a été correctement envoyée.
2. Lorsque vous cliquez sur Terminer, les opérations suivantes se produisent : les tirages uniques sont exécutés immédiatement. À moins que vous n’ayez activé l’option “Créer un job mais ne pas extraire de données”, les extractions planifiées sont exécutées immédiatement, puis définies pour s’exécuter en fonction de la planification.

Pour plus d’informations sur le suivi des jobs, voir Synthèse des pages de jobs.