ユーザーIDの設定

内部ユーザーIDをSingularに送信して、クロスデバイストラッキングとユーザーレベルのデータレポートを有効にします。

ユーザーIDの要件

プライバシーとベストプラクティス

プライバシーコンプライアンスと正確なクロスデバイス測定を確保するため、ユーザーIDトラッキングを実装する際は以下のガイドラインに従ってください。

• PII禁止: ユーザーIDは、メールアドレス、ユーザー名、電話番号などの個人を特定できる情報（PII）を露出してはなりません。ファーストパーティデータに固有のハッシュ値を使用してください。
• プラットフォーム間の一貫性: ユーザーIDの値は、正確なクロスデバイス測定のために、すべてのプラットフォーム（Web/Mobile/PC/Console/Offline）で取得する同じ内部識別子である必要があります。
• ファーストパーティデータ: SingularはユーザーIDをユーザーレベルのエクスポート、ETL、および内部BIポストバック（構成されている場合）に含めます。ユーザーIDはファーストパーティデータであり、第三者と共有されることはありません。
• 永続性: ユーザーIDは、 unsetCustomUserId() を使用して明示的に解除するか、アプリがアンインストールされるまで保持されます。アプリを閉じたり再起動したりしてもユーザーIDはクリアされません。

実装の概要

ユーザーIDを設定するタイミング

ユーザー識別子を設定するには setCustomUserId() を使用し、ログアウト中にクリアするには unsetCustomUserId() を使用します。

アプリを開く時点で既にユーザーIDが分かっている場合は、Singular SDKを初期化する前に setCustomUserId() を呼び出してください。これにより、Singularは最初のセッションからユーザーIDを受け取ることができます。ただし、ユーザーIDは通常、ユーザーが登録またはログインするまで利用できないため、その場合は登録または認証フローが完了した後に setCustomUserId() を呼び出してください。

SDKメソッド

カスタムユーザーIDの設定

クロスデバイストラッキングとユーザーレベルのレポートのために、内部ユーザーIDをSingularに送信します。

// Set the user ID after login or registration
Singular.setCustomUserId("custom_user_id")

// Set the user ID after login or registration
Singular.setCustomUserId("custom_user_id");

メソッドシグネチャ:

public static void setCustomUserId(String customUserId);

カスタムユーザーIDの解除

複数のユーザーが使用するデバイスで正確なセッショントラッキングを確保するため、ユーザーがログアウトする際にユーザーIDをクリアしてください。

// Unset the user ID on logout
Singular.unsetCustomUserId()

// Unset the user ID on logout
Singular.unsetCustomUserId();

メソッドシグネチャ:

public static void unsetCustomUserId();