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
- Android:
implementation("ai.dashlink:dashlink-android:1.0.0") - iOS: CocoaPods
pod 'Dashlink', '~> 1.0.0'(the React Native podspec already declares this)
DashlinkPackage on Android if autolinking does not pick it up. Rebuild the native app after installing the package.
Dynamic Link API key
JSON resolve requires a Dynamic Link key. REST keys (dlk_live_) are rejected.
- Settings → API Keys → Type Dynamic Link.
- Call
configurebefore any resolve. - Call
setDynamicLinkHostswith the Dynamic Link domain. An empty list lets any https URL with a back-half through.
Association
Declare the Dynamic Link host inAndroidManifest.xml and in Associated Domains. The wrapper cannot invent OS intercept. See App association.
Live taps
Subscribe to React NativeLinking and forward every URL.
deferred=0 and match=direct, returns appUrl, and analytics records app_open.
Deferred first open
CallgetDynamicLink() once at startup, after configure and setDynamicLinkHosts.
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 whenclick_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.