Unreal Engine SDK : 고급 옵션

싱글 언리얼 엔진 SDK
다운로드
싱글 언리얼 엔진 SDK 버전 2.4.0
호환성

언리얼 엔진 4.23 이상

통합 가이드
  1. 기본 통합
  2. 이벤트 및 수익 추적
  3. 딥링크 구현하기
  4. SKAdNetwork 지원 추가
  5. 고급 옵션

 

짧은 리퍼러 링크 만들기

참고: 이 기능은 SDK 버전 2.0.6 이상에서 사용할 수 있습니다.

짧은 링크를 사용하면 매개변수로 가득 찬 긴 단일 링크를 공유하기에 편리한 더 짧고 안전한 링크로 변환할수 있습니다.

일반적으로 짧은 링크를 동적으로 생성하여 앱 사용자가 친구와 공유하여 앱을 사용하도록 초대할 수 있도록 하려는 경우가 많습니다.

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

  • 앱 다운로드로 연결되는 단일 링크 ( 단일 링크 FAQ 참조).
  • 링크에 동적으로 추가하려는 모든 매개변수 (옵션 목록은 링크 매개변수 추적참조).
  • 링크를 공유한 사용자의 새 앱 설치를 추적할 수 있도록 하려는 경우 추천 사용자의 이름과 ID입니다.

짧은 링크를 활성화하려면 먼저 이 코드를 메인 캐릭터 생성자에 추가합니다:

if (AUnrealTestAppCharacter::singularDelegates == NULL) {
    AUnrealTestAppCharacter::singularDelegates =
      CreateDefaultSubobject<USingularDelegates>(TEXT("SingularShortLinksHandler"));
      singularDelegates->OnSingularShortLinksResolved.AddDynamic(this, &AUnrealTestAppCharacter::SingularShortLinksResolved);
  }
      
  void AUnrealTestAppCharacter::SingularShortLinksResolved(const FSingularShortLinkParams& linkParams) {
    const FString shortLinkURL = linkParams.SingularShortLinksParams["data"];
    const FString errorMessage = linkParams.SingularShortLinksParams["error"];
/* 여기에 공유 논리를 추가하세요. 오류가 있는 경우 오류 원인에 따라 함수에 전달된 매개변수를 재시도/중단/수정하는 논리를 추가하세요.*/ }

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

// 링크에 매개변수를 추가합니다(긴 링크 URL에 매개변수가 아직 없는 경우).
  TMap<FString, FString> params;
  params.Add(TEXT("channel"), TEXT("sms"));
  params.Add(TEXT("anotherparam"), TEXT("paramvalue"));
  
  // 리퍼러 이름, 리퍼러 ID 및 선택적 추가 매개변수를 사용하여 원본 Singular 링크 URL을 기반으로 짧은 링크를 생성합니다.
  USingularSDKBPLibrary::CreateReferrerShortLink(
      "https://sample.sng.link/B4tbm/v8fp?_dl=https%3A%2F%2Fabc.com",
      "referrer name",
      "referrer ID", 
      params
  );

제거 추적

참고: 제거 추적은 Enterprise 고객만 사용할 수 있습니다.

Android 제거 추적

Android 앱에 대해 제거 추적을 사용 설정하려면 먼저 제거 추적 설정에 설명된 대로 단일 플랫폼에서 앱을 구성한 다음 아래 지침을 따르세요.

참고: 구글은 2018년 4월에 GCM API를 더 이상 사용하지 않습니다. 제거 추적에는 FCM을 사용합니다.

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

1. FCM과 통합합니다:

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

FCM 요구 사항(출처)

FCM 클라이언트를 사용하려면 Android 4.1 이상을 실행하는 기기에 Google Play 스토어 앱이 설치되어 있거나 Google API를 사용하여 Android 4.1을 실행하는 에뮬레이터가 필요합니다. Google Play 스토어를 통해서만 Android 앱을 배포할 수 있는 것은 아닙니다.

지원되는 Android 버전에서 실행되지 않는 사용자/기기는 단일 제거 추적에 사용할 수 없습니다.

2. 안드로이드 매니페스트.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>
<service android:name=".java.MyFirebaseMessagingService" android:exported="false"> <intent-filter> <action android:name="com.google.firebase.MESSAGING_EVENT" /> </intent-filter> </service>

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

마지막으로, 다음과 같이 OnCreate()에서 SingularConfig가 초기화된 후 FCM 디바이스 토큰을 설정합니다:

Singular.setFCMDeviceToken(String fcmDeviceToken);

iOS 제거 추적

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

SingularSDK SetUninstallToken 메서드
설명 APNS/FCM에서 반환된 장치 토큰을 전달합니다. APNS/FCM 토큰은 일반적으로 네이티브 형식의 바이너리 데이터이지만 문자열로 전달해야 합니다.
서명
public static void SetUninstallToken(FString token)
사용 예시
// 토큰을 16진수 문자열로 전달
USingularSDKBPLibrary::SetUninstallToken("ba85ab31a7c7f5c2f012587f29fb0e596d4b67e7b7b2838fa1a8582c1f7dbdee");

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

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

데이터 공유 제한

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

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

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

참고: 이 방법의 사용은 선택 사항이지만, 사용자가 옵트인했음을 구체적으로 고지한 경우에만 파트너가 싱귤러와 공유하는 어트리뷰션 정보가 있을 수 있습니다.

싱귤러SDK 데이터 공유 제한 방법
서명 public void LimitDataSharing(bool shouldLimitDataSharing)
설명 개인 데이터 공유에 대한 사용자 동의(옵트인)를 Singular에 알립니다.
사용 예시
// 사용자가 데이터 공유를 선택했습니다.
USingularSDKBPLibrary::LimitDataSharing(false);

 

GDPR 준수를 위한 추가 방법

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

싱귤러 SDK 트래킹 옵트인 메서드
설명 추적에 대한 사용자 동의(옵트인)를 Singular에 알립니다.
사용 예시
USingularSDKBPLibrary::TrackingOptIn();
SingularSDK StopAllTracking 메서드
설명 이 앱에서 이 사용자에 대한 모든 추적 활동을 중지합니다.
참고: 이 메서드를 호출하면 앱이 재시작된 후에도 SDK가 효과적으로 비활성화됩니다(상태는 지속됨). 추적을 다시 활성화하는 유일한 방법은 resumeAllTracking()을 호출하는 것입니다.
사용 예시
USingularSDKBPLibrary::StopAllTracking();
SingularSDK ResumeAllTracking 메서드
설명 이 앱에서 이 사용자에 대한 추적을 재개합니다.
사용 예시
USingularSDKBPLibrary::ResumeAllTracking();
SingularSDK IsAllTrackingStopped 메서드
설명 이 앱에서 이 사용자의 추적 상태를 확인합니다. StopAllTracking()을 사용하여 추적을 중지하고 다시 시작하지 않은 경우 true를 반환합니다.
사용 예시
USingularSDKBPLibrary::IsAllTrackingStopped();