Web SDK 拡張機能の設定

Last update: Mon May 05 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

トピック：

作成対象：

開発者

Web SDK タグ拡張機能は、web プロパティからAdobe Experience Cloud Edge Networkを介してExperience Platformにデータを送信します。

拡張機能を使用すると、データをExperience Platformにストリーミングし、ID を同期し、顧客の同意シグナルを処理して、コンテキストデータを自動的に収集できます。

このドキュメントでは、タグ UI でタグ拡張機能を設定する方法について説明します。

Web SDK タグ拡張機能のインストール

Web SDK タグ拡張機能には、プロパティをインストールする必要があります。まだ行っていない場合は、タグプロパティの作成に関するドキュメントを参照してください。

プロパティを作成したら、プロパティを開き、左側のバーにある 拡張機能 タブを選択します。

「カタログ」タブを選択します。使用可能な拡張機能のリストから、Web SDK の拡張機能を見つけて インストール を選択します。

Web SDK拡張機能が選択されたタグ UI を示す画像

インストール を選択した後、web SDK タグ拡張機能を設定し、設定を保存する必要があります。

NOTE

タグ拡張機能は、設定を保存した後にのみインストールされます。タグ拡張機能の設定方法については、次の節を参照してください。

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

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

カスタム Web SDK ビルドを作成すると、そのビルドがすべての Web SDK インスタンスで使用されます。

IMPORTANT

Web SDK コンポーネントを無効にすると、既存の実装が壊れる可能性があります。コンポーネントを無効にするたびに、実装を徹底的にテストして、必要なすべての機能が期待どおりに動作していることを確認します。
コンポーネントを無効にすると、そのコンポーネントの設定を編集できなくなります。

Web SDK タグ拡張機能を使用してカスタム web SDK ビルドを作成するには、次の手順に従います。

タグ拡張機能の設定ページで、「カスタムビルドコンポーネント」セクションを展開します。
必要に応じて、コンポーネントを有効または無効にします。次のコンポーネントから選択できます。
- アクティビティコレクター：このコンポーネントを使用すると、リンクの自動収集と Activity Map のトラッキングを行えます。
- オーディエンス：このコンポーネントを使用すると、URL や cookie ベースの宛先などのAudience Manager統合や、ID の同期を有効にできます。
- 同意：このコンポーネントは、同意統合を有効にします。このコンポーネントを無効にすると、次の要素が無効になります。
  - 同意を設定アクションタイプ
- コンテキスト：このコンポーネントを使用すると、コンテキストデータを自動的に収集できます。
- イベントの結合: 非推奨。このコンポーネントを無効にすると、次の要素が無効になります。
  - イベント結合 ID データ要素
  - イベント結合 ID をリセット アクションタイプ
- Media Analytics ブリッジ：このコンポーネントは、Media Analytics インターフェイスを使用してEdge Network Streaming Media を有効にします。このコンポーネントを無効にすると、次の要素が無効になります。
  - Media Analytics トラッカーを取得アクションタイプ
- Personalization：このコンポーネントは、Adobe TargetとAdobe Journey Optimizerの統合を有効にします。このコンポーネントを無効にすると、次の要素が無効になります。
  - 提案を適用アクションタイプ
- ルールエンジン：このコンポーネントは、Adobe Journey Optimizer オンデバイス判定を有効にします。このコンポーネントを無効にすると、次の要素が無効になります。
  - ルールセットを評価アクションタイプ
  - ルールセット項目を登録イベントタイプ
- ストリーミングメディア：このコンポーネントは、Edge Network Streaming Media を有効にします。このコンポーネントを無効にすると、次の要素が無効になります。
  - メディアイベントを送信アクションタイプ

インスタンス設定を指定

ページ上部の設定オプションは、データのルーティング先と、サーバーで使用する設定をAdobe Experience Platformに指示します。

タグ UI の web SDK タグ拡張機能の一般設定を示す画像

名前:Adobe Experience Platform Web SDK拡張機能は、ページ上の複数のインスタンスをサポートします。この名前は、タグ設定を持つ複数の組織にデータを送信する場合に使用します。インスタンス名のデフォルトは alloy です。ただし、インスタンス名を任意の有効なJavaScript オブジェクト名に変更できます。
IMS 組織 ID:Adobeでデータを送信する組織の ID です。ほとんどの場合、自動入力されるデフォルト値を使用します。ページ上に複数のインスタンスがある場合、データの送信先の 2 番目の組織の値をこのフィールドに入力します。
Edge ドメイン：拡張機能がデータを送受信するドメイン。 Adobeでは、この拡張機能にファーストパーティドメイン（CNAME）を使用することをお勧めします。デフォルトのサードパーティドメインは開発環境で使用できますが、実稼動環境には適していません。ファーストパーティ CNAME の設定方法については、ここで説明します。

