Resolve short branded links

Adjust’s link shortener solution converts your complex and long links into cleaner and shorter links. The shortened links retain deep link and campaign information, and route users to the app store, if they don’t have your app installed.

Use the method described in this section to resolve your short links.

Set up deep linking in the Adjust SDK

In the Adjust SDK, add support for the following:

Set up the Adjust SDK to resolve short links

+ (void)processAndResolveDeeplink:(nonnull NSURL *)deeplink
            withCompletionHandler:(nonnull ADJResolvedDeeplinkBlock)completion;

Call the processAndResolveDeeplink:completionHandler: method from your AppDelegate to resolve a short Adjust link URL that deep linked users into your app.

Swift
Objective-C

1
func application(_ application: UIApplication, continue userActivity: NSUserActivity, restorationHandler: @escaping ([any UIUserActivityRestoring]?) -> Void) -> Bool {
2
      if userActivity.activityType.isEqual(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
         if let incomingURL = userActivity.webpageURL {
6
              if let deeplink = ADJDeeplink(deeplink: incomingURL) {
7
                  Adjust.processAndResolve(deeplink) { resolveDeeplink in
8
                      // resolvedLink contains either resolved URL (if it was unshortened)
9
                      // or just echoed URL if it was not shortened
10
                  }
11
              }
12
          }
13
      }
14
    return true
15
}

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
        [Adjust processAndResolveDeeplink:deeplink
7
                withCompletionHandler:^(NSString * _Nullable resolvedLink) {
8
            // resolvedLink contains either resolved URL (if it was unshortened)
9
            // or just echoed URL if it was not shortened
10
        }];
11
    }
12
    return YES;
13
}

In case the link you sent to processDeeplink:completionHandler: method was shortened, resolvedLink returns the extended original link. In case the link you passed to the method wasn’t shortened, then resolvedLink contains the same link you have passed.

Handling Deeplinks with Referrer

An optional referrer URL used to track source of the deep link or app open for better attribution or reattribution and deep linking. For example, channels like SEO / Organic Search, Adjust links are not directly used. 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
}