Intégration de plateformes tierces au panel WeJot

Public : plateformes d’enquête ou d’échantillon qui envoient leurs propres participants vers des tâches du panel WeJot Mis à jour : 2026-10-30

1. Modèle d’intégration

L’intégration d’une plateforme tierce est un flux différent du lien d’enquête externe qu’un chercheur crée lui-même.

Déroulement :

1. WeJot fournit un lien d’entrée de tâche avec un token de déploiement.
2. La plateforme dirige le participant vers ce lien. La page WeJot affiche son code unique.
3. La plateforme enregistre ce code dans son enquête.
4. À la fin, la plateforme redirige vers une URL de statut WeJot selon le résultat.
5. WeJot enregistre l’état final et affiche la page de résultat.

Si vous êtes chercheur et souhaitez lancer une enquête externe sur le panel WeJot, consultez Liens d’enquêtes externes pour le panel WeJot.

2. Avant de commencer

• La plateforme peut enregistrer le code de chaque participant et le renvoyer tel quel lors de la redirection finale.
• La plateforme peut configurer des URL de redirection différentes selon le résultat.
• Les URL de redirection utilisent HTTPS.
• Effectuez un test complet avec une tâche de test WeJot avant de passer en production.
• N’exposez pas le code sur des pages publiques, dans les journaux ou dans un espace accessible aux autres participants.

3. Transmission du code participant

WeJot génère le code unique lorsque le participant entre dans la tâche. À l’ouverture de l’enquête externe, WeJot ajoute automatiquement responseCode=<code> à l’URL, ainsi que le paramètre de suivi agentPID.

La plateforme doit lire et enregistrer responseCode à l’entrée, puis le renvoyer tel quel dans code à la fin. Si la plateforme ne peut pas lire les paramètres d’URL, ajoutez au début une question texte obligatoire sur une ligne comme solution de repli, dans laquelle le participant colle le code affiché par WeJot.

responseCode et agentPID sont ajoutés par WeJot. La plateforme ne doit pas les supprimer ni les écraser. code doit contenir la valeur de responseCode, et non l’ID de réponse, l’ID de questionnaire ou l’ID utilisateur de la plateforme.

Encodez le code en URL avant de l’ajouter au callback.

4. Quatre URL de callback de statut

Production :

Terminé :
https://wj.pro/api/sample/task/external/status?result=complete&code={responseCode}&taskId={agentPID}

Quota atteint :
https://wj.pro/api/sample/task/external/status?result=overquota&code={responseCode}&taskId={agentPID}

Filtré :
https://wj.pro/api/sample/task/external/status?result=screened&code={responseCode}&taskId={agentPID}

Qualité refusée :
https://wj.pro/api/sample/task/external/status?result=quality&code={responseCode}&taskId={agentPID}

4.1 Paramètres

taskId est facultatif. S’il est présent, utilisez la valeur de agentPID pour faciliter le diagnostic par WeJot.

4.2 Résultats

complete passe toujours par la vérification des quotas WeJot. Si la tâche WeJot est déjà complète, le résultat est traité comme un quota atteint.

5. Étapes de configuration

1. Contactez WeJot pour activer l’intégration et obtenir une tâche de test ainsi qu’un lien d’entrée.
2. Ajoutez la collecte du code participant dans votre enquête et assurez-vous que chaque code est enregistré.
3. Configurez quatre URL de redirection pour terminé, quota atteint, filtré et refus qualité.
4. Placez le code dans le paramètre code et encodez-le en URL.
5. Testez les quatre résultats avec la tâche de test et vérifiez les états correspondants dans les données WeJot.
6. Passez à la tâche et au domaine de production après validation.

6. Page de résultat et idempotence

• Les quatre résultats renvoient une page destinée au participant. Le résultat terminé affiche la carte de récompense ; les trois autres affichent la page de fin correspondante.
• Les callbacks répétés avec le même code sont idempotents et ne dupliquent ni les comptages, ni les quotas, ni les récompenses.
• Si le participant a déjà validé la fin sur la page WeJot, un callback ultérieur est traité comme déjà soumis et ne modifie plus le résultat.
• Un code invalide ou absent, ou un result inconnu, renvoie une page d’avertissement sans modifier la réponse.

7. Questions fréquentes

Le callback indique que le code est invalide

Vérifiez que code est le code affiché sur la page WeJot, et non l’ID de réponse ou l’ID utilisateur de votre plateforme. Le code doit correspondre à la tâche et au participant.

Peut-on omettre taskId ?

Oui. Les codes sont uniques au niveau global et WeJot retrouve la tâche avec le code. taskId ne sert qu’au diagnostic.

Un callback répété génère-t-il une seconde récompense ?

Non. Les callbacks répétés avec le même code sont idempotents.

La page de résultat ne s’ouvre pas

Vérifiez d’abord code et result, puis confirmez que la plateforme utilise le domaine de callback du bon environnement. Si le problème persiste, contactez le support WeJot.

8. Liste de vérification

• La plateforme dispose du lien de la tâche de test.
• Le participant voit le code sur la page WeJot.
• L’enquête enregistre le code et le renvoie dans code.
• Les quatre URL sont configurées avec complete, overquota, screened et quality.
• Chaque résultat a été testé et apparaît correctement dans les données WeJot.
• Un callback répété a été testé sans doublon de réponse ni de récompense.
• Le domaine et la tâche de production sont configurés avant le lancement.