建立自訂網頁SDK組建

Experience Platform Web SDK資料庫包含多個模組,用於各種功能,例如個人化、身分、連結追蹤等。 根據您的使用案例,您可能只需要特定功能,而不需要整個程式庫。 建立自訂的Web SDK組建可讓您僅選取所需的模組,藉此縮小程式庫大小並提升效能。

使用案例 use-case

建立自訂Web SDK組建有助於減少程式庫大小並提高效能。 以下是一些範例:

移除Media Analytics media-analytics-removal

如果您的網站沒有媒體內容,您可以從組建排除Media Analytics和Streaming Media模組。 這樣可以將網頁SDK組建大小縮減高達50%,並提升載入速度。

移除Personalization personalization

如果您只需要收集使用者量度,並且不打算使用Adobe Target或Journey Optimizer進行個人化,您可以排除Personalization模組。 這樣可在縮減程式庫大小的同時,仍能收集必要的量度。

先決條件 prerequisites

若要建立自訂Web SDK建置版本,您需要Web SDK NPM套件。 確定您的電腦上已安裝Node.js。 如需詳細資訊,請參閱有關如何使用NPM套件安裝Web SDK的檔案。

元件和相依性 components-dependencies

在建立自訂Web SDK組建之前,請定義您計畫使用的Web SDK元件和命令。 有些命令取決於組建中包含的特定模組。

下表顯示Web SDK模組與其所包含命令之間的關係:

模組相依性
設定參數
命令
大小類別
活動收集器
clickCollectionEnabled
不適用
媒體
客群
不適用
不適用
小
內容
context
不適用
小
規則引擎
personalizationStorageEnabled
媒體
事件合併
不適用
createEventMergeId
小
Media Analytics Bridge
不適用
getMediaAnalyticsTracker
大
個人化
不適用
大
同意
defaultConsent
setConsent
小
串流媒體
streamingMedia
大

使用NPM套件建立自訂Web SDK組建 create-custom-build

  1. 開啟您的終端機並執行npx @adobe/alloy。 系統會要求您選取要納入自訂組建的網頁SDK元件。

    顯示自訂組建模組選取專案的終端機影像。

    使用方向鍵在模組清單中上下移動。

    • 按下​ 空間 ​以啟用或停用選取的模組。
    • 按下A以啟用或停用所有模組。
    • 按下I以反轉您的選取範圍。
    • 按下Enter以確認您的選擇,並前往下一個步驟。
  2. 選取要納入自訂組建的模組後,您可以選擇儲存自訂Web SDK程式庫組建的縮制或未縮製版本。 選取您想要的選項,然後按Enter。

    顯示自訂組建精簡選取範圍之終端機的影像。

  3. 接著,系統會詢問您要將組建儲存在本機電腦上的哪個位置。 按下Enter以確認預先選取的位置,或輸入新位置。

    顯示自訂建置儲存選項的終端機影像。

  4. 在您確認位置後,就會產生並儲存您的自訂組建。

    顯示自訂組建儲存位置的終端機影像。

recommendation-more-help
experience-platform-help-collection