`context`

最終更新日： 2026年6月25日

トピック：
Data Collection

作成対象：

Developer

context プロパティは、Web SDKが自動的に収集できる内容を決定する文字列の配列です。これらのデータは大きな価値を提供しますが、こうしたデータを一部省略することで有益な結果を得ることができ、組織のプライバシーポリシーに準拠できるようになります。

コンテキストキーワードとXDM要素

特定のコンテキストキーワードを含めると、Web SDKは、関連するすべてのXDM要素を自動的に入力します。特定のXDM要素を省略して他の要素を許可する場合は、onBeforeEventSendを使用して個々の値を消去できます。 1つのページで複数のイベントを送信する場合、Web SDKには、すべてのSendEvent呼び出しにこれらのフィールドが含まれます。

Web

"web" キーワードは、現在のページに関する情報を収集します。

ディメンション

説明

XDM パス

値の例

ページ URL

現在のページの URL。

xdm.web.webPageDetails.URL

https://example.com/index.html

リファラー URL

前に訪問したページの URL。

xdm.web.webReferrer.URL

http://example.org/linkedpage.html

デバイス

"device" キーワードは、ユーザーのデバイスに関する情報を収集します。

ディメンション

説明

XDM パス

値の例

画面の高さ

画面の高さ（ピクセル単位）。

xdm.device.screenHeight

900

画面の幅

画面の幅（ピクセル単位）。

xdm.device.screenWidth

1440

画面の向き

画面の向き。

xdm.device.screenOrientation

landscape または portrait

環境

"environment" キーワードは、ユーザーのブラウザーに関する情報を収集します。

ディメンション

説明

XDM パス

値の例

環境タイプ

エクスペリエンスが表示された環境のタイプ。 Web SDKは、このフィールドを常にbrowserに設定します。

xdm.environment.type

browser

ビューポートの高さ

ブラウザーのコンテンツ領域の高さ（ピクセル単位）。

xdm.environment.browserDetails.viewportHeight

679

ビューポートの幅

ブラウザーのコンテンツ領域の幅（ピクセル単位）。

xdm.environment.browserDetails.viewportWidth

642

場所の背景

"placeContext" キーワードは、ユーザーの場所に関する情報を収集します。

ディメンション

説明

XDM パス

値の例

現地時間

エンドユーザーのローカルタイムスタンプ（簡略化されたISO 8601形式）（タイムゾーンオフセットなし）。

xdm.placeContext.localTime

YYYY-07-04T12:08:56

ローカルタイムゾーンのオフセット

ユーザーの現地時間がUTCからオフセットされる分数。

xdm.placeContext.localTimezoneOffset

360

国コード

エンドユーザーの国コード。

xdm.placeContext.geo.countryCode

US

州都

エンドユーザーの都道府県コード。

xdm.placeContext.geo.stateProvince

CA

緯度

エンドユーザーの位置の緯度。

xdm.placeContext.geo._schema.latitude

37.3307447

経度

エンドユーザーの場所の経度。

xdm.placeContext.geo._schema.longitude

-121.8945965

IANA タイムゾーン

エンドユーザーのIANA タイムゾーン。ライブラリのバージョン 2.32.0以降に含まれています。

xdm.placeContext.ianaTimezone

America/Denver

タイムスタンプ

"timestamp" キーワードは、イベントのタイムスタンプに関する情報を収集します。このコンテキストは常に含まれ、削除できません。

ディメンション

説明

XDM パス

値の例

イベントのタイムスタンプ

エンドユーザーのUTC タイムスタンプ（簡易拡張ISO 8601形式）。

xdm.timestamp

YYYY-08-07T22:47:17.129Z

実装の詳細

implementationDetails キーワードは、イベントの収集に使用されたSDK バージョンに関する情報を収集します。

ディメンション

説明

XDM パス

値の例

名前

ソフトウェア開発キット（SDK） ID。このフィールドでは、URI を使用で、異なるソフトウェアライブラリで提供される ID 間の一意性を改善します。

xdm.implementationDetails.name

スタンドアロンライブラリを使用する場合、値はhttps://ns.adobe.com/experience/alloyです。ライブラリがタグ拡張機能の一部として使用されている場合、値はhttps://ns.adobe.com/experience/alloy+reactorです。

バージョン

ソフトウェア開発キット（SDK）のバージョン。

xdm.implementationDetails.version

スタンドアロンライブラリを使用する場合、値はライブラリバージョンです。ライブラリがタグ拡張機能の一部として使用されている場合、値はライブラリバージョンとタグ拡張機能のバージョンが+と結合されています。例えば、ライブラリのバージョンが2.1.0、タグ拡張機能のバージョンが2.1.3の場合、値は2.1.0+2.1.3になります。

環境

データが収集された環境。 JavaScript ライブラリを使用する場合、このフィールドは常にbrowserに設定されます。

xdm.implementationDetails.environment

browser

高いエントロピーのクライアントヒント high-entropy-client-hints

