Set up direct deep linking

1
// Receive universal link when app is installed
2
// and link opens app from "Not Running"
3
// or Background state.
4
func application(
5
  _ application: UIApplication,
6
  continue userActivity: NSUserActivity,
7
  restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void
8
) -> Bool {
9
  guard userActivity.activityType == NSUserActivityTypeBrowsingWeb,
10
    let incomingLink = userActivity.webpageURL
11
  else { return true }
12

13
  print("[IncomingLink] application:continueUserActivity: url=\(incomingLink.absoluteString)")
14

15
  // Send deep link to Adjust's servers for attribution.
16
  // If short branded link, receive long link.
17
  // Otherwise, receive original link.
18
  Adjust.processDeeplink(incomingLink) { resolvedLink in
19
    // Handle failure if resolvedLink is nil
20
    guard let resolvedLink = resolvedLink else { return }
21

22
    /*
23
     Possible resolvedLink formats:
24

25
     1. https://brandname.go.link/?adj_t=def456&
26
     adj_link=https%3A%2F%2Fexample.com%2Fsummer-clothes%3Fpromo%3Dbeach
27
     - Extract and decode the deep link from the 'adj_link' query parameter.
28

29
     2. https://brandname.go.link/summer-clothes?promo=beach&adj_t=def456
30
     - Extract the path and relevant query parameters directly from the URL.
31

32
     TODO: Handle the deep link and navigate to the appropriate screen.
33
     */
34
  }
35

36
  return true
37
}
38

39
// Receive app scheme deep link when app is installed
40
// and link opens app from "Not Running",
41
// Background, or Foreground state.
42
func application(
43
  _ application: UIApplication,
44
  open incomingLink: URL,
45
  options: [UIApplication.OpenURLOptionsKey: Any] = [:]
46
) -> Bool {
47
  print("[IncomingLink] application:openURL: url=\(incomingLink)")
48

49
  // Send deep link to Adjust's servers for attribution.
50
  // If short branded link, receive long link.
51
  // Otherwise, receive original link.
52
  Adjust.processDeeplink(incomingLink) { resolvedLink in
53
    // Handle failure if resolvedLink is nil
54
    guard let resolvedLink = resolvedLink else { return }
55

56
    /*
57
     resolvedLink format:
58

59
     example://summer-clothes?promo=beach&adj_t=def456
60
     - Extract the path and relevant query parameters directly from the URL.
61

62
     TODO: Handle the deep link and navigate to the appropriate screen.
63
     */
64
  }
65
  return true
66
}

1
// Receive universal link when app is installed
2
// and link opens app from "Not Running"
3
// or Background state.
4
- (BOOL)application:(UIApplication *)application
5
    continueUserActivity:(NSUserActivity *)userActivity
6
      restorationHandler:
7
          (void (^)(NSArray<id<UIUserActivityRestoring>> *_Nullable))
8
              restorationHandler {
9
  // Check if it's a web browsing activity
10
  if (![userActivity.activityType
11
          isEqualToString:NSUserActivityTypeBrowsingWeb])
12
    return YES;
13

14
  // Check if there's a valid URL
15
  NSURL *incomingLink = userActivity.webpageURL;
16
  if (!incomingLink) return YES;
17

18
  // Send deep link to Adjust's servers for attribution.
19
  // If short branded link, receive long link.
20
  // Otherwise, receive original link.
21
  [Adjust processDeeplink:incomingLink
22
        completionHandler:^(NSString *resolvedLink){
23
            if (!resolvedLink) return;
24

25
            /*
26
             Possible resolvedLink formats:
27

28
             1. https://brandname.go.link/?adj_t=def456&
29
             adj_link=https%3A%2F%2Fexample.com%2Fsummer-clothes%3Fpromo%3Dbeach
30
             - Extract and decode the deep link from the 'adj_link' query parameter.
31

32
             2. https://brandname.go.link/summer-clothes?promo=beach&adj_t=def456
33
             - Extract the path and relevant query parameters directly from the URL.
34

35
             TODO: Handle the deep link and navigate to the appropriate screen.
36
             */
37
        }];
38

39
  return YES;
40
}
41

