Action Obtenir un Paramètre URL

L'action Get URL Parameter lit un paramètre nommé de l'URL du participant et l'écrit directement dans une variable que vous choisissez. Elle appartient à la catégorie Variable Actions du système d'événements.

Aperçu

Un lien de participation peut transporter des informations au-delà de ce que Labvanced lit automatiquement, un paramètre de ciblage propre à une plateforme de crowdsourcing, ou une valeur transmise d'une autre étude. Get URL Parameter est la méthode pour extraire un paramètre spécifique et nommé de ce lien et le stocker directement dans une variable.

Cas d'Utilisation Communs

• Lire le paramètre propre à une plateforme de crowdsourcing (par exemple le tc de Besample) directement dans une variable, pour ramifier la logique de l'étude.
• Transmettre une valeur statique d'une étude parente dans une Sous-Étude, via le champ Query Parameters de l'objet Sous-Étude.
• Construire votre propre lien de participation personnalisé avec des paramètres supplémentaires attachés (voir Paramètres URL Personnalisés), et lire l'un d'eux dans une variable.

Comment ça Fonctionne

Pour accéder à Get URL Parameter, ouvrez le Système d'Événements dans l'Éditeur de Tâches et créez un nouvel événement. Choisissez d'abord un déclencheur, par exemple On Frame Start ou un clic de bouton, quel que soit l'élément qui doit déclencher la lecture. Ensuite, sous Add Action → Variable Actions, sélectionnez Get URL Parameter.

L'action lit la valeur une fois, au moment où l'événement la contenant se déclenche. Ce n'est pas une liaison en direct, donc déclenchez-la suffisamment tôt pour que la valeur soit prête avant que tout autre élément de l'étude n'ait besoin de la lire. Si le paramètre nommé n'est pas présent dans l'URL, le résultat dépend du type de données de la variable : une variable de chaîne est définie sur une chaîne vide, tandis qu'une variable numérique est définie sur 0 (la chaîne vide lue par l'action est convertie en nombre).

Les valeurs des paramètres sont toujours des chaînes en principe, puisque tout dans une URL est du texte. Une variable de chaîne est l'adéquation naturelle pour cela, mais une variable numérique fonctionne également si la valeur est strictement numérique, comme le code pays de tc, et est en réalité le meilleur choix si votre étude doit effectuer des opérations mathématiques supplémentaires dessus par la suite.

Action Obtenir un Paramètre URL vs. Variable Système URL_Search_Params

Ce n'est pas strictement l'un ou l'autre. URL_Search_Params enregistre tout sur le lien automatiquement, sans rien à configurer. Get URL Parameter est le choix le plus simple lorsque vous avez juste besoin d'une valeur spécifique, déjà nommée : une action, pas de JSON, pas de code. Il est également possible de combiner URL_Search_Params avec une Action Exécuter JavaScript, si le design expérimental l'exige.

Voyez les deux méthodes côte à côte dans un exemple fonctionnel : Récupérer l'URL Personnalisée depuis la Variable Globale, une étude de bibliothèque qui lit le même paramètre URL des deux manières afin que vous puissiez comparer directement les résultats. Ce lien de bibliothèque ouvre l'écran d'introduction de l'étude, qui vous remet ensuite un lien à copier. L'URL ci-dessous est ce même lien en mode lecteur avec tc déjà attaché, afin que vous puissiez aller directement à la comparaison.

Copiez cette URL dans votre navigateur et essayez-le vous-même :

https://www.labvanced.com/player.html?id=88576&tc=276

Conseils de Flux de Travail

• Correspondre exactement au nom du paramètre. La correspondance est sensible à la casse, donc tc et TC sont considérés comme des paramètres différents.
• Écrire le nom bare, pas le fragment de requête complet. Le champ prend tc, pas &tc= ou tc=; l'action construit le reste de la correspondance en interne.
• Prendre en compte la valeur par défaut du paramètre manquant. Un Requirement Action vérifiant cette variable devrait tester pour une chaîne vide (variables de chaîne) ou 0 (variables numériques), et non null, lorsque le paramètre pourrait être manquant.
• Déclenchez-le avant que la valeur ne soit nécessaire. Puisque la lecture se fait une fois lorsque l'événement se déclenche, placez-le sur un déclencheur qui s'exécute suffisamment tôt, avant toute image qui affiche ou branche sur la valeur.

Études & Scénarios Exemples

Lire le paramètre propre à une plateforme de crowdsourcing

Toute plateforme de crowdsourcing peut ajouter ses propres paramètres à un lien de participation, au-delà de ceux que Labvanced lit déjà automatiquement. Tant que vous connaissez le nom du paramètre, Get URL Parameter le lit directement, peu importe quelle plateforme l'a envoyé. Par exemple, une étude Besample peut ajouter tc (pays cible) : ajouter Get URL Parameter avec Parameter name défini sur tc et Save in Variable défini sur une variable personnalisée (par exemple Target_Country), et la valeur est prête à ramifier la logique immédiatement. Voir Intégration de Besample pour cette configuration spécifique.

Transmettre des valeurs dans une Sous-Étude

L'Objet Sous-Étude utilise Get URL Parameter pour permettre à une étude enfant de lire les valeurs statiques qu'une étude parente a ajoutées à son lien de participation grâce au champ Query Parameters de l'objet, par exemple transporter un code de participation ou une valeur de points entre deux études liées.

Lectures Supplémentaires

Système d'Événements

La référence complète pour chaque déclencheur et action dans Labvanced.

URL_Search_Params

La variable système fourre-tout pour chaque paramètre d'URL, pour lorsque vous ne savez pas à l'avance lesquels apparaîtront.

Exécuter l'Action JavaScript

Comment lire et définir des variables Labvanced avec du JavaScript personnalisé, l'action derrière l'exemple URL_Search_Params.