subscribeRulesetItems

subscribeRulesetItems コマンドを使用すると、満たされたルールセットの結果である提案をサブスクライブできます。 これを行うには、フィルタリングするサーフェスとスキーマを指定し、コールバック関数を指定します。

ルールセットは、sendEvent コマンドが送信されるたびに評価されます。 コールバック関数は、その中に提案の配列を持つresult オブジェクトを受け取ります。

alloy("subscribeRulesetItems", {
  surfaces: ["web://example.com/#welcome"],
  schemas: ["https://ns.adobe.com/personalization/message/content-card"],
  callback: (result, collectEvent) => {
    const { propositions = [] } = result;
    renderMyPropositions(propositions);
    collectEvent("display", propositions);
  },
});

上記のコードは、コンテンツカードのweb://example.com/#welcome サーフェスをサブスクライブし、すべての提案にcollectEventの便利なメソッドを使用してdisplayのイベントを発生させます。

コマンドオプション command-options

このコマンドは、次のプロパティを持つoptions オブジェクトを取ります。

コールバックパラメーター callback-parameters

コールバック関数は、呼び出されたときに、以下の表に記載されている2つのパラメーターを受け取ります。

collectEvent 関数 collectevent-function

collectEvent関数は、Edge Network イベントを送信して、インタラクション、ディスプレイ、その他のイベントをトラッキングするために使用できる利便性関数です。 次の表に示す2つのパラメーターを受け入れます。

collectEvent関数は、コールバックの外部で独立して呼び出すことができます。 この関数の呼び出しは、ユーザーのアクションに対する応答など、後でインタラクションまたは却下を追跡する場合に便利です。

collectEvent("interact", propositions);

Web SDK タグ拡張機能を使用したコンテンツカードの購読

コマンド応答と同等のWeb SDK タグ拡張機能は、Subscribe ruleset items イベントをサブスクライブするルールです。 このイベントを使用すると、目的のスキーマとサーフェスを指定できます。