Skip to main content

​
はじめに

mParticle 連携は現在、Unified Identity (Identity Resolution) および Portfolio をサポートしていません。OS タイプとしての TV はサポートされていません。
MoEngage × mParticle 連携により、mParticle に送信しているすべてのユーザーデータとイベントデータが、サーバー間 API を介して MoEngage に送信されます。

​
連携

  • MoEngage の設定にアクセスできることを確認してください。
  • mParticle ダッシュボードにアクセスできることを確認してください。

​
範囲

​
サーバー間連携

mParticle は、すべてのデータをイベントとして MoEngage に転送します。その後、MoEngage システムはイベントタイプとユーザー ID に基づいてイベントまたはユーザー属性を作成します。
重要サーバー間連携は、In-Apps、Cards、Push 通知などの機能をサポートしていません。これらのチャネルを使用する場合は、MoEngage SDK との統合が必要です。

​
サポートされているデータタイプ

​
手順

​
ステップ 1. mParticle で MoEngage を出力として設定する

mParticle ダッシュボードで、次の操作を行います。
  1. Setup > Output に移動します。
  2. Event タブに移動します。右上の Add Event Output をクリックします。
  3. MoEngage を検索します。
  4. ポップアップで、MoEngage アプリの詳細を入力します。Screenshot_2022-10-20_at_1.13.18_PM.png

​
ステップ 2: MoEngage 接続を設定する

mParticle ダッシュボードで、次の操作を行います。
  1. Connections >> Connect に移動します。
  2. 目的の入力ストリームを選択します。入力ストリーム
  3. 出力として MoEngage アカウントを選択します。これはステップ 1 で設定したアカウントです。
  4. 要件に応じて転送ルールを定義します。mParticle でのデータ転送の詳細はこちら。 Screenshot_2022-10-20_at_1.19.49_PM.png
有効化すると、MoEngage ダッシュボードにユーザーとイベントが表示されるようになります。

​
データマッピング

​
データマッピング

​
Portfolio のサポート

この機能を使用すると、属性マッピングを使用して、単一の mParticle ソースから MoEngage ワークスペース内の特定のプロジェクトにイベントをルーティングできます。

​
設定要件

特定のプロジェクトにイベントをルーティングするには、mParticle ワークスペースで次の設定を行う必要があります。
  • プロジェクト識別子をマッピングする: MoEngage にイベントを転送する際に、ソースプロパティ(例: brand_name または app_id)を MoEngage のイベント属性 moe_project_name にマッピングします。
  • 完全一致を確認する: ソースフィールドの値は、MoEngage の Portfolio で設定されているプロジェクト名と完全に一致する必要があります。一致判定では大文字と小文字が区別されます。

​
イベント取り込みのルール

MoEngage は、次のロジックに基づいてイベントの取り込みを処理します。
  • ルーティング成功: moe_project_name の値が設定済みのプロジェクト名と一致する場合、MoEngage はその特定のプロジェクトレベルでイベントを取り込みます。
  • フォールバック動作: moe_project_name 属性が欠落している、空白である、または設定済みのプロジェクト名と完全に一致しない場合、MoEngage はグローバルな Portfolio レベルでイベントを取り込みます。注意: Portfolio レベルで取り込まれたデータは、特定のプロジェクトに関連付けられません。このデータは、プロジェクト固有の分析、セグメンテーション、キャンペーンのターゲティングには使用できません。
詳細については、Portfolio および Portfolio: Data Ingestion and Management を参照してください。
制限事項mParticle イベントのプロジェクトレベルのルーティングは利用可能です。次の機能はグローバルな Portfolio レベルで管理されます。
  • ユーザー同期: プロジェクトレベルではサポートされていません。アウトバウンドのユーザー同期中、ユーザーはデフォルトでグローバルな Portfolio レベルで追跡されます。
  • コホート同期: プロジェクトレベルではサポートされていません。

​
Commerce Events のマッピング

  • MoEngage は Commerce Events の展開をサポートしていません。
  • 商品アクションイベントのアクション名が、MoEngage でのイベント名になります。
  • ワークスペースでこれらのイベントのサポートを追加する方法については、カスタマーサポートマネージャーにお問い合わせください。

