ドキュメントExperience PlatformWeb SDK ガイド

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

Last update: Wed Mar 05 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • トピック：

作成対象：

  • 開発者

Experience Platform web SDK ライブラリには、パーソナライズ機能、ID、リンクトラッキングなど、様々な機能に対応する複数のモジュールが含まれています。 ユースケースによっては、ライブラリ全体ではなく、特定の機能のみが必要になる場合があります。 カスタム web SDK ビルドを作成すると、必要なモジュールのみを選択でき、ライブラリのサイズを減らし、パフォーマンスを向上させることができます。

ユースケース

カスタム web SDK ビルドを作成すると、ライブラリのサイズを減らし、パフォーマンスを向上させることができます。 次に例を示します。

Media Analytics の削除

Web サイトにメディアコンテンツがない場合は、Media Analytics モジュールと Streaming Media モジュールをビルドから除外できます。 これにより、web SDKのビルドサイズを最大 50% 削減し、読み込み速度を向上させることができます。

Personalizationの削除

ユーザー指標のみを収集し、パーソナライゼーションにAdobe TargetやJourney Optimizerを使用する予定がない場合は、Personalization モジュールを除外できます。 これにより、ライブラリのサイズが小さくなりますが、必要な指標を収集できるようになります。

前提条件

カスタム Web SDK ビルドを作成するには、Web SDK NPM パッケージが必要です。 Node.js がマシンにインストールされていることを確認します。 詳しくは、NPM パッケージを使用して web SDKをインストールする方法に関するドキュメントを参照してください。

コンポーネントと依存関係

カスタム Web SDK ビルドを作成する前に、使用する Web SDK コンポーネントおよびコマンドを定義します。 一部のコマンドは、ビルドに含まれている特定のモジュールによって異なります。

次の表に、Web SDK モジュールとモジュールに含まれるコマンドとの関係を示します。

モジュールの依存関係
設定パラメーター
コマンド
サイズカテゴリ
アクティビティコレクター
clickCollectionEnabled
なし
メディア
オーディエンス
なし
なし
小
コンテキスト
context
なし
小
ルールエンジン
personalizationStorageEnabled
  • evaluateRulesets
  • subscribeRulesetItems
イベントの結合
なし
createEventMergeId
小
Media Analytics Bridge
なし
getMediaAnalyticsTracker
大
パーソナライズ機能
  • prehidingStyle
  • targetMigrationEnabled
  • autoCollectPropositionInteractions
なし
大
同意
defaultConsent
setConsent
小
ストリーミングメディア
streamingMedia
  • createMediaSession
  • sendMediaEvent
大

NPM パッケージを使用したカスタム web SDK ビルドの作成

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

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

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

    • スペース を押して、選択したモジュールを有効または無効にします。
    • A を押して、すべてのモジュールを有効または無効にします。
    • I を押して、選択を反転します。
    • Enter を押して選択を確認し、次の手順に進みます。

  2. カスタムビルドに含めるモジュールを選択したら、カスタム Web SDK ライブラリビルドの縮小バージョンまたは縮小されていないバージョンを保存するかどうかを選択できます。 目的のオプションを選択し、Enter キーを押します。

    カスタムビルドの縮小選択を表示しているターミナルの画像

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

    カスタムビルドの保存オプションを表示しているターミナルの画像

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

    カスタムビルドが保存された場所を示すターミナルの画像

recommendation-more-help
ad108910-6329-42f1-aa1d-5920a2b13636