`context`

Last update: Thu Dec 04 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

トピック：
Appmeasurement，データ収集，無効化

作成対象：

開発者

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-08-07T15:47:17.129-07:00

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

ユーザーが GMT からオフセットされる分数。

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

タイムスタンプ

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

ディメンション

説明

XDM パス

値の例

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

簡略化された拡張 ISO 8601 形式のエンドユーザーの UTC タイムスタンプ。

xdm.timestamp

YYYY-08-07T22:47:17.129Z

実装の詳細

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

ディメンション

説明

XDM パス

値の例

名前

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

xdm.implementationDetails.name

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

バージョン

Software Development Kit （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

詳しくは、User Agent Client Hints を参照してください。

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

NOTE

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

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

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

Web SDK タグ拡張機能ドキュメントのデータ収集設定のコンテキスト設定を参照してください。

recommendation-more-help

1ae86b30-e55e-49c1-ab11-9d0356a5f3e1