adjust-icon

다이렉트 딥링크 설정

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

설정

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

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

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

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

메서드 서명
+ (void)processAndResolveDeeplink:(nonnull ADJDeeplink *)deeplink
withCompletionHandler:(nonnull ADJResolvedDeeplinkBlock)completion;

processDeeplink(_:) 메서드는 단축 브랜드 링크를 사용하지 않는 경우 딥링크 클릭으로부터의 어트리뷰션을 기록합니다.

메서드 서명
+ (void)processDeeplink:(ADJDeeplink *)deeplink;

processAndResolve(_:withCompletionHandler:) 메서드가 이 레거시 메서드를 대체합니다.

구현

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

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

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

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

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

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

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

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

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

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

포그라운드 탐색

프로모션 배너나 제품 추천과 같이 자체 앱 내부에 Adjust 딥링크를 배치한 경우, 해당 링크에 대해 UIApplication.open(_:options:completionHandler:) 또는 SwiftUI의 openURL을 호출하지 마세요. iOS는 앱의 유니버설 링크를 앱 내부에서 라우팅하는 대신 Safari에서 엽니다. 대신, processAndResolve를 통해 링크를 전달한 뒤, 이 페이지에서 설명한 것과 동일한 처리 경로를 사용하여 확인된 딥링크를 라우팅하시기 바랍니다.