Skip to documentation
AdQuestDocs

Survey evidence

API type: survey. Collect structured responses without a media watch timer.

On this page

Collect every required response

Start with requiresTimer: false and call session.getQuestions(). Render all required questions and collect the participant’s answers. Surveys accept supported responses rather than requiring the advertiser’s preferred opinion; validation and any configured verification still apply.

Submit a multi-question survey
import type { SurveyAnswerInput } from "@adquest/sdk";

const session = await client.startQuest(questId, { requiresTimer: false });
const questions = await session.getQuestions();
// Your form must populate these from the participant's actual responses.
const answers: SurveyAnswerInput[] = questions.map((question) => ({
  questionId: question.id,
  optionId: selectedOptions[question.id],
}));
const result = await session.complete(answers);

Verify response handling

  • Block submission when required responses are missing.
  • Check multi-question navigation, answer preservation and free-text validation where enabled.
  • Respect validation or fraud-check rejection; do not silently change the user’s answers to pass a check.
  • Inspect answer distribution in quest analytics after a real completion.

Next steps

Something unclear, missing or wrong here? Tell us