Integration von Drittanbieter-Plattformen in die WeJot-Panel

Zielgruppe: Umfrage- oder Sample-Plattformen, die eigene Teilnehmende an Aufgaben der WeJot-Panel senden Aktualisiert: 2026-10-30

1. Integrationsmodell

Die Integration einer Drittanbieter-Plattform ist ein anderer Ablauf als ein externer Umfragelink, den ein Forschender selbst erstellt.

Der Ablauf:

1. WeJot stellt einen Aufgabenlink mit Deploy-Token bereit.
2. Die Plattform leitet Teilnehmende zu diesem Link. Auf der WeJot-Aufgabenseite wird der individuelle Antwortcode angezeigt.
3. Die Plattform speichert diesen Code in ihrer Umfrage.
4. Am Ende leitet die Plattform je nach Ergebnis auf eine WeJot-Status-URL weiter.
5. WeJot speichert den Endstatus und zeigt die Ergebnisseite an.

Wenn Sie als Forschender eine Umfrage einer Drittanbieter-Plattform über die WeJot-Panel starten möchten, lesen Sie Externe Umfragelinks für die Panel.

2. Vorbereitung

• Die Plattform kann den Antwortcode jedes Teilnehmenden speichern und beim Abschluss unverändert zurückgeben.
• Die Plattform kann für unterschiedliche Ergebnisse unterschiedliche Weiterleitungs-URLs konfigurieren.
• Weiterleitungs-URLs verwenden HTTPS.
• Führen Sie mit einer Testaufgabe von WeJot einen vollständigen Test durch, bevor Sie in den Produktivbetrieb wechseln.
• Der Antwortcode darf nicht auf öffentlichen Seiten, in Logs oder an für andere Teilnehmende zugänglichen Stellen erscheinen.

3. Antwortcode übergeben

WeJot erzeugt den individuellen Antwortcode beim Eintritt in die Aufgabe. Beim Öffnen der Drittanbieter-Umfrage hängt WeJot automatisch responseCode=<Code> an die URL an, zusammen mit dem Tracking-Parameter agentPID.

Die Plattform sollte responseCode beim Eintritt lesen und speichern und am Ende unverändert als code zurückgeben. Kann die Plattform URL-Parameter nicht lesen, dient eine Pflichtfrage vom Typ einzeiliger Text am Anfang als Fallback, in die Teilnehmende den Code von der WeJot-Aufgabenseite kopieren.

responseCode und agentPID werden von WeJot angehängt. Die Plattform darf sie nicht entfernen oder überschreiben. code muss der Wert von responseCode sein, nicht die Response-ID, Antwort-ID oder User-ID der Plattform.

URL-kodieren Sie den Code, bevor Sie ihn an die Callback-URL anhängen.

4. Vier Status-Callback-URLs

Produktion:

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

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

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

Qualität abgelehnt:
https://wj.pro/api/sample/task/external/status?result=quality&code={responseCode}&taskId={agentPID}

4.1 Parameter

taskId ist optional. Wenn vorhanden, verwenden Sie den Wert von agentPID, damit WeJot leichter diagnostizieren kann.

4.2 Ergebnisse

complete durchläuft weiterhin die Quotenprüfung von WeJot. Ist die WeJot-Aufgabe bereits voll, wird das Ergebnis als Quote voll behandelt.

5. Einrichtung

1. Kontaktieren Sie WeJot, um die Drittanbieter-Integration freizuschalten und eine Testaufgabe sowie einen Aufgabenlink zu erhalten.
2. Ergänzen Sie die Erfassung des Antwortcodes in Ihrer Umfrage und stellen Sie sicher, dass jeder Code gespeichert wird.
3. Konfigurieren Sie vier Weiterleitungs-URLs für abgeschlossen, Quote voll, herausgefiltert und Qualität abgelehnt.
4. Übergeben Sie den Antwortcode im Parameter code und URL-kodieren Sie ihn.
5. Testen Sie alle vier Ergebnisse mit der Testaufgabe und prüfen Sie die entsprechenden Status in den WeJot-Antwortdaten.
6. Wechseln Sie erst nach erfolgreichem Test auf Produktivaufgabe und Produktivdomain.

6. Ergebnisseite und Idempotenz

• Alle vier Ergebnisse liefern eine Ergebnisseite für Teilnehmende. Bei complete erscheint die Belohnungskarte, bei den anderen drei die jeweilige Abschlussseite.
• Wiederholte Callbacks mit demselben Antwortcode sind idempotent und erzeugen keine doppelten Rückläufe, Quotenverbräuche oder Belohnungen.
• Wenn Teilnehmende die Aufgabe bereits auf der WeJot-Aufgabenseite abgeschlossen haben, wird ein später eintreffender Endstatus-Callback als bereits abgeschlossen behandelt und ändert das Ergebnis nicht erneut.
• Ein ungültiger oder fehlender Code oder ein unbekannter result-Wert führt zu einer Hinweisseite, ohne den Antwortstatus zu ändern.

7. Häufige Fragen

Der Callback meldet einen ungültigen Antwortcode

Prüfen Sie, ob code der auf der WeJot-Aufgabenseite angezeigte Antwortcode ist und nicht die Antwort-ID oder User-ID Ihrer Plattform. Der Code muss zur Aufgabe und zur Person passen.

Kann taskId weggelassen werden?

Ja. Antwortcodes sind global eindeutig, und WeJot findet die Aufgabe über den Code. taskId dient nur der Fehlersuche.

Erzeugt ein doppelter Callback eine doppelte Belohnung?

Nein. Wiederholte Callbacks mit demselben Antwortcode sind idempotent.

Die Ergebnisseite öffnet sich nicht

Prüfen Sie zuerst code und result und dann, ob Ihre Plattform die Callback-Domain der richtigen Umgebung verwendet. Wenn es weiterhin fehlschlägt, kontaktieren Sie den WeJot-Support.

8. Checkliste

• Die Plattform hat den Aufgabenlink der Testaufgabe erhalten.
• Teilnehmende sehen den Antwortcode auf der WeJot-Aufgabenseite.
• Die Umfrage speichert den Code und gibt ihn als code zurück.
• Alle vier Callback-URLs sind mit complete, overquota, screened und quality konfiguriert.
• Jedes Ergebnis wurde getestet und erscheint korrekt in den WeJot-Antwortdaten.
• Ein doppelter Callback wurde getestet und erzeugt keine doppelten Rückläufe oder Belohnungen.
• Produktivdomain und Produktivaufgabe sind vor dem Start konfiguriert.