Web擴充功能的資料元素型別

Last update: Thu May 25 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

建立對象：

NOTE

Adobe Experience Platform Launch已經過品牌重塑，現在是Adobe Experience Platform中的一套資料收集技術。因此，所有產品文件中出現了幾項術語變更。如需術語變更的彙整參考資料，請參閱以下文件。

在資料收集標籤中，資料元素本質上是頁面上資料片段的別名。此資料可在查詢字串引數、Cookie、DOM元素或其他位置找到。資料元素可供規則參照，並可作為據以存取這些資料片段的抽象概念。

資料元素型別由擴充功能提供，可讓使用者設定資料元素，以特定方式存取資料片段。例如，擴充功能可提供「本機儲存體項目」資料元素類型，讓使用者可在其中指定本機儲存體項目名稱。當規則參考資料元素時，擴充功能將可利用使用者在設定資料元素時提供的本機儲存體項目名稱，來尋找本機儲存體項目值。

本文介紹如何在Adobe Experience Platform中定義Web擴充功能的資料元素型別。

IMPORTANT

如果您正在開發邊緣擴充功能，請參閱以下指南：邊緣擴充功能的資料元素型別而非。

本檔案也假設您熟悉程式庫模組，以及如何將這些模組整合在Web擴充功能中。如果需要相關說明，請先參閱程式庫模組格式化的概述文章，再返回閱讀本指南。

資料元素型別通常包含下列專案：

請考量您想要讓使用者從名為 productName 的本機儲存體項目中擷取資料片段的情況。您的模組可能如下所示：

module.exports = function(settings) {
  return localStorage.getItem('productName');
}

如果要讓Adobe Experience Platform使用者能夠設定本機儲存體專案名稱，您可以允許使用者輸入名稱，然後將該名稱儲存至 settings 物件。該物件可能如下所示：

{
  itemName: "campaignId"
}

若要運用於使用者定義的本機儲存體項目名稱，您的模組必須變更為：

module.exports = function(settings) {
  return localStorage.getItem(settings.itemName);
}

預設值支援

請注意，使用者可以選擇為任何資料元素設定預設值。如果您的資料元素程式庫模組傳回 undefined 或 null 值，則會自動取代為使用者針對資料元素而設定的預設值。

如果是因引規則而擷取資料元素 (例如，資料元素用於規則的條件和動作中)，則會將第二個引數傳至與引發規則的事件有關的內容資訊所在的模組。此模組在某些情況下可能有所助益，可透過下列方式存取：

module.exports = function(settings, event) {
  // event contains information regarding the event that fired the rule
};

event 物件必須包含下列屬性：

屬性

說明

$type

說明擴充功能名稱和事件名稱的字串，需以句點連接，例如 youtube.play。

$rule

包含當前所執行規則相關資訊的物件。物件必須包含下列子屬性：

提供觸發規則之事件類型的擴充功能可選擇性地將任何其他有用的資訊新增至此 event 物件。

recommendation-more-help

12b4e4a9-5028-4d88-8ce6-64a580811743