applyPropositions

applyPropositions コマンドを使用すると、既にsendEvent コマンドを使用してレンダリングされた提案を再レンダリングできます。 このコマンドは、ページの一部が再レンダリングされるシングルページアプリケーションを操作する場合に便利で、既にページに適用されているパーソナライゼーションが上書きされる可能性があります。

このコマンドは、次のフィールドをサポートしています。

  • 提案:再レンダリングする提案オブジェクトの配列。

  • ビュー名:レンダリングするビューの名前。 これらの決定の表示通知はキャッシュされ、personalization.includeRenderedPropositions オプションを使用して、後続のsendEvent コマンドに含めることができます。

  • Meta data: HTML オファーの適用方法を決定するオブジェクト。 次のプロパティが含まれています。

    • 範囲
    • セレクター
    • アクションタイプ
NOTE
applyPropositions コマンドは、表示イベントを自動的に送信しません。 ディスプレイの記録が必要な場合は、表示イベントの管理の説明に従って、sendEvent コマンドを使用します。

Web SDKの設定済みインスタンスを呼び出す際に、applyPropositions コマンドを実行します。 設定オプションを含むオブジェクトは、次のフィールドをサポートしています。

  • propositions:再レンダリングする提案オブジェクトの配列。 このオブジェクトは通常は使用されません。通常、propositionScopes フィールドによって、再レンダリングするスコープまたはサーフェスが決まります。

  • metadata: HTML オファーの適用方法を指定します。 これは、キーがスコープまたはサーフェスで、値がキーselectoractionTypeを含むオブジェクトであるマップです。

    • selector: HTMLを適用する場所のCSS セレクターを含む文字列。
    • actionType: HTMLで実行するアクション。 有効な値には、setHtmlreplaceHtmlおよびappendHtmlが含まれます。
  • viewName: シングルページアプリケーションでレンダリングするビューの名前。 これらの決定の表示通知はキャッシュされ、personalization.includeRenderedPropositionsを使用して後続のsendEvent コマンドに含めることができます。

alloy("applyPropositions",{
  "propositions": [],
  "metadata": {},
  "viewName": ""
});

Web SDK タグ拡張機能を使用した提案の適用

このコマンドと同等のWeb SDK タグ拡張機能は、提案を適用 アクションです。

recommendation-more-help
experience-platform-help-collection