The OneLink Developer Hub

Welcome to the OneLink developer hub. You'll find comprehensive guides and documentation to help you start working with OneLink as quickly as possible, as well as support if you get stuck. Let's jump right in!

Getting Started with OneLink

At a glance: OneLink is a single link that apps use to provide the optimal user experience to their users regardless of device, operating system, channel, or platform. This article provides an overview of OneLink benefits, as well as an explanation of the steps needed for basic OneLink setup within the app.

About Onelink


  • Helps marketers engage their users by providing links that work across all owned media marketing channels, including banners, social media posts, QR codes, SMS campaigns, emails, etc.
  • Redirects users to the correct app store (e.g. App Store or Google Play), landing page, or app (if users already have the app installed).
  • Drastically increases user engagements and conversions by deep linking existing users, or deferred deep linking new users, to specific content or a specific experience within the app.

Deep linking and deferred deep linking

Since users may or may not have the mobile app installed, there are three types of deep linking:

Deep linking type


Deep linking

Directly serves personalized content to existing users, who already have the app installed.

Deferred deep linking

Serves personalized content to new or former users, directly after the download, installation and first app launch.

Unified deep linking

API that serves personalized content to both new and existing users (i.e. deep linking and deferred deep linking). Does not support SRN campaigns.

Using OneLink, AppsFlyer supports both deep linking and deferred deep linking methods.

OneLink setup

Setting up a OneLink requires two different personas within an organization to work together, using their own resources:

  • Marketers/product managers: Plan the marketing campaigns and set up the OneLink in the AppsFlyer dashboard.
  • Developers: Configure the app to receive data from the link click, and then launch the app with the requisite personalized user experience (with deep linking and deferred deep linking).

The developer's tasks for OneLink setup in the app include:

  1. Initial app setup
  2. Direct deep linking and/or unified deep linking
  3. Deferred deep linking and/or unified deep linking

Updated 3 months ago

Getting Started with OneLink

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.