subscribeRulesetItems
subscribeRulesetItems コマンドを使用すると、ルールセットが満たされた結果である提案を購読できます。 これを行うには、フィルタリングの基準にするサーフェスとスキーマを指定し、コールバック関数を指定します。
ルールセットが評価されるたびに、コールバック関数は提案の配列を含んだ result オブジェクトを受け取ります。
IMPORTANT
subscribeRulesetItems コマンドは、ルールセットから取得した提案を取得する唯一の方法です。これは、sendEvent の結果と一緒に返されないからです。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 オブジェクトを取得します。
プロパティ
タイプ
説明
surfaces文字列配列
サーフェスのリスト 提案は、ここで提供されるサーフェスのいずれかに一致する場合にのみ、コールバック関数によって受け取られます。
schemas文字列配列
スキーマのリスト。 提案は、ここで提供されるスキーマのいずれかと一致する場合にのみ、コールバック関数によって受け取られます。
callback関数
提案がルールセットの満たされた結果である場合に呼び出されるコールバック関数。 コールバック関数は、呼び出されたときに 2 つのパラメーター（
result と collectEvent）を受け取ります。 詳しくは、 コールバックパラメーター を参照してください。コールバックパラメーター callback-parameters
コールバック関数は、呼び出されたときに、以下の表で説明している 2 つのパラメーターを受け取ります。
パラメーター
タイプ
説明
resultオブジェクト
このオブジェクトには
propositions 配列が含まれています。 これらの提案は、ルールセットが満たされている場合の直接的な結果です。 result オブジェクトは、 句を使用して が返す sendEventresult オブジェクト then と同じ構造になっています。collectEvent関数
Edge Network イベントを送信して、インタラクション、ディスプレイ、その他のイベントをトラッキングするのに使用できる便利な関数。
collectEvent 関数 collectevent-function
collectEvent 関数は、Edge Network イベントを送信して、インタラクション、ディスプレイ、その他のイベントをトラッキングするための便利な関数です。 次の表で説明する 2 つのパラメーターを受け入れます。
パラメーター
タイプ
説明
イベントタイプ
文字列
生成する提案イベントタイプを示す文字列。 サポートされるイベントタイプは、
display、interact、dismiss です。propositions配列
イベントに対応する提案の配列。
Web SDK タグ拡張機能を使用したコンテンツカードの購読
コマンド応答と同等の web SDK タグ拡張機能は、Subscribe ruleset items イベントをサブスクライブするルールです。 イベントを使用して、目的のスキーマとサーフェスを指定できます。
recommendation-more-help
1ae86b30-e55e-49c1-ab11-9d0356a5f3e1