시작하기 전에 SDK 사전 요구 사항

• Singular SDK 연동의단계를 따르세요 :계획 및 사전 요구 사항의 단계를 따르세요.
  이 단계는 모든 Singular SDK 연동의 전제 조건입니다.
• Unity용 Google 외부 종속성 관리자인 Google EDM4U를 사용하는지 확인합니다.
  Google EDM4U란 무엇인가요? 자세히 알아보기 [여기].

1. SDK 설치하기

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

1.2. 안드로이드용 구성

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

1.3. iOS용 팁

pod repo update
pod update

// Printing Identifier for Vendor (IDFV) to Xcode Console for use in Singular SDK Console


NSLog(@"Singular === IDFV: %@", [[[UIDevice currentDevice] identifierForVendor] UUIDString]);

2. SDK 연동

2.1. SingularSDKObject 생성

SingularSDKObject를 계층 구조에 추가합니다.

SingularSDKObject 설정 구성하기

1. SingularSDKObject에 대한 검사 창의 각 필드에 Singular SDK 키와 SDK 시크릿을 붙여넣습니다. SDK 키 및 비밀번호를 검색하려면 Singular 계정에 로그인하고"개발자 도구 > SDK 연동 > SDK 키"로 이동합니다.)
   
   
   
   중요: Singular 리포팅 API 키를 사용하지 않으면 SDK 데이터를 받을 수 없습니다. 위의 지침에 따라 적절한 키와 비밀번호를 검색하세요.
   
   
   

   Singular SDK 키와 비밀번호가 잘못 적용되면 데이터가 Singular로 전송되지 않습니다.
   Singular SDK 콘솔을 사용하여 구현을 테스트하여 올바른 동작을 확인하세요.

   참고: SingularSDKObject의 기본 검사 창 설정:

   검사 창에서 다음 옵션이 활성화됩니다:

   #

   • 깨어 있을 때 초기화 (체크됨)

     이 설정을 사용하면 Unity가 앱의 깨어 있음 상태에 따라 Singular SDK 초기화를 제어할 수 있습니다.

     앱 요구 사항에 대한 개인정보 보호 규정 준수를 따르고 필요에 따라 이 옵션을 업데이트하세요. 이 옵션을 선택 취소하면 깨어 있음 상태의 Singular SDK 초기화가 비활성화되며 수동으로 초기화해야 합니다.

   • SKAN 사용 (체크됨)

     Unity SDK 버전 4.0.17부터 SKAdNetwork가 기본적으로 활성화됩니다. 이 기능은 관리 모드(Singular 대시보드에서 사용자가 선택한 전환 모델을 사용하여 Singular가 SKAN 전환 값을 업데이트하는 모드)에서 활성화됩니다.

   • 추적 승인 대기, 0으로 설정(꺼짐)

     앱에 앱 추적 투명도(ATT) 프롬프트가 표시되는 경우, 이 시간 제한을 300초로 설정하는 것이 좋습니다. 시간 제한을 추가하면 Singular SDK 세션이 지연되어 사용자가 이벤트를 Singular 서버에 로깅하기 전에 앱 트래킹 투명성 동의를 승인/거부할 수 있습니다. 사용자가 ATT 프롬프트에 응답하면 Singular SDK는 지체 없이 계속 진행됩니다. 이렇게 하면 동의가 제공될 때 인스톨 어트리뷰션에 대한 IDFA 식별자를 캡처할 수 있습니다. ATT를 표시하지 않는 경우 이 옵션의 기본값은 0(대기 없음)으로 유지해야 합니다.

   • 로깅 활성화 (체크)

     Singular SDK에서 로깅을 활성화합니다. 이 옵션은"로그 수준" 옵션과 함께 사용해야 합니다.
     "로그 수준"은 아래 열거형 매핑에 명시된 대로 "int" 숫자로 지정해야 합니다. 이 범위의 숫자가 낮을수록 로그가 더 상세하게 기록됩니다.

     //Based on Android Logger.java log levels enum: android.util.Log
     public enum LogLevel {
        Verbose = 2,
        Debug   = 3,
        Info    = 4,
        Warn    = 5,
        Error   = 6,
        Assert  = 7
        }

     참고: 현재 대부분의 로그는 Android에서만 사용할 수 있습니다.

   • Ddl 시간 초과 초를 0으로 설정

     기본적으로 "0"으로 설정하면 60초의 시간 제한이 사용됩니다. 이는 Singular 서버가 마지막 터치 어트리뷰션에 연결된 딥링크 값을 검색할 수 있는 시간을 알려줍니다. 디퍼드 딥링크가 발견되면 SDK 세션 요청에 대한 응답에서 앱으로 다시 전송되고 SingularLinkHandler에서 처리됩니다. 60초 이내에 디퍼드 딥링크를 찾지 못하면 서버는 검색을 중지합니다.

   • 세션 시간 초과 초가 0으로 설정됨

     앱이 백그라운드에서 포그라운드로 돌아올 때 Singular SDK가 새 세션을 등록하기 전까지의 시간(초)입니다. 기본적으로 "0"으로 설정하면 60초의 시간 제한이 사용됩니다. 필요한 경우 이 설정을 조정하여 더 긴 시간으로 설정할 수 있습니다.

   • 쇼트링크 확인 시간 제한을 0으로 설정

     기본적으로 '0'으로 설정하면 10초의 시간 제한이 사용됩니다. 이 시간 제한은 사용자 환경을 보호합니다. 지정된 시간 내에 지정된 쇼트링크가 해결되지 않으면 Singular SDK는 딥링크 핸들러를 트리거하지 않습니다.

   기타 검사 창 옵션:

   Facebook 활성화(메타 설치 리퍼러)

   #

   메타 인스톨 리퍼러 어트리뷰션 방법을 지원하려면 SingularSDKObject의 검사 창에Facebook 앱 ID를 추가합니다.

   1. 메인 장면에서 SingularSDKObject를 클릭합니다.
   2. 검사 창을 열고 "Facebook 앱 ID" 필드를 찾습니다.
   3. Facebook 앱 ID를 추가합니다.

   메타 인스톨 리퍼러란 무엇인가요?

   앱의 Facebook 앱 ID는 어디에서 찾을 수 있나요?

