Skip to main content
App Dynamic Links combine two behaviors behind one URL: open an already-installed app, and recover the original destination after a store install. The native SDK is required for deferred deep linking and for joining the store tap to first open. It is not required for the OS to open an already-installed app. SDK JSON resolve (and any hand-rolled format=json client) must send a Dynamic Link API key. Browser 302s do not. With the SDK, a Dynamic Link that sends a user through the store recovers app_url on first open and joins that open to the same click_id as the store tap.

Association (always)

Dashlink hosts assetlinks.json and the Apple association file on the Dynamic Link domain. The app must still declare that host. See App association.

JSON resolve (any client)

When the OS delivers the short URL, or after the SDK recovers it from Play referrer / pasteboard:
JSON resolve that writes tracking requires a Dynamic Link API key (dlk_sdk_…, header only). REST keys (dlk_live_) are rejected. Browser 302s stay public. A 401 means the key is missing, wrong kind, revoked, expired, or bound to another organization — no app_open / deferred_open is published. Replay of the same click_id still returns app_url but does not publish a second deferred_open. Optional query (the SDKs send these): The body keeps app_url, destination_url, fallback_url, outcome, platform, and adds click_id, is_deferred, match_type, and UTM fields. outcome is app_open, deferred_open, or deferred_miss. JSON resolve never 302s to the store. The store 302 is the click. deferred_open is an outcome on that same click_id, not a second campaign click.

SDKs

Install, lifecycle, deferred recovery, and tracking join live on the platform pages. This page stays the routing vs deferred map and the JSON resolve contract. Sample apps and changelogs stay in the GitHub repos. All clients need a Dynamic Link API key (dlk_sdk_…) from Settings → API Keys before configure / getDynamicLink. See API keys.
  • Android — Dashlink.configure then getDynamicLink; deferred via Play Install Referrer. See Android SDK.
  • iOS — DynamicLinks.configure, handleUniversalLink, and performDeferredCheckIfNeeded; deferred via pasteboard. See iOS SDK.