iOS SDK - ユーザーIDの設定

フォローする
Avatar
Jared Ornstead
Updated

ユーザーIDの設定

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

注意: Singularの クロスデバイスソリューション を使用する場合、すべてのプラットフォームで ユーザーIDを収集する必要があります。

ユーザーIDの要件

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

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

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

実装の概要

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

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

ベストプラクティス: 複数のユーザーが1台のデバイスを共有する場合、 ログイン時に setCustomUserId() を呼び出し、ログアウト時に unsetCustomUserId() を呼び出すログアウトフローを実装してください。

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

SDKメソッド

Custom User IDの設定

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

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

メソッドシグネチャ: 

+ (void)setCustomUserId:(NSString *)customUserId;

+setCustomUserId: は void を返します。呼び出し時点での成功/失敗のシグナルはありません。ユーザーIDは SDKが送信する次のセッションおよびイベントに付加されます。

名前が似ている +setDeviceCustomUserId: は __attribute__((deprecated)) と注釈されており、レガシー互換性のためにのみ存在します。新しいコードでは常に +setCustomUserId: を呼び出してください。

Custom User IDの解除

マルチユーザーデバイスで正確なセッショントラッキングを確保するため、ユーザーが ログアウトしたらユーザーIDをクリアしてください。

Swift Objective-C 
// Unset the user ID on logout
Singular.unsetCustomUserId()

メソッドシグネチャ: 

+ (void)unsetCustomUserId;