2.2. SKAdNetwork 사용

Unity SDK 버전 4.0.17부터 SKAdNetwork가 기본적으로 활성화됩니다. 이 기능은 관리 모드(Singular 대시보드에서 선택한 전환 모델을 사용하여 Singular가 SKAN 전환 값을 업데이트하는 방식)에서 활성화됩니다.

최신 SDK를 사용하는 한 SKAdNetwork를 사용하기 위해 다른 설정이나 코드를 추가할 필요가 없습니다.

추가 정보

// A sign-up event happened


Singular.Event("SignUp");

// Update the conversion value to 7


SingularSDK.SkanUpdateConversionValue(7);

int? value = SingularSDK.SkanGetConversionValue();

public class Main : MonoBehaviour, SingularConversionValueUpdatedHandler {
  void Awake() {
    SingularSDK.SetConversionValueUpdatedHandler(this);
  }

  void OnConversionValueUpdated(int value) {
    // Use the conversion value


  }
}

2.3. iOS 앱 트래킹 투명성(ATT) 동의 처리하기

앱 추적 투명성(ATT) 프롬프트가 표시되나요?

iOS 14.5부터 앱은 추적 목적에 유용한 기기의 IDFA를 포함한 일부 사용자 데이터에 액세스하고 공유하기 전에 앱 추적 투명성 프레임워크를 사용하여 사용자 동의를 요청해야 합니다.

Singular 및 광고 네트워크는 IDFA를 통해 디바이스를 식별하고 인스톨 어트리뷰션을 수행함으로써 큰 이점을 얻을 수 있습니다(IDFA 없이도 이 작업을 수행할 수 있는 방법이 있지만). IDFA를 얻기 위해 사용자의 동의를 구할 것을 강력히 권장합니다.

사용자가 ATT 프롬프트에 응답할 때까지 Singular SDK 초기화를 지연하는 것이 좋습니다.

기본적으로 Singular SDK는 초기화될 때 사용자 세션을 전송합니다. 새 디바이스에서 세션이 전송되면 즉시 Singular의 어트리뷰션 프로세스가 트리거되며, 이 프로세스는 해당 시점에 Singular에서 사용 가능한 데이터만을 기반으로 수행됩니다. 따라서 Singular SDK가 첫 세션을 전송하기 전에 동의를 요청하고 IDFA를 검색하는 것이 필수적입니다.

