Guide de mise en œuvre du Monetization Link 14 février 2019•Connaissances

V 1.6

Présentation de Lucid Marketplace Lucid Marketplace propose à certains fournisseurs sélectionnés toute une gamme d’opportunités afin de monétiser les répondants lorsqu'ils participent aux enquêtes. Notre solution Monetization Link, qui s'appelait auparavant « Pulley », gère le processus attribuant aux répondants les enquêtes qui leur correspondent pour vous permettre de les monétiser de manière rapide et efficace.

Fonctionnement du Monetization Link de Lucid Vous utiliserez un lien d’entrée unique pour envoyer les répondants vers Lucid Marketplace. Vous pouvez directement ajouter vos paramètres à ces liens pour personnaliser l’expérience du répondant. Lorsqu'un répondant entre sur la marketplace, notre lien utilise les paramètres fournis et toute information enregistrée au sujet du répondant pour lui proposer l’étude disponible qui lui correspond le mieux. Si une étude contient des critères de sélection qui n'ont pas été transmis via le lien d’entrée, la marketplace affichera des questions de pré-sélection pour catégoriser le répondant avant de le diriger vers l’étude. Les informations recueillies par le biais de ces questions seront enregistrées et réutilisées pendant 30 jours.

Lorsque le répondant termine correctement une enquête, il est immédiatement renvoyé vers votre lien de redirection « Enquête terminée ». Lucid ajoute des paramètres au lien de redirection « Enquête terminée » pour vous transmettre les informations qui s’y rattachent. En moyenne, les répondants réussissent à bien terminer une enquête au bout de leur troisième. Si une enquête se révèle infructueuse, le répondant devra répondre à une question lui demandant s'il souhaite poursuivre la session ou y mettre fin. Si le répondant ne termine pas l’enquête correctement, il est renvoyé vers le lien de redirection « Enquête annulée » à la fin de la session.

Considérations liées à l’intégration Fonctionnalité Un lien d’entrée comportant un identifiant unique propre à chaque répondant doit être ajouté dans la chaîne de requête. Les liens d’entrée sur la marketplace ne peuvent pas être partagés entre plusieurs répondants. Les informations liées aux cookies sont utilisées pour s’assurer que les répondants n’essaient pas de répondre à l’enquête plusieurs fois. Cela permet d’éviter que les répondants puissent répondre aux enquêtes en utilisant plusieurs comptes, y compris les comptes détenus auprès de différents fournisseurs. Les répondants entrent sur la marketplace via les liens d’entrée que vous générez, puis vous sont redirigés via un lien de redirection que vous fournissez et qui contient les paramètres de la marketplace que vous y avez ajoutés. Il est nécessaire d’analyser ces paramètres pour évaluer la réussite des résultats de vos utilisateurs. Les noms de paramètres personnalisés ne sont pas disponibles à ce jour.

Si un répondant abandonne une enquête, la marketplace ne peut pas renvoyer le répondant vers un lien de redirection d'un fournisseur.

En tant que fournisseur, vous êtes responsable de la rétribution des répondants. Vous

recevrez des versements mensuels automatisés pour les enquêtes que les répondants ont bien terminées. Vous ne serez pas rétribué pour les sessions incomplètes, abandonnées ou annulées.

Sécurité Le Monetization Link nécessite une signature comportant une fonction de hachage sécurisée SHA-1 sur les liens de redirection vers la marketplace. Cela permet de réduire de manière considérable les répondants frauduleux et la manipulation des liens. Les liens de redirection qui redirigent les répondants vers vous à partir de la marketplace comporteront également des fonctions de hachage.

Il vous incombe de garantir la qualité des répondants avant de les envoyer vers Lucid Marketplace.

En plus du hachage d'URL, nous vous recommandons de mettre en place des mesures de sécurité supplémentaires, de type « Invisible reCAPTCHA » pour vous assurer que seuls des participants humains de haute qualité soient autorisés dans votre intégration.

Les acheteurs de la marketplace évaluent régulièrement la qualité des données qu'ils achètent. La marketplace permet aux acheteurs d’effectuer un ajustement positif ou négatif en fonction de la qualité des données jusqu’à la fin du mois suivant la session. Si un répondant fournit des réponses de mauvaise qualité ou inutilisables, le créateur de l’enquête pourra modifier (inverser) le statut « Enquête terminée » du répondant. Le fournisseur ne sera pas rémunéré pour ces enquêtes dont le statut a dû être modifié.