データストリーム設定の指定

このセクションでは、使用可能な 3 つの環境（実稼働、ステージング、開発）のそれぞれに使用するデータストリームを選択できます。

リクエストがEdge Networkに送信されると、データストリーム ID がサーバーサイド設定の参照に使用されます。 Web サイト上でコードを変更することなく、設定を更新できます。

データストリームの設定方法については、データストリームに関するガイドを参照してください。

使用可能なドロップダウンメニューからデータストリームを選択するか、値を入力 を選択して、各環境のカスタムデータストリーム ID を入力できます。

タグ UI の Web SDK タグ拡張機能のデータストリーム設定を示す画像

プライバシー設定の指定

このセクションでは、web SDKが web サイトからのユーザー同意シグナルをどのように処理するかを設定できます。特に、他の明示的な同意環境設定が指定されていない場合にユーザーが想定されるデフォルトの同意レベルを選択できます。

デフォルトの同意レベルは、ユーザープロファイルに保存されません。

タグ UI の web SDK タグ拡張機能のプライバシー設定を示す画像

デフォルトの同意レベル

説明

イン

ユーザーが同意環境設定を指定する前に発生するイベントを収集します。

アウト

ユーザーが同意環境設定を指定する前に発生するイベントを破棄します。

保留中

ユーザーが同意環境設定を指定する前に発生するイベントをキューに追加します。同意の環境設定が指定されると、指定された環境設定に応じてイベントが収集または破棄されます。

データ要素によって提供

デフォルトの同意レベルは、定義した別のデータ要素によって決まります。このオプションを使用する場合は、提供されたドロップダウンメニューを使用してデータ要素を指定する必要があります。

TIP

ビジネス運営に明示的なユーザー同意が必要な場合は、「アウト」または 保留中 を使用します。

ID 設定の指定

この節では、ユーザー ID の処理に関する Web SDKの動作を定義できます。

タグ UI の Web SDK タグ拡張機能の ID 設定を示す画像

VisitorAPI から ECID を移行：このオプションはデフォルトで有効になっています。この機能が有効な場合、SDKは AMCV および s_ecid Cookie を読み取り、Visitor.js が使用する AMCV Cookie を設定できます。この機能は、一部のページがまだ Visitor.js を使用している可能性があるので、Web SDKに移行する際に重要です。このオプションを使用すると、SDKは引き続き同じ ECID を使用できるので、ユーザーが 2 人の異なるユーザーとして識別されることはありません。
サードパーティ cookie を使用：このオプションを有効にすると、Web SDKはユーザー ID をサードパーティ cookie に保存しようとします。成功した場合、ユーザーは、各ドメインで個別のユーザーとして識別されるのではなく、複数のドメインを移動する際に単一のユーザーとして識別されます。このオプションが有効になっている場合、ブラウザーがサードパーティ cookie をサポートしていない場合や、ユーザーによってサードパーティ cookie が許可されないように設定されている場合には、SDKでサードパーティ cookie にユーザー ID を格納できない可能性があります。この場合、SDKはファーストパーティドメインにのみ ID を保存します。

IMPORTANT
>サードパーティ cookie は、Web SDKのファーストパーティデバイス ID 機能と互換性がありません。

ファーストパーティデバイス ID またはサードパーティ Cookie のいずれかを使用できますが、両方の機能を同時に使用することはできません。

パーソナライゼーション設定の指定

このセクションでは、パーソナライズされたコンテンツの読み込み中にページの特定の部分を非表示にする方法を設定できます。これにより、訪問者にはパーソナライズされたページのみが表示されます。

タグ UI の web SDK タグ拡張機能のパーソナライゼーション設定を示す画像

Target を at.js から web SDKに移行:at.js 1.x または 2.x ライブラリで使用される従来の mbox および mboxEdgeCluster cookie の読み取りと書き込みを Web SDK で行えるようにする場合は、このオプションを使用します。これにより、訪問者プロファイルを維持しながら、Web SDKを使用するページから at.js 1.x または 2.x ライブラリを使用するページに（その逆も同様に）移行できます。

スタイルの事前非表示

事前非表示のスタイルエディターでは、ページの特定のセクションを非表示にするカスタム CSS ルールを定義できます。ページが読み込まれると、Web SDKはこのスタイルを使用して、パーソナライズの必要なセクションを非表示にし、パーソナライゼーションを取得した後、パーソナライズされたページセクションの非表示を解除します。これにより、訪問者には、パーソナライゼーション取得プロセスが表示されずに、既にパーソナライズされたページが表示されます。

