擴充功能開發快速入門

NOTE
Adobe Experience Platform Launch 已進行品牌重塑,現在是 Adobe Experience Platform 中的一套資料彙集技術。 因此,這些產品文件都推出多項幾術語變更。如需術語變更的彙整參考資料,請參閱以下文件

為了協助您著手展開擴充功能的建置,我們將使用Adobe工程師提供的開放原始碼架構工具,為您的擴充功能套件建立必要的檔案和檔案結構,而您只需負責最重要的工作:撰寫程式碼。

先決條件

擴充功能設定

建立將用來保存擴充功能檔案的目錄。

mkdir example && cd example

本指南採用擴充功能結構工具建置初始擴充結構,讓開發人員能夠快速展開編碼工作。此程序可視需要手動完成,而無需使用架構工具。

執行架構工具。

npx @adobe/reactor-scaffold

架構工具會顯示一些初始設定選項的提示,如下所示:

  • 顯示名稱 - 擴充功能的可見名稱
  • Platform — 指定擴充功能是為網頁、行動裝置或邊緣開發
  • 版本 - 擴充功能的版本
  • 說明 - 擴充功能用途的簡短說明
  • 作者 - 擴充功能作者的名稱
NOTE
針對行動擴充功能,我們將會詢問您有關Android和iOS應用程式結構的幾個問題。

架構工具隨後將提供用來建置擴充功能結構的選項:

  • 擴充功能組態檢視:供擴充功能用來向使用者收集全域設定的檢視 (HTML 檔案)。
  • 事件類型:定義要觀察的活動。例如,了解使用者於何時快速捲動,或使用者何時與頁面元素互動。然後,即可在規則中使用事件來執行動作。
  • 條件類型:條件類型會評估某條件是否成立。
    例如,此選項可傳回使用者的瀏覽器是否為 Chrome、他們是否使用 iPad,或使用者是否位於特定網域。
  • 動作類型:發生事件時所要執行的動作。例如,傳送分析信標、顯示優惠活動、儲存 Cookie,或開啟支援聊天。
  • 資料元素類型:一個資料元素類型會擷取一個資料片段。此資料可能位於本機儲存體、Cookie、DOM 元素或自訂位置中。
  • 共用模組 (僅限Web):共用模組是一種可讓擴充功能與其他擴充功能通訊的機制。
  • 檢視:每個事件、條件、動作或資料元素類型都可提供一個檢視,讓使用者提供設定。
  • Exchange URL (僅限Web和Edge):將擴充功能發佈至Adobe的公共目錄時,請在此處提供清單URL。
  • 圖示路徑:副檔名的圖示檔案路徑。
NOTE
  • 架構工具的後續執行將略過初始設定。
  • 可以新增多個事件、條件、動作。
  • 只能有一個組態檢視。

後續步驟

recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743