ショートリファラーリンクの作成

ショートリンクを使用すると、長くてパラメータが多いシンギュラーリンクを、共有に便利な短くて安全なリンクに変換できます。

通常、ショートリンクを動的に作成し、アプリのユーザーが友達と共有してアプリの使用を招待できるようにします。

ショートリンクを作成するには

• アプリのダウンロードにつながるシンギュラーリンク（シンギュラーリンクの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"];
  // Add your share logic here

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

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

  }

次に、CreateReferrerShortLinkメソッドを使用して、以下の例のようにショートリンクを作成します。

// Add parameters to the link (if they don't already exist in the long link URL)

  TMap<FString, FString> params;
  params.Add(TEXT("channel"), TEXT("sms"));
  params.Add(TEXT("anotherparam"), TEXT("paramvalue"));
  
  // Create the short link based on the original Singular Link URL 

// with a referrer name, referrer ID, and optional additional parameters

  USingularSDKBPLibrary::CreateReferrerShortLink(
      "https://sample.sng.link/B4tbm/v8fp?_dl=https%3A%2F%2Fabc.com",
      "referrer name",
      "referrer ID", 
      params
  );

アンインストールの追跡

Android のアンインストール追跡

Android アプリのアンインストールトラッキングを有効にするには、まず、 アンインストールトラッキングの設定の詳細に従って、Singular プラットフォームでアプリを設定します。その後、以下の手順に従ってください。

Firebase Cloud Messaging (FCM) を使用してアンインストールトラッキングを有効にする

1.FCM と統合します：

アンインストールを追跡するには、Firebase Cloud Messaging (FCM) プラットフォームのサービスを使用できます。FCM をまだ使用していない場合は、 Android で Firebase Cloud Messaging クライアントアプリをセットアップする方法について、Google の指示に従ってください。

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デバイストークンの登録と送信

最後に、OnCreate()でSingularConfigを初期化した後、以下のようにFCMデバイストークンを設定します：

Singular.setFCMDeviceToken(String fcmDeviceToken);

iOS のアンインストールトラッキング

iOS のアンインストールトラッキングは Apple のプッシュ通知テクノロジーに基づいています。アプリが現在プッシュ通知をサポートしていない場合は、 Apple のガイドを参照してください。アプリがすでにプッシュ通知をサポートしている場合は、SDK が初期化された後、RegisterDeviceTokenForUninstall メソッドを使用して APNS から返されたデバイストークンを渡すだけです。

public static void SetUninstallToken(FString token)

// pass the token as a hex-string

  USingularSDKBPLibrary::SetUninstallToken("ba85ab31a7c7
f5c2f012587f29fb0e596d4b67e7b7b2838fa1a8582c1f7dbdee");

データプライバシー法の遵守

Singularは、GDPRやCCPA（カリフォルニア州消費者プライバシー法）のような消費者プライバシー法を遵守する可能性のあるパートナーと協力するためのプライバシー保護機能を提供します。このようなパートナーは、エンドユーザーが個人情報の共有に同意した場合に通知されることを望んでいます。

データ共有の制限

ユーザーに情報共有の同意を求める方法を実装している場合は、limitDataSharingメソッドを使用してユーザーの選択をSingularに通知します：

• limitDataSharing:NO を使用して、ユーザーが情報の共有に同意した (オプトインした) ことを示します。
• ユーザーが同意しなかった場合はlimitDataSharing:YESを使用します。

Singularは「ユーザープライバシーのポストバック」においてLimitDataSharingを使用し、関連法規を遵守するためにこの情報を必要とするパートナーに情報を提供します。詳しくは「ユーザーのプライバシーとデータ共有の制限」をご覧ください。

// user has opted in to share data

  USingularSDKBPLibrary::LimitDataSharing(false);

GDPR準拠のための追加メソッド

Singular SDKは、GDPRポリシーに準拠し、トラッキングに対するユーザーの同意または非同意についてSingularに知らせるためのメソッドをいくつか提供しています。

USingularSDKBPLibrary::TrackingOptIn();

USingularSDKBPLibrary::StopAllTracking();

USingularSDKBPLibrary::ResumeAllTracking();

USingularSDKBPLibrary::IsAllTrackingStopped();