Unity SDK 연동 가이드

Adjust Unity SDK를 사용하면 Unity 앱에서 어트리뷰션, 이벤트 등을 기록할 수 있습니다. 본 가이드의 단계를 수행하여 Adjust SDK와 연동되도록 앱을 설정하시기 바랍니다.

1. Adjust SDK 설치

Adjust SDK를 설치하려면 다음 방법 중 하나를 선택하시기 바랍니다.

Unity 패키지 설치

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

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

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

Unity 패키지 매니저 사용하기

Unity 패키지 매니저로 Adjust SDK를 설치하려면 다음의 단계를 수행하시기 바랍니다.

1. Unity 에디터에서 패키지 매니저 창을 선택합니다.
2. git URL에서 패키지 추가를 선택합니다.
3. 다음 URL을 입력합니다: https://github.com/adjust/unity_sdk.git?path=Assets/Adjust.

2. iOS와 Android SDK 설치

SDK v5는 더 이상 iOS 및 Android SDK를 바이너리 디펜던시로 사용하지 않습니다. 기본 iOS 및 Android SDK를 설치하려면 Unity용 External Dependency Manager(EDM4U) 를 사용하여 CocoaPods 및 Maven에서 패키지를 설치해야 합니다.

프라이버시 매니페스트와 프레임워크가 iOS에 대해 올바르게 로딩되도록 하려면 정적 링크를 비활성화해야 합니다. 다음을 수행하시기 바랍니다.

1. Assets -> External Dependency Manager -> iOS Resolver -> Settings 를 선택합니다.
2. Link frameworks statically 옵션을 찾아 선택을 취소합니다.

3. SDK 연동

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

1. Assets/Adjust/Adjust.prefab 로부터의 프리팹을 첫 화면에 추가합니다.
2. 프리팹 Inspector Menu를 실행합니다.
3. 프리팹 메뉴는 Adjust SDK의 동작을 제어하는 편집 가능한 필드를 포함하고 있습니다.

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

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

2. 앱 환경 .

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

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

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

AdjustConfig adjustConfig = new AdjustConfig("{YourAppToken}", AdjustEnvironment.Sandbox);
Adjust.InitSdk(adjustConfig);
// ...

4. Android 기기 설정

Google Play Services 추가

Google 플레이 스토어를 타겟으로 하는 앱은 기기 식별을 위해 gps_adid(Google 광고 ID)를 사용해야 합니다. gps_adid에 액세스하기 위해 프로젝트에 play-services-ads-identifier AAR을 추가합니다.

App Set ID 수집

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

설치 리퍼러 설정

설치 리퍼러는 앱 설치를 소스에 어트리뷰션하는 데 사용할 수 있는 고유한 ID입니다. Adjust SDK는 어트리뷰션을 위해 이 정보가 필요합니다. Google Play 리퍼러 API 를 사용하여 이러한 정보를 수집할 수 있습니다.

Google Play Referrer API를 지원하는 방법에는 두 가지가 있습니다.

Meta 리퍼러 연동

Adjust SDK는 Meta 설치 리퍼러 를 지원합니다. 이 기능을 활성화하려면 다음을 수행하시기 바랍니다.

1. 앱 대시보드 에서 Meta 앱 ID를 찾습니다. 자세한 정보는 Meta의 앱 대시보드 문서 를 참고하시기 바랍니다.
2. Meta 앱을 AndroidManifest.xml 파일에 추가합니다.

<queries>
   <package android:name="com.facebook.katana" />
</queries>

<queries>
   <package android:name="com.instagram.android" />
</queries>

3. AdjustConfig 인스턴스의 FbAppId 속성을 앱 ID로 설정합니다.

   AdjustConfig config = new AdjustConfig("{YourAppToken}", AdjustEnvironment.Sandbox, true);
   //...
   config.FbAppId = "{FB_APP_ID_STRING}";
   //...
   Adjust.InitSdk(config);

5. 앱 빌드하기