대기 시간 제한 간격을 구성하려면 SingularSDKObject 검사 창에서 구성 옵션을 조정합니다. 이 옵션은 이벤트를 Singular 서버에 로깅하기 전에 사용자가 앱 추적 투명성 동의를 승인/거부할 때까지 기다리는 최대 시간(초)을 설정합니다.

2.4. 딥링크 처리

딥링크는 사용자를 앱 내의 특정 콘텐츠로 안내하는 URL입니다. 사용자가 앱이 이미 설치된 기기에서 딥링크를 클릭하면 앱이 열리고 특정 제품이나 경험을 표시합니다.

Singular 추적 링크에는 딥링킹과 디퍼드 딥링킹이 모두 포함될 수 있습니다. 자세한 내용은 딥링킹 FAQ 및 Singular 링크 FAQ를 참조하세요.

플랫폼 지원 및 핸들러 코드에 대한 자세한 내용은 아래 섹션을 확장하세요:

using System.Collections;
using System.Collections.Generic;
using UnityEngine;
using Singular;

public class SingularMain : MonoBehaviour, SingularLinkHandler
{
    // Start is called before the first frame update


    void Start()
    {
        
    }
    
    void Awake () {
        Debug.Log("Singular === Awake");
        /* Register the class as the Singular Link handler. 
           You can call this method at any point in the app's run. 
           It will fetch the tracking link details and call OnSingularLnkResolved. */
        SingularSDK.SetSingularLinkHandler(this);
    }
    
    public void OnSingularLinkResolved(SingularLinkParams linkParams) {
        Debug.Log("Singular === OnSingularLinkResolved");
        
        // The deep link destination, as configured in the Manage Links page


        string deeplink = linkParams.Deeplink;

        // The passthrough parameters added to the link, if any.


        string passthrough = linkParams.Passthrough;

        // Whether the link configured as a deferred deep link.


        bool isLinkDeferred = linkParams.IsDeferred;

        // Add code here to process the deeplink


        Debug.Log("Singular === deeplink: "+deeplink);
        Debug.Log("Singular === passthrough: "+passthrough);
        Debug.Log("Singular === isLinkDeferred: "+isLinkDeferred);      
    }
}

public void SetSingularLinkHandler(SingularLinkHandler 
handler)

public class Main : MonoBehaviour, SingularLinkHandler {
    void Awake () {
        SingularSDK.SetSingularLinkHandler(this)
    }
}

public void OnSingularLinkResolved(SingularLinkParams
linkParams)

public void OnSingularLinkResolved(SingularLinkParams
linkParams){
    // Read the tracking link details and log them


    Debug.Log("deeplink: " + linkParams.Deeplink);
    Debug.Log("passthrough: " + linkParams.Passthrough);
    Debug.Log("is_deferred: " + linkParams.IsDeferred);
}

2.5. SDK 초기화하기

앱을 열 때마다 SDK 초기화 코드를 호출해야 합니다. 이는 모든 Singular 어트리뷰션 기능의 전제 조건이며, 사용자 리텐션을 계산하는 데 사용되는 새 세션을 Singular로 전송합니다.

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

수동 초기화

앱 실행 후 나중에 SDK를 수동으로 초기화하려면 다음을 수행합니다:

1. SingularSDK 개체의 검사 창에서 깨어날 때 초기화 옵션을 비활성화합니다.
2. SingularSDK.InitializeSingularSDK 정적 메서드를 사용하여 SDK를 초기화합니다:

public void InitializeSingularSDK()

// SDK Key and SDK Secret are set on the 


// game object associated with SingularSDK 


SingularSDK.InitializeSingularSDK();

2.6. 세션 타임아웃 구성(선택 사항)

기본적으로 앱이 백그라운드에서 60초 이상 실행된 후 포그라운드로 돌아가는 경우 Singular SDK는 새 세션을 등록합니다. SingularSDKObject의 세션 타임아웃 초 속성을 수정하여 기본 타임아웃 값을 변경할 수 있습니다.

2.7. Singular에 사용자 ID 보내기(선택 사항)

Singular SDK 메소드를 사용하여 내부 사용자 ID를 Singular로 보낼 수 있습니다.

