Quest evidence
Multi-step evidence
API type: multi_step. Own-platform only. One reward after every required step is verified.
On this page
What you do for each step
| Step | You do |
|---|---|
| Reach a target (condition) | Report the step’s activity from your server. Facts after the step unlocks count toward its goal. |
| Custom outcome, URL callback | Submit the step. AdQuest checks your URL with a signed request that also names step_key, execution_id and steps_version. |
| Custom outcome, manual review | Submit the participant’s evidence for the step. A reviewer decides. |
| Streak | Report the step’s daily activity from your server. |
| Watch video, View banner, Survey, Visit link | Send start, click or answers for the step, as for a single quest. |
| Profile, Referral | As for a single quest: a fresh participant session with the profile, or a reported signup. |
Submit a step — client from the SDK
await client.startQuest(questId, { requiresTimer: false });
const execution = await client.getQuestExecution(questId);
// A manual-review step: the participant's evidence.
await client.submitQuestStepEvidence(questId, "receipt", { evidence: participantEvidence });A sequential quest refuses a step that is not unlocked yet. The quest settles once, after every required step is verified; a complete request before that returns MULTI_STEP_REQUIRED.
Check before publishing
- Report a fact before a step unlocks and check that it does not count.
- Resubmit a verified step: nothing changes.
- Leave an optional step undone: the reward still pays.
- Participants who started before a new version was published keep their steps.