Docs/Installation/Embed / WebView

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

  1. WebView loads the embed and receives adquest:ready.
  2. Host posts adquest:init with public API key, external user id, and participant token.
  3. Optional: post adquest:navigate with { 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.