"highEntropyUserAgentHints" キーワードは、ユーザーのデバイスに関する詳細情報を収集します。このデータは、Adobeに送信されるリクエストのHTTP ヘッダーに含まれます。データがEdge ネットワークに到着すると、XDM オブジェクトはそれぞれのXDM パスに入力されます。 sendEvent呼び出しでそれぞれのXDM パスを設定した場合は、HTTP ヘッダーの値よりも優先されます。

データストリームを設定するときにデバイス参照を使用する場合、データを消去してデバイス参照値を優先できます。一部のクライアントヒントフィールドとデバイス参照フィールドは、同じヒットに存在できません。

プロパティ

説明

HTTP ヘッダー

XDM パス

例

オペレーティングシステムのバージョン

オペレーティングシステムのバージョン。

Sec-CH-UA-Platform-Version

xdm.environment.browserDetails.
userAgentClientHints.platformVersion

10.15.7

アーキテクチャ

CPUアーキテクチャ。

Sec-CH-UA-Arch

xdm.environment.browserDetails.
userAgentClientHints.architecture

x86

デバイスモデル

使用するデバイスの名前。

Sec-CH-UA-Model

xdm.environment.browserDetails.
userAgentClientHints.model

Intel Mac OS X 10_15_7

ビット数

基礎となるCPU アーキテクチャがサポートするビット数。

Sec-CH-UA-Bitness

xdm.environment.browserDetails.
userAgentClientHints.bitness

64

ブラウザーベンダー

ブラウザーを作成した会社。低エントロピーのヒント Sec-CH-UAもこの要素を収集します。

Sec-CH-UA-Full-Version-List

xdm.environment.browserDetails.
userAgentClientHints.vendor

Google

ブラウザー名

使用するブラウザー。低エントロピーのヒント Sec-CH-UAもこの要素を収集します。

Sec-UA-Full-Version-List

xdm.environment.browserDetails.
userAgentClientHints.brand

Chrome

ブラウザーバージョン

ブラウザーの重要なバージョン。低エントロピーのヒント Sec-CH-UAもこの要素を収集します。正確なブラウザーバージョンは自動的には収集されません。

Sec-UA-Full-Version-List

xdm.environment.browserDetails.
userAgentClientHints.version

105

詳しくは、ユーザーエージェントクライアントヒントを参照してください。

1回限りのAnalytics リファラー one-time-analytics-referrer

"oneTimeAnalyticsReferrer" キーワードは、ページの最初の非決定sendEvent呼び出しでのみ、Adobe Analyticsにリファラー値を送信します。このコンテキストキーワードの主な使用例は、AnalyticsとTargetの統合で主に使用されるヒットによって、Adobe AnalyticsのReferrer ディメンションが膨らまるのを防ぐことです。

特定のsendEvent コマンドで決定イベント型（decisioning.propositionFetch、decisioning.propositionDisplay、decisioning.propositionInteract）が使用されている場合、ページの最初のsendEventを計算する際に無視されます。リファラー値がページ上で変更され、別のsendEventがトリガーされた場合、新しいリファラー値がペイロードに含まれます。この条件を使用すると、この機能をシングルページアプリケーションで使用できます。

重複するリファラー値が検出されると、ライブラリはdata.__adobe.analytics.referrerを空の文字列（""）に設定します。
このデータオブジェクトフィールドを空の文字列に設定すると、ヒットがAdobe Analyticsに到達したときに値が実質的にクリアされます。これは、データオブジェクトがXDM オブジェクトに相当するフィールドを上書きするためです。XDM オブジェクトには影響しません。データストリームに複数のサービスを含める場合は、そのデータをExperience Platform データセットに引き続き送信できます。

実装

configure コマンドの実行時に、文字列のcontext配列を設定します。 SDKの設定時にこのプロパティを省略すると、"highEntropyUserAgentHints"と"oneTimeAnalyticsReferrer"を除くすべてのコンテキスト情報がデフォルトで収集されます。高エントロピーのクライアントヒントを収集する場合や、データ収集から他のコンテキスト情報を省略する場合は、このプロパティを設定します。文字列は任意の順序で含めることができます。

TIP

高エントロピーのクライアントヒントを含むすべてのコンテキスト情報を収集する場合は、context配列文字列にすべての値を含める必要があります。デフォルトのcontext値では"highEntropyUserAgentHints"と"oneTimeAnalyticsReferrer"が省略されます。context プロパティを設定した場合、省略された値はデータを収集しません。

alloy("configure", {
  datastreamId: "ebebf826-a01f-4458-8cec-ef61de241c93",
  orgId: "ADB3LETTERSANDNUMBERS@AdobeOrg",
  context: ["web", "device", "environment", "placeContext", "highEntropyUserAgentHints", "oneTimeAnalyticsReferrer"]
});

Web SDK タグ拡張機能を使用してコンテキスト情報を収集する

Web SDK タグ拡張機能ドキュメントのData Collection Configuration SettingsのContext settingsを参照してください。

recommendation-more-help

experience-platform-help-collection