事前非表示のスニペット

事前非表示スニペットは、Web SDK ライブラリが非同期で読み込まれる際に役立ちます。この場合、ちらつきを避けるために、Web SDK ライブラリが読み込まれる前にコンテンツを非表示にすることをお勧めします。

事前非表示のスニペットを使用するには、コピーしてページの <head> 要素内に貼り付けます。

IMPORTANT

事前非表示スニペットを使用する場合、Adobeでは事前非表示スタイルで使用したのと同じ CSS ルールを使用することをお勧めします。

データ収集設定の指定

データ収集設定を管理します。 configure コマンドを使用すると、JavaScript ライブラリの同様の設定を利用できます。

タグ UI の web SDK タグ拡張機能のデータ収集設定を示す画像。

On before event send callback:Adobeに送信されるペイロードを評価して変更するコールバック関数。コールバック関数内の content 変数を使用して、ペイロードを変更します。このコールバックは、JavaScript ライブラリの onBeforeEventSend と同等のタグです。
内部リンククリック数を収集：サイトまたはプロパティ内部のリンクトラッキングデータの収集を有効にするチェックボックス。このチェックボックスを有効にすると、イベントのグループ化オプションが表示されます。
- イベントのグループ化なし：リンクトラッキングデータは、別々のイベントでAdobeに送信されます。別々のイベントで送信されるリンククリック数は、Adobe Experience Platformに送信されるデータの契約上の使用を増やす可能性があります。
- セッションストレージを使用したイベントのグループ化：次のページイベントまで、リンクトラッキングデータをセッションストレージに保存します。次のページでは、保存されたリンクトラッキングデータとページビューデータがAdobeに同時に送信されます。 Adobeでは、内部リンクをトラッキングする場合にこの設定を有効にすることをお勧めします。
- ローカルオブジェクトを使用したイベントのグループ化：次のページイベントまで、リンクトラッキングデータをローカルオブジェクトに保存します。訪問者が新しいページに移動すると、リンクトラッキングデータが失われます。この設定は、単一ページアプリケーションのコンテキストで最も役立ちます。
外部リンククリック数を収集：外部リンクの収集を有効にするチェックボックス。
ダウンロードリンクのクリック数を収集：ダウンロードリンクの収集を有効にするチェックボックス。
ダウンロードリンク修飾子：リンク URL をダウンロードリンクとして認定する正規表現。
クリックのプロパティをフィルター：コレクション前にクリック関連のプロパティを評価および変更するコールバック関数。この関数は、イベント送信コールバックの前 On に実行されます。
コンテキスト設定：特定の XDM フィールドに値を入力する訪問者情報を自動的に収集します。 すべてのデフォルトのコンテキスト情報 または 特定のコンテキスト情報 を選択できます。これは、JavaScript ライブラリの context と同等のタグです。
- Web：現在のページに関する情報を収集します。
- デバイス：ユーザーのデバイスに関する情報を収集します。
- 環境：ユーザーのブラウザーに関する情報を収集します。
- 場所のコンテキスト：ユーザーの場所に関する情報を収集します。
- 高エントロピーのユーザーエージェントヒント：ユーザーのデバイスに関するより詳細な情報を収集します。

TIP

リンククリックの前にオン送信 フィールドは、既に設定されているプロパティにのみ表示される非推奨のコールバックです。これは、JavaScript ライブラリの onBeforeLinkClickSend と同等のタグです。 フィルタークリックプロパティ コールバックを使用してクリックデータをフィルタリングまたは調整するか、イベント送信前にオン コールバックを使用して、Adobeに送信されるペイロード全体をフィルタリングまたは調整します。 フィルタークリックのプロパティ コールバックと リンククリックの送信前にオン コールバックの両方が設定されている場合、フィルタークリックのプロパティ コールバックのみが実行されます。

メディアコレクション設定の指定

メディア収集機能は、web サイト上のメディアセッションに関連するデータを収集するのに役立ちます。

収集されたデータには、メディアプレイバック、一時停止、完了およびその他の関連イベントに関する情報を含めることができます。収集したら、このデータをAdobe Experience PlatformやAdobe Analyticsに送信して、レポートを生成できます。この機能は、web サイトでのメディア消費行動を追跡および把握するための包括的なソリューションを提供します。

タグ UI の web SDK タグ拡張機能の Media Collection 設定を示す画像

