第三方平臺接入WeJot樣本庫指引

適用對象：把自有受訪者引導到WeJot樣本任務的三方問卷或樣本平臺更新日期：2026-10-30

1. 接入方式

第三方平臺接入和研究員自助外鏈投放是兩條不同的鏈路。

項目	研究員外鏈投放	第三方平臺接入
發起方	研究員在WeJot對話裡建立	第三方平臺接入
受訪者來源	趣賺派樣本庫	平臺自有受訪者
結果識別	填答碼 + 任務頁手動提交	`code` + `result` 狀態回傳

平臺接入的完整鏈路如下：

WeJot向平臺提供帶投放 token 的任務入口連結。
平臺把受訪者引導到該連結，受訪者在WeJot任務頁看到自己的專屬填答碼。
平臺在自己的問卷裡保存這串填答碼。
問卷結束後，平臺按最終結果跳轉到WeJot的狀態回傳連結。
WeJot記錄終態，並向受訪者展示結果頁。

如果你是研究員，想把三方問卷投放到WeJot樣本庫，請閱讀《第三方外部連結投放至WeJot樣本庫設定指南》。

2. 接入前準備

平臺能夠保存每位受訪者的填答碼，並在結束跳轉時原樣帶回。
平臺支援按不同結束結果設定不同的跳轉網址。
跳轉網址使用 HTTPS。
平臺使用WeJot提供的測試任務完成一輪聯調後，再切到正式任務。
平臺不要把填答碼暴露在公開頁面、日誌或可被其他受訪者存取的位置。

3. 填答碼怎麼傳

WeJot會在受訪者進入任務頁時產生專屬填答碼，並在開啟三方問卷時自動追加 responseCode=<填答碼> 參數（同時保留 agentPID 追蹤參數）。

平臺應在問卷入口讀取並保存 responseCode，結束時把它原樣帶回 code。如果平臺無法讀取 URL 參數，再在問卷開頭放一道必填單行文字題，讓受訪者從WeJot任務頁複製貼上作為備援。

responseCode 和 agentPID 由WeJot自動追加，平臺不要刪除或覆蓋。code 必須帶回 responseCode 的值，不是平臺自己的 response ID、答卷 ID 或使用者 ID。

回傳前請先對填答碼做 URL 編碼，避免特殊字元破壞連結。

4. 四個狀態回傳連結

正式環境：


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

超配額：
https://wj.pro/api/sample/task/external/status?result=overquota&code={responseCode}&taskId={agentPID}

甄選淘汰：
https://wj.pro/api/sample/task/external/status?result=screened&code={responseCode}&taskId={agentPID}

品質剔除：
https://wj.pro/api/sample/task/external/status?result=quality&code={responseCode}&taskId={agentPID}

4.1 參數

參數	必填	說明
`code`	是	WeJot自動傳入的 `responseCode`，即受訪者專屬填答碼
`result`	是	`complete`、`overquota`、`screened`、`quality`
`taskId`	否	WeJot自動傳入的 `agentPID`（任務 ID），建議原樣帶回

taskId 可以不帶；帶上時請使用 agentPID 的值，方便WeJot排查。

4.2 四種結果

`result`	平臺情境	WeJot處理
`complete`	受訪者完成整份問卷	進入WeJot配額歸集；符合條件時計入有效回收並進入獎勵流程
`overquota`	平臺側配額已滿	記為超配額終止，不計有效回收，不產生獎勵
`screened`	受訪者未通過甄選	記為甄選淘汰，不計有效回收，不產生獎勵
`quality`	平臺判定答卷品質不合格	記為品質剔除，不計有效回收，不產生獎勵

complete 仍會經過WeJot側配額檢核。如果WeJot任務已經收滿，會按超配額結果處理。

5. 設定步驟

聯絡WeJot開通第三方平臺接入，取得測試任務和任務入口連結。
在平臺問卷中增加填答碼收集邏輯，確保每位受訪者的填答碼都能被保存。
在平臺的結束邏輯裡設定四個跳轉網址，分別對應完成、超配額、甄選淘汰和品質剔除。
跳轉時把填答碼放進 code 參數，並做 URL 編碼。
用測試任務把四種結果各走一遍，確認WeJot回收資料裡出現對應狀態。
聯調通過後再切換到正式任務和正式網域。

6. 結果頁與冪等

四種結果都會返回面向受訪者的結果頁。完成態展示獎勵卡片；其餘三種展示對應的結束頁。
同一個填答碼重複回傳按冪等處理，不會重複計回收、重複扣配額或重複發獎。
受訪者已經在WeJot任務頁提交完成後，再到達的終止回傳會按已提交狀態處理，不會重複改變結果。
填答碼無效、缺失或結果參數無法識別時，會返回提示頁，不會修改答卷狀態。

7. 常見問題

回傳後提示填答碼無效

確認傳給 code 的是WeJot任務頁展示的填答碼，而不是平臺自己的答卷 ID 或使用者 ID。填答碼需要和任務、受訪者對應。

回傳連結裡可以不帶 taskId 嗎？

可以。填答碼全球唯一，WeJot會用填答碼反查任務。taskId 只用於排查。

重複回傳會重複發獎嗎？

不會。同一個填答碼的回傳按冪等處理。

結果頁打不開怎麼辦？

先確認 code 和 result 參數正確，再確認平臺使用的是對應環境的狀態回傳網域。如果仍然打不開，請聯絡WeJot技術支援。

8. 聯調檢查清單

平臺已拿到測試任務入口連結。
受訪者能在WeJot任務頁看到填答碼。
平臺問卷能保存填答碼，並在結束跳轉時帶回 code。
四個回傳連結都已設定，result 值分別為 complete、overquota、screened、quality。
四種結果各跑通一次，WeJot回收資料裡能看到對應狀態。
重複回傳一次，確認沒有重複計回收或重複發獎。
正式上線前已切換到正式網域和正式任務。