Skip to main content
Personalize API は、プラットフォームのコードから直接、ユーザーに合わせたエクスペリエンスを提供するためのエンドポイント群です。クライアントサイドのパーソナライズとは異なり、これらのサーバーサイド API は、関連するデータを受け取るためにレンダリングパイプライン内で呼び出す必要があります。 プラットフォームがパーソナライズされたペイロードを受け取ったら、それを使用して、リクエストしたユーザー向けにバナー、商品のレコメンデーション、価格などのコンテンツを動的にレンダリングできます。MoEngage は、ターゲティングルール、セッション内属性、セグメントを自動的に評価して、適切なバリエーションを返します。

​
エンドポイント

Personalize API 群は、エクスペリエンス管理とイベントレポートに分類されます。
  • Fetch Experience: ターゲティングルールを評価し、ユーザー向けのパーソナライズされたペイロード（バリエーション）を返します。
  • Fetch Experience Metadata: 現在 Active、Scheduled、または Paused 状態のすべてのエクスペリエンスの一覧を取得します。
  • Track Experience Events: 正確なキャンペーンレポートのために、インプレッション（表示）とユーザーインタラクション（クリック）をトラッキングします。

​
エクスペリエンスイベントのレポート

プラットフォームに応じて、API または MoEngage SDK のいずれかを使用して、サーバーサイドエクスペリエンスのインプレッションとクリックをレポートできます。

​
よくある質問

​
エクスペリエンス管理

はい。experience_key 配列に複数の値（例: ["hero-banner", "sidebar-promo"]）を渡すことで、1 回のリクエストでページの複数のセクション向けのパーソナライズされたコンテンツを受け取ることができます。
API は主に customer_id を使用します。これが不正確な場合や存在しない場合は、MoEngage ワークスペースで Identity Resolution が有効になっていれば、フォールバックとして user_identifiers（メールアドレスや携帯電話番号など）を使用できます。

​
セキュリティとイベント

API Secret は、セキュリティ侵害が発生した場合にのみ再生成してください。新しいシークレットを保存すると、古いキーを使用している既存のすべての連携が直ちに機能しなくなることに注意してください。
サーバーサイドのパーソナライズでは、トラッキングロジックをコンテンツ配信ロジックと一貫させることができるため、すべてのプラットフォーム（Web、モバイル、TV）で Report Experience Events API を使用することを推奨します。
イベントペイロード内の b_id フィールドを使用すると、同じパーソナライズされたエクスペリエンス内でどの要素がクリックされたか（例: “Add to Cart” と “Wishlist”）を一意に識別できます。