[Partner Name] と MoEngage の連携
作成者 : [Your Company Name]最終更新日 : [Date] (貴社と事業内容について、2～3 文で簡潔に紹介してください。次に、MoEngage との連携の中核となる価値提案を説明してください。共通の顧客にとって、どのような重要な課題を解決しますか?) 例: パートナー名 : [Partner Name] パートナーカテゴリー : Personalization
概要 🚀
(連携の中核となる価値を説明してください。MoEngage キャンペーンに動的コンテンツを取り込む方法、または MoEngage のデータを使用して外部のサイト/アプリでの体験を調整する方法によって、マーケターがパーソナライズされたユーザー体験をどのように作成できるかを説明してください。) MoEngage と [Partner Name] の連携により、MoEngage キャンペーン内でユーザーに動的な 1 対 1 のパーソナライズされたコンテンツを配信できます。商品のレコメンデーション、パーソナライズされた画像、動的なオファーなどのリアルタイムのコンテンツを [Partner Name] から取得することで、エンゲージメントとコンバージョンを大幅に向上させることができます。 さらに、この連携では MoEngage のユーザーデータとイベントデータを [Partner Name] に送信できるため、ユーザーのクロスチャネルの行動に基づいて、Web サイト、アプリ、その他のチャネルでの体験をパーソナライズできます。ユースケース 🎯
(この連携でユーザーが実現できる主な内容を 2～3 件挙げてください。具体的かつ行動指向で記述してください。)- パーソナライズされた商品レコメンデーションの表示 : ユーザーの閲覧履歴や購入データに基づいて、メール内に商品カルーセルを取得して表示します。
- 動的でパーソナライズされた画像の埋め込み : ユーザーの名前、ロイヤルティポイント、その他の属性がリアルタイムでレンダリングされた画像をキャンペーンに挿入します。
- カウントダウンタイマーの表示 : 開封時にユーザーごとに固有にレンダリングされるライブのカウントダウンタイマーを埋め込み、フラッシュセールのキャンペーンで緊急性を演出します。
前提条件 ✅
(ユーザーが開始する前に必要なものをすべて挙げてください。アカウントの詳細、プランのレベル、および API キー、アカウント ID、認証トークンなど、貴社プラットフォームから必要となる具体的な認証情報を含めてください。)- 有効な MoEngage アカウント。
- [例:
Pro、Enterprise] プランの有効な [Partner Name] アカウント。 - 両方のプラットフォームへの管理者アクセス権。
- [Partner Name] ダッシュボードから取得した認証情報 (例:
API Key、Account ID、Authentication Token)。
連携の設定 🛠️
(これは最も重要なセクションです。貴社プラットフォームがサポートする内容に応じて、以下の連携タイプの一方または両方について、設定手順を明確に説明してください。スクリーンショットを使用し、該当する場合は API エンドポイント、リクエスト本文、Jinja コードの具体的な例を提供してください。)パート 1: [Partner Name] のコンテンツを MoEngage キャンペーンに取り込む
(連携が MoEngage のメッセージ内で使用するコンテンツを提供する場合は、このセクションを使用してください。)方法 A: MoEngage Content API を使用する
(商品レコメンデーション用の JSON データなど、構造化された API レスポンスにはこの方法を使用してください。)ステップ 1: [Partner Name] から API 認証情報を取得する
- (ユーザーがダッシュボードのどこで API エンドポイント URL、API キー、その他の必要な認証情報を確認できるかについて、明確な手順を提供してください。スクリーンショットを使用してください。)
- API URL :
https://api.your-platform.com/recommendations - 認証 :
Authorization: Bearer <YOUR_API_KEY>
ステップ 2: MoEngage で Content API を設定する
- MoEngage UI の左側のナビゲーションメニューで、Settings > Content API に移動し、+ Add content API をクリックします。
- ステップ 1 で取得した API エンドポイント URL を入力します。MoEngage のパーソナライズ構文を使用して、URL を動的にすることができます:
https://api.partner.com/content?user_id={{UserAttribute['ID']}} - Headers に認証キーを追加します。
- 保存して API をテストします。テストが成功すると、受信が想定されるデータのサンプルが表示されます。
方法 B: 動的な画像 URL を使用する
(パーソナライズされた画像、タイマー、その他のシンプルなビジュアル要素を埋め込む場合は、この方法を使用してください。)ステップ 1: [Partner Name] で動的要素を作成する
- (ユーザーが貴社プラットフォームでパーソナライズされた画像やタイマーを作成する方法を示す手順とスクリーンショットを提供してください。)
- 要素を作成したら、生成された「Magic Link」または動的な画像 URL を見つけてコピーします。URL にはプレースホルダーのマージタグが含まれます。URL の例:
https://img.your-platform.com/v1/getImage?name=MERGE_TAG&points=POINTS_TAG
ステップ 2: MoEngage キャンペーンに URL を埋め込む
(MoEngage のキャンペーンエディターとプレビューに埋め込まれたコンテンツを示すスクリーンショットを提供してください。)- MoEngage のキャンペーンエディター (例: メール用) で、画像ブロックまたは HTML ブロックを追加します。
- ステップ 1 で取得した動的 URL を画像のソースとして貼り付けます。
- URL 内のプレースホルダーのマージタグ (例:
MERGE_TAG) を、@を入力するか{{...}}を使用して MoEngage のパーソナライズ構文に置き換えます。MoEngage の構文を使用した例:https://img.your-platform.com/v1/getImage?name={{UserAttribute['First Name']}}&points={{UserAttribute['Loyalty Points']}}
パート 2: MoEngage のデータを [Partner Name] に送信する
(連携が MoEngage のデータを使用して貴社プラットフォーム上の体験をパーソナライズする場合は、このセクションを使用してください。)ステップ 1: [Partner Name] からデータ送信先の認証情報を取得する
- (データ配信に必要な認証情報をユーザーが取得する方法を説明してください。S3 の場合は、S3 バケットの URL、Access Key、Secret Key が含まれます。Webhook の場合は、エンドポイント URL と必要な認証トークンになります。)
ステップ 2: MoEngage でデータエクスポートを設定する
- MoEngage UI で、Settings > Exports に移動します。
- エクスポートタイプ (例: S3 Export、または Webhook の場合は Connector) を選択します。
- 送信するユーザーイベント (例:
Campaign Clicked、Product Viewed) とユーザー属性を選択して、エクスポートを設定します。 - ステップ 1 で取得した送信先の認証情報を入力し、設定を保存します。エクスポートの頻度を設定します。
トラブルシューティングとよくある質問❓
(ユーザーが直面する可能性のある一般的な問題とその解決策を 2～3 件挙げてください)。 例:問題
問題の例: パーソナライズされたコンテンツがテストメールに表示されない。- API リクエストを確認する: Content API 設定の「Test」機能を使用して、MoEngage がサーバーから有効な
200 OKレスポンスを受信していることを確認してください。レスポンス本文を確認し、想定どおりのデータが含まれていることを確認してください。 - Jinja 構文を確認する: API レスポンスの解析に使用する Jinja コードが正しいことを確認してください。よくある間違いは、JSON レスポンスに存在しないキーを参照することです。
- ユーザーデータを確認する: 送信先のテストユーザープロファイルに、API 呼び出しで使用する属性の値があることを確認してください (例: URL で
{{UserAttribute['ID']}}を使用している場合は、テストユーザーに User ID があることを確認してください)。
よくある質問
Content API はどのくらいの頻度でデータを取得しますか?
Content API はどのくらいの頻度でデータを取得しますか?
Content API は、メッセージが生成されるときに、ユーザーごとにリアルタイムで呼び出されます。
MoEngage が API を呼び出したときに API がダウンしている場合はどうなりますか?
MoEngage が API を呼び出したときに API がダウンしている場合はどうなりますか?
[動作を記載してください] 例: API 呼び出しが失敗またはタイムアウトした場合、コンテンツはレンダリングされません。Jinja コードでフォールバックを設定して、デフォルトの画像やテキストを表示できます。
問題が解決しない場合は誰に問い合わせればよいですか?
問題が解決しない場合は誰に問い合わせればよいですか?
API の可用性や貴社プラットフォームから返されるデータに関する問題については、[Partner Support Email/Link] からサポートチームにお問い合わせください。MoEngage 内でのキャンペーン設定や Jinja テンプレートに関する問題については、カスタマーサクセスマネージャーにお問い合わせください。
サポート 🤝
- [Partner Name] に関する問題については、
[Partner Support Email or Link to Support Portal]から当社のサポートチームにお問い合わせください。 - MoEngage プラットフォームに関する問題については、MoEngage サポートチームにお問い合わせください。