시작하기

Adjust Unity SDK를 사용하면 Unity 앱에서 어트리뷰션, 이벤트 등을 트래킹할 수 있습니다. 본 가이드의 단계를 통해 Adjust SDK 설정을 완료하시기 바랍니다.

중요:
Adjust SDK는 iOS 9 이상 버전과 Android API level 9 (Gingerbread) 이상을 지원합니다.

1. Adjust SDK 추가

Unity 앱에서 Adjust SDK를 시작하려면 우선 프로젝트에 Adjust SDK를 추가해야 합니다. Adjust의 GitHub releases 페이지에서 최신 버전을 다운로드하시기 바랍니다.

Adjust SDK를 Unity 프로젝트로 불러오는 방법:

  1. Unity Editor를 실행합니다.
  2. Assets -> Import Package -> Custom Package 를 선택합니다.
  3. 다운로드된 SDK 패키지를 선택합니다.

2. SDK 연동

Adjust SDK는 템플릿 게임 객체와 Adjust 스크립트를 포함하는 Unity prefab 을 포함합니다. 이 스크립트를 사용해 SDK를 구성할 수 있습니다. Unity Editor에서 프리팹을 열려면 다음을 수행하시기 바랍니다.

  1. Assets/Adjust/Adjust.prefab 로부터의 프리팹을 첫 화면에 추가합니다.
  2. 프리팹 Inspector Menu 를 실행합니다.

프리팹 메뉴는 Adjust SDK의 동작을 제어하는 편집 가능한 필드를 포함하고 있습니다.

Adjust SDK를 설정하려면 다음의 정보를 입력하시기 바랍니다.

  1. 앱 토큰 . 앱 토큰 확인 방법은 앱 설정 페이지를 참조하시기 바랍니다.

  2. 앱 환경 .

    • 앱을 테스트 중이며 테스트 데이터를 전송하고자 하는 경우 샌드박스 모드를 선택하시기 바랍니다. 테스트 데이터를 보려면 대시보드에서 샌드박스 모드를 활성화해야 합니다.
    • 테스트를 완료하고 앱 출시 준비가 된 경우 프로덕션 모드를 선택하시기 바랍니다.

  3. 로그 수준 . 어느 로그를 받는지에 관한 것으로, 자세한 정보는 로그 수준 설정 페이지를 참조하시기 바랍니다.

Adjust SDK는 기본 설정에 따라 앱의 Awake 이벤트가 트리거된 경우 시작됩니다. 이 행동을 오버라이드하려면 START SDK MANUALLY 옵션을 확인하시기 바랍니다. 이를 통해 config 인스턴스를 인수로 Adjust.start() 를 호출하여 Adjust SDK를 초기화할 수 있습니다.

C#
AdjustConfig adjustConfig = new AdjustConfig("{YourAppToken}", AdjustEnvironment.Sandbox);
…
Adjust.start(adjustConfig);

3. Android 기기 설정

Google Play Services 추가

Google Play Store를 타겟팅하는 앱은 기기 식별을 위해 반드시 Google Advertising ID (gps_adid)를 사용해야 합니다. gps_adid 에 액세스하기 위해 프로젝트에 play-services-ads-identifier AAR을 추가해야 합니다.

Google External Dependency Manager

수동 설치

App Set ID 수집

참고:
App Set ID는 Adjust SDK v4.33.1 이상에서 이용 가능합니다.

App Set ID 는 사용자가 기기에 설치한 앱 정보를 측정할 수 있도록 해주는 고유한 식별자입니다. 동일한 개발자의 모든 앱은 App Set ID를 공유하기 때문에, 모든 앱 사용자로부터 유의미한 인사이트를 수집할 수 있습니다.

Google External Dependency Manager

수동 설치

Proguard 설정

Proguard를 사용하는 경우, 다음의 규칙을 커스텀 Proguard 파일에 추가하시기 바랍니다.

-keep public class com.adjust.sdk.** { *; }
-keep class com.google.android.gms.common.ConnectionResult {
    int SUCCESS;
}
-keep class com.google.android.gms.ads.identifier.AdvertisingIdClient {
    com.google.android.gms.ads.identifier.AdvertisingIdClient$Info getAdvertisingIdInfo(android.content.Context);
}
-keep class com.google.android.gms.ads.identifier.AdvertisingIdClient$Info {
    java.lang.String getId();
    boolean isLimitAdTrackingEnabled();
}
-keep public class com.android.installreferrer.** { *; }

설치 리퍼러 설정

설치 리퍼러는 소스에 앱 설치를 어트리뷰션할 때 사용할 수 있는 고유 식별자로, Adjust SDK가 어트리뷰션을 하려면 이 정보가 필요합니다. 두 가지 방법을 통해 설치 리퍼러를 얻을 수 있으며, 타겟팅하는 앱 스토어에 따라 방법이 달라집니다.

Google Play Referrer API

Huawei 리퍼러 API

Meta 리퍼러 연동

4. 앱 빌드

Adjust Unity 패키지를 사용하면 앱 빌드 절차를 완료하기 위해 빌드 완료 후 커스텀 작업을 수행하여, Adjust SDK가 앱 내에서 제대로 작동하도록 할 수 있습니다.

이 과정은 AdjustEditor.cs 의 OnPostprocessBuild 메서드에 의해 수행됩니다. 아웃풋 로그는 Unity IDE 콘솔 아웃풋 화면에서 나타납니다.

iOS

Android

5. Adjust SDK 서명 추가

Adjust SDK 서명을 사용해 Adjust SDK가 전송한 모든 커뮤니케이션에 서명을 추가할 수 있습니다. Adjust 서버는 이를 기반으로 유효하지 않은 설치 활동을 감지 및 차단할 수 있습니다.

Adjust SDK 서명을 사용하려면 담당 테크니컬 어카운트 매니저 또는 support@adjust.com에 문의하시기 바랍니다.

6. 연동 테스트

Adjust SDK는 연동 테스트와 문제 해결 툴을 제공합니다. 다음과 같이 설정을 테스트하시기 바랍니다.

팁:
문제 발생 시, 모든 상세 내용과 로그를 support@adjust.com 에 보내시기 바랍니다.

Google Play Services 연동 테스트