Comment mettre en œuvre le Monetization Link Pour commencer, vous devez transmettre à l’équipe chargée des comptes de Lucid les informations suivantes :

● Nom du fournisseur ● Liens de redirection vers le fournisseur ○ URL de base pour le lien de redirection « Enquête terminée » ○ URL de base pour le lien de redirection « Enquête annulée » L’équipe chargée des comptes vous fournira ensuite : ● Votre lien fournisseur SID ● Votre lien SHA-1 à clé secrète

Liens d’entrée La session de chaque répondant commence par un lien d’entrée unique à ce répondant. Les liens d’entrée sont générés par le fournisseur à l’aide des éléments suivants : 1. URL de base 2. Paramètres obligatoires 3. Paramètres facultatifs 4. Paramètres démographiques 5. Signature à fonction de hachage

URL de base Tous les liens d’entrée du Monetization Link commencent par les éléments suivants : https://www.samplicio.us/s/default.aspx

Paramètres obligatoires Les liens d’entrée doivent comporter les paramètres obligatoires suivants. Les noms des paramètres doivent être écrits en lettres minuscules.

Lien d’entrée : paramètres obligatoires

Variable Description

Votre identifiant SID pour le lien fournisseur fourni par Lucid sid

Exemple : sid=ac0da46e-ae93-474a-adb1-e19cd686623c Identifiant de répondant unique défini par le fournisseur. Le PID est inclus dans les rapports de la marketplace. Peut contenir des caractères alphanumériques uniquement, pas de

pid

caractères spéciaux à l’exception des tirets (du 6 ou du 8). Limite de 128 caractères.

Exemple : pid=TestUser001_19-995 Identifiant Langue-Pays du répondant

clid Exemple : clid=9

Liste des valeurs CLID : https://support.lucidhq.com/s/article/Country-Languages

Exemple de lien d’entrée comportant les paramètres obligatoires https://www.samplicio.us/s/default.aspx?sid=ac0da46e-ae93-474a-adb1e19cd686623c&pid=TestUser001&clid=9&

Paramètres facultatifs Les paramètres facultatifs permettent aux fournisseurs de limiter la durée de l’étude et de définir un coût minimum par entretien (CPI, cost per interview) pour les enquêtes mises à disposition de leurs répondants. En définissant la variable maximale de la durée de l’entretien (LOI, length of interview) ou la variable minimale du CPI, l'intégration éliminera les opportunités d’enquête qui ne correspondent pas aux limites spécifiées, à moins d'utiliser la variable de l’identifiant de l’enquête ciblée (tar). Les fournisseurs doivent procéder avec prudence lorsqu'ils définissent ces variables puisqu’elles limitent le nombre d’opportunités mises à disposition des répondants. Les noms des paramètres doivent être écrits en lettres minuscules.

Lien d’entrée : paramètres facultatifs

Varia

Description

ble Variable personnalisable pour les données supplémentaires concernant l’identifiant du répondant. Souvent utilisée comme identifiant pour la session. La variable mid est comprise dans les rapports de la marketplace. Doit contenir des mid

caractères alphanumériques uniquement ; pas de caractères spéciaux à l’exception des tirets (du 6 ou du 8). Limite de 128 caractères.

Exemple : mid=testUserMID

Durée maximale de l’enquête en minutes. Comprise entre 0 et 60. loi

Exemple : loi=15 CPI brut minimal en dollars USD, avant tous frais ou commissions applicables. Doit être exprimé au format « XX.xx ».

cos Exemple : cos=0.50 Identifiant pour la publicité mobile. Format GUID. Permet d’améliorer le ciblage des répondants qui répondent sur appareils mobiles. Veuillez contacter l’équipe maid

d'intégration de Lucid pour toute information supplémentaire.

Exemple : maid=20018c3d-40e9-4f50-8693-45a31ef196d4 Identifiant pour les enquêtes ciblées. Précise le premier numéro de l’enquête auquel le répondant doit essayer de répondre, sans prendre en compte les critères CPI ou LOI. Si le répondant n’est pas sélectionné pour l’enquête ciblée, la tar

