Unified Deep Linking (UDL)
UDL privacy protection
For new users, the UDL method only returns parameters relevant to deferred deep linking:
deep_link_value
anddeep_link_sub1
todeep_link_sub10
. If you try to get any other parameters (media_source
,campaign
,af_sub1-5
, etc.), they returnnull
.
UDL flow
- The SDK is triggered by:
- Deferred Deep Linking - using a dedicated API
- Direct Deep Linking - triggered by the OS via Android App Link, iOS Universal Links or URI scheme.
- The SDK triggers the
OnDeepLink
listener, and passes the deep link result object to the user. - The
OnDeepLink
listener uses the deep link result object that includes thedeep_link_value
and other parameters to create the personalized experience for the users, which is the main goal of OneLink.
Check out the Unified Deep Linking docs for Android and iOS.
Considerations:
- Requires AppsFlyer Android SDK V6.1.3 or later.
- Does not support SRN campaigns.
- Does not provide af_dp in the API response.
- onAppOpenAttribution will not be called. All code should migrate to
onDeepLink
.
Implementation:
Important The code implementation for onDeepLink
must be made prior to the initialization code of the SDK.
Example:
const onDeepLinkCanceller = appsFlyer.onDeepLink(res => {
if (res?.deepLinkStatus !== 'NOT_FOUND') {
const DLValue = res?.data.deep_link_value;
const mediaSrc = res?.data.media_source;
const deepLinkSub1 = res?.data.deep_link_sub1; // get up to 10 custom OneLink params
[...]
const deepLinkSub10 = res?.data.deep_link_sub10; // get up to 10 custom OneLink params
console.log(JSON.stringify(res?.data, null, 2));
}
})
appsFlyer.initSdk(
{
devKey: 'K2***********99',
isDebug: false,
appId: '41*****44',
onInstallConversionDataListener: true,
onDeepLinkListener: true // --> you must set the onDeepLinkListener to true to get onDeepLink callbacks
},
(result) => {
console.log(result);
},
(error) => {
console.error(error);
}
);
Updated 25 days ago