​

はじめに

​

ユースケース

• セグメントをデータウェアハウスに同期: セグメントをデータウェアハウスにシームレスに同期して詳細な分析を行うことで、より深いインサイトを得て、データドリブンな意思決定を強化できます。
• セグメントをロイヤルティプラットフォームに同期: セグメントを同期することで、個々の好みに合わせたパーソナライズされた特典やプロモーションを提供し、顧客ロイヤルティプログラムを強化できます。
• セグメントを In-App パーソナライゼーションプラットフォームに同期: セグメントを同期することで、各ユーザーが好みに合ったコンテンツや機能を受け取れるようにし、高度にパーソナライズされたユーザー体験を実現できます。
• セグメントを広告ネットワークに同期: 精度の高いターゲティング広告キャンペーンのためにセグメントを同期し、広告が最も関連性の高いオーディエンスに届くようにします。
• 顧客セグメントを実験プラットフォームに同期: セグメントを同期して異なる顧客グループの反応や行動を比較し、A/B/n テストを精度高く実施できます。
• セグメントを CRM プラットフォームに同期: セグメントを同期することで顧客とのやり取りの追跡を改善し、顧客の行動や好みについてより良いインサイトを得られます。
• セグメントをカスタマーサービスプラットフォームに同期: セグメントを同期することで、カスタマーサービスチームが個々の顧客をより深く理解し支援できるようになり、パーソナライズされたサポートを提供できます。
• ある MoEngage アプリから別のアプリにセグメントを同期: Outbound Segment Sync と Cohort Sync API を組み合わせることで、複数の MoEngage アプリ間でセグメントを簡単に同期できます。詳細については、ある MoEngage アプリから別のアプリにセグメントを同期するを参照してください。

​

連携

​

オプション 1: パートナー連携を使用する

​

オプション 2: API エンドポイントを使用してカスタム宛先を設定する

​

ステップ 1: コネクテッドアプリを作成する

1. MoEngage ダッシュボードの左側のナビゲーションメニューで、App marketplace をクリックします。
2. App marketplace ページで、+ Create app をクリックします。

3. Create app ダイアログボックスで、以下の詳細を入力します。

   フィールド	説明
   App name	アプリ名を入力します。
   App type	Outbound Segment Sync（MoEngage セグメントをアプリにエクスポート）をクリックします。

4. Create をクリックします。 これにより、コネクテッドアプリが MoEngage の宛先として追加されます。コネクテッドアプリのページに移動します。

​

ステップ 2: 連携を追加する

1. App marketplace のコネクテッドアプリページで Integrate タブをクリックし、+ Add integration をクリックします。
2. Connection details セクションで、エンドポイントにセグメントを同期するための以下の詳細を入力します。

   フィールド	説明
   Integration Name	エンドポイントを識別するための連携名を入力します。
   URL Endpoint	データを同期する URL エンドポイントを入力します。例: https://api.example.com/segments システムで IP ホワイトリスト登録が必要な場合は、こちらを参照してください。
   Key-Value Pairs	[任意] 必要に応じて、ヘッダーおよびパラメーターに追加できるキーと値のペアのリストを入力します。
   Authentication	サポートされているオプションは Basic auth と No auth です。
   User Identifier	MoEngage のユーザーセグメントからエンドポイントに同期するユーザー識別子を選択します。これは宛先でユーザーを一意に識別するキーである必要があります。このキーは宛先のユーザー識別子に合わせて名前を変更できます。
   Request Body	add_users: 特定のセグメントに追加されるユーザーを含むリストです。 remove_users: 特定のセグメントから削除されるユーザーを含むリストです。 注: 1 つのリクエストで add_users と remove_users の両方のフィールドが必須というわけではありません。リクエストペイロードにはどちらか一方または両方が存在でき、空の配列にすることもできます。 これらのキーは削除できません。ただし、宛先に合わせて名前を変更できます。 [任意] 必要に応じて、追加ユーザーと削除ユーザーのリストにキーと値のペアのリストを追加できます。
   Throttle	MoEngage は 1 分あたり 25000 件のリクエストを送信します。 各リクエストには同時に 100～10000 人のユーザーを含めることができ、スロットルで設定できます。
   Allow resync	Allow resync of all users in the segment to the destination: 特定の同期で問題が発生した場合、宛先のセグメントに誤ったユーザーが含まれる可能性があります。セグメント内のユーザーの正確な状態を維持するために、セグメント内のすべてのユーザーを再同期できます。すべてのユーザーの再同期を許可すると、同期された各セグメントでこのアクションが有効になります。ただし、宛先がセグメント内のすべてのユーザーを削除し、セグメント全体の再同期を再度受け入れられることを確認してください。
   Request Preview	宛先の設定を編集すると、MoEngage から送信される更新後のリクエストボディを確認できます。

   サンプルのユーザー値を設定した宛先に送信して、接続をテストします。レスポンス（成功、または宛先から受信したメッセージを伴う失敗）も確認できます。
   + Add integration をクリックすると、複数の連携を追加できます。