Adjust Unity 패키지를 사용하면 앱 빌드 절차를 완료하기 위해 빌드 완료 후 커스텀 작업을 수행하여, Adjust SDK가 앱 내에서 작동하도록 할 수 있습니다. 이 과정은 OnPostprocessBuild 메서드에 의해 AdjustEditor.cs 내에서 수행됩니다.

빌드 후(post-build) 옵션을 구성하여 앱 빌드를 맞춤화할 수 있습니다.

프로세스의 결과는 Unity IDE 콘솔 창에 표시됩니다.

6. 연동 테스트

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으로 메일 주시기 바랍니다.

Adjust Unity SDK를 사용하면 Unity 앱에서 어트리뷰션, 이벤트 등을 기록할 수 있습니다. 본 가이드의 단계를 수행하여 Adjust SDK와 연동되도록 앱을 설정하시기 바랍니다.

1. Adjust SDK 설치

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

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

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

2. SDK 연동

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

1. Assets/Adjust/Adjust.prefab 로부터의 프리팹을 첫 화면에 추가합니다.
2. 프리팹 Inspector Menu를 실행합니다.
3. 프리팹 메뉴는 Adjust SDK의 동작을 제어하는 편집 가능한 필드를 포함하고 있습니다.

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

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

2. 앱 환경 .

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

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

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

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

3. Android 기기 설정

Google Play Services 추가

Google 플레이 스토어를 타겟으로 하는 앱은 기기 식별을 위해 gps_adid(Google 광고 ID)를 사용해야 합니다. gps_adid에 액세스하기 위해 프로젝트에 play-services-ads-identifier AAR을 추가합니다.

App Set ID 수집

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

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 Referrer API 사용.

Google Play Referrer API

Google Play Referrer API를 지원하는 방법에는 두 가지가 있습니다.

1. 커스텀 build.gradle 파일에 설치 리퍼러 라이브러리를 디펜던시로 추가

dependencies {
   implementation 'com.android.installreferrer:installreferrer:2.2'
}

2. 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 설치 리퍼러 를 지원합니다. 이 기능을 활성화하려면 다음을 수행하시기 바랍니다.

1. 앱 대시보드 에서 Meta 앱 ID를 찾습니다. 자세한 정보는 Meta의 앱 대시보드 문서 를 참고하시기 바랍니다.
2. Meta 앱을 AndroidManifest.xml 파일에 추가합니다.

<queries>
   <package android:name="com.facebook.katana" />
</queries>

<queries>
   <package android:name="com.instagram.android" />
</queries>

3. 앱 ID를 string 인수로 AdjustConfig.setFbAppId 메서드에 전달합니다.

   AdjustConfig config = new AdjustConfig("{YourAppToken}", AdjustEnvironment.Sandbox, true);
   //...
   config.setFbAppId("{FB_APP_ID_STRING}");
   //...
   Adjust.start(config);

4. iOS 프라이버시 매니페스트 추가

iOS 17에는 앱 스토어에 앱의 개인정보 보호 요구 사항을 알려주는 프라이버시 매니페스트 메커니즘이 도입되었습니다. Adjust Unity SDK는 이 프라이버시 매니페스트 파일을 번들로 제공하지 않기 때문에, 앱이 iOS 17 및 이후 버전을 사용하는 기기를 타겟하는 경우 Adjust iOS SDK 프라이버시 매니페스트 파일의 내용이 앱의 프라이버시 매니페스트에 있는지 확인해야 합니다.

Adjust 프라이버시 매니페스트 추가 방법:

1. Adjust Unity SDK v4.38.0 이상을 사용하고 있는지 확인하시기 바랍니다.
2. 프라이버시 매니페스트가 아직 없는 경우 생성합니다.
3. GitHub에서 PrivacyInfo.xcprivacy 파일을 다운로드하거나 내용을 복사합니다.
4. Adjust의 PrivacyInfo.xcprivacy 파일 내용이 개인정보 보호 매니페스트 파일에 있는지 확인하시기 바랍니다.

앱 스토어에 앱을 제출하면 Adjust 의 개인정보 보호 선언이 앱에 포함됩니다.

5. 앱 빌드하기

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

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

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으로 메일 주시기 바랍니다.