personalization

personalization对象配置请求哪些个性化决策（优惠或建议），以及如何在请求和响应中处理这些决策。 它在Adobe Target或Adobe Journey Optimizer实施中特别有用，因为它是允许您按用户自定义显示内容的驱动力。

alloy("sendEvent", {
  personalization: {
    decisionScopes: ["hero-banner"],
    surfaces: ["web://example.com"],
    schemas: ["https://ns.adobe.com/personalization/dom-action"],
    sendDisplayEvent: true,
    sendDisplayNotifications: true,
    includePendingDisplayNotifications: true,
    defaultPersonalizationEnabled: false
  },
  renderDecisions: true,
  xdm: adobeDataLayer.getState(reference)
});

personalization对象包含以下属性：

personalization.decisionScopes

decisionScopes属性是一个字符串数组，它指示Web SDK检索并返回个性化决策。 数组中的每个项目标识需要个性化内容的位置、上下文或逻辑位置。

当您想要显式获取页面特定区域或组件的个性化内容时，此属性很有用。 在需要随着用户的导航或视图更改而设置不同选件集的单页应用程序中，此选项特别有用。 您还可以使用此属性通过仅检索与用户相关的UI元素的选件来优化性能。

personalization: {
  decisionScopes: ["hero-banner", "cart-offer"]
}

在Adobe Target中，每个决策范围都映射到mbox或活动。 在Adobe Journey Optimizer中，每个决策范围都映射到基于决策的Web内容投放或营销活动。 在Offer Decisioning中，决策范围映射到访客应收到的选件或建议。

personalization.surfaces

surfaces属性是表面URI字符串的数组，这些字符串手动定义从中请求个性化的渠道、设备或上下文。 它们允许您区分不同的数字体验，例如跨渠道生态系统内的域、应用程序或设备平台。 默认情况下，库推断来自当前页面的缺省曲面。 可以使用此属性覆盖当前页面的自动推断表面。

当您想要使用跨渠道个性化并且必须区分个性化在单独的渠道之间的工作方式时，此属性很有价值。 它允许您为同一Adobe Experience Platform组织下的不同站点创建不同的选件。

personalization: {
  surfaces: ["web://example.com", "web://support.example.com/contact"]
}

此属性基本与Adobe Journey Optimizer一起使用，因为它与Journey Optimizer营销活动和表面管理中设置的表面相匹配。

personalization.schemas

schemas属性是一个架构URI字符串数组，用于筛选从Edge Network请求的个性化内容类型。 设置此属性可限制您从Adobe收到的响应，使其仅包含与您指定的内容类型定义匹配的选件。 如果忽略，则库将请求匹配范围或表面的所有可用架构的选件。

此属性有助于优化响应大小，并确保您的网站或应用程序仅接收它可处理的选件类型。 当与以特定方式呈现个性化内容的单页应用程序一起使用时（例如仅使用DOM操作或仅使用JSON对象），此功能也非常有用。

personalization: {
  schemas: [
    "https://ns.adobe.com/personalization/dom-action",
    "https://ns.adobe.com/personalization/html-content-item"
  ]
}

支持以下架构URI：

personalization.sendDisplayEvent

sendDisplayEvent属性是一个布尔值，用于确定在页面上呈现个性化内容后是否立即将显示通知事件自动发送到Edge Network。 如果忽略，则其默认值为true。 如果您不想指示已针对展示跟踪呈现个性化内容，请将此变量设置为false。

将此变量设置为false的最常见用例是当您计划在实施中的其他位置发送另一个标记显示事件的命令时。 某些实施同时具有展示次数和Analytics事件；此属性可让您完全控制哪些sendEvent命令递增展示次数。

personalization: {
  sendDisplayEvent: true
}

personalization.includePendingDisplayNotifications

includePendingDisplayNotifications属性是一个布尔值，它控制当前sendEvent调用中是否捆绑了任何挂起的显示通知。 待处理显示通知是已渲染但尚未作为显示事件报告给Edge Network的个性化内容的展示次数。 当使用单页应用程序时，此属性非常有用，因为呈现个性化内容和sendEvent调用可能相互异步。

此属性的默认值为false。 如果要批处理并刷新任何待处理的显示通知，以便准确记录其展示次数，请将此属性设置为true。 同步实施（如传统网站）通常不需要设置此属性。

personalization: {
  includePendingDisplayNotifications: true
}

personalization.defaultPersonalizationEnabled

defaultPersonalizationEnabled属性是一个布尔值，用于显式控制Web SDK如何请求此__view__命令的默认全页个性化范围(sendEvent)和表面。 默认情况下，在页面加载后的第一个sendEvent命令上，Web SDK请求提供默认页面范围的个性化范围和关联的界面。 后续sendEvent命令不请求默认个性化。 您可以使用此属性来覆盖该行为。 它在单页应用程序实施中非常有用，您可以在实施中在用户浏览网站时再次请求默认个性化。 当您希望​ 仅 ​发送显示事件而不复制选件检索时，也可以使用此属性。

personalization: {
  defaultPersonalizationEnabled: false
}

此属性会根据其设置方式使用以下逻辑：

使用Web SDK标记扩展的Personalization组件

在配置“Personalization”操作时，此属性的Web SDK标记扩展等效项是Send event部分。