iOS SDK 시작 가이드

Adjust iOS SDK는 iOS 앱에서 어트리뷰션, 이벤트 등의 트래킹을 가능하게 합니다. 본 가이드의 단계를 통해 Adjust SDK 설정을 완료하시기 바랍니다. 또한, GitHub에서 예시 앱을 확인하실 수 있습니다.

1단계: 환경 설정

Adjust SDK를 시작하려면 우선 프로젝트에 Adjust SDK를 dependency로 추가해야 합니다.

중요:
Adjust SDK는 iOS 9 이상 버전을 지원합니다.

Cocoapods

Carthage

Swift 패키지 매니저

프레임워크로 추가

2단계: SDK 연동

Cocoapods

Carthage와 프레임워크 가져오기

3단계: iOS 프레임워크 추가

Adjust SDK는 특정 iOS 프레임워크가 앱에 포함된 경우 추가적인 정보를 얻을 수 있습니다. 프레임워크를 추가하고 이를 optional 로 지정하면 Adjust SDK에서 추가적인 기능을 활성화할 수 있습니다.

프레임워크설명참고
AdSupport.frameworkSDK가 IDFA 값과 (iOS 14 이전의 경우) LAT 정보에 액세스하기 위해 필요.앱이 "Kids" 카테고리를 타겟팅하는 경우에는 이 프레임워크를 실행할 필요 없음.
AdServices.framework본 프레임워크는 Apple Search Ads 어트리뷰션을 위해 필요합니다.
StoreKit.frameworkSKAdNetwork 프레임워크에 액세스하고, Adjust SDK가 iOS 14 및 이후 버전에서 통신을 자동으로 처리하기 위해 필요.
AppTrackingTransparency.frameworkiOS 14 및 이후 버전에서 SDK가 유저의 트래킹 동의를 래핑하고 유저의 동의 응답에 액세스하기 위해 필요.앱이 "Kids" 카테고리를 타겟팅하는 경우에는 이 프레임워크를 실행할 필요 없음.
WebKit.framework앱에서 웹뷰를 활용하기 위해 필요.앱이 웹뷰를 사용하는 경우에만 필요.

4단계: SDK 초기화

필요한 프레임워크가 모두 추가되면 앱 내에서 Adjust SDK를 초기화할 수 있습니다. 이를 위해 앱 토큰, 앱을 실행하고자 하는 환경과 함께 ADJConfig 객체를 초기화합니다.

중요:
테스트 시에는 반드시 환경이 ADJEnvironmentSandbox 로 설정되어야 합니다. 앱을 App Store에 제출하기 전에 이를 ADJEnvironmentProduction 로 변경하시기 바랍니다.

표준 설정

iMessage 설정

웹 브릿지 설정

5단계: 로깅 설정

참고:
모든 로깅을 비활성화하려면 ADJConfig인스턴스에서 allowSuppressLogLevel 를 true 로 설정하고 ADJLogLevelSuppress 값과 함께 setLogLevel 메서드를 호출합니다.

로깅의 verbosity를 설정하려면 ADJConfig 인스턴스에서 logLevel 속성 을 사용합니다. 이를 적용하려면 appDidLaunch 를 호출하기 전에 이 작업을 수행해야 합니다.

Objective-C
Swift
Javascript
[adjustConfig setLogLevel:ADJLogLevelVerbose];

6단계: 앱 빌드

잘하셨습니다! 이제 앱을 빌드하고 실행할 수 있을 것입니다. 로깅을 실행하여 문제가 있는지 확인합니다. Adjust SDK를 통해 유저 어트리뷰션을 시작할 수 있습니다.