ユーザー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"];メソッドの署名
+ (void)setCustomUserId:(NSString *)customUserId;カスタムユーザーIDの解除
ユーザーがログアウトした際にユーザーIDをクリアし、マルチユーザーデバイスの正確なセッショントラッキングを保証します。
// Unset the user ID on logout
Singular.unsetCustomUserId()// Unset the user ID on logout
[Singular unsetCustomUserId];方法署名
+ (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"];メソッドの署名
+ (void)setDeviceCustomUserId:(NSString *)customUserId;説明カスタムユーザーID（ログインと同じ）を設定し、サーバー間のイベント帰属のためにSingularのトラッキング識別子にマッピングします。