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를 설치하려면 EDM4U(External Dependency Manager for Unity)를 사용하여 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 수집

앱 세트 ID 는 사용자가 기기에 설치한 앱 정보를 측정할 수 있도록 해주는 고유한 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. SDK 서명 설정

SDK v5는 SDK Signature 라이브러리를 포함합니다. iOS 와 Android 용 테스트 가이드를 참조하여 연동이 잘 되는지 확인하시기 바랍니다.

서명 보호는 기본 설정에 따라 비활성화되어 있습니다. 활성화하려면 다음이 필요합니다.

1. Signature 검증 시행.
2. 테스트하기 전에 앱의 SHA-1 핑커프린트를 제공합니다.

6. 앱 빌드

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

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

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

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