Transmission d'informations avec des chaînes de requêtes
Contenus de cette page
À propos des chaînes de requête
Une chaîne de requête vous permet de transmettre des informations vers et depuis un site Web en ajoutant simplement ces informations à la fin d’une URL. Ces informations sont stockées dans la chaîne de requête et sont capturées par le site Web lorsqu’il lit l’URL.
Des données peuvent être transmises dans une enquête à l’aide d’une chaîne de requête. Une fois passées, les données peuvent être sauvegardées en tant que données intégrées avec la réponse à l’enquête. À la fin d’une enquête, des chaînes de requête peuvent être utilisées pour transmettre des données à un autre site Web ou à une autre enquête.
Structure de la chaîne de requête
Structure de chaîne de requête générale
Les chaînes de requête suivent une syntaxe très spécifique. Ils sont ajoutés à la fin d’une URL dans le format général suivant : ?FieldName=FieldValue. Le FieldName est le nom de votre champ de données tandis que FieldValue est la valeur de données spécifique de votre champ. Jetons un coup d’œil à un exemple d’URL avec une chaîne de requête ajoutée. La chaîne de requête est en gras.
https://survey.qualtrics.com/jfe/form/SID=SV_1234?Source=Facebook Lorsqu’un répondant répond à l’enquête avec le lien ci-dessus, le champ de données « Source » avec la valeur « Facebook » sera enregistré avec la réponse.
Plusieurs chaînes de requête dans une URL
Les chaînes de requête permettent de transmettre plusieurs données dans une seule URL. Cependant, lorsque votre URL contient plusieurs chaînes de requête, la syntaxe est un peu différente. Jetons un coup d’œil à une URL avec plusieurs chaînes de requête ajoutées. Les chaînes de requête sont en gras.
https://survey.qualtrics.com/jfe/form/SV_123456789?Source=Facebook&Campaign=Mobile La deuxième chaîne de requête commence par une esperluette (& 😉 au lieu d’un point d’interrogation ( ?). En effet, les URL ne peuvent prendre en charge qu’un seul point d’interrogation. Des chaînes de requête supplémentaires peuvent être ajoutées en ajoutant des champs au format &FieldName=FieldValue.
Attention : Bien qu’il n’y ait pas de limite à la quantité de données que vous pouvez transmettre via les chaînes de requête dans Qualtrics, les navigateurs web ont des limites de longueur de caractères pour les URL. Ces limites varient selon le navigateur. Nous vous recommandons d’essayer de limiter vos URL à moins de 2 000 caractères. Pour plus d’informations sur les limites d’un navigateur spécifique, consultez l’aide du navigateur.
Combinaison de valeurs de chaîne de requête dans les données relatives aux réponses
Vous pouvez transmettre plusieurs valeurs pour le même champ dans une chaîne de requête. Le résultat sera un champ combiné dans vos données de réponses, séparé par des virgules.
Par exemple, si vous transmettez la chaîne de requête suivante :
https://survey.qualtrics.com/jfe/form/SV_9GfoihavJJR5R7U?Client=ATT&Client=Sprint Le résultat sera que le champ « Client » aura la valeur « ATT, Sprint ».
Transmission d’informations dans une enquête
Vous pouvez utiliser des chaînes de requête pour transmettre des informations dans une enquête Qualtrics. Vous pouvez enregistrer ces informations en tant que données intégrées et utiliser ensuite ce champ dans la logique de branche et d’affichage, tout en enregistrant les données avec la réponse de l’enquêteur.
Exemple : Vous pouvez utiliser une chaîne de requête pour savoir à partir de quelle source un participant accède à une enquête. Imaginons que vous lanciez une enquête sur plusieurs sites de réseaux sociaux. Si vous souhaitez savoir quels participants viennent de Facebook et lesquels viennent de LinkedIn, vous pouvez créer deux liens personnalisés (chaînes de requête en gras).
https://survey.qualtrics.com/jfe/form/SID=SV_1234?Source=Facebookhttps://survey.qualtrics.com/jfe/form/SID=SV_1234?Source=LinkedInCes chaînes de requête enregistreront deux valeurs différentes pour le champ “Source”. Ces valeurs sont « Facebook » et « LinkedIn ». Vous pouvez ensuite utiliser ces données dans vos rapports, les brancher sur des questions à afficher pour vos répondants, et baser la logique debranche et d’affichage sur ces données pour afficher ou masquer les questions pertinentes.
La transmission d’informations dans une enquête par le biais de chaînes de requête nécessite une configuration en deux parties. La première partie consiste à ajouter des données à votre URL avec des chaînes de requête, et la deuxième à créer des éléments de données intégrées dans votre flux d’enquête pour capturer les informations de l’URL.
Partie 1 : Ajouter des données à l’URL d’une enquête
Partie 2 : Capturer des informations à partir d’une URL sous forme de données intégrées
Transmission d’informations à partir d’une enquête
Vous pouvez transmettre des informations d’une enquête à un autre site web ou d’une enquête à une autre en ajoutant des informations à l’URL de redirection. C’est ce que l’on fait généralement lorsqu’on travaille avec un fournisseur de panel tiers.
Attention : La destination de la redirection doit être configurée pour accepter les informations transmises dans l’URL. Faute de quoi les informations transmises ne seront pas capturées. Reportez-vous à la section ” Transmettre des informations à une enquête ” ci-dessus pour en savoir plus sur la configuration d’une enquête afin qu’elle accepte les informations transmises dans l’URL.
Pour transmettre des informations à partir d’une enquête
Après avoir créé votre lien de redirection, vous devrez vérifier que votre site Web de redirection peut capturer les informations à partir des chaînes de requête. Si vous redirigez vers une enquête Qualtrics, vous trouverez des détails sur la préparation de votre enquête pour capturer les informations dans la partie 2 de la section ” Transmettre des informations à une enquête ” ci-dessus.
Ajouter des chaînes de requête aux liens envoyés par e-mail
Certains éditeurs de messagerie Qualtrics contiennent du texte inséré pour votre lien vers une enquête au lieu du lien d’enquête lui-même. Il s’agit notamment des invitations à l’enquête envoyées par e-mail, ainsi que de la tâche Envoyer l’enquête par e-mail. Vous pouvez ajouter des chaînes de requête au texte inséré pour ces liens afin que les chaînes de requête soient ajoutées au lien lors de l’envoi de l’e-mail. Cela sera utile notamment est si vous envoyez de nombreuses distributions identiques et que vous souhaitez savoir quelles réponses proviennent de quelle distribution. D’autres actions sont nécessaires pour vous assurer que votre lien est correctement créé et mis en hyperlien dans vos e-mails Qualtrics.
Encodage des URL pour les chaînes de requête
Astuce : cette solution ne fonctionne que pour les flux de travail qui commencent par un évènement de réponse à une enquête. Par exemple, si vous utilisez une réponse à une enquête pour déclencher une tâche e-mail.
Votre chaîne de requête semble ne pas fonctionner ? Cela peut lié à la mise en forme de votre texte inséré. Les URL ne peuvent pas toujours lire les caractères spéciaux, tels que les espaces et les symboles. Nous devons donc nous assurer que l’URL sait comment traiter ces caractères en les encodant.
La meilleure pratique consiste à ajouter “?format=urlencode” à la fin des valeurs du texte inséré, avant la dernière parenthèse. Cela garantit que les valeurs contenant des espaces et des caractères spéciaux sont correctement transférées dans la chaîne de requête.
Exemple : Insérez des données intégrées appelées Département dans votre chaîne de requête en utilisant ${e://Field/Department?format=urlencode} au lieu de ${e://Field/Department}.
Attention : N’ajoutez pas?format=urlencode aux champs Email. Cela convertira le symbole @ en %40.
Attention : N’ajoutez pas ?format=urlencode au texte inséré pour l’URL de l’Enquête. Au lieu de cela, ajoutez-la à l’URL d’une enquête complète dont la chaîne de requête contient du texte inséré. Un exemple d’utilisation correcte serait https://qunivocalize.co1.qualtrics.com/jfe/form/SV_xxxxxxx?Department=${e://Field/Department?format=urlencode}&Office=${e://Field/Office?format=urlencode}
N’utilisez qu’un point d’interrogation avant le formatage du code URL. N’utilisez pas d’esperluette ( & ; ) ni aucun autre caractère.
Comment utiliser Q_EED
Q_EED peut être utilisé comme paramètre d’URL pour transmettre des paramètres de données intégrées obfusquées (ou encodées Base64URL). L’un des cas d’utilisation les plus courants consiste à transmettre des données JSON au format binaire via une URL.
Dans l’exemple ci-dessous, nous gérons le genre (homme) et l’âge (32) d’un répondant dans une enquête Qualtrics en utilisant Q_EED ajouté à la fin d’un lien vers une enquête comme chaîne de requête.
Astuce : ne modifiez pas l’orthographe, la ponctuation ou la casse de vos variables. Si votre flux d’enquête indique « Genre », le G doit toujours être mis en majuscule pour que l’encodage fonctionne ainsi que la transmission de ces informations.
Attention : Pour des raisons de sécurité, les chaînes encodées ne peuvent pas contenir de signes plus ( + ), sinon les données intégrées ne seront pas enregistrées. Utilisez des tirets ( – ) à la place.
Comment utiliser Q_PopulateResponse
Q_PopulateResponse est utilisé comme paramètre d’URL pour pré-remplir les réponses à l’enquête.
Les valeurs sont transmises via l’URL sous forme de champs au format JSON :
YourSurveyURL?Q_PopulateResponse={"QID1":"6","QID2":"4","QID3":"this is my text","QID4":"1"}
Si vous souhaitez intégrer les réponses de l’année dernière aux enquêtes de cette année, vous pouvez télécharger les réponses en tant que données intégrées dans une liste de contacts, puis créer un lien individuel personnalisé qui fait référence à ces réponses. Tout d’abord, rédigez un texte cliquable dans votre e-mail de distribution, puis récupérez le texte inséré pour l’URL de l’enquête et utilisez le bouton de lien dans l’éditeur de contenu riche pour créer un lien vers quelque chose comme ceci
:${l://SurveyURL} ?Q_PopulateResponse={"QID1" : "${e://Field/QID1}", "QID2" : "${e://Field/QID2}", "QID3" : "${e://Field/QID3}"}Cet
exemple fait référence aux champs de contact QID1, QID2 et QID3. Veillez à encoder les guillemets (“) avec %22, mais n’ encodez pas la totalité de la chaîne URL, car cela désactiverait le texte inséré.
Ce lien renseignera les réponses de l’année dernière. Si la personne modifie certaines de ces réponses par défaut, puis quitte l’enquête, lorsqu’elle accédera de nouveau à l’enquête, l’enregistrement le plus récent remplacera ce que l’URL devrait renseigner. De plus, s’il existe une logique d’affichage sur une question, la réponse à cette question sera remplie, mais celle-ci ne sera pas enregistrée à moins que la personne ne choisisse la bonne logique pour afficher cette question.
Astuce : Voir les FAQ au bas de la page pour obtenir de l’aide sur le formatage JSON.
Cas d’utilisation courants
Vous trouverez ci-dessous quelques cas d’utilisation courants de Qualtrics qui utilisent des chaînes de requête. Consultez les pages mises en lien pour plus d’informations.
- Tirer des données dans une deuxième enquête (enquêtes longitudinales)
- Intégration avec une société de panel
- Créer un lien pour répondre à nouveau à l’enquête
Types de projets pour lesquels vous pouvez utiliser des chaînes de requête
Les chaînes de requête peuvent être utilisées avec n’importe quel type de projet comportant un lien. Cela comprend notamment :
- Projets d’enquête
- Engagement
- 360
- Cycle de vie
- Recherche ponctuelle sur les employés
- Pulse
- Solutions XM
- Analyses conjointes
- Différence maximum
Astuce : Cette page d’aide a été rédigée en tenant compte des projets d’enquête. Les cas d’utilisation présentés sur cette page ne sont pas tous pertinents pour tous les types de projets.
FAQs
Dois-je remplir chaque question de l’enquête avec Q_PopulateResponse ?
Dois-je remplir chaque question de l’enquête avec Q_PopulateResponse ?
S’il est utilisé avec un lien anonyme et si vous accédez à nouveau à une enquête partiellement terminée, Q_PopulateResponse remplacera-t-il manuellement les réponses saisies lors de la session précédente ?
S’il est utilisé avec un lien anonyme et si vous accédez à nouveau à une enquête partiellement terminée, Q_PopulateResponse remplacera-t-il manuellement les réponses saisies lors de la session précédente ?
Comment Q_PopulateResponse fonctionne-t-il avec la logique d’affichage ?
Comment Q_PopulateResponse fonctionne-t-il avec la logique d’affichage ?
La longueur de l’URL pouvant être utilisée avec Q_PopulateResponse est-elle limitée ?
La longueur de l’URL pouvant être utilisée avec Q_PopulateResponse est-elle limitée ?
C'est génial! Merci pour votre avis!
Merci pour votre avis!
Comment puis-je déterminer la mise en forme JSON d'une question ?
Choix multiples Format court : "QuestionID":"ChoiceID"
Choix
multiple Format complet : "QuestionID":[{"Value":"ChoiceID":"Text":"QuestionID":"ChoiceID,ChoiceID":"
Matrice au format complet : "QuestionID":{"StatementID":{"Value": "ScaleID(s)", "Text": "Text1"},"StatementID":{"Value": "ScaleID(s)", "Text": "Text2"}}
Matrice Entrée et matrice Somme constante : "QuestionID":{"StatementID":"ID de texte"{"ID de texte
" de "ID" de
"
ID de texte" de "ID" de "
ID de texte et de matrice" : "
QuementID":{"ID de scaleID":"ID de texte":"ID de valeur" : "ID de texte" :{"ChoiceID":{"GroupID":"
Rank", "
Text":"AllowText Entry","ChoiceID"
Point actif : "QuestionID":{"SpotID":"ScaleID","SpotID":"ScaleID"}
Hot Spot Full Format : "QuestionID":{"SpotID":{"Value":"ScaleID"},"SpotID":{"Value":"ScaleID"}}
Heat Map : "QuestionID":[{"x":number, "y":number},{"x":number, "y":number}]
Explorer en avant : "QuestionID":{"ChoiceID":"AnswerID"
light":{"ChoiceID" spéciaux:"
AnswerID" HighswerID} :
Chargement de fichier et signature : "QuestionID" : {Taille : nombre, Nom de fichier : 'name',FileType : 'mimetype',FileThumbnail:, FileData:, FileID : 'FileID',S3 : true} ;