Channel：メディアコレクションが実行されるチャネルの名前。例：Video channel。
Player Name：メディアプレーヤーの名前。
アプリケーションのバージョン：メディアプレーヤーアプリケーションのバージョン。
メイン ping 間隔：メインコンテンツに対する ping の頻度（秒単位）。デフォルト値は 10 です。値の範囲は 10 ～ 50 秒です。値を指定しない場合、自動的にトラッキングされるセッションを使用するときにデフォルト値が使用されます。
広告 ping 間隔：広告コンテンツに対する ping の頻度（秒単位）。デフォルト値は 10 です。値の範囲は 1 ～ 10 秒です。値を指定しない場合、自動的にトラッキングされるセッションを使用するときにデフォルト値が使用されます

データストリームの上書きの設定

データストリームの上書きを使用すると、Web SDK を介して Edge Network に渡されるデータストリームの追加設定を定義できます。

これにより、新しいデータストリームを作成したり、既存の設定を変更したりすることなく、デフォルトとは異なるデータストリームの動作をトリガーできます。

データストリーム設定の上書きは、次の 2 つの手順で構成されます。

最初に、データストリーム設定ページでデータストリーム設定の上書きを定義する必要があります。
次に、Web SDK コマンドまたは Web SDK タグ拡張機能を使用して、上書きをEdge Networkに送信する必要があります。

データストリーム設定を上書きする方法について詳しくは、データストリーム設定の上書きドキュメントを参照してください。

Web SDK コマンドを使用して上書きを渡す代わりに、以下に示すタグ拡張機能画面で上書きを設定できます。

IMPORTANT

データストリームの上書きは、環境ごとに設定する必要があります。開発環境、ステージング環境および実稼動環境では、すべて別々のオーバーライドが行われます。次の画面に示す専用オプションを使用して、設定間でコピーできます。

Web SDK タグ拡張機能ページを使用したデータストリーム設定の上書きを示す画像。

デフォルトでは、データストリーム設定の上書きは無効になっています。「データストリーム設定を一致させる」オプションがデフォルトで選択されています。

データストリーム設定がデフォルト設定を上書きすることを示す web SDK タグ拡張機能ユーザーインターフェイス

タグ拡張機能でデータストリームの上書きを有効にするには、ドロップダウンメニューから「有効」を選択します。

データストリーム設定の上書きの有効設定を示す web SDK タグ拡張機能ユーザーインターフェイス

データストリーム設定の上書きを有効にすると、以下に説明する各サービスの上書きを設定できます。

以下のデータストリーム優先設定は、選択した環境のサーバーサイドのデータストリーム設定およびルールを上書きします。

Adobe Analytics

このセクションの設定を使用して、Adobe Analytics サービスへのデータルーティングを上書きします。

Adobe Analytics データストリーム上書き設定を示す web SDK タグ拡張機能の UI 画像。

有効/無効：このドロップダウンメニューを使用して、Adobe Analytics サービスへのデータルーティングを有効または無効にします。
レポートスイート:Adobe Analyticsの宛先レポートスイートの ID。値は、データストリーム設定から事前設定された上書きレポートスイート（またはレポートスイートのコンマ区切りリスト）である必要があります。この設定は、プライマリレポートスイートを上書きします。
レポートスイートを追加：レポートスイートを追加するには、このオプションを選択します。

Adobe Audience Manager

このセクションの設定を使用して、Adobe Audience Manager サービスへのデータルーティングを上書きします。

Adobe Audience Manager データストリーム上書き設定を示す web SDK タグ拡張機能の UI 画像。

有効/無効：このドロップダウンメニューを使用して、Adobe Audience Manager サービスへのデータルーティングを有効または無効にします。
サードパーティ ID 同期コンテナ:Audience Managerの宛先サードパーティ ID 同期コンテナの ID。この値は、データストリーム設定から事前設定されたセカンダリコンテナである必要があり、プライマリコンテナを上書きします。

Adobe Experience Platform

このセクションの設定を使用して、Adobe Experience Platform サービスへのデータルーティングを上書きします。

Adobe Experience Platform データストリーム上書き設定を示す web SDK タグ拡張機能の UI 画像。

有効/無効：このドロップダウンメニューを使用して、Adobe Experience Platform サービスへのデータルーティングを有効または無効にします。
イベントデータセット:Adobe Experience Platformの宛先イベントデータセットの ID。値は、データストリーム設定の事前設定済みセカンダリデータセットである必要があります。
Offer Decisioning：このドロップダウンメニューを使用して、Offer Decisioning サービスへのデータルーティングを有効または無効にします。
Edge セグメント化：このドロップダウンメニューを使用して、Edge Segmentation サービスへのデータルーティングを有効または無効にします。
Personalizationの宛先：このドロップダウンメニューを使用して、パーソナライゼーションの宛先へのデータルーティングを有効または無効にします。
Adobe Journey Optimizer：このドロップダウンメニューを使用して、Adobe Journey Optimizer サービスへのデータルーティングを有効または無効にします。