Adjust Unity SDK를 사용하면 Unity 앱에서 어트리뷰션, 이벤트 등을 기록할 수 있습니다. 본 가이드의 단계를 수행하여 Adjust SDK와 연동되도록 앱을 설정하시기 바랍니다.
1. Adjust SDK 설치
Unity 앱에서 Adjust SDK를 시작하려면 우선 프로젝트에 Adjust SDK를 추가해야 합니다. GitHub releases 페이지에서 최신 버전을 다운로드합니다.
Adjust SDK를 Unity 프로젝트로 불러오는 방법:
- Unity Editor를 실행합니다.
- Assets —> Import Package —> Custom Package 를 선택합니다.
- 다운로드된 SDK 패키지를 선택합니다.
2. SDK 연동
Adjust SDK는 Unity 프리팹(prefab)을 포함하며, 프리팹에는 템플릿 게임 객체와 Adjust 스크립트가 있습니다. 이 스크립트를 사용해 SDK를 구성할 수 있습니다. Unity Editor에서 프리팹을 실행하려면 다음을 수행하시기 바랍니다.
Assets/Adjust/Adjust.prefab
로부터의 프리팹을 첫 화면에 추가합니다.- 프리팹 Inspector Menu를 실행합니다.
- 프리팹 메뉴는 Adjust SDK의 동작을 제어하는 편집 가능한 필드를 포함하고 있습니다.
Adjust SDK를 설정하려면 다음의 정보를 입력하시기 바랍니다.
-
앱 토큰 . 앱 토큰 확인 방법은 앱 설정 페이지를 참조하시기 바랍니다.
-
앱 환경 .
- 앱을 테스트 중이며 테스트 데이터를 전송하고자 하는 경우 샌드박스 모드를 선택하시기 바랍니다. 테스트 데이터를 보려면 대시보드에서 샌드박스 모드를 활성화해야 합니다.
- 테스트를 완료하고 앱 출시 준비가 된 경우 프로덕션 모드를 선택하시기 바랍니다.
-
로그 수준 . 어느 로그를 받는지에 관한 것으로, 자세한 정보는 로그 수준 설정 페이지를 참조하시기 바랍니다.
Adjust SDK는 기본값 설정에 따라 앱의 Awake 이벤트가 발생한 경우 시작됩니다. 이 행동을 오버라이드하려면 START SDK MANUALLY 옵션을 확인하시기 바랍니다. 이를 통해 config 인스턴스를 인수로 Adjust.start()
를 호출하여 Adjust SDK를 초기화할 수 있습니다.
3. Android 기기 설정
Google Play Services 추가
Google 플레이 스토어를 타겟으로 하는 앱은 기기 식별을 위해 gps_adid(Google 광고 ID)를 사용해야 합니다. gps_adid
에 액세스하기 위해 프로젝트에 play-services-ads-identifier
AAR을 추가합니다.
External Dependency Manager 플러그인을 사용하는 경우, Dependencies.xml
파일에 다음을 추가하시기 바랍니다.
ARR (Android Archive)을 수동으로 설치하려면, Maven에서 다운로드한 뒤 Assets/Plugins/Android
디렉토리에 추가하시기 바랍니다.
App Set ID 수집
App Set ID 는 사용자가 기기에 설치한 앱 정보를 측정할 수 있도록 해주는 고유한 식별자입니다. 동일한 개발자의 모든 앱은 App Set ID를 공유하기 때문에, 모든 앱 사용자로부터 유의미한 인사이트를 수집할 수 있습니다.
기기의 App Set ID를 기록하려면 다음의 디펜던시를 Dependencies.xml
파일에 추가해야 합니다.
ARR (Android Archive)을 수동으로 설치하려면, Maven에서 다운로드한 뒤 Assets/Plugins/Android
디렉토리에 추가하시기 바랍니다.
Proguard 설정
Proguard를 사용하는 경우, 다음의 규칙을 커스텀 Proguard 파일에 추가하시기 바랍니다.
설치 리퍼러 설정
설치 리퍼러는 소스에 앱 설치를 어트리뷰션할 때 사용할 수 있는 고유 식별자로, Adjust SDK가 어트리뷰션을 하려면 이 정보가 필요합니다. 두 가지 방법을 통해 설치 리퍼러를 얻을 수 있으며, 타겟팅하는 앱 스토어에 따라 방법이 달라집니다.
- Google Play Referrer API 사용.
- Huawei Referrer API 사용.
Google Play Referrer API
Google Play Referrer API를 지원하는 방법에는 두 가지가 있습니다.
- 커스텀
build.gradle
파일에 설치 리퍼러 라이브러리를 디펜던시로 추가
- Maven에서 설치 리퍼러 라이브러리를 다운로드하고, AAR(안드로이드 아카이브) 파일을
Plugins/Android
폴더에 넣기.
Huawei 리퍼러 API
Adjust SDK는 v4.21.1부터 Huawei App Gallery v10.4 이상을 사용하는 Huawei 기기에서의 설치 측정을 지원합니다. Huawei Referrer API를 사용하기 위해 추가적인 변경을 수행하지 않아도 됩니다.
Meta 리퍼러 연동
Adjust SDK는 v4.36.0 이상 버전에서 Meta 설치 리퍼러 를 지원합니다. 이 기능을 활성화하려면 다음을 수행하시기 바랍니다.
- 앱 대시보드 에서 Meta 앱 ID를 찾습니다. 자세한 정보는 Meta의 앱 대시보드 문서 를 참고하시기 바랍니다.
- Meta 앱을
AndroidManifest.xml
파일에 추가합니다.
-
앱 ID를
string
인수로AdjustConfig.setFbAppId
메서드에 전달합니다.
4. iOS 프라이버시 매니페스트 추가
iOS 17에는 앱 스토어에 앱의 개인정보 보호 요구 사항을 알려주는 프라이버시 매니페스트 메커니즘이 도입되었습니다. Adjust Unity SDK는 이 프라이버시 매니페스트 파일을 번들로 제공하지 않기 때문에, 앱이 iOS 17 및 이후 버전을 사용하는 기기를 타겟하는 경우 Adjust iOS SDK 프라이버시 매니페스트 파일의 내용이 앱의 프라이버시 매니페스트에 있는지 확인해야 합니다.
Adjust 프라이버시 매니페스트 추가 방법:
- Adjust Unity SDK v4.38.0 이상을 사용하고 있는지 확인하시기 바랍니다.
- 프라이버시 매니페스트가 아직 없는 경우 생성합니다.
- GitHub에서
PrivacyInfo.xcprivacy
파일을 다운로드하거나 내용을 복사합니다. - Adjust의
PrivacyInfo.xcprivacy
파일 내용이 개인정보 보호 매니페스트 파일에 있는지 확인하시기 바랍니다.
앱 스토어에 앱을 제출하면 Adjust 의 개인정보 보호 선언이 앱에 포함됩니다.
5. 앱 빌드하기
Adjust Unity 패키지를 사용하면 앱 빌드 절차를 완료하기 위해 빌드 완료 후 커스텀 작업을 수행하여, Adjust SDK가 앱 내에서 작동하도록 할 수 있습니다.
이 과정은 OnPostprocessBuild
메서드에 의해 AdjustEditor.cs
내에서 수행됩니다. 아웃풋 로그는 Unity IDE 콘솔 아웃풋 화면에서 나타납니다.
iOS 빌드 후 절차는 생성한 Xcode 프로젝트를 다음과 같이 변경합니다.
- 다른 링커 플래그
-ObjC
추가: 빌드 시 Adjust Objective-C 카테고리 인식에 필요. - Objective-C exceptions 활성화.
프레임워크
iOS 기능에 액세스하기 위해 다음의 프레임워크를 활성화할 수 있습니다.
AdServices.framework
: Apple Search Ad 측정에 필요AdSupport.framework
: 기기의 IDFA를 읽기 위해 필요AppTrackingTransparency.framework
: 사용자에게 측정 동의 여부를 묻기 위해 필요StoreKit.framework
: SKAdNetwork 프레임워크와 통신하기 위해 필요iAd.framework
지원 중단(Deprecated) : 사용AdServices.framework
App Tracking Transparency 동의 대화
ATT(App Tracking Transparency) 래퍼를 사용하는 경우, User Tracking Description 메시지를 입력하시기 바랍니다. 이는 사용자 화면에 ATT 동의 다이얼로그를 표시할 때 나타납니다.
딥링킹
딥링크를 활성화하려면, 다음의 정보를 추가하시기 바랍니다.
- iOS 유니버설 링크 도메인 : 유니버설 링크에 사용되는 관련 도메인.
- iOS URL 식별자 : 앱의 번들 ID.
- iOS URL 스킴 : 앱과 관련된 URL 스킴.
Android 빌드 후 과정에서는 AndroidManifest.xml
파일이 Assets/Plugins/Android/
안에 있는지 찾습니다. 이 파일이 없는 경우, AdjustAndroidManifest.xml
사본을 생성합니다.
권한
Android 기능에 액세스하려면 다음의 권한을 활성화하시기 바랍니다.
android.permission.INTERNET
: 인터넷 연결에 필요.android.permission.ACCESS_NETWORK_STATE
: 기기가 연결된 네트워크의 유형을 읽기 위해 필요.com.android.finsky.permission.BIND_GET_INSTALL_REFERRER_SERVICE
지원 중단 : Google Play Store 인텐트를 통해 설치 리퍼러 정보를 가져오기 위해 필요.com.google.android.gms.permission.AD_ID
: Android 12(API 레벨 31) 이상에서 기기의 광고 ID를 읽기 위해 필요. 자세한 정보는 Google의AdvertisingIdClient.info
문서 를 참조하시기 바랍니다.
딥링킹
딥링크를 활성화하려면, 다음의 정보를 추가하시기 바랍니다.
Android URI Schemes : 딥링크의 목적지.
6. Adjust SDK 서명 추가
Adjust SDK 서명을 사용해 Adjust SDK가 전송한 모든 커뮤니케이션에 서명을 추가할 수 있습니다. Adjust 서버는 이를 기반으로 유효하지 않은 설치 활동을 감지 및 차단할 수 있습니다.
Adjust SDK 서명을 사용하려면 담당 테크니컬 어카운트 매니저 또는 support@adjust.com에 문의하시기 바랍니다.
7. 연동 테스트
Adjust SDK는 연동 테스트와 문제 해결 툴을 제공합니다. 다음과 같이 설정을 테스트하시기 바랍니다.
- 환경을
AdjustEnvironment.sandbox
로 설정합니다. - Adjust 대시보드 결과에 샌드박스 필터를 추가합니다.
- 로그 수준을
AdjustLogLevel.Verbose
로 설정합니다.
Google Play Services 연동 테스트
Adjust SDK가 기기의 Google 광고 ID를 수신할 수 있는지 테스트하려면 로그 수준을 AdjustLogLevel.Verbose
로 설정하고, 환경을 AdjustEnvironment.sandbox
로 설정합니다. 앱을 시작하고 session
또는 이벤트를 측정합니다. SDK가 광고 ID를 읽으면 gps_adid(Google 플레이 서비스 광고주 ID) 파라미터를 로깅합니다.
Google광고 ID를 읽을 수 없다면 Adjust의 Github repository에 이슈를 제기하거나 support@adjust.com으로 메일 주시기 바랍니다.