다이렉트 딥링크 설정

앱이 설치된 사용자가 Adjust 링크를 클릭하면 다이렉트 딥링킹을 통해 앱 내의 특정 콘텐츠로 바로 이동할 수 있습니다.

설정

iOS는 앱 구현에 따라 다이렉트 딥링크를 수신하는 몇 가지 메서드를 제공합니다. 이러한 메서드에 따라 다음 메서드 중 하나를 사용하여 Adjust SDK에 딥링크를 전달할 수 있습니다.

딥링크 처리 및 확인(권장)

processAndResolve(_:withCompletionHandler:) 메서드를 사용하여 다음 작업을 수행합니다.

딥링크 클릭에서 어트리뷰션 기록
짧은 브랜드 링크를 해당 긴 브랜드 링크로 변환
다른 모든 링크를 그대로 전달

앱은 해결된 링크를 분석하여 적절한 화면으로 이동함으로써 처리할 수 있습니다. Adjust의 긴 브랜드 링크, 기타 유니버설 링크, 앱 스킴 딥링크를 포함한 모든 딥링크에 이 메서드를 사용할 수 있습니다.

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

딥링크 처리(레거시)

Adjust SDK에는 짧은 브랜드 링크를 사용하지 않는 경우 딥링크 클릭에서 어트리뷰션을 기록할 수 있는 processDeeplink(_:) 메서드가 있습니다.

+ (void)processDeeplink:(ADJDeeplink *)deeplink;

그러나 processAndResolve(_:withCompletionHandler:) 메서드는 이 레거시 메서드의 기능을 대체하므로, 이 새로운 메서드를 사용하는 것이 권장됩니다.

중요 구현 참고 사항

다음 딥링크 처리 모범 사례를 따르세요.

링크 처리 요구사항
- 귀하의 앱은 Adjust 브랜드 링크(brandname.go.link)와 유니버설 링크(example.com)를 동일하게 처리해야 합니다. 앱에서 도메인 허용 리스트를 사용하는 경우 Adjust 브랜드 도메인이 포함되어 있는지 확인하세요. 예를 들어, 다음 두 링크는 모두 동일한 화면으로 이동해야 합니다.
  - Adjust 브랜드 링크: https://brandname.go.link/summer-clothes?promo=beach
  - 유니버설 링크: https://example.com/summer-clothes?promo=beach
- 귀하의 앱은 Adjust 브랜드 링크와 앱 스킴 딥링크를 동일하게 처리해야 합니다. iOS가 유니버설 링크를 지원하지 않는 경우, Adjust는 이를 해당 앱 스킴 형식으로 변환합니다. 예를 들어, 다음 두 링크는 모두 동일한 화면으로 이동해야 합니다.
  - Adjust 브랜드 링크: https://brandname.go.link/summer-clothes?promo=beach
  - 앱 스킴 딥링크: example://summer-clothes?promo=beach
앱 상태 고려사항
- 앱이 어떤 상태에서든(‘실행 중이 아님’, 백그라운드, 또는 해당되는 경우 포그라운드) 링크를 올바르게 처리하는지 확인하세요.
- 사용자가 아직 인증되지 않은 경우와 같이 즉시 처리할 수 없는 경우 딥링크를 저장했다가 앱이 탐색할 준비가 되면 처리하는 것을 고려하세요.
인앱 탐색
- 앱이 UIApplication.open(_:options:completionHandler:) 또는 SwiftUI의 openURL을 호출하여 자체 유니버설 링크를 열려고 할 때, iOS는 이를 앱이 아닌 Safari에서 엽니다. 이러한 메서드를 내부 탐색을 위해 사용하려면 앱 스킴 딥링크만 전달할 수 있습니다. 또는 앱 내에 유니버설 링크를 배치하고 딥링크 처리 로직을 사용하여 이를 파싱하고 적절한 화면으로 이동할 수 있습니다.

구현

앱의 구조에 맞는 구현을 사용하세요.

