ユーザーIDの設定
社内ユーザーIDをSingularに送信して、クロスデバイス追跡とユーザーレベルデータレポートを有効にします。
注： Singularのクロスデバイスソリューションをご利用の場合は、すべてのプラットフォームでユーザーIDを収集する必要があります。
ユーザーIDの要件
プライバシーとベストプラクティス
プライバシーコンプライアンスと適切なクロスデバイス測定を保証するため、ユーザーIDトラッキングを実施する際は以下のガイドラインに従ってください。
- PIIなし：ユーザIDは、メールアドレス、ユーザ名、電話番号のような個人を特定できる情報（PII）を公開すべきではありません。 ファーストパーティデータに固有のハッシュ値を使用してください。
- プラットフォーム間の一貫性：ユーザーIDの値は、正確なクロスデバイス測定のために、すべてのプラットフォーム（ウェブ／モバイル／PC／コンソール／オフライン）で同じ内部識別子でなければなりません。
- ファーストパーティデータ：Singularは、ユーザーレベルのエクスポート、ETL、内部BIポストバック（設定されている場合）にユーザーIDを含めます。ユーザーIDはファーストパーティデータであり、第三者と共有されることはありません。
-
永続性：ユーザーIDは、
unsetCustomUserId()を使用して明示的に設定が解除されるか、アプリがアンインストールされるまで保持されます。アプリを終了または再起動しても、ユーザーIDはクリアされません。
実装の概要
ユーザIDを設定するタイミング
ユーザーIDを設定するにはsetCustomUserId() 、ログアウト時にクリアするにはunsetCustomUserId() 。
ベストプラクティス複数のユーザーが1つのデバイスを共有する場合は、ログイン時に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 void setCustomUserId(String customUserId)カスタムユーザーIDの解除
ユーザーがログアウトした際にユーザーIDをクリアし、マルチユーザーデバイスの正確なセッショントラッキングを保証します。
// Unset the user ID on logout
Singular.unsetCustomUserId()ode class="="java"// Unset the user ID on logout Singular.unsetCustomUserId();
方法署名
public void unsetCustomUserId()高度な機能
カスタムユーザーIDのデバイスマッピング
サーバー間の統合のために、ユーザーIDをSingularのモバイルデバイス追跡識別子にマッピングします。
重要:この高度なエンタープライズ機能は例外的な場合にのみ使用できます。実装する前にSingularのソリューションエンジニアにご相談ください。
Singularはサーバー間統合で追加のモバイルイベント追跡データを受け取ることができます。この機能を利用するには、ユーザーIDをSingularのモバイルデバイス追跡識別子にマッピングする必要があります。
注：Singular SDKを初期化した後、またはユーザーIDを取得した後、できるだけ早くこのメソッドを呼び出してください。
実装
setDeviceCustomUserId() を使用してカスタムユーザーIDを設定し、Singularのトラッキング識別子にマッピングします。
// Map user ID to device identifier for S2S integration
Singular.setDeviceCustomUserId("custom_user_id")// Map user ID to device identifier for S2S integration
Singular.setDeviceCustomUserId("custom_user_id");メソッドの署名
public void setDeviceCustomUserId(String customUserId)説明カスタムユーザーID（ログインと同じ）を設定し、それをSingularのトラッキング識別子にマッピングします。