Skip to main content
Deferred Deep Links (DDLs) provide the most seamless way to guide users from your funnel to your mobile application after purchase, eliminating the need for manual login or authentication. In this guide we’ll tell you how to configure deep links with AppsFlyer or Adjust.
You’ll need an active AppsFlyer or Adjust account to implement deep links.
Deferred deep links (DDLs) enable you to pass information (such as user identifiers or tokens) through a single link that can:
  • Redirect new users to the App Store if the app isn’t installed.
  • Automatically open the app if it’s already installed.
  • Deliver metadata (like authentication tokens) into the app on first launch, even after installation.
This creates a frictionless post-purchase experience with no login steps required.

​
Prerequisites

Before setting up deep links, ensure you have:
  • AppsFlyer account with OneLink configured, or an Adjust account.
  • Mobile app with the AppsFlyer or Adjust SDK integrated.
  • FunnelFox funnel ready for button configuration.

​
Configuration

Setting up deferred deep links requires configuring both your funnel and mobile app to pass and receive user identification data.

​
1. Funnel setup

  • AppsFlyer
  • Adjust
1

Generate AppsFlyer OneLink

  1. Log into your AppsFlyer dashboard.
  2. Create a new OneLink or use an existing one.
  3. Copy your OneLink URL (format: https://yourapp.onelink.me/example).
Learn about creating deep links in AppsFlyer.
2

Create button element

  1. In your funnel, add a Button element where you want the app redirect.
  2. Configure the button with External Link action.
  3. (Optional) Mark this button as CTA for analytics tracking
3

Configure deep link URL

Set the button link with ffkey query parameter using user variables:
https://yourapp.onelink.me/example?ffkey={{user.id}}
You can use other identifiers like {{user.session_id}} or custom properties depending on your authentication flow.
Your web configuration is now complete! Next, you’ll need to handle these links in your mobile application.

​
2. Mobile app setup

The goal is to get the user ID into the app and use it for identification (e.g., with Adapty).
  • AppsFlyer
  • Adjust
When the app isn’t installed, AppsFlyer SDK will invoke a callback (typically onConversionDataSuccess) with the original link parameters after installation.Set up your mobile app in three steps:
  1. Listen for the callback from AppsFlyer SDK.
  2. Extract ffkey from the conversion data.
  3. Identify/authenticate the user using the extracted key.
For complete implementation details, refer to the AppsFlyer documentation.Code examples:
  • Swift
  • Kotlin
  • React Native
import AppsFlyerLib

class AppsFlyerDelegateHandler: NSObject, AppsFlyerLibDelegate {
    static let shared = AppsFlyerDelegateHandler()

    func onConversionDataSuccess(_ data: [AnyHashable : Any]) {
        guard let status = data["af_status"] as? String, 
              status == "Non-organic" else { return }

        if let sessionId = data["ffkey"] as? String {
        // Identify user using the AppsFlyer DDL ffkey from conversion data.
        }
    }

    func onConversionDataFail(_ error: Error) {
        print("AppsFlyer DDL failed: \(error)")
    }
}
⌘I