A deferred deep link sends a user to a place in your app after routing them via the App Store to install the app first.
How it works
This is how a deferred deep link works:
- The user clicks on an Adjust deep link.
- Adjust’s servers redirect the user to the App Store.
- The user installs your app and opens it.
- Adjust’s servers perform attribution and send the deep link to the Adjust SDK.
- Your app displays its preliminary content, such as onboarding screens and user login, if applicable.
- Your app retrieves the deep link from the Adjust SDK and handles the deep link.
Setup
When you set up Adjust deferred deep linking, you need to disable deferred deep linking in other SDKs in your app. You also need to disable any deep linking setup from other MMPs.
Check out the Facebook deferred deep linking documentation for information about how to configure deep linking with your Facebook campaigns.
There are 2 approaches to set up deferred deep linking in your app:
- Adjust’s servers automatically pass the deferred deep link to the Adjust SDK. When the user opens your app, the Adjust SDK automatically calls the
open(_:options:completionHandler:)method with the deep link. If your app doesn’t have preliminary content (for example: onboarding screens and user login), or if your app already handles this content before opening the deep link, then no further configuration is required, and you can skip the rest of this section. - If your app has preliminary content (for example: onboarding screens and user login), but your app doesn’t already handle this before handling the deep link, then you can add a deferred deep link listener.
Set up a deferred deep link listener
- Set up a delegate callback for deferred deep linking. If you have already configured attribution callbacks, you can skip this step.
class AppDelegate: UIResponder, UIApplicationDelegate, AdjustDelegate {}@interface AppDelegate : UIResponder <UIApplicationDelegate, AdjustDelegate>- If you haven’t already done so, create an instance of the
ADJConfigclass and set a delegate on theADJConfigobject in your app delegate. You need to set the delegate inADJConfigbefore initializing the SDK.
let yourAppToken = "{YourAppToken}"let environment = ADJEnvironmentSandboxlet adjustConfig = ADJConfig( appToken: yourAppToken, andEnvironment: environment)adjustConfig?.delegate = self
// ...
Adjust.initSdk(adjustConfig)ADJConfig *adjustConfig = [[ADJConfig alloc] initWithAppToken:@"{YourAppToken}" andEnvironment:ADJEnvironmentSandbox];[adjustConfig setDelegate:self];
// ...
[Adjust initSdk:adjustConfig];- Add the
adjustDeferredDeeplinkReceiveddeferred deep link callback method to the delegate. The Adjust SDK calls this method after receiving a deferred deep link.- Set your deep link handling code.
- Set the return value of the
adjustDeferredDeeplinkReceivedmethod to true or false. This indicates whether you want the Adjust SDK to call theopen(_:options:completionHandler:)method to open the deep link after your deep link handling code runs.
func adjustDeferredDeeplinkReceived(_ deeplink: URL?) -> Bool { // add your code below to handle deep link // (for example, show onboarding screens, then open deep link content) // deeplink object contains the deep link
return false}- (BOOL)adjustDeferredDeeplinkReceived:(NSURL *)deeplink { // add your code below to handle deep link // (for example, show onboarding screens, then open deep link content) // deeplink object contains the deep link
return NO;}Set up Adjust LinkMe
- (void)enableLinkMe;Discuss with your marketing team whether you need to implement LinkMe in your app.
Adjust’s LinkMe solution is an optional feature that ensures robust deferred deep linking performance by enabling your app to read deep link information from the device pasteboard.
The Adjust SDK checks the pasteboard when a user opens the app for the first time. The device displays a dialog asking if the user wants to allow the app to read the pasteboard.
When a user clicks on a LinkMe URL they have the option to copy the link information to their system pasteboard. You can use the Adjust SDK to read the system pasteboard for deep link information. If deep link information is present, the Adjust SDK forwards the user to the correct page in your app.
To enable pasteboard checking in your app, call the [ADJConfig enableLinkMe] method.
let yourAppToken = "{YourAppToken}"let environment = ADJEnvironmentSandboxlet adjustConfig = ADJConfig( appToken: yourAppToken, andEnvironment: environment)// ...adjustConfig.enableLinkMe()NSString *yourAppToken = @"{YourAppToken}";NSString *environment = ADJEnvironmentSandbox;ADJConfig *adjustConfig = [[ADJConfig alloc] initWithAppToken:@"{YourAppToken}" andEnvironment:ADJEnvironmentSandbox];/// ...[adjustConfig enableLinkMe];A deferred deep link sends a user to a place in your app after routing them via the App Store to install the app first.
How it works
This is how a deferred deep link works:
- The user clicks on an Adjust deep link.
- Adjust’s servers redirect the user to the App Store.
- The user installs your app and opens it.
- Adjust’s servers perform attribution and send the deep link to the Adjust SDK.
- Your app displays its preliminary content, such as onboarding screens and user login, if applicable.
- Your app retrieves the deep link from the Adjust SDK and handles the deep link.
Setup
When you set up Adjust deferred deep linking, you need to disable deferred deep linking in other SDKs in your app. You also need to disable any deep linking setup from other MMPs.
Check out the Facebook deferred deep linking documentation for information about how to configure deep linking with your Facebook campaigns.
There are 2 approaches to set up deferred deep linking in your app:
- Adjust’s servers automatically pass the deferred deep link to the Adjust SDK. When the user opens your app, the Adjust SDK automatically calls the
open(_:options:completionHandler:)method with the deep link. If your app doesn’t have preliminary content (for example: onboarding screens and user login), or if your app already handles this content before opening the deep link, then no further configuration is required, and you can skip the rest of this section. - If your app has preliminary content (for example: onboarding screens and user login), but your app doesn’t already handle this before handling the deep link, then you can add a deferred deep link listener.
Set up a deferred deep link listener
- Set up a delegate callback for deferred deep linking. If you have already configured attribution callbacks, you can skip this step.
class AppDelegate: UIResponder, UIApplicationDelegate, AdjustDelegate {}@interface AppDelegate : UIResponder <UIApplicationDelegate, AdjustDelegate>- If you haven’t already done so, create an instance of the
ADJConfigclass and set a delegate on theADJConfigobject in your app delegate. You need to set the delegate inADJConfigbefore initializing the SDK.
let yourAppToken = "{YourAppToken}"let environment = ADJEnvironmentSandbox as? Stringlet adjustConfig = ADJConfig( appToken: yourAppToken, environment: environment)adjustConfig?.delegate = self
// ...
Adjust.appDidLaunch(adjustConfig)*adjustConfig = [ADJConfig configWithAppToken:@"{YourAppToken}" environment:ADJEnvironmentSandbox];[adjustConfig setDelegate:self];
// ...
[Adjust appDidLaunch:adjustConfig];- Add the
adjustDeeplinkResponsedeferred deep link callback method to the delegate. The Adjust SDK calls this method after receiving a deferred deep link.- Set your deep link handling code.
- Set the return value of the
adjustDeeplinkResponsemethod to true or false. This indicates whether you want the Adjust SDK to call theopen(_:options:completionHandler:)method to open the deep link after your deep link handling code runs.
func adjustDeeplinkResponse(_ deeplink: URL?) -> Bool { // add your code below to handle deep link // (for example, show onboarding screens, then open deep link content) // deeplink object contains the deep link
return false}- (BOOL)adjustDeeplinkResponse:(NSURL *)deeplink { // add your code below to handle deep link // (for example, show onboarding screens, then open deep link content) // deeplink object contains the deep link
return NO;}Set up Adjust LinkMe
@property (nonatomic, assign) BOOL linkMeEnabled;Discuss with your marketing team whether you need to implement LinkMe in your app.
Adjust’s LinkMe solution is an optional feature that ensures robust deferred deep linking performance by enabling your app to read deep link information from the device pasteboard.
The Adjust SDK checks the pasteboard when a user opens the app for the first time. The device displays a dialog asking if the user wants to allow the app to read the pasteboard.
When a user clicks on a LinkMe URL they have the option to copy the link information to their system pasteboard. You can use the Adjust SDK to read the system pasteboard for deep link information. If deep link information is present, the Adjust SDK forwards the user to the correct page in your app.
To enable pasteboard checking in your app, pass a true value to the setLinkMeEnabled method on your ADJConfig object:
let yourAppToken = "{YourAppToken}"let environment = ADJEnvironmentSandbox as? Stringlet adjustConfig = ADJConfig( appToken: yourAppToken, environment: environment)// ...adjustConfig?.linkMeEnabled = trueNSString *yourAppToken = @"{YourAppToken}";NSString *environment = ADJEnvironmentSandbox;*adjustConfig = [ADJConfig configWithAppToken:yourAppToken environment:environment];/// ...[adjustConfig setLinkMeEnabled:YES];setupWebViewJavascriptBridge(function (bridge) { // ... var yourAppToken = yourAppToken; var environment = AdjustConfig.EnvironmentSandbox; var adjustConfig = new AdjustConfig(yourAppToken, environment); adjustConfig.setLinkMeEnabled(true);});