DOM アクションの提案を自動的にレンダリング

パーソナライゼーションの応答に提案項目がスキーマに含まれる場合は、このパターンを使用します。

https://ns.adobe.com/personalization/dom-action

これらの項目には通常、セレクターとアクションタイプ（setHtml など）が含まれ、renderDecisions が有効な場合に web SDKによって自動的に適用されます。

1.ちらつきの管理（オプション）

パーソナライズされたコンテンツの適用中にちらつきを防止する必要がある場合は、実装に推奨されるちらつき管理手法を使用します。 使用可能なオプションについては、​ ちらつきの管理 ​ を参照してください。

2.自動レンダリングで記録された決定のリクエストとレンダリング

renderDecisions コマンドを呼び出す場合は、true を sendEvent に設定します。 省略すると、renderDecisions プロパティの既定値は false になります。

alloy("sendEvent", {
  renderDecisions: true,
  xdm: {
    web: {
      webPageDetails: {
        name: "home"
      }
    }
  }
});

オプションで、特定のプレースメントをリクエストする必要がある場合は、personalization.decisionScopes を含めます。

alloy("sendEvent", {
  renderDecisions: true,
  personalization: {
    decisionScopes: ["hero-banner", "recommendations"]
  },
  xdm: { }
});

詳細については、personalization コマンドの sendEvent オブジェクトを参照してください。

​3. イベントの表示

renderDecisions を true に設定し、personalization.sendDisplayEvent を true に設定するか省略すると、Web SDKはパーソナライゼーションがレンダリングされた直後に表示イベントを送信します。

alloy("sendEvent", {
  renderDecisions: true,
  personalization: {
    // sendDisplayEvent defaults to true when omitted
  },
  xdm: { }
});

​ 上位および下位のページイベント ​ を使用する場合など、実装のニーズを満たす代替オプションについては、​ 表示イベントの管理 ​ を参照してください。

​4. SPA ビューの変更と再レンダリング

単一ページアプリケーションの場合は、ビュー変更イベントの viewName を含めます。

alloy("sendEvent", {
  renderDecisions: true,
  xdm: {
    web: {
      webPageDetails: {
        viewName: "cart"
      }
    }
  }
});

SPA が、新しい決定フェッチを行わずに、同じビューに対して UI を再レンダリングした場合は、以前に返された提案を再適用できます。

let lastPropositions = [];

alloy("sendEvent", {
  renderDecisions: true,
  xdm: {
    web: { webPageDetails: { viewName: "cart" } }
  }
}).then(({ propositions = [] }) => {
  lastPropositions = propositions;
});

// Later, after a UI re-render:
alloy("applyPropositions", {
  propositions: lastPropositions
});

詳細は、applyPropositions を参照してください。