AppDelegate 라이프사이클을 사용하는 UIKit 앱
SceneDelegate 라이프사이클을 사용하는 UIKit 앱
AppDelegate 라이프사이클을 사용하는 SwiftUI 앱
SceneDelegate 라이프사이클을 사용하는 SwiftUI 앱

AppDelegate 라이프사이클을 사용하는 UIKit 앱

iOS 다이렉트 딥링킹 메서드를 구현하려면 AppDelegate를 업데이트하세요.

Swift
Objective-C

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
  // Create deep link object
14
  guard let deeplink = ADJDeeplink(deeplink: incomingLink) else { return false }
15

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

23
    // TODO: Handle resolvedLink by parsing its components
24
    // (example: path, query parameters) and
25
    // navigating to the appropriate screen.
26
  }
27

28
  return true
29
}
30

31
// Receive app scheme deep link when app is installed
32
// and link opens app from "not running",
33
// background, or foreground state.
34
func application(
35
  _ application: UIApplication,
36
  open incomingLink: URL,
37
  options: [UIApplication.OpenURLOptionsKey: Any] = [:]
38
) -> Bool {
39
  // Create deep link object
40
  guard let deeplink = ADJDeeplink(deeplink: incomingLink) else { return false }
41

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

49
    // TODO: Handle resolvedLink by parsing its components
50
    // (example: path, query parameters) and
51
    // navigating to the appropriate screen.
52
  }
53
  return true
54
}

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
  // Create deep link object
19
  ADJDeeplink *deeplink = [[ADJDeeplink alloc] initWithDeeplink:incomingLink];
20
  if (!deeplink) return YES;
21

22
  // Send deep link to Adjust's servers for attribution.
23
  // If short branded link, receive long link.
24
  // Otherwise, receive original link.
25
  [Adjust processAndResolveDeeplink:deeplink
26
              withCompletionHandler:^(NSString *resolvedLink) {
27
                // Handle failure if resolvedLink is nil
28
                if (!resolvedLink) return;
29

30
                // TODO: Handle resolvedLink by parsing its components
31
                // (example: path, query parameters) and
32
                // navigating to the appropriate screen.
33
              }];
34

35
  return YES;
36
}
37

38
// Receive app scheme deep link when app is installed
39
// and link opens app from "not running",
40
// background, or foreground state.
41
- (BOOL)application:(UIApplication *)application
42
            openURL:(NSURL *)incomingLink
43
            options:
44
                (NSDictionary<UIApplicationOpenURLOptionsKey, id> *)options {
45
  // Create deep link object
46
  ADJDeeplink *deeplink = [[ADJDeeplink alloc] initWithDeeplink:incomingLink];
47
  if (!deeplink) return YES;
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 processAndResolveDeeplink:deeplink
53
              withCompletionHandler:^(NSString *resolvedLink) {
54
                // Handle failure if resolvedLink is nil
55
                if (!resolvedLink) return;
56

57
                // TODO: Handle resolvedLink by parsing its components
58
                // (example: path, query parameters) and
59
                // navigating to the appropriate screen.
60
              }];
61
  return YES;
62
}

SceneDelegate 라이프사이클을 사용하는 UIKit 앱

iOS 다이렉트 딥링킹 메서드를 구현하려면 SceneDelegate를 업데이트하세요.

Swift
Objective-C

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
    // Create deep link object
14
    guard let deeplink = ADJDeeplink(deeplink: incomingLink) else { return false }
15

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

23
      // TODO: Handle resolvedLink by parsing its components
24
      // (example: path, query parameters) and
25
      // navigating to the appropriate screen.
26
    }
27
    return
28
  }
29

30
  // Receive incoming app scheme deep link
31
  guard let incomingLink = connectionOptions.urlContexts.first?.url else { return }
32

33
  // Create deep link object
34
  guard let deeplink = ADJDeeplink(deeplink: incomingLink) else { return false }
35

