applyPropositions
applyPropositions
コマンドを使用すると、sendEvent
コマンドを使用して既にレンダリングされた提案を再レンダリングできます。 このコマンドは、単一ページアプリケーションで作業しているときにページの一部が再レンダリングされると、ページに適用済みのパーソナライゼーションが上書きされる可能性があるので便利です。
このコマンドは、次のフィールドをサポートしています。
-
提案:再レンダリングする提案オブジェクトの配列。
-
ビュー名: レンダリングするビューの名前。 これらの決定に対する表示通知はキャッシュされ、
personalization.includePendingDisplayNotifications
オプションを使用して、後続のsendEvent
コマンドに含めることができます。 -
メタデータ:HTMLオファーの適用方法を指定するオブジェクト。 これには、次のプロパティが含まれます。
- 範囲
- セレクター
- アクションタイプ
Web SDK タグ拡張機能を使用した提案の適用
提案の適用は、Adobe Experience Platform Data Collection タグインターフェイスのルール内のアクションとして実行されます。
- Adobe IDの資格情報を使用して experience.adobe.com にログインします。
- データ収集/タグ に移動します。
- 目的のタグプロパティを選択します。
- ルール に移動し、目的のルールを選択します。
- アクション で、既存のアクションを選択するか、アクションを作成します。
- 拡張機能 ドロップダウンフィールドを Adobe Experience Platform Web SDK に設定し、 アクションタイプ を 提案を適用 に設定します。
- 目的のフィールドを右側に設定します。
- 「変更を保持」をクリックして、公開ワークフローを実行します。
Web SDK JavaScript ライブラリを使用して提案を適用します
設定済みの Web SDK インスタンスを呼び出す際に、applyPropositions
コマンドを実行します。 設定オプションを含むオブジェクトは、次のフィールドをサポートしています。
-
propositions
:再レンダリングする提案オブジェクトの配列。propositionScopes
フィールドは通常、どのスコープまたはサーフェスを再レンダリングするかを決定するので、通常、このオブジェクトは使用されません。 -
metadata
:HTMLオファーの適用方法を決定します。 キーがスコープまたはサーフェスであり、値がキーselector
とactionType
を含むオブジェクトであるマップです。selector
:HTMLの適用先の CSS セレクターを含む文字列actionType
:HTMLで実行するアクション。 有効な値には、setHtml
、replaceHtml
、appendHtml
などがあります。
-
viewName
:単一ページアプリケーションでレンダリングするビューの名前。 これらの決定に対する表示通知はキャッシュされ、personalization.includePendingDisplayNotifications
を使用して後続のsendEvent
コマンドに含めることができます。
alloy("applyPropositions",{
"propositions": [],
"metadata": {},
"viewName": ""
});