• 사용자 ID는 모든 식별자가 될 수 있으며 PII(개인 식별 정보)를 노출해서는 안 됩니다. 예를 들어, 사용자의 이메일 주소, 사용자 이름 또는 전화번호를 사용해서는 안 됩니다. Singular는 퍼스트 파티 데이터에만 고유한 해시값을 사용할 것을 권장합니다.
• 또한 Singular에 전달되는 사용자 ID 값은 모든 플랫폼(웹/모바일/PC/콘솔/오프라인)에서 캡처한 내부 사용자 ID와 동일해야 합니다.
• Singular는 사용자 수준 내보내기, ETL 및 내부 BI 포스트백(구성된 경우)에 사용자 ID를 포함합니다. 사용자 ID는 퍼스트 파티 데이터이며, Singular는 이를 다른 당사자와 공유하지 않습니다.
• Singular SDK 메서드로 설정한 경우, 사용자 ID 값은 UnsetCustomUserId 메서드를 사용하여 설정 해제하거나 앱이 제거될 때까지 유지됩니다. 앱을 닫거나 다시 시작해도 사용자 ID는 설정이 해제되지 않습니다.

사용자 ID를 설정하려면 SetCustomUserId 메서드를 사용합니다. 설정을 해제하려면(예: 사용자가 계정에서 '로그아웃'하는 경우) UnsetCustomUserId 으로 전화하세요.

앱이 열릴 때 사용자 ID를 이미 알고 있는 경우 Singular SDK를 초기화하기 전에 SetCustomUserId 으로 전화하세요. 이렇게 하면 Singular가 첫 번째 세션에서 사용자 ID를 가져올 수 있습니다. 그러나 일반적으로 사용자가 등록하거나 로그인을 수행할 때까지 사용자 ID를 사용할 수 없습니다. 이 경우 등록 흐름이 완료된 후 SetCustomUserId 을 호출하세요.

SingularSDK.SetCustomUserId("custom_user_id");

SingularSDK.UnsetCustomUserId();

SingularSDK.SetDeviceCustomUserId('CustomUserId');

3. 이벤트 및 구매 추적

3.1. 이벤트 추적 (비구매)

Singular는 인앱 이벤트에 대한 데이터를 수집하여 캠페인의 성과를 분석하고 KPI를 측정할 수 있습니다. 예를 들어, 게임 앱에서 사용자 로그인, 등록, 튜토리얼 완료 또는 레벨 업에 대한 데이터를 수집하고자 할 수 있습니다.

Singular는 다양한 표준 이벤트를 지원합니다. 광고 네트워크는 보고 및 최적화를 위해 일반적으로 사용되는 이러한 이벤트를 지원하는 경우가 많습니다. 또 다른 장점은 표준 이벤트 이름을 사용하면 수동으로 정의할 필요 없이 Singular가 자동으로 인식하여 이벤트 목록에 추가한다는 것입니다. 가능하면 표준 이벤트를 사용하는 것이 좋습니다.

Singular로 전송되는 이벤트 목록(첨부된 속성 포함)은 UA/마케팅/비즈니스 팀에서 조직의 마케팅 KPI에 따라 작성해야 합니다. 비즈니스 팀은 인앱 이벤트 추적 방법을 따를 수 있습니다: Singular 어트리뷰션 고객을 위한 가이드.

추적하는 각 이벤트마다 다양한 어트리뷰트를 전달할 수 있습니다. 이벤트별 권장 표준 어트리뷰트를 참조하세요.

코드의 event 또는 eventWithArgs 메서드를 사용하여 표준 이벤트를 Singular로 전송합니다.

SingularSDK.Event(Events.sngLogin);

public static void Event(string name)

public static void Event(string name, params object[] args)

public static void Event(Dictionary<string, object> args, string name)

// 1) Send the standard event Login


SingularSDK.Event(Events.sngLogin);

// 2) An example custom event passing two key value pairs


SingularSDK.Event("myEventName", "Key1", "Value1", "Key2", 1234);

// 3) An example JSON Event passing a dictionary


// Create a dictionary for attributes


Dictionary<string, object> attributes = new Dictionary<string, object>();

// Add attributes


attributes["key1"] = "value1";
attributes["key2"] = "value2";
attributes["key3"] = "value3";
// Add more attributes as needed



SingularSDK.Event(attributes, "myEventName");

3.2. 구매 추적

