언인스톨 트래킹

Android 언인스톨 트래킹

Android 앱에서 언인스톨 트래킹을 활성화하려면, 우선 언인스톨 트래킹 설정 가이드에 따라 Singular 플랫폼의 App에서 앱을 설정해야 합니다. 설정한 이후 다음 안내 사항을 진행하세요.

Firebase Cloud Messaging (FCM)를 사용해서 언인스톨 트래킹 활성화

1. FCM 연동:

언인스톨 트래킹을 위해서 Firebase Cloud Messaging (FCM) 플랫폼을 사용할 수 있습니다. FCM을 아직 도입하지 않았다면 Google의 Android에서 Firebase 클라우드 메시징 클라이언트 앱 설정 가이드를 따르세요.

2. AndroidManifest.xml 파일 업데이트

앱의 AndroidManifest.xml 파일에 다음처럼 인텐트 필터를 추가합니다. MyFirebaseMessagingService는 Firebase Service를 구현한 클래스 이름으로 변경하세요.

<service android:name=".java.MyFirebaseMessagingService"
android:exported="false">
<intent-filter>
    <action android:name="com.google.firebase.MESSAGING_EVENT" />
</intent-filter> </service>
<service
    android:name=".java.MyFirebaseMessagingService"
    android:exported="false">
    intent-filter> 
        action android:name="com.google.firebase.MESSAGING_EVENT" />
    </intent-filter> 
</service>

3. FCM 디바이스 토큰 등록 및 전송

마지막으로 FCM 디바이스 토큰을 OnCreate()에서 SingularConfig를 초기화한 이후 시점에 다음처럼 설정합니다.

Singular.setFCMDeviceToken(String fcmDeviceToken);

iOS 언인스톨 트래킹

iOS의 언인스톨 트래킹은 Apple 푸시 노티피케이션 기술을 기반으로 합니다. 앱이 현재 푸시 노티피케이션을 지원하지 않는 경우 Apple의 가이드를 참조하세요. 앱이 이미 푸시 노티피케이션을 지원하는 경우 SDK가 초기화된 이후 RegisterDeviceTokenForUninstall 메서드를 사용하여 APNS에서 반환된 디바이스 토큰을 전달하도록 구현하기만 하면 됩니다.

public static void RegisterDeviceTokenForUninstall
(string APNSToken)

// hex-string 형태로 APNS 토큰 전달 
SingularSDK.RegisterDeviceTokenForUninstall("ba85ab31a7c7
f5c2f012587f29fb0e596d4b67e7b7b2838fa1a8582c1f7dbdee");

글로벌 프로퍼티 추가

Singular SDK로 추가 프로퍼티를 커스텀으로 정의하고 앱에서 발생하는 모든 세션과 이벤트에 포함해서 Singular 서버에 전송할 수 있습니다. 이 프로퍼티는 유저 관련, 앱 모드, 앱 상태 등 어떤 정보이든 될 수 있습니다. 프로퍼티를 설정하면 추후 리포트에서 데이터를 분류하는 디멘션으로 사용할 수 있습니다.

예를 들어 게임 앱이라면 “Level”이라는 프로퍼티를 정의하고 “0”으로 초기화할 수 있습니다. 이 경우 앱에서 보내는 세션과 이벤트에 "Level": "0"이라는 프로퍼티가 포함됩니다. 유저의 레벨이 상승하면 해당 프로퍼티를 “1”로 업데이트하는 것처럼 값은 계속 변경할 수 있습니다. 이렇게 설정하면 플레이어의 게임 레벨에 따른 세션, 이벤트 및 매출 데이터 등을 확인할 수 있습니다.

• 글로벌 프로퍼티는 최대 5개까지 설정할 수 있습니다.
• 앱 실행 간에도 최신 값이 유지되며 설정을 해제하거나 유저가 앱을 언언스톨하기 전에는 유지됩니다.
• 각 프로퍼티 이름과 값은 영문 200자까지 설정할 수 있습니다. 더 긴 이름과 값을 전달하면 200자까지만 확인됩니다.
• 글로벌 프로퍼티는 현재 Singular의 유저 레벨 이벤트 로그(어트리뷰션 로그 추출 가이드 참조)와 포스트백에서 확인할 수 있습니다. Singular의 집계 리포트 (리포팅 페이지나 리포팅 API)에서의 지원은 추후 추가될 예정입니다. 기능에 대한 질문이 있거나 글로벌 프로퍼티 지원에 관심이 있다면 담당 고객 성공 매니저와 상의하세요.

SingularConfig를 통한 초기화 이전 글로벌 프로퍼티 설정

SingularConfig 내의 setGlobalProperty 메서드를 사용하면 SDK 초기화 이전에 글로벌 프로퍼티를 설정할 수 있습니다.

글로벌 프로퍼티와 값이 앱 실행 사이에도 유지되므로 프로퍼티가 이미 다른 값으로 설정되었을 가능성이 있습니다. SDK에 기존 프로퍼티를 신규 값으로 오버라이딩하려면 overrideExisting 파라미터를 사용하세요.

초기화 이후 글로벌 프로퍼티 설정

앱 실행 중 언제든 다음 메서드를 통해 글로벌 프로퍼티의 설정, 설정 해제 및 값 획득이 가능합니다.

bool result = SingularSDK.SetGlobalProperty("key", "value", false);

Dictionary<string, string> props = SingularSDK.GetGlobalProperties();

SingularSDK.UnsetGlobalProperty(“test_key”);

SingularSDK.clearGlobalProperties();

데이터 개인정보 보호 법률 준수

Singular는 개인정보 보호를 준수하는 기능을 제공하여 GDPR나 CCPA (California Consumer Privacy Act)와 같이 소비자 개인 정보 보호 법률을 준수하고자 하는 고객사를 지원하고 있습니다.   만약 유저가 개인 정보를 공유하도록 동의한 경우 파트너들은 해당 사항에 대해 알림 수신을 원할 수 있습니다.

유저의 정보 공유 동의를 획득하는 방법을 구현했다면 limitDataSharing 메서드를 사용해서 유저의 동의 여부에 대해 알릴 수 있습니다.

• 유저가 정보 공유를 동의한 경우 SingularSDK.LimitDataSharing(false)를 사용하세요.

• 유저가 정보 공유를 거부한 경우 SingularSDK.LimitDataSharing(true)를 사용하세요.

Singular는 관련 규정을 준수하기 위해 이 정보를 관련 파트너에게 전달합니다.

// 유저가 데이터 공유를 동의한 경우
SingularSDK.LimitDataSharing(false);

GDPR 규정 준수를 위한 추가 메서드

Singular SDK는 고객사가 GDPR 규정을 준수하고 사용자의 트래킹 동의 및 비동의 사항을 Singular에 알리는데 필요한 여러 메서드를 제공합니다.

SingularSDK.TrackingOptIn();

SingularSDK.TrackingUnder13();

SingularSDK.StopAllTracking();

SingularSDK.ResumeAllTracking();

SingularSDK.IsAllTrackingStopped();