프로젝트에 SDK 추가하기

프로젝트에 싱글 SDK를 추가하려면 다음과 같이 하세요:

1. 다운로드한 SDK 아카이브에 SDK 플러그인이 포함된 SingularSDK 폴더가 포함되어 있습니다. 앱의 플러그인 폴더에 SingularSDK 폴더를 복사합니다.

2. 앱의 Build.cs 파일(<YOUR_APP>.Build.cs)의 PublicDependencyModuleNames 배열에 SingularSDK를 종속 요소로 추가합니다:

   PublicDependencyModuleNames.AddRange(new string[] { "Core", "CoreUObject",
     "Engine", "InputCore", "SingularSDK" });

SDK 초기화

SDK 초기화 코드는 앱을 열 때마다 호출되어야합니다. 이는 모든 싱귤러 어트리뷰션 기능의 전제 조건이며, 사용자 리텐션을 계산하는 데 사용되는 새 세션을싱귤러로 전송하기도 합니다. 앱 실행 시 가능한 한 빨리 SDK를 초기화하는 것이 좋습니다.

SDK를 초기화하려면 SingularSDKBPLibrary 클래스에서 Initialize 메서드를 호출합니다:

static bool Initialize(FString sdkKey, FString sdkSecret,
       int sessionTimeout = 60,
       FString customUserId = TEXT(""),
       bool skAdNetworkEnabled = false,
       bool manualSkanConversionManagement = false,
       int waitForTrackingAuthorizationWithTimeoutInterval = 0,
       bool oaidCollection = false);

#include "SingularSDKBPLibrary.h"
  
  [...]
  
  USingularSDKBPLibrary::Initialize("SDK KEY", "SDK SECRET");
  

메서드 매개변수

싱귤러에 사용자 ID 보내기(선택 사항)

싱귤러 SDK 방법을 사용하여 내부 사용자 ID를 싱귤러에 전송할 수 있습니다.

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

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

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

USingularSDKBPLibrary::SetCustomUserId("custom_user_id");

USingularSDKBPLibrary::UnsetCustomUserId();

USingularSDKBPLibrary::SetDeviceCustomUserId("custom_user_id");

선택 사항입니다: iOS 14+ 앱 추적 투명성 지원

iOS 14+에서 앱은 디바이스의 IDFA 값을 사용하는 것을 포함하여 사용자 데이터를 공유하기 전에 사용자 동의를 요청해야 합니다( 앱 추적 투명성 참조). 싱귤러는 디바이스를 식별하고 인스톨 어트리뷰션을 수행하기 위해 IDFA를 사용하는 것이 큰 도움이 됩니다. 따라서, 싱귤러 SDK가 사용자 세션과 사용자 이벤트를 싱귤러 서버로 전송하기 전에 사용자 동의를 요청해야 합니다.

SDK가 세션을 전송하면, 해당 시점에 싱귤러가 사용할 수 있는 데이터만을 기반으로 싱귤러의 인스톨 어트리뷰션 프로세스가 트리거됩니다.

SDK가 사용자 세션과 사용자 이벤트를 전송하는 것을 지연시키려면 waitForTrackingAuthorizationWithTimeoutInterval 파라미터를 사용하여 Singular SDK를 초기화합니다. 그렇게 하면

1. SDK가 초기화되고 세션과 사용자 이벤트를 기록하기 시작하지만 아직 Singular 서버로 전송하지는 않습니다.
2. 앱 추적 투명성 동의가 승인/거부되거나 설정된 시간 제한이 경과하는 즉시, SDK는 세션과 대기 중인 모든 이벤트를 (IDFA를 사용하거나 사용하지 않고) Singular 서버로 전송합니다.
3. 그러면 싱귤러가 어트리뷰션 프로세스를 시작하여 사용 가능한 경우 IDFA를 활용합니다.

자세한 내용은 iOS 14 준비하기를 참조하세요.