網頁擴充功能的資料元素類型

注意

Adobe Experience Platform Launch在Adobe Experience Platform中已重新命名為一套資料收集技術。 因此,產品檔案中已推出數個術語變更。 有關術語更改的綜合參考,請參閱以下document

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

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

本檔案說明如何在Adobe Experience Platform中為網頁擴充功能定義資料元素類型。

重要

如果您正在開發邊緣擴充功能,請參閱邊緣擴充功能資料元素類型上的指南。

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

資料元素類型通常包含下列項目:

  1. 資料收集UI中顯示的view,可讓使用者修改資料元素的設定。
  2. 在標籤執行階段程式庫內發出的程式庫模組,用於解譯設定及擷取資料片段。

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

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

如果要使Adobe Experience Platform用戶可以配置本地儲存項名稱,則可以允許用戶輸入名稱,然後將該名稱保存到settings對象。 該物件可能如下所示:

{
  itemName: "campaignId"
}

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

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

預設值支援

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

內容事件資料

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

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

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

屬性 說明
$type 說明擴充功能名稱和事件名稱的字串,需以句點連接,例如 youtube.play
$rule 包含當前所執行規則相關資訊的物件。物件必須包含下列子屬性:
  • id:當前所執行規則的 ID。
  • name:當前所執行規則的名稱。

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

本頁內容