`context`

Last update: Wed Feb 11 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

주제:
구매 ID

작성 대상:

개발자

context 속성은 웹 SDK에서 자동으로 수집할 수 있는 항목을 결정하는 문자열 배열입니다. 이 데이터는 큰 가치를 제공할 수 있지만 이 데이터 중 일부를 생략하면 조직의 개인정보 처리방침을 준수하는 데 도움이 될 수 있습니다.

컨텍스트 키워드 및 XDM 요소

주어진 컨텍스트 키워드를 포함하면 웹 SDK이 연관된 모든 XDM 요소를 자동으로 채웁니다. 다른 요소를 허용하면서 특정 XDM 요소를 생략하려면 onBeforeEventSend을(를) 사용하여 값을 지울 수 있습니다. 페이지에서 여러 이벤트를 보내는 경우 웹 SDK은 SendEvent 호출 시마다 이러한 필드를 포함합니다.

웹

"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 경로

예제 값

환경 유형

경험이 표시되는 환경의 유형입니다. 웹 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 경로

예제 값

이름

소프트웨어 개발 키트(SDK) 식별자. 이 필드는 URI를 사용하여 다른 소프트웨어 라이브러리에서 제공하는 식별자 간의 고유성을 개선합니다.

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

자세한 내용은 사용자 에이전트 클라이언트 힌트를 참조하십시오.

일회성 Analytics 레퍼러 one-time-analytics-referrer

"oneTimeAnalyticsReferrer" 키워드는 페이지에 대한 첫 번째 비의사 결정 sendEvent 호출에서만 Adobe Analytics에 레퍼러 값을 보냅니다. 이 컨텍스트 키워드의 기본 사용 사례는 Adobe Analytics의 레퍼러 차원이 Analytics 및 Target 통합에 주로 사용되는 히트에 의해 부풀려지지 않도록 하는 것입니다.

지정된 sendEvent 명령이 의사 결정 이벤트 유형(decisioning.propositionFetch, decisioning.propositionDisplay, decisioning.propositionInteract)을 사용하는 경우 페이지에서 첫 번째 sendEvent을(를) 계산할 때 무시됩니다. 페이지에서 레퍼러 값이 변경되고 다른 sendEvent이(가) 트리거되면 새 레퍼러 값이 페이로드에 포함됩니다. 이 조건을 사용하면 기능을 단일 페이지 애플리케이션과 함께 사용할 수 있습니다.

중복 레퍼러 값이 검색되면 라이브러리는 data.__adobe.analytics.referrer을(를) 빈 문자열("")로 설정합니다.
이 데이터 개체 필드를 빈 문자열로 설정하면 히트가 Adobe Analytics에 도달할 때 데이터 개체가 XDM 개체 해당 필드를 덮어쓰므로 값이 사실상 지워집니다. XDM 개체에는 영향을 주지 않으므로 데이터 스트림에 여러 서비스를 포함하는 경우 해당 데이터를 Experience Platform 데이터 세트로 계속 전송할 수 있습니다.

구현

context 명령을 실행할 때 configure 문자열 배열을 설정하십시오. 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"]
});

웹 SDK 태그 확장을 사용하여 컨텍스트 정보 수집

웹 SDK 태그 확장 설명서의 데이터 수집 구성 설정에서 컨텍스트 설정을 참조하십시오.

recommendation-more-help

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