Skip to main content
MoEngage Web SDK の統合では、オプションの手順を実施することを強く推奨します。
ユーザー属性とは、メールアドレス、ユーザー名、携帯電話番号、性別など、ユーザーに固有の特性です。ユーザー属性を使用すると、デバイスやインストールをまたいでこれらの属性に基づいてユーザーをターゲティングしたり、メッセージをパーソナライズしたりできます。

事前定義済みの属性

標準のユーザー属性を使用するには、以下の MoEngage メソッドを使用します。

カスタム属性

ユーザーのログインとログアウト

ID は、MoEngage ダッシュボード内でユーザーを一意に識別するために使用されます。 Web サイトへの訪問中にユーザーのログインとログアウトが正しく実装され、ユーザーが認証されていることを確認してください。
ユーザーのログインとログアウトが正しく処理されない場合、ユーザーデータが破損する可能性があります。
MoEngage Web SDK を初めて本番稼働させる際は、ページの読み込み時に既存の Web サイトユーザーの ID を設定していることを確認してください。 ユーザーが認証されたらすぐに、ログインメソッドを使用してユーザー ID を MoEngage SDK に渡してください。ユーザーがアプリからログアウトした後は、必ず MoEngage のログアウトメソッドを呼び出してください。 ユーザーのログイン、ログアウト、およびユーザーの更新時には、以下の MoEngage メソッドを使用します。

ログイン

SDK バージョン 2.52.2 未満については、こちらのドキュメントを参照してください。
以下の MoEngage メソッドを使用する前に、最新の統合スクリプトを使用していることを確認してください。
情報ユーザーの識別とセッション管理を改善するため、SDK の関数が更新されています。
  • 強制ログアウト: MoEngage SDK は、デバイスで新しいユーザーが検出されたときに、以前のユーザーを自動的にログアウトしなくなりました。Identity resolution が有効なワークスペースでは、データの破損を防ぐために、ログアウトを明示的に呼び出す必要があります。
  • SetUniqueID: IdentifyUser 関数は複数の識別子をサポートしているため、ユーザーの識別に SetUniqueID 関数を使用する必要がなくなりました。SetUniqueID は今後の SDK バージョンのリリースで削除される予定です。特にワークスペースで Identity resolution を使用している場合は、代わりに identifyUser を使用することが重要です。
  • SetAlias: Identity resolution 機能が有効なワークスペースでは、MoEngage SDK は以前の識別子の値を保存します。IdentifyUser 関数を使用して新しい識別子の値をトラッキングすると、MoEngage SDK は識別子の値の変更を検出し、それに応じてレポートします。
  • ログアウトせずに IdentifyUser 関数を呼び出すと、既存のログイン済みユーザーの ID が更新されます。
この機能の詳細については、ヘルプドキュメントを参照してください。 ここで、u_em、u_mb、uid は標準のユーザー属性です。標準のユーザー属性でユーザーを識別するには、以下の表を参照してください。 MoEngage ダッシュボードでカスタムユーザー属性が ID として選択されている場合は、カスタムユーザー属性でユーザーを識別することもできます。
ユーザーに設定されている ID の現在の状態を取得するには、以下のメソッドを使用できます。
重要 - 非常に重要な統合ガイドラインプロジェクト内で、identifyUser と updateUniqueUserId (SDK バージョン 2.52.2 未満のログインメソッド) の両方のログインメソッドを使用しないでください。どちらか一方のメソッドのみを使用してください。両方のメソッドを使用すると、MoEngage アカウントでのユーザープロファイルの作成やマージに不整合が生じる可能性があります。
トラッキングされたユーザー属性の値を取得するには、以下のメソッドを使用できます。

ログアウト

現在のユーザーをログアウトします。

ユーザーの更新

重要identifyUser メソッドと logoutUser メソッドは、適切な順序で呼び出す必要があります。そのため、これらのメソッドの実行が完全に完了した後に他の属性をトラッキングするようにしてください。これらのメソッドは Promise を返すため、次のようにデータをトラッキングできます。

ユーザー属性のトラッキング

以下の場合にユーザー属性をトラッキングしていることを確認してください。
  1. ユーザーに新しい属性が設定された場合。たとえば、ユーザーが Web サイトにログインまたはサインアップした後に、そのユーザーのメール ID や携帯電話番号の属性を設定します。
  2. 既存の属性の値が更新された場合。
  3. MoEngage Web SDK の統合を初めて本番稼働させる際は、ページの読み込み後に、既存の Web サイトユーザーに設定されているユーザー属性を渡していることを確認してください (まだ MoEngage に送信されていない場合)。
  4. サポートされているデータ型とデータトラッキングポリシーの詳細については、データトラッキングポリシーを参照してください。
すべてのユーザーに単一の一意の ID を使用していないことを確認してください。これは、一意の ID の値をサーバーから取得せずにハードコードしている場合にのみ発生します。

Google Tag Manager (GTM) による属性のトラッキング

GTM を使用して属性をトラッキングするには、Google Tag Manager(GTM) のドキュメントに従ってください。

リダイレクト時のトラッキング

属性やイベントをトラッキングした直後に別のページにリダイレクトする場合は、トラッキングが完了してからリダイレクトするようにしてください。
トラッキングの完了を待てず、すぐにリダイレクトする必要がある場合は、リダイレクト後の次のページでデータをトラッキングすることを推奨します。

ユーザー属性のキャッシュ

重複するユーザー属性は、6 時間トラッキングされません。 MoEngage SDK によって収集されるデフォルト属性の詳細については、Web SDK のデータ収集を参照してください。 さらにサポートが必要な場合は、MoEngage のカスタマーサクセスマネージャー (CSM) またはサポートチームにお問い合わせください。