Redirect Handling
Who this is for: Supply integrators. When to use it: when a respondent finishes (or exits) a survey and is sent back to you. What happens next: you'll classify each session outcome and reconcile correctly.
When a respondent leaves the survey, Zamplia redirects them back to your return URL carrying the participant identifier and an outcome status. Use these to credit, screen out, or retry the respondent.
Typical outcomes
| Outcome | Meaning | Your action |
|---|---|---|
| Complete | Respondent finished and qualified | Credit the respondent; counts toward delivery |
| Terminate / Screenout | Did not qualify | Do not credit; optionally offer another survey |
| Overquota | Matched a full quota cell | Do not credit; route elsewhere |
| Quality / Security | Failed an integrity check | Do not credit; review traffic source |
Treat the redirect as a signal, not the final word. Always confirm the authoritative status with reconciliation before crediting at scale.
Reconcile to confirm
- Supply: confirm outcomes with
GetReconciliation. - Demand: confirm participant outcomes with
reconcileParticipantIds.
Integrity
Validate the redirect's authenticity (e.g. HMAC signing where applicable) so outcomes can't be spoofed. See the HMAC Validation guide in the sidebar.
Read end-to-end routing in Traffic Flow, and how to act on failures in Error Handling.