36
  // Send deep link to Adjust's servers for attribution.
37
  // If short branded link, receive long link.
38
  // Otherwise, receive original link.
39
  Adjust.processAndResolve(deeplink) { resolvedLink in
40
    // Handle failure if resolvedLink is nil
41
    guard let resolvedLink = resolvedLink else { return }
42

43
    // TODO: Handle resolvedLink by parsing its components
44
    // (example: path, query parameters) and
45
    // navigating to the appropriate screen.
46
  }
47
}
48

49
// Receive universal link when app is installed
50
// and link opens app from background state.
51
func scene(_ scene: UIScene, continue userActivity: NSUserActivity) {
52
  guard userActivity.activityType == NSUserActivityTypeBrowsingWeb,
53
    let incomingLink = userActivity.webpageURL
54
  else { return }
55

56
  // Create deep link object
57
  guard let deeplink = ADJDeeplink(deeplink: incomingLink) else { return false }
58

59
  // Send deep link to Adjust's servers for attribution.
60
  // If short branded link, receive long link.
61
  // Otherwise, receive original link.
62
  Adjust.processAndResolve(deeplink) { resolvedLink in
63
    // Handle failure if resolvedLink is nil
64
    guard let resolvedLink = resolvedLink else { return }
65

66
    // TODO: Handle resolvedLink by parsing its components
67
    // (example: path, query parameters) and
68
    // navigating to the appropriate screen.
69
  }
70
}
71

72
// Receive app scheme deep link when app is installed
73
// and link opens app from background
74
// or foreground state.
75
func scene(
76
  _ scene: UIScene,
77
  openURLContexts URLContexts: Set<uiopenurlcontext>
78
) {
79
  guard let incomingLink = URLContexts.first?.url else { return }
80

81
  // Create deep link object
82
  guard let deeplink = ADJDeeplink(deeplink: incomingLink) else { return false }
83

84
  // Send deep link to Adjust's servers for attribution.
85
  // If short branded link, receive long link.
86
  // Otherwise, receive original link.
87
  Adjust.processAndResolve(deeplink) { resolvedLink in
88
    // Handle failure if resolvedLink is nil
89
    guard let resolvedLink = resolvedLink else { return }
90

91
    // TODO: Handle resolvedLink by parsing its components
92
    // (example: path, query parameters) and
93
    // navigating to the appropriate screen.
94
  }
95
}

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

15
      // Create deep link object
16
      ADJDeeplink *deeplink =
17
          [[ADJDeeplink alloc] initWithDeeplink:incomingLink];
18
      if (!deeplink) return;
19

20
      // Send deep link to Adjust's servers for attribution.
21
      // If short branded link, receive long link.
22
      // Otherwise, receive original link.
23
      [Adjust processAndResolveDeeplink:deeplink
24
                  withCompletionHandler:^(NSString *resolvedLink) {
25
                    // Handle failure if resolvedLink is nil
26
                    if (!resolvedLink) return;
27

28
                    // TODO: Handle resolvedLink by parsing its components
29
                    // (example: path, query parameters) and
30
                    // navigating to the appropriate screen.
31
                  }];
32
      return;
33
    }
34
  }
35

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

39
  UIOpenURLContext *urlContext =
40
      connectionOptions.URLContexts.allObjects.firstObject;
41
  NSURL *incomingLink = urlContext.URL;
42

43
  // Create deep link object
44
  ADJDeeplink *deeplink = [[ADJDeeplink alloc] initWithDeeplink:incomingLink];
45
  if (!deeplink) return;
46

47
  // Send deep link to Adjust's servers for attribution.
48
  // If short branded link, receive long link.
49
  // Otherwise, receive original link.
50
  [Adjust processAndResolveDeeplink:deeplink
51
              withCompletionHandler:^(NSString *resolvedLink) {
52
                // Handle failure if resolvedLink is nil
53
                if (!resolvedLink) return;
54

55
                // TODO: Handle resolvedLink by parsing its components
56
                // (example: path, query parameters) and
57
                // navigating to the appropriate screen.
58
              }];