Singular는 앱을 통해 얻은 구매에 대한 데이터를 수집하여 캠페인의 성과와 ROI를 분석하는 데 도움을 줄 수 있습니다. Singular는 보고서, 로그 내보내기 및 포스트백에서 데이터를 사용할 수 있도록 합니다.

유니티의 기본 제공 IAP(인앱 구매) 오브젝트를 사용하여 구매 이벤트를 추적할 수 있습니다. 이렇게 하면 Singular가 구매에 대한 모든 가용 정보를 가져와 더욱 풍부한 리포팅을 제공합니다. 또한, Singular는 구매 영수증을 받아 백엔드에서 구매를 검증하고 어트리뷰션 부정을 배제하는 데 사용합니다.

public static void InAppPurchase(Product product, Dictionary<string, object> attributes, bool isRestored = false)

public static void InAppPurchase(string eventName, Product product, Dictionary<string, object> attributes, bool isRestored = false)

public static void InAppPurchase(IEnumerable<Product> products,
Dictionary<string, object> attributes, bool isRestored = false)

public static void InAppPurchase(string eventName,IEnumerable<Product> products, Dictionary<string, object> attributes, bool isRestored = false)

// IAP with a single product and no extra attributes


SingularSDK.InAppPurchase(myProduct, null);

// IAP with a single product and attributes


var attr = new Dictionary<string, object>() {
["my_first_attribute"] = "value1",
["my_second_attribute"] = "value2"};
 
SingularSDK.InAppPurchase(myProduct, attr);

// IAP with with a single product, 


// no extra attributes and a custom event name



SingularSDK.InAppPurchase("MyCustomProduct",
myProduct, null);

// IAP with list of products, no extra attributes


SingularSDK.InAppPurchase(myProductList, null);

// IAP with with list of products, no extra attributes


// and a custom event name



SingularSDK.InAppPurchase("MyCustomProducts",
myProductList, null);

public static void Revenue(string currency, double amount)

public static void Revenue(string currency, double amount, string productSKU, string productName, string productCategory, int productQuantity, double productPrice)

public static void Revenue(string currency, double amount, Dictionary<string, object> attributes)

// Send a revenue event with no product details


SingularSDK.Revenue("USD", 1.99);

// Send a revenue event with product details


SingularSDK.Revenue("USD", 4.99, "coin_package_abc123", "Coin Pack 5", "Bundles", 1, 4.99);

// Send a revenue event with JSON Dictionary for attributes


Dictionary<string, object> attributes = new Dictionary<string, object>();

// Add attributes


attributes["productSKU"] = "coin_package_abc123";
attributes["productName"] = "Coin Pack 5";
attributes["productCategory"] = "Bundles";
attributes["productQuantity"] = 2;
attributes["productPrice"] = 4.99;

SingularSDK.Revenue("USD", 9.98, attributes);

public static void CustomRevenue(string eventName, string currency, double amount)

public static void CustomRevenue(string eventName, string currency, double amount, string productSKU, string productName, string productCategory, int productQuantity, double productPrice)

public static void CustomRevenue(string eventName, string currency, double amount, Dictionary<string, object> attributes)

// Send a revenue event with a custom name


SingularSDK.CustomRevenue("MyCustomRevenue", "USD", 9.99);

// Send a revenue event with a custom name + product details


SingularSDK.CustomRevenue("MyCustomRevenue", "USD", 50.50, "abc123", "myProductName", "myProductCategory", 2, 25.50);

// Send a revenue event with a custom name + JSON Dictionary for attributes


// Create a dictionary for attributes


Dictionary<string, object> attributes = new Dictionary<string, object>();

// Add attributes


attributes["productSKU"] = "coin_package_abc123";
attributes["productName"] = "Coin Pack 5";
attributes["productCategory"] = "Bundles";
attributes["productQuantity"] = 2;
attributes["productPrice"] = 4.99;
// Add more attributes as needed



SingularSDK.CustomRevenue("MyCustomRevenue", "USD", 9.98, attributes);

3.3. 하이브리드 이벤트 추적(고급)

Singular는 앱에 연동된 Singular SDK를 통해 모든 이벤트와 구매을 전송할 것을 권장합니다. 그러나 Singular는 다른 소스에서 이벤트와 구매을 수집할 수 있습니다.

