Transmission d’informations avec des chaînes de requêtes

À 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 (&amp 😉 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.

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.

https://survey.qualtrics.com/jfe/form/SID=SV_1234?Source=Facebook

https://survey.qualtrics.com/jfe/form/SID=SV_1234?Source=LinkedIn

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

1. Copiez le lien anonyme de votre enquête et collez-le dans un éditeur de texte, tel que Word ou Notepad.

   https://survey.qualtrics.com/jfe/form/SV_123456789

2. Ajoutez un point d’interrogation (?) à la fin de l’URL.

   https://survey.qualtrics.com/jfe/form/SV_123456789 ?

3. Tapez le nom du champ Données intégrées (par exemple, « région » ou « ville ») après le point d’interrogation.

   https://survey.qualtrics.com/jfe/form/SV_123456789?city

4. Ajouter un signe égal(=)

   https://survey.qualtrics.com/jfe/form/SV_123456789?city=

5. Saisissez la valeur du champ (par exemple, « Occitanie » ou « Rhône-Alpes »)

   https://survey.qualtrics.com/jfe/form/SV_123456789?city=Provo

6. Pour les champs supplémentaires que vous souhaitez ajouter, répétez les étapes 2 à 5 en utilisant une esperluette(&amp 😉 au lieu d’un point d’interrogation ( ?).

   https://survey.qualtrics.com/jfe/form/SV_123456789?city=Provo&state=Utah

Partie 2 : Capturer des informations à partir d’une URL sous forme de données intégrées

1. Lors de l’édition de votre enquête, accédez à la section Flux d’enquête en cliquant sur l’icône du flux d’enquête dans la barre de navigation de gauche.
   
2. Cliquez sur Ajouter un nouvel élément ici.
   
3. Sélectionnez l’option Données intégrées élément.
   
4. Saisissez le nom de tous les champs que vous souhaitez capturer à partir de l’URL. Ne pas attribuer de valeur à ces champs. Pour ces champs, la Technologie de l’information devrait indiquer que la valeur sera définie à partir du Panel ou de l’URL.
   
   Astuce : la majuscule de vos champs est importante ! Assurez-vous que les champs de votre flux d’enquête correspondent à la capitalisation des champs de votre URL.
5. Déplacez l’élément de données intégrées en tête de votre flux d’enquête. Ceci est particulièrement important si vous souhaitez utiliser les champs de données intégrées dans la logique ou si vous souhaitez afficher les valeurs avec du texte inséré. L’élément de données intégré doit apparaître avant les éléments du flux d’enquête qui y font référence.
   
   Exemple : Dans le bloc de questions Introduction, nous voulons insérer la valeur de “ville” dans un texte de question. Nous devons ainsi déplacer l’élément de données intégrées avant le bloc de questions Introduction dans le flux de l’enquête.

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.

Pour transmettre des informations à partir d’une enquête

1. Générez le code de texte inséré pour chaque élément de données que vous souhaitez transmettre (par exemple, les réponses aux questions de l’enquête, les données intégrées ou toute autre information collectée avec la réponse). Copiez ces codes et enregistrez-les pour plus tard.
   Exemple : Nous voulons transmettre la réponse de la personne interrogée à deux des questions de notre enquête. Le texte inséré pour nos questions d’enquête sélectionnées est ${q://QID7/ChoiceGroup/SelectedChoices} et ${q://QID3/ChoiceGroup/SelectedChoices}.
2. Copiez l’URL de redirection. Il s’agit de l’URL vers laquelle vous souhaitez envoyer les répondants à l’enquête et qui sera le site Web qui capturera les informations.
   Exemple : Nous redirigeons d’une enquête Qualtrics vers un panel tiers, notre URL est donc https://www.survey.panelcompany.com
3. Ajoutez un point d’interrogation (?) à la fin de l’URL.

   https://www.survey.panelcompany.com?

4. Tapez le nom de la variable que vous souhaitez transmettre.

   https://www.survey.panelcompany.com ?Q7Réponse

5. Ajouter un signe égal(=) à la fin de l’URL

   https://www.survey.panelcompany.com?Q7Answer=

6. Collez le code de texte inséré en tant que valeur de la variable.

   https://www.survey.panelcompany.com?Q7Answer=${q://QID7/ChoiceGroup/SelectedChoices}

7. Répétez les étapes 3 à 6 pour toutes les variables supplémentaires que vous souhaitez transmettre. Utilisez une esperluette(&amp 😉 au lieu d’un point d’interrogation ( ?) pour les variables supplémentaires.

   https://www.survey.panelcompany.com?Q7Answer=${q://QID7/ChoiceGroup/SelectedChoices}&Q3Answer=${q://QID3/ChoiceGroup/SelectedChoices}.

8. Collez votre URL complété à l’étape 7 dans la zone de fin d’enquête appropriée (par exemple, par défaut ou dans l’élément de flux d’enquête ).
   Astuce : Vous avez une chaîne de requête qui ne semble pas fonctionner ? Cela peut lié à la mise en forme de votre texte inséré. La meilleure pratique consiste à ajouter « ?format=urlencode » à la fin des valeurs de texte inséré, avant le dernier crochet. 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. Par exemple, tirez 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}. Cependant, n’ajoutez pas format=urlencode dans les champs E-mail. Cela convertira le symbole @ en %40.

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 par e-mail ainsi que de la tâche du Répertoire XM. 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.

1. Ouvrez l’éditeur de messagerie et commencez à rédiger un message. Il peut s’agir de l’éditeur d’e-mails pour les invitations aux enquêtes par e-mail, ou de la tâche Répertoire XM.
2. Si votre message contient déjà du code texte pour une enquête, supprimez ce code. Le code du texte inséré du Lien vers l’enquête est généralement au format ${l://SurveyURL} . Nous procédons ainsi pour nous assurer que le lien que nous créons est exempt d’erreurs.
   
   
3. Cliquez sur l’icône de texte inséré {A} et sélectionnez Liens vers l’enquête → URL de l’enquête.
   
4. Créez votre lien en suivant les instructions de la première partie concernant la transmission d’informations dans une enquête. Le code de texte inséré que vous avez inséré agira comme votre URL.
   Astuce: lors de l’élaboration de vos chaînes de requête, veillez à utiliser un &amp ; pour chaque chaîne, car le lien individuel de l’enquête contiendra déjà des chaînes de requête.
   Exemple : Supposons que nous envoyions une enquête par vagues et que nous souhaitions savoir à quelle vague la personne interrogée a participé. Notre URL dans l’éditeur d’email ressemblera à ${l://SurveyURL}&Wave=wave1
   Astuce : Vous pouvez également utiliser du texte inséré pour les variables et les valeurs de votre chaîne de requête. Toutefois, pour vous assurer que vos valeurs insérées dans des pipelines sont encodées correctement, vous devez ajouter &format=urlencode à la fin des valeurs de texte inséré dans des pipelines, 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. Par exemple, tirez 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}. Cependant, n’ajoutez pas format=urlencode dans les champs E-mail. Cela convertira le symbole @ en %40. De plus, n’ajoutez pas format=urlencode au texte inséré pour l’URL de l’enquête.
5. Copiez le lien créé et mettez le lien en surbrillance dans l’éditeur de messagerie.
   
6. Cliquez sur le bouton du lien hypertexte.
7. Dans la zone URL, collez votre lien copié.
   
8. Changez le protocole en <other>.
9. Si vous le souhaitez, modifiez le texte d’affichage du lien, par exemple “Cliquez ici pour répondre à l’enquête”
10. Cliquez sur OK.

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 masqués (ou encodés en Base64). 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.

1. Ajoutez les données intégrées Sexe et Âge à votre Flux d’enquête.
2. Saisissez les informations que vous souhaitez transmettre au format JSON. Par exemple :

   {"Gender":"Male","Age":32}

3. Maintenant, Base64 encode l’ensemble du format JSON, de crochet en crochet. Veillez à vérifier Perform URL-safe encoding lors de l’encodage de vos données. Une fois encodé, le JSON de l’étape 2 ressemble à ceci :

   eyJHZW5kZXIiOiJZW1hbGUiLCJBZ2UiOjMyfQ====

4. Ajoutez la chaîne de caractères de l’étape 3 comme valeur du champ Q_EED :

   Q_EED=eyJHZW5kZIiOiJGZW1hbGUiLCJBZ2UiOjMyfQ==
   

5. Obtenez l’URL de votre enquête.
6. Si l’URL contient un point d’interrogation ( ?), ajoutez une esperluette (&amp 😉 à la fin. S’il n’y a pas de point d’interrogation, ajoutez un point d’interrogation (?) à la fin.
7. Ajoutez le résultat de l’étape 4 à la fin de votre URL. Cela devrait maintenant ressembler à ceci :

   https://survey.qualtrics.com/jfe/form/SID=SV_1234?Q_EED=eyJHZW5kZXIiOiJGZW1hbGUiLCJBZ2UiOjMyfQ==

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.

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

FAQ