session du lien continue normalement.

Exemple : tar=1234567 Identifiant du compte d'un acheteur. Limite les répondants autorisés à participer aux enquêtes d'un acheteur unique. Souvent utilisé à des fins professionnelles internes, c.-à-d. un fournisseur qui est aussi acheteur et souhaite fournir des act

répondants pour ses propres enquêtes uniquement. La session prend fin si aucune enquête n’est disponible dans le compte pour le répondant. Veuillez noter que les répondants peuvent prendre part aux opportunités Audience si la variable act est utilisée.

Exemple de lien d’entrée comportant des paramètres facultatifs https://www.samplicio.us/s/default.aspx?sid=ac0da46e-ae93-474a-adb1e19cd686623c&pid=TestUser001&clid=9&mid=testUserMID&loi=15&cos=0.50&tar=1234 567&

Paramètres démographiques Vous devez transmettre des informations démographiques standards pour améliorer la capacité de la marketplace à faire correspondre les qualifications d'un répondant à une enquête adéquate. Les informations démographiques doivent être transmises en utilisant l’identifiant de question QuestionID et la valeur précodée Precode de Lucid. Lors des réponses aux questions à réponses multiples, chaque option de réponses multiples qui s’applique au répondant devra être ajoutée en tant que paramètre distinct.

Veuillez noter que les informations démographiques que vous transmettez au sujet d'un répondant doivent correspondre au code Langue-Pays indiqué pour le répondant. Par exemple, les répondants situés aux États-Unis qui parlent anglais correspondront au code Langue-Pays « 9 », et vous utiliserez donc les questions du tableur figurant dans la feuille du classeur « 9 ENG-US ».

Veuillez consulter le fichier téléchargeable intitulé Qualifications standards pour obtenir la liste des identifiants QuestionID et des valeurs précodées Precode par Langue-Pays. Exemple de lien d’entrée comportant des informations démographiques : Données démographiques fournies : une femme de 45 ans résidant aux États-Unis, code postal 70130, ayant des animaux domestiques (chat(s) et oiseau(x)) à son domicile. https://www.samplicio.us/s/default.aspx?sid=ac0da46e-ae93-474a-adb1e19cd686623c&pid=TestUser001&clid=9&loi=15&cos=0.50&mid=testUserMID&42=45&43= 2&45=70130&639=1&639=3

Veuillez noter que même si nous continuons à approuver l’utilisation de la valeur QuestionName, nous recommandons vivement l’utilisation de la valeur QuestionID à titre de bonne pratique.

Signature à fonction de hachage Une signature à fonction de hachage est obligatoire sur tous les liens d’entrée, et ce afin d’éviter une utilisation non autorisée. Votre responsable de la réussite client vous transmettra une clé secrète pour générer des signatures à fonction de hachage. La signature à fonction de hachage doit être créée en utilisant le hachage HMAC SHA1 avec votre clé privée, puis encodée en base64URL. Votre chaîne base64 doit comprendre l’intégralité de l’URL, jusqu’au signe « & » (y compris) qui précède la valeur de hachage. Les extraits de codes sont disponibles sur le Validateur des fonctions de hachage Lucid. La signature à fonction de hachage qui est générée doit être ajoutée à la fin de la chaîne URL.

Veuillez noter que si l'un des caractères suivants est inclus, il doit être remplacé pour respecter les standards Web.

Original

Remplacement

+

- (tiret du 6)

/

_ (tiret du 8)

=

(chaîne vide)

Hash Tool de Lucid

Veuillez-vous référer au Hash Tool de Lucid pour les tests et les extraits de codes qui permettront de mettre en œuvre le hachage HMAC SHA-1.

Exemple de lien d’entrée comportant la signature à fonction de hachage Avant l’ajout du hachage : https://www.samplicio.us/s/default.aspx?sid=ac0da46e-ae93-474a-adb1e19cd686623c&pid=TestUser001&clid=9&loi=15&cos=0.50&mid=testUserMID&42=45&43= 2&45=70130& Après l’ajout du hachage : https://www.samplicio.us/s/default.aspx?sid=ac0da46e-ae93-474a-adb1e19cd686623c&pid=TestUser001&clid=9&loi=15&cos=0.50&mid=testUserMID&42=45&43= 2&45=70130&hash=yESPcX92n5TiYZbPud89uFYhvkM Interdit : https://www.samplicio.us/s/default.aspx?sid=ac0da46e-ae93-474a-adb1e19cd686623c&pid=TestUser001&clid=9&loi=15&cos=0.50&mid=testUserMID&hash=yESP cX92n5TiYZbPud89uFYhvkM&42=45&43=2&45=70130