Singular SDK에서 전송되지 않은 모든 이벤트는 Singular의 서버 간 이벤트 문서 요구사항을 준수해야 하며, 이벤트의 정확한 어트리뷰션을 위해 일치하는 기기 식별자를 제공해야 합니다.

하이브리드 이벤트 추적 가이드

4. 고급 옵션

4.1. 짧은 리퍼러 링크 생성

짧은 링크를 사용하면 매개변수로 채워진 긴 Singular 링크를 공유에 편리한 더 짧고 안전한 링크로 변환할 수 있습니다.

일반적으로 앱 사용자가 친구와 공유하여 앱을 사용하도록 초대할 수 있도록 짧은 링크를 동적으로 생성하고 싶을 것입니다.

짧은 링크를 만들려면 다음이 필요합니다:

• 앱 다운로드로 연결되는 Singular 링크 ( Singular 링크 FAQ 참조).
• 링크에 원하는 매개변수를 동적으로 추가할 수 있습니다(옵션 목록은 링크 매개변수 추적 참조).
• 링크를 공유한 사용자의 새 앱 설치를 추적하려면 추천 사용자의 리퍼러 이름과 리퍼러 ID를 제공해야 합니다.

아래 예시와 같이 createReferrerShortLink 메서드를 사용하여 짧은 링크를 생성합니다.

void callback(string shortLinkURL, string error){
    // Add your share logic here if shortLinkURL is not null


    // If there was an error, add logic to retry/abort/modify the params


    // passed to the function, based on the cause of the error


}

SingularSDK.createReferrerShortLink(
    "https://sample.sng.link/B4tbm/v8fp?_dl=https%3A%2F%2Fabc.com",
    "John Doe", // Referrer Name


    "342", // Referrer ID


    new Dictionary<string, string>() { 
        // a Dictionary object containing any parameters you want to add


        {"channel", "sms"}
    },
    callback 
);

4.2. 광고 구매 어트리뷰션 지원 추가하기

4.3. 제거 추적

Android 제거 추적

Android 앱에 대해 제거 추적을 사용 설정하려면 먼저 제거 추적 설정에 설명된 대로 Singular 플랫폼에서 앱을 구성합니다. 그런 다음 아래 지침을 따릅니다.

FCM(Firebase 클라우드 메시징)을 사용하여 제거 추적 활성화하기:

1. FCM과 연동합니다:

제거를 추적하려면 FCM(Firebase Cloud Messaging) 플랫폼의 서비스를 사용할 수 있습니다. 아직 FCM을 사용하고 있지 않다면 Google의 Android에서 Firebase 클라우드 메시징 클라이언트 앱을 설정하는 방법에 대한 지침을 따르세요.

2. AndroidManifest.xml 파일을 업데이트합니다:

AndroidManifest.xml 파일을 업데이트하여 앱에 필요한 인텐트 필터를 추가합니다(MyFirebaseMessagingService를 Firebase 서비스를 구현하는 클래스로 대체):

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

3. FCM 장치 토큰을 등록하고 전송합니다:

FCM 토큰을 검색한 후 'RegisterTokenForUninstall' 메서드에 파라미터로 전달합니다:

SingularSDK.RegisterTokenForUninstall(String fcmDeviceToken);

'RegisterTokenForUninstall' 메서드는 'SingularSDK.InitializeSingularSDK()' 메서드 전에 호출해야 합니다.

iOS 제거 추적

iOS의 앱 제거 추적은 Apple 푸시 알림 기술을 기반으로 합니다. 앱이 푸시 알림을 지원하지 않는 경우 Apple 가이드를 참조하세요. 앱이 이미 푸시 알림을 지원하는 경우 SDK가 초기화된 후 RegisterTokenForUninstall 메서드를 사용하여 APNS에서 반환된 디바이스 토큰을 전달해야 합니다.

public static void RegisterTokenForUninstall
(string APNSToken)