59
}
60

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

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

74
  // Create deep link object
75
  ADJDeeplink *deeplink = [[ADJDeeplink alloc] initWithDeeplink:incomingLink];
76
  if (!deeplink) return;
77

78
  // Send deep link to Adjust's servers for attribution.
79
  // If short branded link, receive long link.
80
  // Otherwise, receive original link.
81
  [Adjust processAndResolveDeeplink:deeplink
82
              withCompletionHandler:^(NSString *resolvedLink) {
83
                // Handle failure if resolvedLink is nil
84
                if (!resolvedLink) return;
85

86
                // TODO: Handle resolvedLink by parsing its components
87
                // (example: path, query parameters) and
88
                // navigating to the appropriate screen.
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
- (void)scene:(UIScene *)scene
96
    openURLContexts:(NSSet<uiopenurlcontext *> *)URLContexts {
97
  // Check if we have any URL contexts
98
  UIOpenURLContext *urlContext = URLContexts.allObjects.firstObject;
99
  if (!urlContext) return;
100

101
  // Check if the URL is valid
102
  NSURL *incomingLink = urlContext.URL;
103
  if (!incomingLink) return;
104

105
  // Create deep link object
106
  ADJDeeplink *deeplink = [[ADJDeeplink alloc] initWithDeeplink:incomingLink];
107
  if (!deeplink) return;
108

109
  // Send deep link to Adjust's servers for attribution.
110
  // If short branded link, receive long link.
111
  // Otherwise, receive original link.
112
  [Adjust processAndResolveDeeplink:deeplink
113
              withCompletionHandler:^(NSString *resolvedLink) {
114
                // Handle failure if resolvedLink is nil
115
                if (!resolvedLink) return;
116

117
                // TODO: Handle resolvedLink by parsing its components
118
                // (example: path, query parameters) and
119
                // navigating to the appropriate screen.
120
              }];
121
}

AppDelegate 라이프사이클을 사용하는 SwiftUI 앱

아직 만들지 않았다면 아래 App.swift 파일 예시와 같이 프로젝트의 기본 디렉터리에 AppDelegate.swift 파일을 만들고 기본 애플리케이션 파일에서 이 파일을 참조하세요. 이는 앱 라이프사이클 이벤트 및 Adjust SDK 연동을 처리하는 데 필요합니다. 또한 앱이 설치되면 유니버설 링크와 앱 스킴 딥링크를 수신하는 onOpenURL SwiftUI 수정자를 구현하세요.

Swift

1
import AdjustSdk
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
          // Create deep link object
16
          guard let deeplink = ADJDeeplink(deeplink: incomingLink) else { return false }
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.processAndResolve(deeplink) { resolvedLink in
22
            // Handle failure if resolvedLink is nil
23
            guard let resolvedLink = resolvedLink else { return }
24

25
            // TODO: Handle resolvedLink by parsing its components
26
            // (example: path, query parameters) and
27
            // navigating to the appropriate screen.
28
          }
29
        }
30
    }
31
  }
32
}

SceneDelegate 라이프사이클을 사용하는 SwiftUI 앱

AppDelegate 라이프사이클을 사용하는 SwiftUI 앱 섹션의 지침을 따르세요. onOpenURL SwiftUI 수정자는 앱이 설치된 상태에서 링크가 백그라운드 또는 포그라운드 상태에서 앱을 열 때 유니버설 링크와 앱 스킴 딥링크를 수신합니다.

또한 SceneDelegate 라이프사이클을 사용하는 UIKit 앱 섹션에서 scene(_:willConnectTo:options:) 메서드를 구현합니다. 이 메서드는 앱이 설치되어 있고 링크가 ‘실행되지 않는’ 상태에서 앱을 열 때 유니버설 링크 및 앱 스킴 딥링크를 수신합니다.