​

API リクエスト形式

​

リクエストボディ:

{
"type": "segment_sync",
"pagination": {
"total_pages": 14,
"page_count": 12
},
"data": {
"moengage_sync_id": "{{sync_id}}",
"moengage_sync_name": "{{sync_name}}",
"moengage_execution_id": "{{execution_id}}",
"moengage_integration_id": "{{integration_id}}",
"add_users": [
{
"moengage_distinct_id": ,
"partner_user_id": "{{uid99}}"
},
{
"moengage_distinct_id": ,
"partner_user_id": "{{uid00}}"
}
],
"remove_users": [
{
"moengage_distinct_id": ,
"partner_user_id": "{{uid98}}"
},
{
"moengage_distinct_id": ,
"partner_user_id": "{{uid01}}"
}
]
}
}

​

ペイロード内の ID の定義

1. moengage_sync_id: 特定のセグメントに対して開始された同期に付与される一意の ID で、他の同期済みセグメントと区別するためのものです。
2. moengage_sync_name: 同期されているセグメントの名前です。
3. moengage_execution_id: 同期の実行に割り当てられる一意の ID で、特定のセグメントで発生しうる複数の同期の中からその同期を区別するためのものです。
4. moengage_integration_id: セグメントが特定の連携宛先にマッピングされたときに生成される ID です。つまり、セグメントと連携宛先のマッピングを moengage_integration_id で表します。
5. moengage_distinct_id: MoEngage システムによってユーザーに割り当てられる一意の ID です。これは、顧客/パートナーがユーザーに割り当てた ID とは異なります。
6. partner_user_id: 顧客/パートナーが独自の規則に従ってユーザーを識別できるように、自社システムを通じて MoEngage に送信する一意の ID です。

​

キーと値のペアの構造

curl --location --request POST
''
-H 'Content-Type: application/json'
--data-raw '{
"type": "segment_sync",
"pagination": {
"total_pages": 1,
"page_count": 1
},
"data": {
"moengage_sync_id": "sync_id",
"moengage_sync_name": "sync_name",
"moengage_execution_id": "execution_id",
"moengage_integration_id": "integration_id",
"add_users": [
{
"moengage_distinct_id": "moengage_user_id",
"key_format_1": "value_format_1",
"key_format_2": "value_format_2",
"user_attribute": ""
}
],
"remove_users": [
{
"moengage_distinct_id": "moengage_user_id",
"key_format_1": "value_format_1",
"key_format_2": "value_format_2",
"user_attribute": "uid99"
}
]
}
}'

​

エラーの説明

​

ステップ 3: セグメント同期を設定する

• 同期設定の更新
• 同期の実行成功
• 同期の失敗

​

定期的なアウトバウンドセグメント同期

​

すべてのアウトバウンド同期セグメントを表示する

​

アウトバウンド同期セグメントに対するアクション

​

同期ステータス

​

ある MoEngage アプリから別のアプリにセグメントを同期する

​

ステップ 1: 送信元アプリにログインする

​

ステップ 2: 新しいカスタム宛先を作成する

​

ステップ 3: 新しいエンドポイントを作成する

​

ステップ 4: 宛先アプリにセグメントを同期する

​

アウトバウンド同期セグメントの詳細を表示する

​

​

同期履歴

• Run time - 同期が実行された時刻です。
• Status of execution - 各同期の実行は、次のいずれかのステータスになります。
  • Complete - 同期が正常に実行され、すべての行が必要な宛先に送信されました。
  • Processing - 必要な宛先への同期が現在実行中です。
  • Failed - 同期の実行中に失敗が発生しました。
• No. of users added - 前回同期が処理されてからカスタムセグメントに追加された、<synced user attribute> を持つユーザーの数です。このユーザーのリストは、リクエストボディの ‘add_users’ として宛先に同期されます。
• No. of users removed - 前回同期が処理されてからカスタムセグメントから削除された、<synced user attribute> を持つユーザーの数です。このユーザーのリストは、リクエストボディの ‘remove_users’ として宛先に同期されます。
• Total no. of users - 親カスタムセグメントに存在する、<synced user attribute> を持つユーザーの数です。

​

よくある質問