/deeplink

Overview#

A /deeplink URL behaves identically to /redirect when followed through a browser — same two-phase attribution flow, same query parameters, same store redirect logic. The difference is what happens when the device can intercept it:

• /deeplink URLs are listed in the app's AASA / assetlinks file. iOS and Android can open the customer's app directly without ever loading the URL in a browser — your onDeepLink handler fires within ~50 ms of the tap.
• /redirect URLs are not. They always go through the web flow.

Pick per link: /redirect for traditional ad campaigns, /deeplink for influencer / unlock / push / email / other direct links where instant app-open is best.

See the Smart Links & Deeplinking guide for setup (Team ID, SHA-256 fingerprints, app-side intent filters, etc.).

Endpoint#

GET https://YOUR_APP_ID.mobana.ai/deeplink

Or use your custom endpoint: https://yourdomain.com/da/deeplink

Query Parameters#

Identical to /redirect. See /redirect → Query Parameters for the full list (utm_*, data, url, plus any additional params captured as click_params).

Example#

https://YOUR_APP_ID.mobana.ai/deeplink
  ?data={"unlock":"PROMO50"}
  &utm_source=tiktok
  &utm_campaign=influencer_drop

When the user taps this link, the OS opens your app directly (if installed) and your onDeepLink handler receives a DeepLinkEvent with the parsed data, utm, and clickParams. If not installed, the user goes through the App Store / Play Store and the same payload is delivered on first launch via getAttribution().

Custom endpoints#

To serve smart links from your own domain, your reverse proxy must forward both:

• /deeplink* (and the existing /redirect, /find, /conversion, /flows, /ping SDK paths)
• /.well-known/apple-app-site-association and /.well-known/assetlinks.json at the host root (NOT under your /da path prefix)

# Using your custom endpoint
https://yourdomain.com/da/deeplink?data={"unlock":"PROMO50"}

The auto-generated nginx / Apache config templates in App Settings → Custom Endpoint already include both. See the Custom Endpoints guide for details.