Connecteur entrant Qualtrics
À propos du connecteur entrant Qualtrics
Vous pouvez utiliser le connecteur entrant Qualtrics pour charger des enquêtes à partir de votre compte Qualtrics.
Chargement de données à partir d’un compte Qualtrics dans XM Discover
Avant de commencer
Avant de configurer une tâche à l’aide du connecteur entrant Qualtrics, assurez-vous que vous disposez des informations suivantes relatives à votre compte Qualtrics :
- Adresse de votre instance Qualtrics.
- Votre jeton API Qualtrics.
- Nom de l’enquête à partir de laquelle télécharger les données.
Astuce Qualtrics : pour en savoir plus, consultez la documentation de l’API Qualtrics.
Configuration de la connexion
Création d’une tâche de connecteur entrant Qualtrics
Après avoir configuré la connexion, suivez ces étapes pour créer des enquêtes de chargement depuis votre compte Qualtrics dans XM Discover.
- Étape 1 : indiquez le nom du job
- Étape 2 : Spécifier le projet et la description
- Étape 3 : Fournissez les identifiants Qualtrics
- Étape 4 : Type de données Qualtrics
- Étape 5 : Mapper les champs souhaités dans XM Discover
- Étape 6 : Remplacement et reproduction des données (facultatif)
- Étape 7 : Spécifier le filtre (facultatif) et la limite d’enregistrement
- Étape 8 : notification et configuration (facultatif)
- Étape 9 : configurer des options supplémentaires pour le poste
- Étape 10 : Confirmer toutes les options du job
Étape 1 : indiquez le nom du job
Saisissez un nom de tâche reconnaissable dans la zone Nom du job en haut à gauche de la page.
Étape 2 : Spécifier le projet et la description
- Sur la page Spécifier le projet et la description, sélectionnez le projet dans lequel les données doivent être chargées dans le 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. - Cliquez sur Suivant.
Étape 3 : Fournissez les identifiants Qualtrics
- Sur la page Fournir les identifiants Qualtrics, vous pouvez sélectionner un ensemble existant d’identifiants dans le menu déroulant.
Astuce Qualtrics : vous pouvez ajouter un nouvel ensemble d’identifiants Qualtrics. Pour plus d’informations sur les nouveaux identifiants Qualtrics, voir le Ajout de nouveaux identifiants Qualtrics . - Cliquez sur Suivant.
Étape 4 : Type de données Qualtrics
- Sur la page Type de données Qualtrics, sélectionnez l’une des options suivantes pour spécifier le type de données à télécharger dans XM Discover :
- Enquête : téléchargez des données à partir d’un Qualtrics spécifique. Consultez la sous-section Enquête ci-dessous pour plus d’informations.
- Gestion de la réputation en ligne (ORM) : chargez les avis et les données de localisation à partir d’un projet de gestion de la réputation Qualtrics. Voir la sous-section Gestion de la réputation en ligne (ORM) ci-dessous pour plus de renseignements.
- Tickets : ingérez les données des tickets à partir de Qualtrics Engage. Voir la sous-section Tickets ci-dessous pour plus d’informations.
- Cliquez sur Suivant.
Enquête
- Si vous sélectionnez Enquête, vous serez redirigé vers la page Sélectionner une enquête pour la configuration, où vous pourrez sélectionner l’une des enquêtes Qualtrics disponibles à partir desquelles télécharger des données.
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 depuis l’environnement Qualtrics. - Si des filtres sont disponibles pour l’enquête sélectionnée, sélectionnez l’un des filtres Qualtrics dans le menu (facultatif). Pour plus d’informations, voir Filtrage des réponses.
- Cochez la case Récupérer les réponses « En cours » si vous souhaitez inclure les réponses non terminées dans le chargement. Ne cochez pas cette case si vous souhaitez uniquement extraire les réponses complétées.
Astuce Qualtrics : vous pouvez mettre à jour la configuration des requêtes après la création de la tâche.
Gestion de la réputation en ligne (ORM)
Si vous sélectionnez Online Reputation Management (ORM), vous serez dirigé vers la page Indiquer l’ID du jeu de données ORM où vous pourrez saisir l’idpSourceId pour le projet de données importées dans la zone ID source IDP.
Tickets
Si vous sélectionnez Tickets, vous serez dirigé vers le Mapper les champs souhaités dans XM Discover où vous pouvez connecter des champs de données source à des champs de données dans votre projet XM Discover.
Étape 5 : Mapper les champs souhaités dans XM Discover
- Sur la page Mapper les champs souhaités dans XM Discover, sélectionnez l’onglet MAPPAGE DE SOURCE pour connecter les champs de données source aux champs de données de votre projet XM Discover.
- Dans la section Mappage source par défaut, configurez les champs de données par défaut que tous les documents de XM Discover partagent. Pour plus d’informations sur le mappage de source par défaut, voir le Mappage source par défaut .
- Dans la section Mappage source, configurez les champs de données supplémentaires du fichier.
Astuce Qualtrics : pour plus d’informations sur le mappage des données, consultez la section Configurer le mappage des données. - Cliquez sur Suivant.
Étape 6 : substitution et édition des données (facultatif)
- Sur la page Remplacement et édition des données, vous pouvez fournir des règles de remplacement et de rédaction pour masquer les données sensibles ou remplacer automatiquement certains mots et phrases types dans le feedback et les interactions des clients.
Astuce Qualtrics :Pour en savoir plus sur la substitution et la rédaction des données, consultez Remplacement et rédaction des données. - Cliquez sur Suivant.
Étape 7 : Spécifier le filtre (facultatif) et la limite d’enregistrements
- Sur la page Spécifier un filtre, vous pouvez définir une condition de filtre pour un job afin de charger uniquement les enregistrements qui le satisfont (facultatif).
Astuce Qualtrics : pour en savoir plus sur l’application d’un filtre, consultez Filtre de connecteur. - 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.
- Cliquez sur Suivant.
Étape 8 : configuration des notifications (facultatif)
- Sur la page Configuration des notifications, vous pouvez sélectionner les notifications que les observateurs d’un job doivent recevoir si l’un des événements répertoriés ci-dessous se produit.
- Envoyer une notification lorsque zéro enregistrement est chargé dans le projet.
- Envoyer une notification lorsque des valeurs consécutives manquantes ont été trouvées.
- Envoyer une notification en cas d’échec de l’exécution du job.
- Envoyer une notification lorsque l’exécution du job réussit partiellement.
- Envoyer une notification lorsque le job se termine avec un délai d’expiration.
- Contactez le support en cas d’échec de cette tâche.
- Cliquez sur Suivant.
Étape 9 : configurer des options supplémentaires pour le poste
- Sur la page Configurer des options supplémentaires pour le job, dans la section Gestion des documents nouveaux et existants, sélectionnez la manière dont le système doit gérer les documents en double en cochant l’une des cases suivantes dans la section Gestion des documents nouveaux et existants :
- Rejeter les doublons pour les documents existants et créer de nouveaux enregistrements pour les nouveaux documents
- Mettre à jour les attributs structurés pour les documents existants et créer de nouveaux enregistrements pour les nouveaux documents
- Mettre à jour les attributs structurés pour les documents existants et ne pas créer d’enregistrements pour les nouveaux documents
Attention : chaque document doit avoir un ID naturel unique afin que le système puisse traiter les documents en double ayant des ID naturels identiques.
- Sur la page Configurer des options supplémentaires pour le job, dans la section Planifier job 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 : pour en savoir plus sur la planification des exécutions incrémentielles, voir Planification des tâches.
- Configurez Extraction unique pour effectuer une extraction de données unique.
Étape 10 : Confirmer toutes les options du job
- 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.
Lorsque vous cliquez sur Terminer, les opérations suivantes se produisent : Les extractions uniques sont exécutées 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 que vous avez définie.
Pour plus d’informations sur le suivi des jobs, voir Synthèse des pages de jobs.
Ajout de nouveaux identifiants Qualtrics
- Pour ajouter un nouvel ensemble d’identifiants, sélectionnez Ajouter Nouveau dans le menu des identifiants.
- Saisissez le nom du nouvel ensemble d’identifiants dans la zone NOM DE LA CONNEXION.
- Fournissez votre identifiant de centre de données Qualtrics dans la case ID QUALTRICS DATACENTER.
Astuce Qualtrics : pour en savoir plus sur la recherche de votre centre de données, veuillez lire la section Localiser votre ID de centre de données sur la page Recherche d’ID Qualtrics.
- Fournissez le jeton API pour votre compte Qualtrics dans la case THÈMES API QUALTRICS.
Astuce Qualtrics : pour savoir comment trouver un jeton API Qualtrics, consultez Authentification par jeton API.
- Vous pouvez définir vos identifiants pour qu’ils expirent après un certain temps (facultatif). 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.
- 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 case Jours avant expiration.
- 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.
Mappage source par défaut
Voici les options des champs de données par défaut pour le connecteur entrant Qualtrics :
- natural_id : ID naturel sert d’identifiant unique d’un document et permet le traitement correct des documents en double. Pour Natural ID, XM Discover utilise des ID source préfixés par le nom du connecteur via une transformation personnalisée : Natural ID = Connector-name;Source-ID
- document_date : la date du document est le champ de date principal associé à un document. Cette date est utilisée dans les rapports XM Discover, les tendances, les alertes, etc. Pour Date du document, sélectionnez l’une des options suivantes :
- endDate (par défaut) : date et heure auxquelles le répondant a soumis son enquête. Si la saisie est une réponse partielle, cette date indiquera la dernière fois que le répondant a effectué une action dans l’enquête.
- startDate : date et heure auxquelles le répondant a cliqué pour la première fois sur le lien vers l’enquête.
- registered dedDate : il s’agit d’un enregistrement du début, de la soumission ou de la mise à jour d’une réponse à une enquête dans Qualtrics.
- job_name : le nom du job vous aide à identifier les données en fonction du nom du job utilisé pour le chargement. Vous pouvez modifier la valeur de cet attribut lors de la configuration via le champ Nom du job qui est affiché en haut de chaque page lors de la configuration.
- loadDate : la date de chargement indique quand un document a été téléchargé dans XM Discover. Cette zone est définie automatiquement.
- feedback_provider : Feedback Provider vous aide à identifier les données obtenues auprès d’un fournisseur spécifique. Pour les documents Qualtrics, la valeur de cet attribut est définie sur Qualtrics.
- feedback_type: Feedback Type vous aide à identifier les données en fonction de leur type. Cela est utile pour le reporting lorsque votre projet contient différents types de données (par exemple, des enquêtes et des commentaires sur les médias sociaux). Pour les documents Qualtrics, la valeur de cet attribut est définie sur Enquête.
- source : la source vous aide à identifier les données obtenues à partir d’une source spécifique. Il peut s’agir de tout ce qui décrit l’origine des données, comme le nom d’une enquête ou d’une campagne marketing mobile. Par défaut, la valeur de cet attribut est définie sur Qualtrics, mais vous pouvez fournir votre propre valeur dans la colonne Valeur codée en dur.