42
// Receive app scheme deep link when app is installed
43
// and link opens app from "Not Running",
44
// Background, or Foreground state.
45
- (BOOL)application:(UIApplication *)application
46
            openURL:(NSURL *)incomingLink
47
            options:
48
                (NSDictionary<UIApplicationOpenURLOptionsKey, id> *)options {
49
  // Send deep link to Adjust's servers for attribution.
50
  // If short branded link, receive long link.
51
  // Otherwise, receive original link.
52
  [Adjust processDeeplink:incomingLink
53
        completionHandler:^(NSString *resolvedLink){
54
            if (!resolvedLink) return;
55

56
            /*
57
             resolvedLink format:
58

59
             example://summer-clothes?promo=beach&adj_t=def456
60
             - Extract the path and relevant query parameters directly from the URL.
61

62
             TODO: Handle the deep link and navigate to the appropriate screen.
63
             */
64
        }];
65
  return YES;
66
}

1
// Receive universal link or app scheme deep link when app is installed
2
// and link opens app from "Not Running" state.
3
func scene(
4
  _ scene: UIScene,
5
  willConnectTo session: UISceneSession,
6
  options connectionOptions: UIScene.ConnectionOptions
7
) {
8
  // Receive incoming universal link
9
  if let userActivity = connectionOptions.userActivities.first,
10
    userActivity.activityType == NSUserActivityTypeBrowsingWeb,
11
    let incomingLink = userActivity.webpageURL
12
  {
13
    print("[IncomingLink] scene:willConnectToSession:options: url=\(incomingLink.absoluteString)")
14

15
    // Send deep link to Adjust's servers for attribution.
16
    // If short branded link, receive long link.
17
    // Otherwise, receive original link.
18
    Adjust.processDeeplink(incomingLink) { resolvedLink in
19
      // Handle failure if resolvedLink is nil
20
      guard let resolvedLink = resolvedLink else { return }
21

22
      /*
23
       Possible resolvedLink formats:
24

25
       1. https://brandname.go.link/?adj_t=def456&
26
       adj_link=https%3A%2F%2Fexample.com%2Fsummer-clothes%3Fpromo%3Dbeach
27
       - Extract and decode the deep link from the 'adj_link' query parameter.
28

29
       2. https://brandname.go.link/summer-clothes?promo=beach&adj_t=def456
30
       - Extract the path and relevant query parameters directly from the URL.
31

32
       TODO: Handle the deep link and navigate to the appropriate screen.
33
       */
34
    }
35
    return
36
  }
37

38
  // Receive incoming app scheme deep link
39
  guard let incomingLink = connectionOptions.urlContexts.first?.url else { return }
40

41
  print("[IncomingLink] scene:willConnectToSession:options: url=\(incomingLink.absoluteString)")
42

43
  // Send deep link to Adjust's servers for attribution.
44
  // If short branded link, receive long link.
45
  // Otherwise, receive original link.
46
  Adjust.processDeeplink(incomingLink) { resolvedLink in
47
    // Handle failure if resolvedLink is nil
48
    guard let resolvedLink = resolvedLink else { return }
49

50
    /*
51
     resolvedLink format:
52

53
     example://summer-clothes?promo=beach&adj_t=def456
54
     - Extract the path and relevant query parameters directly from the URL.
55

56
     TODO: Handle the deep link and navigate to the appropriate screen.
57
     */
58
  }
59
}
60

61
// Receive universal link when app is installed
62
// and link opens app from Background state.
63
func scene(_ scene: UIScene, continue userActivity: NSUserActivity) {
64
  guard userActivity.activityType == NSUserActivityTypeBrowsingWeb,
65
    let incomingLink = userActivity.webpageURL
66
  else { return }
67

68
  print("[IncomingLink] scene:continueUserActivity: url=\(incomingLink.absoluteString)")
69

70
  // Send deep link to Adjust's servers for attribution.
71
  // If short branded link, receive long link.
72
  // Otherwise, receive original link.
73
  Adjust.processDeeplink(incomingLink) { resolvedLink in
74
    // Handle failure if resolvedLink is nil
75
    guard let resolvedLink = resolvedLink else { return }
76

77
    /*
78
     Possible resolvedLink formats:
79

80
     1. https://brandname.go.link/?adj_t=def456&
81
     adj_link=https%3A%2F%2Fexample.com%2Fsummer-clothes%3Fpromo%3Dbeach
82
     - Extract and decode the deep link from the 'adj_link' query parameter.
83

84
     2. https://brandname.go.link/summer-clothes?promo=beach&adj_t=def456
85
     - Extract the path and relevant query parameters directly from the URL.
86

87
     TODO: Handle the deep link and navigate to the appropriate screen.
88
     */
89
  }
90
}
91