// pass the APNS token as a hex-string 


  SingularSDK.RegisterTokenForUninstall("ba85ab31a7c7
f5c2f012587f29fb0e596d4b67e7b7b2838fa1a8582c1f7dbdee");

4.4. 글로벌 속성 추가하기

앱에서 전송되는 모든 세션과 이벤트에 대해 Singular SDK를 사용하면 사용자 지정 추가 속성을 정의하여 Singular 서버로 전송할 수 있습니다. 이러한 속성은 사용자, 앱 모드, 상태 등 원하는 모든 정보를 나타낼 수 있습니다. 이러한 속성을 설정하면 보고서에서 기준으로 사용할 수 있으며, 이를 사용하여 데이터를 세분화할 수 있습니다.

예를 들어 게임 앱이 있는 경우 '레벨'이라는 속성을 정의하고 처음에는 '0'으로 설정할 수 있습니다. 앱에서 전송되는 모든 세션과 이벤트는 "Level": "0". 사용자가 레벨을 올리면 해당 속성을 "1"로 재설정하는 등의 방식으로 재설정합니다. 그러면 세션, 이벤트 수, 구매 데이터를 포함한 보고서를 사용자 레벨별로 세분화하여 얻을 수 있습니다.

초기화 전에 글로벌 속성 설정하기

SDK를 초기화하기 전에 SetGlobalProperty 메서드를 사용하여 SingularSDK를 통해 글로벌 프로퍼티를 설정할 수 있습니다. 글로벌 프로퍼티를 세션에 포함하려면 '깨어 있을 때 초기화' 플래그를 끄세요.

글로벌 프로퍼티와 해당 값은 앱 실행 간에 유지되므로 설정하려는 프로퍼티가 이미 다른 값으로 설정되어 있을 수 있습니다. 기존 프로퍼티를 새 값으로 재정의할지 여부를 SDK에 알려주려면 overrideExisting 파라미터를 사용하세요.

초기화 후 전역 프로퍼티 설정

다음 메서드를 사용하여 앱 실행 중 언제든지 글로벌 프로퍼티를 설정, 설정 해제 및 검색할 수 있습니다.

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

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

SingularSDK.UnsetGlobalProperty(“test_key”);

SingularSDK.clearGlobalProperties();

4.5. 구형 안드로이드 기기에서 인스톨 리퍼러 수집하기

안드로이드에서 인스톨 리퍼러는 어트리뷰션을 결정하고 사기 시도를 감지 및 분석하는 데 도움을 주는 가장 정확한 Singular의 툴입니다. 이는 사용자가 앱을 설치하기 전에 클릭한 광고를 가리키는 구글 플레이 스토어에서 제공하는 식별자입니다.

최신 버전의 구글 플레이 스토어가 설치된 기기에서, Singular SDK는 자동으로 인스톨 리퍼러 값을 수집합니다(Singular는 최신 구글 플레이 리퍼러 API와 연동되어 있기 때문에).

구형 기기에서 인스톨 리퍼러를 수집하려면 Android SDK 가이드의 지침을 따르세요.

5. 데이터 개인정보 보호법 준수

5.1. 데이터 공유 제한

Singular는 GDPR 및 CCPA(캘리포니아 소비자 개인정보 보호법)와 같은 소비자 개인정보 보호법을 준수하는 모든 파트너와 협력할 수 있도록 개인정보 보호 기능을 제공합니다. 이러한 파트너는 최종 사용자가 개인 정보 공유에 동의한 경우 알림을 받기를 원합니다.

데이터 공유 제한

사용자에게 정보 공유에 대한 동의를 요청하는 방법을 구현한 경우 limitDataSharing 메서드를 사용하여 사용자의 선택 사항을 Singular에 알립니다:

• 사용자가 정보 공유에 동의(옵트인)했음을 표시하려면 limitDataSharing:NO를 사용합니다.
• 사용자가 동의하지 않은 경우 limitDataSharing:YES를 사용합니다.

Singular는'사용자 개인정보 포스트백'에서 제한데이터공유를 사용하고 관련 규정을 준수하기 위해 이 정보를 필요로 하는 파트너에게 이 정보를 전달합니다. 자세한 내용은"사용자 개인정보 및 데이터 공유 제한"을 참조하세요.

// User has opted in to sharing data


SingularSDK.LimitDataSharing(false);

5.2. GDPR 준수를 위한 추가 방법

Singular SDK는 GDPR 정책을 준수하고 추적에 대한 사용자 동의 또는 비동의를 Singular에 알리는 데 도움이 되는 몇 가지 방법을 제공합니다.

SingularSDK.TrackingOptIn();

SingularSDK.StopAllTracking();

SingularSDK.ResumeAllTracking();

SingularSDK.IsAllTrackingStopped();