Questions API communes

À propos des questions d’API communes

Qualtrics propose différents produits qui permettent à nos clients de collecter des données exploitables en temps réel. Certains de ces produits incluent la Plateforme d’enquête, le Feedback site Web/application, le Répertoire XM et Qualtrics 360. Après avoir acheté la fonctionnalité API Qualtrics, vous pourrez l’utiliser avec tous les produits faisant partie de votre licence.

• Documentation de l’API pour la plateforme d’enquête et le répertoire XM.
• Documentation de l’API pour l’avis sur le site Web/l’application.

Plateforme d’enquête

J’ai tous les paramètres corrects, mais j’obtiens toujours un message d’erreur indiquant « Demande non valide. Paramètre de demande manquant ou non valide.” Pourquoi cela se produit-il ?

Exemple :

curl -X POST \  https://yourdatacenterid.qualtrics.com/API/v3/responseexports \   
 -H 'content-type: application/json' \  -H 'x-api-token: 12345678901234567890' \   
 -d '{"surveyId":"SV_1234567890","Format":"json"}'

Les paramètres de l’API Qualtrics sont sensibles à la casse. Dans cet exemple, votre paramètre s’appelle “Format” alors qu’il doit être “format”. Mettez-le à jour et vous pourrez exécuter correctement votre demande API.

Je souhaite télécharger mes données brutes pour les ouvrir dans Excel. Quelle demande API dois-je utiliser ?

Vous devrez utiliser la demande Créer une exportation de réponse pour lancer le processus d’exportation et spécifier que le format du fichier d’exportation de réponse doit être CSV. Vous devrez ensuite utiliser la demande Obtenir l’avancement de l’exportation des réponses pour vérifier si le fichier est prêt, puis la demande Accéder au fichier d’exportation de réponse pour télécharger votre fichier CSV.

Lorsque vous utilisez Créer des contacts Importer, quelles sont les différentes méthodes de publication ou d’envoi de ma liste de contacts à Qualtrics ?

Il existe deux options pour télécharger votre liste de contacts :

1. Vous pouvez définir le type de contenu sur multipart/form-data et charger vos contacts sous forme de fichier JSON.
2. Vous pouvez définir Content-Type sur application/json et publier les contacts sous forme de tableau JSON dans le corps de la demande.

Suis-je limité au nombre de demandes que je peux effectuer pour mon organisation ? Et combien de demandes d’API simultanées puis-je effectuer simultanément ?

Consultez cette page API pour en savoir plus sur les limites.

J’utilise la demande d’importation d’enquête et j’ai enregistré mon enquête sous forme de fichier TXT. La demande a réussi, mais mes questions n’apparaissent pas dans ma nouvelle enquête importée. Pourquoi cela se produit-il ?

Vous devrez vous assurer que vous respectez le format nécessaire pour importer des enquêtes dans Qualtrics. Pour en savoir plus sur le formatage TXT, voir Préparation d’un fichier TXT au format simple et Préparation d’un fichier TXT au format avancé. Une fois votre fichier correctement formaté, la demande est exécutée avec succès.

J’utilise la demande d’exportation Créer une réponse avec les paramètres startDate et endDate. Cependant, lorsque je regarde les données téléchargées, je ne vois pas la plage de dates prévue pour les réponses.

Pour utiliser les paramètres startDate et endDate, il est essentiel de comprendre quelle valeur de date est utilisée pour évaluer la condition que vous créez (c’est-à-dire les dates qui sont examinées pour évaluer la date de début que vous avez définie et la date de fin que vous avez définie). Ces deux paramètres utilisent la date à laquelle le participant a commencé l’enquête. Cette valeur, appelée Date de début, se trouve dans votre onglet Données & Analysis et les données téléchargées. Ainsi, si vous définissez le paramètre startDate sur 2017-01-01 et le paramètre endDate sur 2017-01-02, vous téléchargerez les réponses qui ont été enregistrées (soumises ou incomplètes) pour les participants à l’enquête qui ont commencé leur enquête dans la plage de dates allant du 1er janvier 2017 au 2 janvier 2017.

Astuce Qualtrics : une réponse à l’enquête n’est enregistrée que lorsque le participant clique sur le bouton Envoyer dans une enquête ou lorsque le réponses à l’enquête incomplètes la période a été respectée.

Avis sur site Web/application

Pour toute question sur l’avis sur le site Web/l’application, contactez notre équipe d’assistance Feedback site Web/application.

Répertoire XM

Puis-je utiliser l’API de plateforme d’enquête maintenant que j’utilise également le répertoire XM ?

Oui, absolument. Le répertoire XM dispose de quelques requêtes d’API qui remplaceront les demandes effectuées via l’API de plateforme d’enquête, mais pour la plupart, vous pouvez toujours utiliser toutes les requêtes d’API de la plateforme d’enquête. Les demandes des Contacts de la plateforme d’enquête sont les seules qui puissent changer. Dans la documentation v3, les demandes d’API qui ne sont pas prises en charge pour les utilisateurs du répertoire XM Directory (et vice versa) recevront un avis.

À quelle fonctionnalité supplémentaire l’API du répertoire XM dispose-t-elle que je n’ai pas accès uniquement avec l’API de plateforme d’enquête ?

L’API du répertoire XM vous fournit quelques demandes uniques spécifiques au répertoire XM. Vous pouvez utiliser getBouncedContacts (API v2.4) pour rechercher tous les contacts de votre répertoire (ou d’une liste de diffusion spécifique) qui ont déjà fait l’objet d’un retour à l’expéditeur d’e-mail. La demande Lister les contacts du répertoire peut être utilisée pour exporter un sous-ensemble de l’intégralité de votre répertoire. La demande getIncentiveRecipients vous permet de télécharger une liste de tous les contacts de votre répertoire qui ont obtenu une récompense spécifique, comme une prime de points ou une entrée de tirage au sort. Ces demandes et d’autres sont disponibles avec l’API du répertoire XM.

Quelle est la différence entre l’ID contact et l’ID destinataire ?

Chaque demande d’API de répertoire XM demande généralement l’ID de contact du contact. Cet ID commence par “CID_” et est suivi d’une chaîne alphanumérique unique. L’ ID contact est l’ID unique du contact dans votre répertoire. Certaines demandes d’API demandent l’ ID destinataire du contact. Cet ID commence par « CGC_ » et est suivi d’une chaîne alphanumérique unique. L’ID du destinataire est l’ID unique du contact dans une liste de distribution.

Pour comprendre la différence entre l’ ID contact et l’ ID destinataire, n’oubliez pas que chaque contact ne doit exister qu’une seule fois dans votre répertoire. Ainsi, un seul contact peut être trouvé une fois dans votre répertoire, mais peut également être membre de plusieurs listes de distribution. Si ce contact était membre de trois listes de distribution, il aurait un ID de contact et trois ID de destinataire, un pour chaque liste.

Qualtrics 360

Pour les questions Qualtrics 360, contactez notre équipe de support Qualtrics 360.