92
// Receive app scheme deep link when app is installed
93
// and link opens app from Background
94
// or Foreground state.
95
func scene(
96
  _ scene: UIScene,
97
  openURLContexts URLContexts: Set<UIOpenURLContext>
98
) {
99
  guard let incomingLink = URLContexts.first?.url else { return }
100

101
  print("[IncomingLink] scene:openURLContexts: url=\(incomingLink.absoluteString)")
102

103
  // Send deep link to Adjust's servers for attribution.
104
  // If short branded link, receive long link.
105
  // Otherwise, receive original link.
106
  Adjust.processDeeplink(incomingLink) { resolvedLink in
107
    // Handle failure if resolvedLink is nil
108
    guard let resolvedLink = resolvedLink else { return }
109

110
    /*
111
     resolvedLink format:
112

113
     example://summer-clothes?promo=beach&adj_t=def456
114
     - Extract the path and relevant query parameters directly from the URL.
115

116
     TODO: Handle the deep link and navigate to the appropriate screen.
117
     */
118
  }
119
}

1
// Receive universal link or app scheme deep link when app is installed
2
// and link opens app from "Not Running" state.
3
- (void)scene:(UIScene *)scene
4
    willConnectToSession:(UISceneSession *)session
5
                 options:(UISceneConnectionOptions *)connectionOptions {
6
  // Receive universal link
7
  if (connectionOptions.userActivities.count > 0) {
8
    NSUserActivity *userActivity =
9
        connectionOptions.userActivities.allObjects.firstObject;
10
    if ([userActivity.activityType
11
            isEqualToString:NSUserActivityTypeBrowsingWeb] &&
12
        userActivity.webpageURL) {
13
      NSURL *incomingLink = userActivity.webpageURL;
14
      // Send deep link to Adjust's servers for attribution.
15
      // If short branded link, receive long link.
16
      // Otherwise, receive original link.
17
      [Adjust processDeeplink:incomingLink
18
            completionHandler:^(NSString *resolvedLink){
19
                if (!resolvedLink) return;
20

21
                /*
22
                 Possible resolvedLink formats:
23

24
                 1. https://brandname.go.link/?adj_t=def456&
25
                 adj_link=https%3A%2F%2Fexample.com%2Fsummer-clothes%3Fpromo%3Dbeach
26
                 - Extract and decode the deep link from the 'adj_link' query parameter.
27

28
                 2. https://brandname.go.link/summer-clothes?promo=beach&adj_t=def456
29
                 - Extract the path and relevant query parameters directly from the URL.
30

31
                 TODO: Handle the deep link and navigate to the appropriate screen.
32
                 */
33
            }];
34
      return;
35
    }
36
  }
37

38
  // Receive app scheme deep link
39
  if (connectionOptions.URLContexts.count == 0) return;
40

41
  UIOpenURLContext *urlContext =
42
      connectionOptions.URLContexts.allObjects.firstObject;
43
  NSURL *incomingLink = urlContext.URL;
44

45
  // Send deep link to Adjust's servers for attribution.
46
  // If short branded link, receive long link.
47
  // Otherwise, receive original link.
48
  [Adjust processDeeplink:incomingLink
49
        completionHandler:^(NSString *resolvedLink){
50
            if (!resolvedLink) return;
51

52
            /*
53
             resolvedLink format:
54

55
             example://summer-clothes?promo=beach&adj_t=def456
56
             - Extract the path and relevant query parameters directly from the URL.
57

58
             TODO: Handle the deep link and navigate to the appropriate screen.
59
             */
60
        }];
61
}
62

