Skip to main content
The React Native package calls the Android and iOS SDKs. It does not replace app association. Routing still needs an autoVerify intent-filter and an applinks: host in the native project. The package forwards live links and recovers the original destination on first open after a store install, using the native Android and iOS SDKs.

When you need the SDK

getDynamicLink() and handleUniversalLink(url) stay split, matching the native SDKs. On Android, getDynamicLink() also reads the current activity intent, so a cold start from an App Link is covered there. On iOS, getDynamicLink() is only the pasteboard check. A live Universal Link must be passed to handleUniversalLink.

Install

The host app also depends on the native SDKs:
  • Android: implementation("ai.dashlink:dashlink-android:1.0.0")
  • iOS: CocoaPods pod 'Dashlink', '~> 1.0.0' (the React Native podspec already declares this)
Register DashlinkPackage on Android if autolinking does not pick it up. Rebuild the native app after installing the package. JSON resolve requires a Dynamic Link key. REST keys (dlk_live_) are rejected.
  1. Settings → API Keys → Type Dynamic Link.
  2. Call configure before any resolve.
  3. Call setDynamicLinkHosts with the Dynamic Link domain. An empty list lets any https URL with a back-half through.

Association

Declare the Dynamic Link host in AndroidManifest.xml and in Associated Domains. The wrapper cannot invent OS intercept. See App association.

Live taps

Subscribe to React Native Linking and forward every URL.
An installed tap JSON-resolves with deferred=0 and match=direct, returns appUrl, and analytics records app_open.

Deferred first open

Call getDynamicLink() once at startup, after configure and setDynamicLinkHosts.
Android reads Play Install Referrer (match=referrer). iOS reads the pasteboard (match=pasteboard) and may show the system paste banner once. Both publish deferred_open joined to the store tap’s click_id. An empty or foreign value is a miss and is consumed once. Editor and web bundles have no native module. configure throws until the app is rebuilt with the native package linked.

Tracking

The store redirect is the click. SDK JSON resolve is an outcome on that click when click_id matches, not a second campaign click. Fields on the result are appUrl, destinationUrl, fallbackUrl, clickId, isDeferred, matchType, outcome, utmSource, utmMedium, utmCampaign, and shortUrl.

Test on a device

1

Uninstall the app

A previous install will not re-run deferred recovery.
2

Tap a Dynamic Link

The device should reach the store, not the home screen.
3

Install a build that includes the wrapper

The host and the API key must already be configured.
4

Open the app

First open must land on appUrl, and analytics must show deferred_open for the same click_id.
If an installed tap still opens the browser, the problem is almost always app association, not the wrapper.