Adjust iOS SDK를 사용하면 iOS 앱에서 어트리뷰션, 이벤트 등을 기록할 수 있습니다. 이 가이드에서는 Adjust SDK를 앱과 연동하는 방법이 다루어집니다.
1. 프로젝트에 SDK 추가
iOS 앱에서 Adjust SDK를 사용하려면 우선 Xcode 프로젝트에 Adjust SDK를 추가해야 합니다.
Swift 패키지 매니저를 사용하여 SDK를 추가하는 경우:
File --> Swift Packages --> Add Package Dependency 를 선택합니다.
나타나는 창에 SDK의 GitHub 주소를 입력합니다. https://github.com/adjust/ios_sdk
버전 드롭다운 메뉴에서 사용을 원하는 Adjust SDK 버전을 선택합니다. 최신 버전은 배포 페이지에서 확인하실 수 있습니다.
대체 설치 메서드
To add the SDK using Cocoapods, specify the version you want to use in your Podfile:
앱에서 웹뷰를 사용하는 경우 다음을 추가하여 Adjust Web Bridge를 추가해야 합니다:
To add the SDK using Carthage, add the following to your Cartfile:
2. Adjust SDK 연동
Xcode 프로젝트에 Adjust SDK를 추가하고 나면 앱에 연동해야 합니다.
프로젝트 파일에 관련 가져오기 명령어를 추가합니다.
To import the Adjust SDK, add the following to your bridging header file:
To import the Adjust SDK, add the following to your AppDelegate.h file:
3. iOS 프레임워크 추가
Adjust SDK는 특정 기기 정보 액세스를 위해 프레임워크에 의존합니다. 이 정보 읽기를 활성화하려면 프레임워크를 추가하고 프레임워크를 옵션 으로 표시하시기 바랍니다.
프레임워크
설명
참고 사항
AdSupport.framework
디바이스 IDFA에 대한 액세스와, iOS 14 이하 버전의 기기에서 LAT에 대한 액세스도 활성화합니다.
앱이 "아동" 카테고리를 타겟으로 하는 경우 이 프레임워크를 추가하지 않습니다.
AdServices.framework
ASA 어트리뷰션을 취급합니다.
StoreKit.framework
SKAdNetwork 프레임워크에 대한 액세스를 활성화합니다.
Required to allow the Adjust SDK to handle communication with SKAdNetwork on devices running iOS 14 or later.
AppTrackingTransparency.framework
Adjust SDK가 iOS 14 이상 버전의 기기에서 사용자 ATT 동의 다이얼로그 및 액세스 동의 응답을 래핑하도록 허용하기 위해 필요합니다.
앱이 "아동" 카테고리를 타겟으로 하는 경우 이 프레임워크를 추가하지 않습니다.
WebKit.framework
애플리케이션의 웹뷰 사용을 활성화합니다.
앱이 웹뷰를 사용하는 경우에만 필요합니다.
4. SDK 서명 설정
If you want to use the SDK signature library to secure communications between the Adjust SDK and Adjust's servers, follow the instructions in the SDK signature guide on the Adjust Help Center.
5. (선택 사항) Adjust Web Bridge 설정
앱이 웹뷰를 사용하는 경우 Adjust Web Bridge를 설정해 웹뷰 내 활동을 기록해야 합니다.
앱에 AdjustBridge 연동
Project Navigator:
View Controller의 소스 파일을 엽니다.
파일 가장 위에 import 명령어를 추가합니다.
AdjustBridge에 대해 웹뷰 델리게이트의 viewDidLoad 또는 viewWillAppear 메서드에서 다음의 콜을 추가합니다.
AdjustBridge를 웹뷰에 연동
웹뷰에서 자바스크립트 브릿지를 사용하려면 브릿지를 구성해야 합니다. 다음 자바스크립트 코드를 추가하여 Adjust iOS 웹브릿지를 초기화합니다:
6. Adjust SDK 초기화
Adjust SDK를 초기화하려면 config 객체를 만들어야 합니다. 이 객체에는 Adjust SDK 행동을 통제하는 구성 옵션이 포함되어 있습니다. 최소 설정을 위한 다음 인수를 전달합니다.