Liens de redirection vers le fournisseur Les répondants seront renvoyés vers le fournisseur via un lien de redirection « Enquête terminée » ou « Enquête annulée » lorsqu’une session se termine sur la marketplace, en fonction du résultat de la session. Si l’enquête n’a pas été terminée, la redirection par défaut sera « Enquête annulée ». Si le répondant abandonne la session, la marketplace n’est pas en mesure de renvoyer le répondant vers le fournisseur et la redirection n’est pas effectuée.

Redirection « Enquête terminée » L'indication de réussite « Enquête terminée » met fin à la session sur la marketplace. Le répondant sera redirigé vers le lien de redirection « Enquête terminée » immédiatement après avoir correctement répondu à une enquête. La marketplace ajoute les variables

suivantes, dans l'ordre, sur la chaîne de requête pour les liens de redirection « Enquête terminée ».

Variables de redirection « Enquête terminée »

Variable

Description

pid

Identifiant du répondant unique créé par le fournisseur.

mid

Identifiant secondaire facultatif transmis lors de l’entrée. Cette valeur est renvoyée vide si elle n’est pas transmise lors de l’entrée.

sur

Identifiant pour les enquêtes terminées.

c

Versement brut en dollars USD par enquête terminée, avant tous frais ou commissions applicables.

l

LOI médiane de l’enquête terminée.

[%questio

Identifiant QuestionID de qualification standard. La valeur Precode est

nID%]

renvoyée si les données sont enregistrées au sujet du répondant. Cette valeur est renvoyée vide si aucune donnée n’est enregistrée. Il est possible que plusieurs identifiants QuestionID soient renvoyés.

hash

Signature à fonction de hachage HMAC SHA1 de l’intégralité de l’URL. Utilisée par le fournisseur pour déterminer si l’URL a été manipulée lors de la redirection.

Lien de redirection « Enquête annulée » Si un répondant est éliminé d’une enquête, la marketplace propose au répondant le choix de continuer la session ou de l’abandonner. Si le répondant choisit de l’abandonner, la session se termine immédiatement et le répondant est renvoyé vers le lien de redirection « Enquête annulée ». Si le répondant n’est qualifié pour aucune enquête selon les paramètres du lien d’entrée, il est renvoyé vers le lien de redirection « Enquête annulée ». La marketplace ajoute les variables suivantes, dans l'ordre, sur la chaîne de requête pour les liens de redirection « Enquête annulée ».

Variables de redirection « Enquête annulée »

Variable

Description

pid

Identifiant du répondant unique créé par le fournisseur.

mid

Identifiant secondaire facultatif transmis lors de l’entrée. Cette valeur est renvoyée vide si elle n’est pas transmise lors de l’entrée.

[%questionID%] Identifiant QuestionID de qualification standard. La valeur Precode est renvoyée si les données sont enregistrées au sujet du répondant. Cette valeur est renvoyée vide si aucune donnée n’est enregistrée. Il est possible que plusieurs identifiants QuestionID soient renvoyés. hash

Signature à fonction de hachage HMAC SHA1 de l’intégralité de l’URL. Utilisée par le fournisseur pour déterminer si l’URL a été manipulée lors de la redirection.

Paramètres démographiques

Les données démographiques enregistrées au sujet d'un répondant sont renvoyées vers les deux liens de redirection, « Enquête terminée » et « Enquête annulée ». Les informations démographiques sont renvoyées à l’aide de l’identifiant QuestionID et des valeurs précodées Precode de Lucid. L’application de la bibliothèque de questions standards de Lucid varie selon le code Langue-Pays. Les identifiants QuestionID renvoient une valeur uniquement si un point de données a été recueilli au cours des 30 derniers jours. Seuls les identifiants QuestionID inclus dans la bibliothèque de questions standards correspondant au code Langue-Pays applicable au répondant renverront une valeur.

