subscribeRulesetItems

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

ルールセットが評価されるたびに、コールバック関数は提案の配列を含んだ result オブジェクトを受け取ります。

IMPORTANT
subscribeRulesetItems コマンドは、ルールセットから取得した提案を取得する唯一の方法です。これは、sendEvent の結果と一緒に返されないからです。

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

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

プロパティ
タイプ
説明
surfaces
文字列配列
サーフェスのリスト 提案は、ここで提供されるサーフェスのいずれかに一致する場合にのみ、コールバック関数によって受け取られます。
schemas
文字列配列
スキーマのリスト。 提案は、ここで提供されるスキーマのいずれかと一致する場合にのみ、コールバック関数によって受け取られます。
callback
関数
提案がルールセットの満たされた結果である場合に呼び出されるコールバック関数。 コールバック関数は、呼び出されたときに 2 つのパラメーター(resultcollectEvent)を受け取ります。 詳しくは、 コールバックパラメーターを参照してください。

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

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

パラメーター
タイプ
説明
result
オブジェクト
このオブジェクトには propositions 配列が含まれています。 これらの提案は、ルールセットが満たされている場合の直接的な結果です。 result オブジェクトは、then 句を使用して sendEvent が返す result オブジェクトと同じ構造になっています。
collectEvent
関数
Edge Networkイベントを送信して、インタラクション、ディスプレイ、その他のイベントをトラッキングするために使用できる便利な関数。

collectEvent 関数 collectevent-function

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

パラメーター
タイプ
説明
イベントタイプ
文字列
生成する提案イベントタイプを示す文字列。 サポートされるイベントタイプは、displayinteractdismiss です。
propositions
配列
イベントに対応する提案の配列。

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

次の手順に従って、タグユーザーインターフェイスを通じてコンテンツカードを購読します。

  1. Adobe IDの資格情報を使用して experience.adobe.com にログインします。
  2. データ収集/タグ に移動します。
  3. 目的のタグプロパティを選択します。
  4. ルール に移動し、目的のルールを選択します。
  5. ​ イベント ​ の下で、既存のイベントを選択するか、新しいイベントを作成します。
  6. ​ 拡張機能 ​ ドロップダウンフィールドを Adobe Experience Platform Web SDK に設定し、イベントタイプ購読ルールセット項目 に設定します。
  7. 画面の右側で、コンテンツカードを購読するスキーマとサーフェスを選択します。
  8. 変更を保持」を選択して、公開ワークフローを実行します。

Web SDK JavaScript ライブラリを使用したコンテンツカードのサブスクライブ library

次のサンプルコードでは、コンテンツカードの web://mywebsite.com/#welcome サーフェスをサブスクライブし、collectEvent の便利なメソッドを使用して、すべての提案に対して display イベントを生成します。

alloy("subscribeRulesetItems", {
  surfaces: ["web://mywebsite.com/#welcome"],
  schemas: ["https://ns.adobe.com/personalization/message/content-card"],
  callback: (result, collectEvent) => {
    const { propositions = [] } = result;
    renderMyPropositions(propositions);
    collectEvent("display", propositions);
  },
});
recommendation-more-help
ad108910-6329-42f1-aa1d-5920a2b13636