Skip to documentation
AdQuestDocs

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

StepYou 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 callbackSubmit the step. AdQuest checks your URL with a signed request that also names step_key, execution_id and steps_version.
Custom outcome, manual reviewSubmit the participant’s evidence for the step. A reviewer decides.
StreakReport the step’s daily activity from your server.
Watch video, View banner, Survey, Visit linkSend start, click or answers for the step, as for a single quest.
Profile, ReferralAs 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.

Next steps

Something unclear, missing or wrong here? Tell us