Adobe Experience Platform Launch已經過品牌重塑,現在是Adobe Experience Platform中的一套資料收集技術。 因此,所有產品文件中出現了幾項術語變更。 如需術語變更的彙整參考資料,請參閱以下文件。
Adobe Experience Platform中標籤的主要目標之一,是建立開放的生態系統,讓Adobe以外的工程師能夠在其網站和行動應用程式上公開其他功能。 這可透過標籤擴充功能來完成。 將擴充功能安裝在標籤屬性上後,該擴充功能即可供屬性的所有使用者使用。
本檔案會概述擴充功能的主要元件,並提供進一步檔案的連結,以協助您進行擴充功能開發程式。
擴充功能由檔案目錄組成。具體而言,擴充功能包含資訊清單檔案、程式庫模組和檢視。
資訊清單檔案(extension.json
)必須存在於根目錄。 此檔案說明副檔名的組成以及某些檔案在目錄中的位置。 資訊清單的功能類似於 package.json
中的檔案 npm 專案。
程式庫模組是說明不同專案的檔案 元件 擴充功能提供的邏輯,換句話說,就是要在標籤執行階段程式庫內發出的邏輯。 每個程式庫模組檔案的內容都必須遵循 CommonJS模組標準.
例如,如果您正在建置名為「傳送信標」的動作型別,則必須要有一個檔案內含傳送信標的邏輯。 如果使用JavaScript,則可呼叫檔案 sendBeacon.js
. 此檔案的內容將在標籤執行階段程式庫內發出。
只要您說明程式庫模組檔案在中的位置,您就可以將程式庫模組檔案放在擴充功能目錄中的任何位置 extension.json
.
檢視是可載入至的HTML檔案 iframe
元素 標籤應用程式內,尤其是透過Platform UI和資料收集UI。 檢視必須包含擴充功能提供的指令碼,並符合小型API,才能與應用程式通訊。
任何擴充功能最重要的檢視檔案是其設定。 請參閱以下小節: 擴充功能組態 以取得詳細資訊。
您的檢視中並沒有可用程式庫的限制。換言之,您可以使用jQuery、Underscore、React、Angular、Bootstrap或其他。 不過,仍建議您讓擴充功能具有類似於UI的外觀和風格。
建議您將所有檢視相關檔案 (HTML、CSS、JavaScript) 放在與程式庫模組檔案不同的單一子目錄中。在 extension.json
,您可以說明此檢視子目錄的位置。 然後,Platform將從其Web伺服器為此子目錄(僅此子目錄)提供服務。
每個擴充功能會定義一組功能。 這些功能透過包含在以下專案中來實作: 資料庫 部署至您的網站或應用程式的屬性。 程式庫是個別元件的集合,包含條件、動作、資料元素等。 每個程式庫元件都是一段可重複使用的程式碼(由擴充功能提供),會在標籤執行階段內發出。
根據您正在開發Web擴充功能或邊緣擴充功能,可用的元件型別及其使用案例會有所不同。 如需每種擴充功能型別可用元件的概述,請參閱以下各小節。
在 Web 擴充功能中,規則會透過事件觸發,接著在符合特定條件時執行特定動作。如需詳細資訊,請參閱 Web 擴充功能中的模組流程概述文件。
除了 核心模組 由Adobe提供,您可以在Web擴充功能中定義下列程式庫元件:
若要進一步瞭解在Web擴充功能中實作程式庫元件所需的格式,請參閱 模組格式概觀.
邊緣擴充功能中,規則會透過條件檢查作業來觸發,接著在通過檢查後執行特定動作。請參閱 邊緣擴充功能流程 以取得詳細資訊。
您可以在邊緣擴充功能中定義下列程式庫元件:
若要進一步了解在邊緣擴充功能中實作程式庫模組所需的格式,請參閱模組格式概述。
擴充功能組態是指擴充功能據以向使用者收集全域設定的方式。組態包含檢視元件,該元件會匯出並發射標籤執行階段程式庫中的設定為純物件。
例如,假設擴充功能允許使用者使用「傳送信標」動作來傳送信標,且信標一律須包含帳戶ID。 擴充功能應從擴充功能設定檢視中要求一次帳戶ID,而不是在使用者每次設定「傳送信標」動作時都詢問帳戶ID。 每次要傳送信標時,「傳送信標」動作都可從擴充功能設定中提取帳戶ID,並將其新增至信標。
當使用者將擴充功能安裝至UI中的屬性時,他們會看到擴充功能組態檢視,使用者必須完成該檢視才能完成安裝。
若要深入瞭解,請參閱以下指南: 擴充功能組態.
當您完成擴充功能的建置後,可以將其提交,以列在Platform的擴充功能目錄中。 請參閱 擴充功能提交程式概觀 以取得詳細資訊。