Additional deep link features

Below are additional deep link features for specific use cases.

Direct deep linking

Get the last deep link

+ (void)lastDeeplinkWithCompletionHandler:(nonnull ADJLastDeeplinkGetterBlock)completion;

You can return the last deep link URL passed to the Adjust.processAndResolveDeeplink or Adjust.processDeeplink method by calling the Adjust.lastDeeplinkWithCompletionHandler: method. This returns the last deep link as NSURL.

Swift
Objective-C

1
Adjust.lastDeeplink { lastDeeplink in
2
    if let deeplink = lastDeeplink {
3
        // Handle the deeplink here
4
        print("Last deep link: \(deeplink.absoluteString)")
5
    }
6
}

1
[Adjust lastDeeplinkWithCompletionHandler:^(NSURL * _Nullable lastDeeplink) {
2
    if (lastDeeplink != nil) {
3
        // Handle the deeplink here
4
        NSLog(@"Last deep link: %@", [lastDeeplink absoluteString]);
5
    }
6
}];

Handling Deeplinks with Referrer

An optional referrer URL is used to track source of the deep link or app open for better attribution or reattribution and deep linking. For example, in channels such as SEO or Organic Search, Adjust links are not used directly. If the client’s root domain has Universal Links implemented and triggers an app opening, For such channels, we may have to rely on signals coming from the referrer URL to attribute or reattribute users.

1
func application(_ application: UIApplication,
2
                continue userActivity: NSUserActivity,
3
                restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void) -> Bool {
4

5
    if userActivity.activityType.isEqual(NSUserActivityTypeBrowsingWeb) {
6
          // Pass deep link URL to Adjust in order to potentially reattribute the user
7
          // and to get the URL resolved if it’s a shortened one.
8
         if let incomingURL = userActivity.webpageURL {
9
              if let deeplink = ADJDeeplink(deeplink: incomingURL) {
10
                // If referrer URL is available, add it to the deeplink object
11
                if let referrer = URL(string: "https://example.com") {
12
                    deeplink.setReferrer(referrer)
13
                }
14
                Adjust.processAndResolve(deeplink) { resolveDeeplink in
15
                    // resolvedLink contains either resolved URL (if it was unshortened)
16
                    // or just echoed URL if it was not shortened
17
                }
18
              }
19
          }
20
      }
21
    return true
22
}

1
- (BOOL)application:(UIApplication *)application continueUserActivity:(NSUserActivity *)userActivity restorationHandler:(void (^)(NSArray<id<UIUserActivityRestoring>> *restorableObjects))restorationHandler {
2
    if ([[userActivity activityType] isEqualToString:NSUserActivityTypeBrowsingWeb]) {
3
        // Pass deep link URL to Adjust in order to potentially reattribute the user
4
        // and to get the URL resolved if it’s a shortened one.
5
        ADJDeeplink *deeplink = [[ADJDeeplink alloc] initWithDeeplink:[userActivity webpageURL]];
6
        NSURL *referrer = [NSURL URLWithString:@"https://example.com"];
7
        // If referrer URL is available, add it to the deeplink object
8
        if (referrer) {
9
            [deeplink setReferrer:referrer];
10
        }
11
        [Adjust processAndResolveDeeplink:deeplink
12
                withCompletionHandler:^(NSString * _Nullable resolvedLink) {
13
            // resolvedLink contains either resolved URL (if it was unshortened)
14
            // or just echoed URL if it was not shortened
15
        }];
16
    }
17
    return YES;
18
}

Deferred deep linking

Set up Adjust LinkMe

- (void)enableLinkMe;

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.

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.

Swift
Objective-C

1
let yourAppToken = "{YourAppToken}"
2
let environment = ADJEnvironmentSandbox
3
let adjustConfig = ADJConfig(
4
    appToken: yourAppToken,
5
    environment: environment)
6
// ...
7
adjustConfig.enableLinkMe()

1
NSString *yourAppToken = @"{YourAppToken}";
2
NSString *environment = ADJEnvironmentSandbox;
3
ADJConfig *adjustConfig = [[ADJConfig alloc] initWithAppToken:@"{YourAppToken}"
4
                                            environment:ADJEnvironmentSandbox];
5
/// ...
6
[adjustConfig enableLinkMe];