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中，每個決定範圍都會對應至以決定為基礎的網頁內容版位或促銷活動。 在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區段。