63
// Receive universal link when app is installed
64
// and link opens app from Background state.
65
- (void)scene:(UIScene *)scene
66
    continueUserActivity:(NSUserActivity *)userActivity {
67
  // Check if it's a web browsing activity
68
  if (![userActivity.activityType
69
          isEqualToString:NSUserActivityTypeBrowsingWeb])
70
    return;
71

72
  // Check if there's a valid URL
73
  NSURL *incomingLink = userActivity.webpageURL;
74
  if (!incomingLink) return;
75

76
  // Send deep link to Adjust's servers for attribution.
77
  // If short branded link, receive long link.
78
  // Otherwise, receive original link.
79
  [Adjust processDeeplink:incomingLink
80
        completionHandler:^(NSString *resolvedLink){
81
            if (!resolvedLink) return;
82

83
            /*
84
             Possible resolvedLink formats:
85

86
             1. https://brandname.go.link/?adj_t=def456&
87
             adj_link=https%3A%2F%2Fexample.com%2Fsummer-clothes%3Fpromo%3Dbeach
88
             - Extract and decode the deep link from the 'adj_link' query parameter.
89

90
             2. https://brandname.go.link/summer-clothes?promo=beach&adj_t=def456
91
             - Extract the path and relevant query parameters directly from the URL.
92

93
             TODO: Handle the deep link and navigate to the appropriate screen.
94
             */
95
        }];
96
}
97

98
// Receive app scheme deep link when app is installed
99
// and link opens app from Background
100
// or Foreground state.
101
- (void)scene:(UIScene *)scene
102
    openURLContexts:(NSSet<UIOpenURLContext *> *)URLContexts {
103
  // Check if we have any URL contexts
104
  UIOpenURLContext *urlContext = URLContexts.allObjects.firstObject;
105
  if (!urlContext) return;
106

107
  // Check if the URL is valid
108
  NSURL *incomingLink = urlContext.URL;
109
  if (!incomingLink) return;
110

111
  // Send deep link to Adjust's servers for attribution.
112
  // If short branded link, receive long link.
113
  // Otherwise, receive original link.
114
  [Adjust processDeeplink:incomingLink
115
        completionHandler:^(NSString *resolvedLink){
116
            if (!resolvedLink) return;
117

118
            /*
119
             resolvedLink format:
120

121
             example://summer-clothes?promo=beach&adj_t=def456
122
             - Extract the path and relevant query parameters directly from the URL.
123

124
             TODO: Handle the deep link and navigate to the appropriate screen.
125
             */
126
        }];
127
}

1
import Adjust
2
import SwiftUI
3

4
@main
5
struct MyApp: App {
6
  @UIApplicationDelegateAdaptor(AppDelegate.self) var appDelegate
7

8
  var body: some Scene {
9
    WindowGroup {
10
      ContentView()
11
        // Receive universal link or app scheme deep link when app is installed
12
        // and link opens app from "Not Running",
13
        // Background, or Foreground state.
14
        .onOpenURL { incomingLink in
15
          print("[IncomingLink] onOpenURL: url=\(incomingLink.absoluteString)")
16

17
          // Send deep link to Adjust's servers for attribution.
18
          // If short branded link, receive long link.
19
          // Otherwise, receive original link.
20
          Adjust.processDeeplink(incomingLink) { resolvedLink in
21
            // Handle failure if resolvedLink is nil
22
            guard let resolvedLink = resolvedLink else { return }
23

24
            /*
25
             Possible resolvedLink formats:
26

27
             1. https://brandname.go.link/?adj_t=def456&
28
             adj_link=https%3A%2F%2Fexample.com%2Fsummer-clothes%3Fpromo%3Dbeach
29
             - Extract and decode the deep link from the 'adj_link' query parameter.
30

31
             2. https://brandname.go.link/summer-clothes?promo=beach&adj_t=def456
32
             - Extract the path and relevant query parameters directly from the URL.
33

34
             3. example://summer-clothes?promo=beach&adj_t=def456
35
             - Extract the path and relevant query parameters directly from the URL.
36

37
             TODO: Handle the deep link and navigate to the appropriate screen.
38
             */
39
          }
40
        }
41
    }
42
  }
43
}