カスタム 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