Les réponses aux questions à réponses multiples seront renvoyées au sein d'un seul paramètre. Le chiffre « 1 » dans la chaîne représente une option sélectionnée, tandis que le chiffre « 0 » représente une option non sélectionnée. La position des nombres dans la chaîne correspond à l’ordre dans lequel les valeurs précodées Precode sont répertoriées dans le fichier des « qualifications standards ». Pour toute information supplémentaire au sujet des paramètres démographiques, veuillez consulter l’équipe chargée des comptes de Lucid.

Exemple de redirection « Enquête terminée » Le lien suivant serait utilisé pour rediriger une femme âgée de 53 ans dont le code postal est 70130, qui a des animaux domestiques (chat(s) et poisson(s)), et qui a bien terminé l’enquête n° 1234567 dont la LOI était de 10 minutes, pour une rémunération s’élevant à 1.50 dollar USD. https://www.suppliername.com/success?pid=xyz&sur=1234567&l=10&c=1.50&mid=abc&42 =53&43=2&45=70130&639=10010000000&hash=RiNPoR2Bu4ZqhGXQrcK6IL2BcRElctks

Exemple de redirection « Enquête annulée »

Le lien suivant serait utilisé pour rediriger un étudiant âgé de 19 ans qui a tenté de répondre à plusieurs enquêtes, mais qui n’en a terminé aucune correctement. https://www.suppliername.com/failure?pid=xyz&mid=abc&42=19&43=1&2189=10&hash=Ak cqWn69FGzQQNL750FAC8ZAiLs0

Test initial Test des « enquêtes annulées » Pour tester une enquête annulée, utilisez les valeurs CPI et LOI qui sont susceptibles d’éliminer toutes les opportunités d’enquête, telles que cos = 100 et loi = 1. Lors de l’entrée, vous verrez certainement qu’aucune enquête n’est disponible, et vous devriez être renvoyé(e) vers le lien de redirection « Enquête annulée ». Assurez-vous que votre système reçoit et analyse correctement les paramètres ajoutés au lien « Enquête annulée », y compris la signature à fonction de hachage.

Test des « enquêtes terminées » À ce stade, contactez [email protected] pour coordonner le test de votre intégration. Pour tester une « enquête terminée », vous utiliserez un numéro d’enquête test créé spécialement à cette fin. Les critères de sélection de l’enquête sont minimes. Une fois l’enquête terminée, vous devriez être redirigé(e) vers votre lien de redirection « Enquête terminée ». Veuillez noter que vous devez effacer les cookies entre chaque test et utiliser un nouvel identifiant PID pour chaque test. Un PID vous permettra de répondre une seule fois à l’enquête test. L’enquête test a un CPI de 0,00 $ et il faut y répondre avec le code CLID = 9 (anglais américain).

Test des paramètres de l’enquête tar=1584274 clid=9

Lancement restreint Une fois que vous êtes prêt(e) à utiliser votre intégration, veuillez le communiquer à votre responsable réussite client pour qu'il puisse vous aider. N’oubliez pas que les intégrations constituent un processus itératif et nécessitent souvent plusieurs cycles d’évaluation pour optimiser complètement les performances. Lors de la phase de lancement restreint, nous vous conseillons d’envoyer de brèves séries de questions limitées à de vrais répondants. Lorsque vous vous sentez à l’aise avec vos performances en matière d'intégration, vous pouvez supprimer les restrictions relatives au nombre de répondants que vous contactez.

Bonnes pratiques Développement échelonné Certains fournisseurs préfèrent d’abord mettre en œuvre le lien en intégrant uniquement les paramètres obligatoires pour le lien d’entrée en phase de lancement restreint. Cela permet de tester rapidement les fonctionnalités d’intégration et de définir des indicateurs de référence. Une fois qu'ils ont vérifié que l’intégration fonctionne comme prévu, ils ajoutent des fonctionnalités supplémentaires, comme des informations démographiques sur le lien d’entrée, et peuvent également préciser la LOI maximale ou le CPI minimal.

