짧은 리퍼러 링크 만들기

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

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

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

• 앱 다운로드로 연결되는 단일 링크 ( 단일 링크 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
  );

제거 추적

Android 제거 추적

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

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

1. FCM과 통합합니다:

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

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에서 반환된 디바이스 토큰을 전달하기만 하면 됩니다.

public static void SetUninstallToken(FString token)

// 토큰을 16진수 문자열로 전달
USingularSDKBPLibrary::SetUninstallToken("ba85ab31a7c7f5c2f012587f29fb0e596d4b67e7b7b2838fa1a8582c1f7dbdee");

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

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

데이터 공유 제한

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

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

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

// 사용자가 데이터 공유를 선택했습니다.
USingularSDKBPLibrary::LimitDataSharing(false);

GDPR 준수를 위한 추가 방법

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

USingularSDKBPLibrary::TrackingOptIn();

USingularSDKBPLibrary::StopAllTracking();

USingularSDKBPLibrary::ResumeAllTracking();

USingularSDKBPLibrary::IsAllTrackingStopped();