Overview
What the AdQuest SDK embeds and how lottery-first quests fit together.
AdQuest is a lottery-first engagement SDK. Hosts embed a branded widget so users can earn tokens through quests, buy lottery tickets, and claim rewards — without leaving the host experience.
What you get
- Hosted embed at
https://sdk.adquest.io/{publicId}for iframe and WebView hosts - React components (
AdQuestWidget,QuestWidget) for web apps - Headless client for server-assisted flows and custom UI
- Theme / branding loaded from platform public config
Core concepts
| Concept | Meaning |
|---|---|
| Platform | Your AdQuest publisher/app record with public_id, API key, and secret |
| Participant | An end user identified by external_user_id |
| Participant token | Short-lived JWT minted by your backend with the platform secret |
| Tokens | In-widget currency earned from quests and spent on lottery entries |
| Quests | Completables (video, survey, and custom flows) that award tokens / gifts |
Recommended path
- Create a platform in the dashboard and copy
public_id, API key, and secret. - Mint participant sessions on your server.
- Embed the hosted SDK or mount
AdQuestWidget. - Theme the skin in Theme Studio.
- Create quests and lotteries, then measure completion and entries.
Continue with Quickstart.