カスタム Web SDK ビルドの作成

Experience Platform Web SDKには、パーソナライゼーション、ID、リンクトラッキングなど、さまざまな機能を実行するための複数のモジュールが用意されています。 ユースケースによっては、ライブラリ全体ではなく、特定の機能だけが必要な場合があります。 カスタム Web SDK ビルドを作成すると、必要なモジュールのみを選択できるため、ライブラリのサイズを小さくしてパフォーマンスを向上できます。

ユースケース use-case

カスタム Web SDK ビルドを作成すると、ライブラリのサイズを小さくし、パフォーマンスを向上させることができます。 例をいくつか紹介します。

Media Analyticsの削除 media-analytics-removal

Web サイトにメディアコンテンツがない場合は、Media AnalyticsおよびStreaming Media モジュールをビルドから除外できます。 これにより、Web 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 モジュールと、そのモジュールに含まれるコマンドの関係を示しています。

モジュール依存関係
設定パラメーター
コマンド
サイズカテゴリ
Activity Collector
clickCollectionEnabled
なし
メディア
オーディエンス
なし
なし
小
コンテキスト
context
なし
小
ルールエンジン
personalizationStorageEnabled
メディア
イベント結合
なし
createEventMergeId
小
Media Analytics Bridge
なし
getMediaAnalyticsTracker
大
パーソナライゼーション
なし
大
同意
defaultConsent
setConsent
小
Streaming Media
streamingMedia
大

NPM パッケージを使用したカスタム Web SDK ビルドの作成 create-custom-build

  1. ターミナルを開き、npx @adobe/alloyを実行します。 カスタムビルドに含めるWeb SDK コンポーネントを選択するように求められます。

    ​ カスタムビルドモジュールの選択を示すターミナルの画像。

    矢印キーを使用して、モジュールリスト内を上下に移動します。

    • 選択したモジュールを有効または無効にするには、スペース​を押します。
    • すべてのモジュールを有効または無効にするには、Aを押します。
    • Iを押して、選択範囲を反転します。
    • Enterを押して選択を確定し、次の手順に進みます。
  2. カスタムビルドに含めるモジュールを選択したら、カスタム Web SDK ライブラリビルドの縮小バージョンまたは縮小バージョンを保存するかを選択できます。 目的のオプションを選択し、Enterを押します。

    ​ カスタムビルドの最小化選択を示すターミナルの画像。

  3. 次に、ローカルマシン上のどこにビルドを保存するかを尋ねられます。 Enterを押して、選択した場所を確認するか、新しい場所を入力します。

    ​ カスタムビルドの保存オプションを表示する端末の画像。

  4. 場所を確認すると、カスタムビルドが生成され、保存されます。

    ​ カスタムビルドの保存場所を示すターミナルの画像。

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