Android와 iOS 준비 사항 설정

Android 준비 사항

AndroidManifest.xml 파일 내에 다음 퍼미션을 추가하세요.  

<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.INTERNET" />

Google Play Services (Mobile Ads)

Singular SDK는Google Play Services APIs 17.0.0+에 포함된 Google Mobile Ads API를 사용합니다.

이미 앱 내에 Google Play Services를 포함했다면 Singular에서 필요로 하는 조건은 충족됩니다.

만약 해당 서비스를 포함하지 않았다면 다음 디펜던시를 앱의 build.gradle 파일에 추가해서 Google Mobile Ads를 개별적으로 연동할 수 있습니다:

compile 'com.google.android.gms:play-services-ads-identifier:17.0.0+'

더 자세한 정보는, Google Play Services 설정에 대한 Google의 가이드에서 확인할 수 있습니다.

-keep class com.singular.sdk.** { *; }
-keep public class com.android.installreferrer.** { *; }
-keep public class com.singular.unitybridge.** { *; }

iOS 준비 사항

다음 라이브러리/프레임워크를 Unity XCode 프로젝트에 링크합니다.

• Security.framework
• SystemConfiguration.framework
• iAD.framework
• AdSupport.framework
• WebKit.framework
• libsqlite3.0.tbd
• libz.tbd
• StoreKit.framework
• AdServices.framework (iOS 14.3 이상 디바이스만 해당합니다. optional로 선택하세요).

SDK 패키지 다운로드 및 임포트

먼저 SDK unitypackage 파일을 다운로드하세요.

Assets > Import Package > Custom package 메뉴를 사용해서 앱에 unitypackage를 임포트합니다.

SDK 오브젝트 추가

Unity 플랫폼에서 다음 단계를 따르세요.

• Main 씬에 오브젝트를 추가하고 SingularSDKObject로 이름 변경
• SingularSDK 스크립트를 해당 오브젝트에 끌어다 넣습니다.
• Inspection 창에서 Singular API Key와 API Secret을 복사하여 붙여 넣습니다.

기본 연동 설정

SDK 초기화

SDK 초기화 코드는 앱이 열릴 때마다 호출돼야 합니다. 이는 Singular의 어트리뷰션 기능이 동작하기 위한 전제 조건으로 Singular에 새 세션을 보내서 유저 리텐션을 계산하는 기준으로 사용됩니다.

기본적으로 SingularSDK.cs는 씬이 생성될 때 Awake 메서드를 통해 SDK를 자동 초기화합니다.

수동 초기화

앱 오픈 시점이 아닌 실행 이후 시점에 SDK를 수동으로 초기화하기를 원하는 경우 다음 단계를 따르세요.

• SingularSDK 오브젝트의 inspection 창에서 Initialize on Awake 옵션을 비활성화합니다.
• Singular.InitializeSingularSDK 정적 메서드를 사용해서 SDK를 초기화합니다.

public void InitializeSingularSDK()

// API Key and API Secret are set on the 
// game object associated with SingularSDK 
SingularSDK.InitializeSingularSDK();

선택 사항: 세션 타임아웃 변경

기본적으로 앱이 포그라운드로 돌아오기 전 백그라운드에서 60초 이상 실행됐다면 Singular SDK는 새 세션을 등록합니다. SingularSDKObject의 Session Timeout Sec 프로퍼티를 수정하면 이 기본 타임아웃 값을 변경할 수 있습니다.

선택 사항: 유저 ID 설정

Singular SDK를 통해 앱에서 Singular로 유저 ID를 전달할 수 있습니다. 유저 ID는 유저 네임, 이메일 주소, 무작위 생성 문자열 등 어떤 식별자라도 가능합니다. Singular는 유저 ID를 유저 레벨 데이터 익스포트 혹은 (설정시) 내부 BI 포스트백에서 제공합니다.

Singular에 보낼 유저 ID를 설정하려면 SetCustomUserId 메서드를 호출하세요. ID를 설정 해제하는 경우 (예를 들어 유저가 로그아웃을 하는 경우) UnsetCustomUserId를 호출하세요.

public void SetCustomUserId(string customUserId)

SingularSDK.SetCustomUserId("custom_user_id");

public void UnsetCustomUserId()

SingularSDK.UnsetCustomUserId();

AppTrackingTransparency 동의 처리

iOS 14.5부터 앱이 디바이스의 IDFA 값을 포함한 유저 데이터 일부에 접근하기 전에 앱 추적 투명성(App Tracking Transparency) 프레임워크를 통해 유저 동의를 받아야 합니다.

Singular는 인스톨 어트리뷰션을 수행한 디바이스를 식별하기 위해 IDFA를 사용해 왔습니다. (물론 IDFA 없이도 어트리뷰션을 수행하는 방법도 있었습니다.) IDFA를 얻으려면 유저 동의를 구하는 것을 적극적으로 권장합니다.

또한 유저 세션을 Singular로 보내기 전에 SDK가 대기하도록 해야합니다. Singular SDK는 기본적으로 유저 세션을 초기화 시점에 전송하며, 세션이 신규 디바이스에서 발송되면 이는 즉시 Singular의 어트리뷰션 절차를 시작합니다. 이 프로세스는 Singular가 해당 시점에 사용할 수 있는 데이터에 의존하게 됩니다.

따라서 Singular SDK가 세션을 발송하기 전에 유저 동의를 구하고 IDFA를 확인할 수 있도록 해야 합니다.

유저 세션 전송을 지연하려면 SingularSDKObject 내의 waitForTrackingAuthorizationWithTimeoutInterval 옵션을 설정하세요. 이는 Singular SDK가 Singular 서버에 이벤트를 전송하기 전, AppTrackingTransparency 동의 사항을 유저가 수락하거나 거부하는 것을 최대 시간(초 단위) 동안 기다립니다. 해당 옵션의 기본값은 0(대기하지 않음)입니다.