Embed / WebView
Hosted Universal WebView SDK for native, mobile, and game hosts via postMessage bridge.
Native hosts should prefer the hosted embed instead of shipping React inside the app binary.
Embed URL
https://sdk.adquest.io/{publicId}?host=1
Load it in a full-screen WebView. Keep host navigation chrome outside the WebView when possible.
Init sequence
- WebView loads the embed and receives
adquest:ready. - Host posts
adquest:initwith public API key, external user id, and participant token. - Optional: post
adquest:navigatewith{ view: "quests" | "lotteries" }.
Participant tokens on mobile
Mint tokens on your game/app backend. Short TTLs are expected — refresh on authRequired.
Bridge package
The embed runtime uses the versioned bridge exported from @adquest/sdk (BRIDGE_VERSION, postToHost, receiveBridgeMessage). Hosts using the hosted URL do not need to call these APIs directly.
See also Quickstart and Authentication.