ユーザー属性とユーザー識別子の違い
MoEngage において、ユーザー属性とユーザー識別子はそれぞれ異なる目的を持っています。 ユーザー識別子: ユーザー識別子は、複数のセッションやデバイスにわたって保持される一意の値です。これにより、ユーザーが異なるプラットフォームを切り替えたり、後からログインしたりした場合でも、MoEngage はそのユーザーを同一人物として認識できます。ID 解決と呼ばれるこのプロセスは、統合されたユーザープロファイルの維持、一貫したユーザーエクスペリエンスの提供、ユーザー行動の正確なトラッキングに不可欠です。 ユーザー識別子の一般的な例は次のとおりです。- メールアドレス: ユーザーのメールアドレスは個人に固有であり、異なるプラットフォーム間でも一貫しているため、広く使用されている識別子です。
- 電話番号: メールアドレスと同様に、電話番号も一意の識別子として使用でき、特にモバイルアプリケーションで有効です。
- ユーザー ID: MoEngage は登録時に各ユーザーに一意の ID を割り当てます。この ID は、MoEngage プラットフォーム内で信頼性の高い識別子として使用されます。
- 顧客 ID: E コマースや顧客関係管理(CRM)システムでは、さまざまなインタラクションにわたって個々の顧客をトラッキングするために顧客 ID が割り当てられます。
MoEngage の機能を支える
ユーザー属性と識別子は、MoEngage を効果的に活用するために不可欠です。- セグメンテーション:
- 属性を使用して、人口統計や行動などに基づくターゲットユーザーグループを作成します。
- 例: 特定のキャンペーン向けに、年齢や購入履歴でユーザーをセグメント化します。
- パーソナライゼーション:
- 識別子により、デバイス間で一貫したユーザーエクスペリエンスが確保されます。
- 属性により、カスタマイズされたコンテンツ(メッセージ、レコメンデーション)が可能になります。
- 例: 名前を使用してメールをパーソナライズしたり、関連性の高い商品をレコメンドしたりします。
- 分析:
- 属性は、ユーザーのアクションや行動データにコンテキストを提供します。
- セグメント別のコンバージョン率や、人口統計別の機能エンゲージメントを分析します。
- データに基づく意思決定のために、より深いインサイトを得られます。
ログイン/ログアウトの実装
SDK バージョン 11.2.00 未満については、こちらのドキュメントを参照してください。ユーザーのログイン
単一の識別子 アプリケーションがログインにメール ID などの単一の一意なユーザー識別子を使用している場合は、以下の API を使用して識別子を MoEngage SDK に渡します。uid を使用します。
複数の識別子
アプリケーションがメール ID、ユーザー ID、携帯電話番号など複数のログイン識別子をサポートしている場合は、次の関数を使用して関連するすべての識別子を SDK に渡します。
ユーザー識別とセッション管理を改善するために、SDK の関数が更新されています。
- 強制ログアウト: MoEngage SDK は、デバイスで新しいユーザーが検出されたときに、以前のユーザーを自動的にログアウトしなくなりました。ID 解決が有効なワークスペースでは、データの破損を防ぐために、ログアウトを明示的に呼び出す必要があります。
- SetUniqueID: IdentifyUser 関数は複数の識別子をサポートしているため、ユーザー識別に SetUniqueID 関数を使用する必要がなくなりました。SetUniqueID は今後の SDK バージョンで削除される予定であるため、特にワークスペースで ID 解決を使用している場合は、代わりに identifyUser を使用することが重要です。
- SetAlias: ID 解決機能が有効なワークスペースでは、MoEngage SDK は以前の識別子の値を保存します。IdentifyUser 関数を使用して新しい識別子の値をトラッキングすると、MoEngage SDK は識別子の値の変更を検出し、それに応じてレポートします。
- ログアウトせずに IdentifyUser 関数を呼び出すと、既存のログイン中ユーザーの ID が更新されます。
ネットワークの問題により識別子が MoEngage サーバーに届かなかった場合、SDK は
identifyUser() の呼び出しをキャッシュし、ネットワークが利用可能になったとき、または次回アプリを開いたときに自動的に再試行します。- identifyUser() を複数回呼び出すと、新しい識別子は既存のリストを置き換えるのではなく、既存のリストに追加されます。以下はその動作例です。
- すでに存在する識別子キーで identifyUser() を呼び出すと、新しい値で既存の値が更新されます。以下はその動作例です。
- 新しい識別子が利用可能になった時点で追加する
- 他の識別子に影響を与えずに特定の識別子を更新する
- 時間をかけて完全なユーザー ID プロファイルを構築する
u_em、u_mb は標準ユーザー属性です。その他の標準ユーザー属性でユーザーを識別するには、こちらのセクションを参照してください。
標準属性とカスタム属性
標準属性: メールアドレスや携帯電話番号など、MoEngage ダッシュボード内で事前に定義されている一般的なユーザー属性です。以下の表に、これらの標準属性と対応するキー名を示します。
カスタム属性: 標準属性に加えて、MoEngage ダッシュボード内で独自に定義する属性です。以下は、カスタム属性を扱う方法の例です。
ユーザーのログアウト
ログアウトコールバックリスナー
ログアウトが完了したときにコールバックを受け取るには、logoutComplete イベントのリスナーを登録します。
ログアウトコールバックリスナーには、React Native SDK バージョン 12.8.0 以降が必要です。
ユーザー属性のトラッキング
名前、メール、携帯電話番号、性別などのユーザー属性を設定するには、次のヘルパーメソッドを使用します。イベント、イベント属性、ユーザー属性の名前に “moe_” をプレフィックスとして使用することはできません。これはシステムプレフィックスであり、使用すると事前の通知なく定期的にブラックリストに登録される可能性があります。
カスタムブール型ユーザー属性
iOS(任意)
react-native-moengage のバージョン 11.x.x 以降、カスタムブール型属性のデフォルトのトラッキングは double(0/1) から boolean(true/false) に変更されます。これを設定するには、MoEAnalyticsConfig を使用し、ブール値を double としてトラッキングする場合は true を渡します。デフォルトでは false に設定されており、ブール値は true/false としてトラッキングされます。 以下の初期化コードスニペットを参照してください。ユーザー属性の予約済みキーワード
以下は、ユーザー属性のトラッキング時に使用してはならないキーの一覧です。- USER_ATTRIBUTE_UNIQUE_ID
- USER_ATTRIBUTE_USER_EMAIL
- USER_ATTRIBUTE_USER_MOBILE
- USER_ATTRIBUTE_USER_NAME
- USER_ATTRIBUTE_USER_GENDER
- USER_ATTRIBUTE_USER_FIRST_NAME
- USER_ATTRIBUTE_USER_LAST_NAME
- USER_ATTRIBUTE_USER_BDAY
- USER_ATTRIBUTE_NOTIFICATION_PREF
- USER_ATTRIBUTE_OLD_ID
- MOE_TIME_FORMAT
- MOE_TIME_TIMEZONE
- USER_ATTRIBUTE_DND_START_TIME
- USER_ATTRIBUTE_DND_END_TIME
- MOE_GAID
- MOE_ISLAT
- INSTALL
- UPDATE
- status
- user_id
- source
イベント、イベント属性、ユーザー属性の名前に “moe_” をプレフィックスとして使用することはできません。これはシステムプレフィックスであり、使用すると事前の通知なく定期的にブラックリストに登録される可能性があります。