Amélioration de l’expérience du répondant L’ajout d’informations démographiques sur les liens d’entrée améliorera la capacité du produit à attribuer au répondant les meilleures enquêtes disponibles. Cela améliore également l’expérience utilisateur en permettant fréquemment au répondant d’éviter les questions de pré-sélection. L’ajout des paramètres liés aux informations démographiques sur les liens d’entrée des répondants est la meilleure manière d’améliorer votre taux de conversion. Si vous n’avez pas encore complètement défini le profil de vos répondants selon les qualifications standards de Lucid Marketplace, votre responsable de la réussite client peut vous aider au sujet des qualifications les plus fréquemment utilisées.

Veuillez consulter la section Paramètres démographiques pour obtenir des informations techniques sur l’ajout de paramètres de qualification sur les liens d’entrée.

Contrôle de l’expérience du répondant Dans certains cas, il vous faudra peut-être limiter la durée des enquêtes disponibles ou définir un CPI minimal pour les enquêtes auxquelles vos répondants participent. En définissant des limites à l’aide de la variable maximale de la LOI ou de la variable minimale du CPI, les opportunités d’enquêtes qui ne correspondent pas aux limites spécifiées seront éliminées. Veuillez procéder avec prudence lorsque vous définissez ces variables puisqu’elles limitent le nombre d’opportunités mises à disposition des répondants, réduisant donc l’efficacité de votre intégration.

Page intermédiaire Même s'il est possible d’envoyer par e-mail un lien d’entrée directement à vos répondants, nous vous conseillons vivement de construire plutôt une page d’accueil (ou intermédiaire) pour les répondants. Cela vous permettra d’analyser le trafic, de surveiller la fréquence des visites des répondants et de limiter les utilisateurs lorsque cela est nécessaire.

Empêcher les sessions simultanées Les répondants qui ouvrent de multiples sessions simultanément peuvent rencontrer des erreurs de redirection dues au conflit des cookies des navigateurs. Vous devez développer votre intégration de sorte que les répondants ne puissent pas ouvrir de multiples sessions simultanément. Par exemple, vous pouvez empêcher les utilisateurs d'ouvrir les liens d’entrée dans plusieurs onglets en désactivant le bouton du lien d’entrée pendant 15 secondes après qu'un utilisateur ait cliqué dessus.

Essais quotidiens par répondant Nous vous recommandons de limiter le nombre de fois où les utilisateurs peuvent essayer les sessions de monétisation chaque jour, surtout pour les utilisateurs qui viennent de s'inscrire, les utilisateurs dont les réponses n'ont pas pu être acceptées récemment, et les utilisateurs qui ont déjà été éliminés ce jour-là.

Surveillance des résultats et de la qualité du répondant Chaque fois que vous envoyez un répondant sur la marketplace, nous vous recommandons de contrôler si le répondant vous est renvoyé vers le lien « Enquête terminée », « Enquête annulée », ou s'il ne vous est pas renvoyé. Nous vous conseillons de revoir ces résultats régulièrement pour chaque répondant. Si vous êtes un fournisseur affilié ou que vous recrutez des utilisateurs à partir de multiples sources, nous vous recommandons de contrôler également les résultats en définissant la source de chaque répondant. Cela vous permettra de déterminer quels répondants et sources sont les plus intéressants.

Les statuts qui ont dû être modifiés à cause de mauvaises réponses doivent également être suivis et surveillés régulièrement. Souvent, les fournisseurs découvrent qu'une augmentation soudaine du nombre de statuts modifiés peut être attribuée à une source ou à un groupe spécifique de répondants. S'ils viennent à poser problème pour votre intégration, vous devez réagir en limitant ou en bloquant l’accès aux répondants ou sources de répondants incriminés.

Obtenir de l’aide Lucid s’engage à vous aider à réussir une intégration efficace. Veuillez nous tenir informés de l’évolution de votre mise en œuvre pour que nous puissions vous porter assistance, à vous et votre équipe.

N’hésitez pas à nous contacter pour toute question ou préoccupation, avant, pendant et après le processus de mise en œuvre ; nous nous ferons un plaisir de vous répondre.

Équipe d'intégration de Lucid : [email protected]

Pour toute demande relative aux comptes professionnels et à la facturation, veuillez contacter votre responsable réussite client.

Partenaires de monétisation

© 2018 Lucid Holdings, LLC. Tous droits réservés.