​
商品ベース

商品ベースのコマースイベントは、購入につながる可能性のある商品とのすべてのインタラクションを測定します。商品イベントには次のものが含まれます。
  • Add to cart
  • Remove from cart
  • Checkout
  • Checkout option
  • Click
  • View Detail
  • Purchase
  • Refund
  • Add to wishlist
  • Remove from wishlist

​
共通のイベント属性

​
購入イベント

​
購入以外のイベント

​
プロモーションベース

​
インプレッションベース

​
ユーザー ID のマッピング

次のユーザー ID がサポートされています。
  • Customer ID
  • Email Address
  • MPID (mParticle ID)
デフォルトでは、連携は Customer ID で動作します。他の ID(上記のもの)を使用する場合は、MoEngage の CSM または MoEngage サポートチームにお問い合わせください。

​
レート制限

プラットフォームの安定性を維持するため、MoEngage は mParticle データの取り込みを、ワークスペースあたり最大 500 リクエスト/秒(RPS)に制限しています。ワークスペースがこの制限を超えると、MoEngage は HTTP 429 (Too Many Requests) ステータスコードを返します。 レート制限がデータフローにどのように影響するかについては、mParticle のデフォルトの再試行ポリシーを参照してください。詳細については、mParticle のドキュメントを参照してください。 再試行の上限到達: mParticle がデータのバッチに対するすべての再試行を使い果たした場合は、mParticle サポートチームに連絡して、失敗したリクエストを再送してもらう必要があります。

​
よくある質問

mParticle の各リクエストはイベントによってトリガーされます。メールアドレスの更新など、ユーザー属性が変更されると、mParticle はイベントをトリガーします。
  • 変更が SDK によって追跡されている場合は、“user_attribute_change” イベントとして MoEngage などの出力に渡されます。その後、MoEngage がユーザー属性を更新します。
  • ユーザー属性が mParticle の別の入力フィード(カスタムフィード、パートナーフィード、計算属性)によって更新された場合、これらは MoEngage などの出力には転送されません。
    • このような場合、新しい値は、ユーザーによってトリガーされる次のイベントでのみ MoEngage などの出力に渡されます。今後アクションがない場合、更新された値は MoEngage に渡されません。
    • 一般的には、MoEngage で更新する必要がある特定のユーザー属性のみを送信する、個別の “user attribute updated” イベント(ダミーイベント)を作成することをお勧めします。
MoEngage は任意の期間のイベントを受け入れます。そのため、履歴データを mParticle に再送すると、自動的に MoEngage に流れ込みます。データがすでに mParticle にあり、それを MoEngage に転送したい場合は、mParticle にデータを再送する方法があります。履歴データを再送するには、mParticle の担当者にお問い合わせください。
MoEngage 連携は、特定のタイプのイベントのみをサポートしています。特定のイベントが連携でサポートされているかどうかを確認するには、ドキュメントのこのセクションを参照してください。mParticle は、すべてのイベントをリアルタイムで MoEngage に送信します。ただし、サポートされているスループットレートは 15k RPM(リクエスト/分)です。送信レートがしきい値を超えると、一部のイベントがドロップされる可能性があります。推奨事項 -短期的な対策- mParticle には、スループットレートの超過やシステムのダウンタイムによって MoEngage でドロップされたデータを再送する方法があります。履歴データを再送するには、mParticle の担当者にお問い合わせください。長期的な対策- mParticle にデータを送信するレートを制御すること(上限は 15k RPM)をお勧めします。
形式や名前の変更は、mParticle Rules を使用して mParticle プラットフォームで直接行うことができます。mParticle の担当者と直接連携して、任意の属性に対するルールを有効化および定義できます。
いいえ。Data Exports は主にイベントをほぼリアルタイムでエクスポートするために構築されており、MoEngage のユーザー属性は非同期で更新されるため、現時点ではエクスポートでユーザー属性の最新値を保証することはできません。