イントロダクション
アウトバウンドセグメント同期
は、MoEngageで作成された貴重な顧客セグメントを、テクノロジースタック内の他のプラットフォームに簡単に同期して送信できる機能です。
これらのセグメントを、広告ネットワーク、ロイヤリティプラットフォーム、レコメンデーションエンジン、実験ツールなど、さまざまなプラットフォーム間で同期でき、ターゲットを絞ったエンゲージメントの促進、データ主導の意思決定の強化など、さまざまなビジネスユースケースを推進します。
ユースケース
ブランドは、Outbound Segment Syncを活用して、ツール間で影響力のあるセグメントを同期させ、ターゲットを絞ったエンゲージメント、データ駆動の意思決定、その他のビジネスユースケースを可能にします。ここにいくつかの例があります:
データウェアハウスにセグメントを同期する
データウェアハウスにセグメントをシームレスに同期させることで、より深い洞察を得て、データに基づく意思決定を強化します。
ロイヤリティプラットフォームにセグメントを同期する
顧客ロイヤルティプログラムを強化するために、セグメントを同期させ、個々の好みに合わせたパーソナライズされた報酬やプロモーションを可能にします。
アプリ内パーソナライズプラットフォームにセグメントを同期する
セグメントを同期させることで、各ユーザーが自分の好みに合ったコンテンツや機能を受け取れるように、高度にパーソナライズされたユーザー体験を作成します。
広告ネットワークにセグメントを同期する
精密にターゲットを絞った広告キャンペーンのために、セグメントを同期させ、広告が最も関連性の高いオーディエンスに届くようにします。
実験プラットフォームに顧客セグメントを同期する
精度を持ってA/B/nテストを実施し、セグメントを同期させて異なる顧客グループの反応と行動を比較します。
CRMプラットフォームにセグメントを同期する
顧客の行動や嗜好に関するより良い洞察を提供するために、セグメントを同期させて顧客インタラクションの追跡を改善します。
カスタマーサービスプラットフォームにセグメントを同期する
セグメントを同期させることで、最高のパーソナライズされたサポートを提供し、カスタマーサービスチームが個々の顧客をよりよく理解し、支援できるようにします。
別のMoEngageアプリにセグメントを同期する
Outbound Segment Syncを使用すると、Cohort Sync APIを利用して、複数のMoEngageアプリ間でセグメントを簡単に同期できます。 この設定方法について詳しく読む 。
この機能を使用してセグメントを同期するのは迅速で簡単です。目的のプラットフォームを選択し、希望するユーザーセグメントを選び、同期の頻度を設定して、同期を開始してください。
始めるには、まず目的のプラットフォームを設定して接続する必要があります。これには2つの方法があります。次のセクションでこれらについて詳しく学びましょう。
library_add_check |
前提条件 アウトバウンド セグメント シンクは、コネクテッド チャンネル アドオンの一部です。あなたのアカウントに対してそれを有効にするために、専任のMoEngage CSM(カスタマーサクセスマネージャー)に連絡してください。 |
接続先
接続先プラットフォームとの設定方法は2つあります:
1. パートナー統合の使用
2. APIエンドポイントを使用してカスタム宛先を設定する
これらの2つの方法に深く入る前に、カスタム宛先を有効にするためのアクセスをリクエストする必要があります。そのためには、次の場所に移動できます:
アプリマーケットプレイス -
> 探索をクリック -> 統合タブを選択 -> アクセスをリクエスト
有効にすると、以下の2つの方法のいずれかで始めることができます。
パートナー統合を使用する
MoEngageは、設定プロセスとAPIエンドポイントのテストを簡素化する既存のパートナー統合を提供します。数回のクリックで、セグメントをパートナープラットフォームに同期し始めることができます。これらの統合に関する詳細情報は、パートナーのヘルプドキュメントをご覧ください。
Storyly
APIエンドポイントを使用してカスタムデスティネーションを構成する
APIエンドポイントを使用して宛先を設定するには、アプリマーケットプレイスに移動し、カスタム宛先セクションに移動します。カスタム宛先を追加し、設定します。
エンドポイントにセグメントを同期するためのカスタムデスティネーションの設定
- エンドポイントを識別するための統合名を提供してください。
-
データを同期するためのURLエンドポイントを提供してください。例:
https://api.example.com/segments
システムにIPホワイトリストが必要な場合は、 こちら を参照してください。
- 要件に応じてヘッダーやパラメーターに追加できるキーと値のペアのリストを提供します。これは任意です。
- 認証 - ベーシック認証と認証なしがサポートされています。
- MoEngageのユーザーセグメントからエンドポイントに同期したいユーザー識別子を選択してください。これは、あなたの目的地でユーザーを一意に識別するキーである必要があります。このキーは、宛先のユーザー識別子に従って名前を変更できます。
-
-
- add_users - このリストには、特定のセグメントに追加されるユーザーが含まれています。
- remove_users - このリストには、特定のセグメントから削除されるユーザーが含まれています。
- add_users と remove_users のフィールドは、1つのリクエストでは必須ではありません:これらのうちの1つだけがリクエストペイロードに含まれるか、両方がリクエストペイロードに含まれるか、または空の配列であることも可能です。
-
これらのキーは削除できません。ただし、目的地に応じて名前を変更することはできます。
- [オプション] 要件に応じて、追加および削除ユーザーのリストにキーと値のペアを追加できます。
-
-
スロットルを選択してください:
- MoEngageは1分あたり25000リクエストを送信します。
- 各リクエストは、スロットルに設定できる100〜10000人のユーザーを同時に持つことができます。
-
セグメント内のすべてのユーザーを宛先に再同期できるようにします:
- リクエストプレビュー - 宛先設定を編集すると、MoEngageによって送信される更新されたリクエストボディを表示できます。
- 設定された宛先にサンプルユーザー値を送信して接続をテストします。また、成功または失敗のいずれかの応答と、宛先から受信したメッセージを確認することもできます。
APIリクエストフォーマット
MoEngageがセグメントをあなたの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": <moengage_user_id>, "partner_user_id": "{{uid99}}" }, { "moengage_distinct_id": <moengage_user_id>, "partner_user_id": "{{uid00}}" } ], "remove_users": [ { "moengage_distinct_id": <moengage_user_id>, "partner_user_id": "{{uid98}}" }, { "moengage_distinct_id": <moengage_user_id>, "partner_user_id": "{{uid01}}" } ] } }
info |
Note
|
。
上記のペイロードにおけるIDの定義
- 「moengage_sync_id」: 特定のセグメントのために開始された同期に与えられるユニークIDであり、他の同期されたセグメントと区別することができます。
- 「moengage_sync_name」: 同期されているセグメントの名前です
- 「moengage_execution_id」: 特定のセグメントに対して可能な複数の同期からその同期を区別するために、一意のIDが同期実行に割り当てられます。
- 「moengage_integration_id」: このIDは、セグメントが特定の統合先にマッピングされるときに生成されます。したがって、セグメントと統合先のマッピングは moengage_integration_id を示します。
- 「moengage_distinct_id」: MoEngageシステムによってユーザーに割り当てられるユニークIDです。これは、顧客/パートナーがユーザーに割り当てたIDとは異なります
- 「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"
}
]
}
'
エラーディスクリプション
Sr. No | Error | Description |
1 | {attr_name} タイプ {datatype} 属性が見つかりません | このエラーは、属性がシステムに存在しない場合に表示され、ユーザーが外部属性を使用して操作を行おうとしたときに表示されます。 |
2 | セグメントの最大リトライ回数を使い果たしました | 3回のAPIコールのリトライが可能で、頻度は1回のリトライにつき3秒です。この制限に達すると、システムは次のエラーを表示します |
3 | エラーが発生しました。もう一度お試しください、またはサポートにお問い合わせください。 |
このエラーは、API呼び出しが複数回失敗し、30分以内に再試行が行われた場合に発生する可能性があります。 |
セグメント同期の設定
目的のプラットフォームの設定が完了したので、セグメント同期の設定を開始できます。
新しい同期セグメントを設定するには:
ステップ 1: 同期するカスタムセグメントを選択します
セグメント -> すべてのセグメントページ で、カスタムセグメントを選択し、アクションドロップダウンでアクション「セグメントを同期」をクリックします。
ステップ2: 目的地を選択する
App Marketplaceのカスタムデスティネーションに設定されたデスティネーションは、ドロップダウンに表示されます。利用可能なオプションから目的地を選択するか、新しい目的地を追加して同期してください。
ステップ 3: 同期のスケジュールを選択し、通知の設定を行います
同期は、セグメント内のユーザーを宛先に一度だけ転送するか、セグメントの最新の状態を継続的に定期的に更新することができます。
定期的であれば、セグメントは毎日、毎週、毎月同期できます。ケースバイケースで時間単位の同期を有効にできます。アカウントマネージャーに連絡して、アカウントの時間単位での同期を有効にしてください。
次の通知を受け取るためのメールアドレスを設定することもできます:
- 同期設定に関する更新はありますか
- 同期の成功した実行
- 同期の失敗
info |
Note 1.アウトバウンド同期プロセスにはクールオフ期間が設定されています。クールオフ期間は、すでに実行中のセグメント同期への中断を避けるために定義されています。例えば、セグメント同期の途中で属性の値が変更されると、進行中の同期に影響を与える可能性があります。また、同期が進行中の間は、属性の値に対する変更はすぐには反映されません。変更が行われてから30分後に反映されます。 2.アウトバウンド セグメント同期のデフォルト制限は次のとおりです:
|
MoEngage サポートチームに連絡するには、MoEngage ダッシュボード内の
サポート Web フォーム
を通じてチケットを提出できます。詳細については、
こちら
を参照してください。
定期的なアウトバウンドセグメント同期
定期的なアウトバウンドセグメント同期では、MoEngageは最初の同期時にのみセグメント内の全ユーザーを送信します。次回の同期では、MoEngageは変更データキャプチャプロセスに従い、前回の同期とセグメントの現在の状態を比較し、ユーザーの違いのみを送信します。
この違いは、2つのリスト - add_users(セグメントに追加されるユーザーのリストを含む)とremove_users(セグメントから削除されるユーザーのリストを含む)で送信されます。この違いは、最終の違いを宛先に同期するアクション「最後の違いを再同期」によってもMoEngageによって維持されます。このオプションは、宛先でのデータの不一致に対処するために提供されています。
すべてのアウトバウンド同期セグメントを表示
すべてのセグメント → 同期されたセグメントタブで同期されたセグメントのリストを表示できます。このページでは、セグメント名、最新の同期ステータス、宛先、スケジュール、最終同期タイムスタンプ、および同期に対して実行できるアクションなどの詳細を確認できます。
アウトバウンド同期セグメントに対するアクション
アクション | Description |
---|---|
表示 |
「表示」をクリックすると、選択した同期セグメントの詳細ページにリダイレクトされます。 |
編集 |
|
Adhoc同期を実行する |
|
同期を一時停止 |
|
すべてのユーザーを再同期 |
|
最後の差分を再同期 |
|
アーカイブ同期 |
アーカイブ同期をクリックすると、セグメントのさらなる同期がすべて停止します。アーカイブされた同期セグメントは、再度アーカイブを解除することはできません。 |
同期状況
各同期化されたセグメントは、次の5つのステータスのいずれかにあります:
ステータス | Description |
---|---|
アクティブ |
最新の同期の実行は成功しました。また、同期はまだ期限切れではありません。つまり、同期の終了日にはまだ達していません。 |
一時停止 |
同期は、一時停止アクションをクリックすることで手動で一時停止されました。Adhoc同期を実行をクリックすると、そのセグメントの今後のすべての同期が再開されます。 |
失敗しました |
最後の同期の実行で失敗が発生しました。同期が失敗した状態にある場合、今後のすべての同期は一時停止されます。スケジュールを再起動するには、手動で同期を実行できます(アドホック同期を実行)。 |
非アクティブ |
|
アーカイブ済み |
ダッシュボードから同期がアーカイブされました。 |
info |
Note
|
別のMoEngageアプリにセグメントを同期する
Outbound Segment Syncと私たちの Cohort Sync API を使用すると、1つのMoEngageアプリから別のアプリにセグメントを同期できます。これは、地域を超えたチームが同期して機能し、より良いターゲティングを行うのに役立ちます。
ステップ 1: ソースアプリにログインします
開始するには、送信したいセグメントのアプリにログインします(ソース)。このアプリでアウトバウンドセグメント同期が既に有効になっていることを確認してください。
ステップ2: 新しいカスタムデスティネーションを作成する
新しいカスタム宛先を設定するには、アプリマーケットプレイスに移動し、カスタム宛先セクションに進んでください。「MoEngage」という新しいカスタム宛先を追加します。
ステップ3:新しいエンドポイントを作成する
新しく作成されたカスタムデスティネーションで、「+ インテグレーションを追加」をクリックして、新しいエンドポイントを設定します。エンドポイントに、デスティネーションアプリの名前のような名前を付けてください。他のフィールドは、説明に従ってください -
Field | 値 | Description |
---|---|---|
リクエストメソッド |
POST |
|
URL エンドポイント |
|
APIエンドポイントURLの'X'はMoEngageデータセンター(DC)を指します。MoEngageは各顧客を異なるDCにホストします。DC番号(Xの値)を見つけ、URL内の'X'の値を置き換えるには、DCとAPIエンドポイントのマッピングを参照してください こちら 。 |
パラメーター |
空のままにしておきます。 |
|
認証 |
基本認証 |
ユーザー名 : これはあなたの目的地 MoEngage ワークスペース ID です。 パスワード : これはあなたの目的地MoEngageアプリのデータAPIキーです。 |
ヘッダー |
|
これらの2つのヘッダーは必須です。 |
ユーザー識別子 |
ユーザー識別子を選択してください。これは、ソースアプリとデスティネーションアプリの両方で同じである必要があります。 |
|
デスティネーション識別子 |
uid
|
別のMoEngageアプリにセグメントを送信するために、宛先識別子を「uid」として選択します。 |
上記のフィールドが設定されると、接続をテストできます。すべての詳細が正しければ、テストは成功するはずです。統合を保存してください。
ステップ 4: セグメントを目的のアプリに同期する
詳細については 上記 を参照して、セグメントを宛先アプリに同期してください。
info |
Note
|
アウトバウンド同期セグメントの詳細を表示
同期されたセグメント名や表示アクションをクリックすると、その同期されたセグメントの詳細ページにリダイレクトされます。
詳細ページには、宛先、スケジュール、最新の同期状況、同期更新者、更新時間、同期スケジュール、最終同期時間、次回同期時間、および親カスタムセグメントへのリンクなどの詳細が表示されます。
同期されたユーザー属性、同期スケジュール、通知設定などの同期構成は、詳細ページでも利用可能です。
このページから同期に関連するすべてのアクションを実行できます - 編集、アドホック同期の実行、同期の一時停止、すべてのユーザーの再同期、最後の差分の再同期、そして同期のアーカイブ。
同期されたセグメントの詳細ページでは、このセグメントに対して実行されたすべての同期実行の同期履歴も表示できます。
同期履歴
同期履歴には、セグメントが予定された頻度で宛先に同期された各回の詳細が表示されます。
- 実行時間 - 同期が実行された時間
-
実行のステータス
- 各同期実行は次のいずれかのステータスになります -
- 完了 - 同期は成功し、すべての行が必要な宛先に送信されました
- 処理中 - 同期は現在、必要な宛先に向けて実行中です
- 失敗 - 同期の実行に失敗しました。
-
追加されたユーザー数
- 最後に同期が処理されてからカスタムセグメントに追加された
を持つユーザーの数。このユーザーのリストは、リクエストボディの 'add_users' の下に同期されます。 -
削除されたユーザー数
- 最後に同期が処理された時からカスタムセグメントから
が削除されたユーザーの数。このユーザーのリストは、リクエストボディの 'remove_users' の下で宛先に同期されます。 -
ユーザーの合計数
- これは、親カスタムセグメントに存在する
を持つユーザーの数です。
info |
Note
|
FAQs
-
30分間のクールオフ期間を削除できますか?
- いいえ、30分間のクールオフ期間は削除できません。進行中の同期に中断が生じたり、誤ったデータ同期の可能性を避けるために、予防措置としてクールオフ期間はデフォルトで設定されています。
-
「APIがすでに失敗しました」とはどういう意味ですか?
- このエラーは、API呼び出しが失敗した場合に表示されますが、それでもAPI呼び出しを再試行しようとした場合に表示されます。「APIがすでに失敗しました」というエラーのいくつかの可能性のある理由は以下の通りです:- ネットワーク接続の問題 :API呼び出しが失敗した理由は、信号が弱い、またはサーバーがダウンしているなどのネットワーク接続の問題があった可能性があります。
- 認可または認証の欠如 :API呼び出しにはクライアント側からの何らかの認可または認証が必要であり、これが欠けていたり無効になっていたりすることで、APIが失敗する可能性があります。
- サーバーの過負荷 :サーバーが処理しているリクエストが多すぎて、サーバーが過負荷になり、さらなるリクエストを処理できなくなり、APIの失敗につながる可能性があります。
-
Sync名を任意の名前に変更できますか?
- いいえ、現在Sync名を編集/変更するための規定はありません
-
セグメント名が途中で編集された場合、API呼び出しで名前が更新されますか?同じ名前の別のセグメントが作成された場合、両方のAPI呼び出しは同じ同期名になりますか?
・同期中にセグメントに対して何らかのアクションを行うことは推奨されません。これにより、同期が中断される可能性があります。その間に同期中にセグメントに加えた変更は、すぐには反映されません。30分のクールオフ期間後に反映されます。同じセグメントに対して1つ以上の同期が存在する場合は、編集、名前変更、アーカイブに注意してください。親カスタムセグメントの名前が変更されると、同期名は親カスタムセグメントの新しい名前を反映しません。
-
セグメント同期に複数の属性を渡すことはできますか?
- いいえ、現在のMoEngageシステムでは、セグメント同期に複数の属性を渡すことはできません。
-
KVペアを個別に設定したり、動的なタイムスタンプを持つことはできますか?
- 顧客はKV(キー-バリュー)ペアをそれぞれのニーズに合わせて個別化できます。ただし、現時点では動的なキー・バリューはサポートされていないことに注意してください。たとえば、動的なタイムスタンプはサポートされていません。キー・バリュー・ペアは静的である必要があります。
-
リトライメカニズムとは何ですか?タイムアウト期間はどのくらいですか?
- リトライメカニズムは、顧客/パートナーのシステムがMoEngage APIを複数回呼び出すことを可能にします。ただし、リトライメカニズムには制限があります。合計で3回のリトライが可能で、最大頻度/タイムアウトは1回のリトライ/3秒です。