데이터스트림 만들기 및 구성

Last update: Thu Oct 30 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

주제:
데이터스트림

작성 대상:

개발자

이 문서에서는 UI에서 데이터스트림을 구성하는 단계를 설명합니다.

Datastreams 작업 영역 액세스

왼쪽 탐색에서 Datastreams을(를) 선택하여 데이터 수집 UI 또는 Experience Platform UI에서 데이터스트림을 만들고 관리할 수 있습니다.

데이터 수집 UI의 데이터스트림 탭

Datastreams 탭에는 알기 쉬운 이름, ID 및 마지막으로 수정한 날짜를 포함하여 기존 데이터 스트림 목록이 표시됩니다. 세부 정보를 보고 서비스를 구성하려면 데이터 스트림의 이름을 선택하십시오.

특정 데이터 스트림에 대한 추가 옵션을 표시하려면 "기타" 아이콘(…)을 선택하십시오. 데이터 스트림에 대한 기본 구성을(를) 업데이트하려면 Edit을(를) 선택하십시오. 데이터 스트림을 제거하려면 Delete을(를) 선택합니다.

기존 데이터스트림을 편집하거나 삭제하는 옵션

데이터 스트림 만들기 create

데이터 스트림을 만들려면 New Datastream을(를) 선택하여 시작합니다.

새 데이터스트림 선택

데이터스트림 생성 워크플로는 구성 단계부터 표시됩니다. 여기에 데이터스트림에 대한 이름 및 선택적 설명을 입력해야 합니다.

Experience Platform에서 사용할 데이터 스트림을 구성하고 웹 SDK도 사용하는 경우 수집할 데이터를 나타내는 이벤트 기반 XDM(Experience Data Model) 스키마도 선택해야 합니다.

데이터스트림에 대한 기본 구성

지리적 위치 및 네트워크 조회 구성 geolocation-network-lookup

지리적 위치 및 네트워크 조회 설정을 사용하면 수집하려는 지리적 및 네트워크 수준 데이터의 세부 기간 수준을 정의할 수 있습니다.

Geolocation and network lookup 섹션을 확장하여 아래에 설명된 설정을 구성합니다.

지리적 위치 및 네트워크 조회 설정이 강조 표시된 데이터 스트림 구성 화면입니다.

설정

설명

Geo Lookup

방문자의 IP 주소를 기반으로 선택한 옵션에 대한 지리적 위치 조회를 활성화합니다. 사용 가능한 옵션은 다음과 같습니다.

국가: xdm.placeContext.geo.countryCode 채우기
우편 번호: xdm.placeContext.geo.postalCode을 채웁니다.
시/도: xdm.placeContext.geo.stateProvince을(를) 채웁니다.
DMA: xdm.placeContext.geo.dmaID 채우기
구/군/시: xdm.placeContext.geo.city을(를) 채웁니다
위도: xdm.placeContext.geo._schema.latitude을(를) 채웁니다.
경도: xdm.placeContext.geo._schema.longitude 채우기

City, Latitude 또는 Longitude을(를) 선택하면 선택한 다른 옵션에 관계없이 최대 2개의 소수점 이하 좌표를 제공합니다. 이는 도시 수준의 세부 기간으로 간주됩니다.

옵션을 선택하지 않으면 지리적 위치 조회가 비활성화됩니다. 지리적 위치는 IP Obfuscation 전에 발생하며, 이는 지리적 위치가 IP Obfuscation 설정의 영향을 받지 않음을 의미합니다.

Network Lookup

방문자의 IP 주소를 기반으로 선택한 옵션에 대한 네트워크 조회를 활성화합니다. 사용 가능한 옵션은 다음과 같습니다.

이동통신사: xdm.environment.carrier을(를) 채웁니다.
도메인: xdm.environment.domain을 채웁니다.
ISP: xdm.environment.ISP을 채웁니다.
연결 형식: xdm.environment.connectionType을(를) 채웁니다.

데이터 수집을 위해 위의 필드 중 하나를 사용하도록 설정하는 경우 웹 SDK을 구성할 때 context 배열 속성을 올바르게 설정했는지 확인하십시오.

지리적 위치 조회 필드는 context 배열 문자열 "placeContext"을(를) 사용하고 네트워크 조회 필드는 context 배열 문자열 "environment"을(를) 사용합니다.

또한 원하는 각 XDM 필드가 스키마에 있는지 확인합니다. 그렇지 않으면 Adobe에서 제공한 Environment Details 필드 그룹을 스키마에 추가할 수 있습니다.

장치 조회 구성 geolocation-device-lookup

Device Lookup 설정을 사용하면 수집할 장치별 정보를 선택할 수 있습니다.

Device Lookup 섹션을 확장하여 아래에 설명된 설정을 구성합니다.

장치 조회 설정이 강조 표시된 데이터 스트림 구성 화면입니다.

IMPORTANT

아래 표에 표시된 설정은 함께 사용할 수 없습니다. 사용자 에이전트 정보 및 장치 조회 데이터를 동시에 선택할 수 없습니다.

설정

설명

Keep user agent and client hints headers

사용자 에이전트 문자열에 저장된 정보만 수집하려면 이 옵션을 선택합니다. 이 설정은 기본적으로 선택됩니다. xdm.environment.browserDetails.userAgent 채우기

Use device lookup to collect the following information

다음 장치별 정보 중 하나 이상을 수집하려면 이 옵션을 선택합니다.

Device 정보:
- 장치 제조업체: xdm.device.manufacturer을 채웁니다.
- 장치 모델: xdm.device.modelNumber 채우기
- 마케팅 이름: xdm.device.model 채우기
Hardware 정보:
- 하드웨어 형식: xdm.device.type을(를) 채웁니다.
- 표시 높이: xdm.device.screenHeight을(를) 채웁니다.
- 표시 너비: xdm.device.screenWidth을 채웁니다.
- 표시 색 농도: xdm.device.colorDepth을(를) 채웁니다.
Browser 정보:
- 브라우저 공급업체: xdm.environment.browserDetails.vendor 채우기
- 브라우저 이름: xdm.environment.browserDetails.name을 채웁니다.
- 브라우저 버전: xdm.environment.browserDetails.version을 채웁니다.
Operating system 정보:
- OS 공급업체: xdm.environment.operatingSystemVendor 채우기
- OS 이름: xdm.environment.operatingSystem 채우기
- OS 버전: xdm.environment.operatingSystemVersion을 채웁니다.

사용자 에이전트 및 클라이언트 힌트와 함께 디바이스 조회 정보를 수집할 수 없습니다. 디바이스 정보를 수집하도록 선택하면 사용자 에이전트 및 클라이언트 힌트 수집이 비활성화되고 그 반대의 경우도 마찬가지입니다.

Do not collect any device information

장치 조회 정보를 수집하지 않으려면 이 옵션을 선택합니다. 장치, 하드웨어, 브라우저, 운영 체제, 사용자 에이전트 또는 클라이언트 힌트 데이터가 수집되지 않습니다.

데이터 수집을 위해 위의 필드 중 하나를 사용하도록 설정하는 경우 웹 SDK을 구성할 때 context 배열 속성을 올바르게 설정했는지 확인하십시오.

장치 및 하드웨어 정보는 context 배열 문자열 "device"을(를) 사용하고, 브라우저 및 운영 체제 정보는 context 배열 문자열 "environment"을(를) 사용합니다.

또한 원하는 각 XDM 필드가 스키마에 있는지 확인합니다. 그렇지 않으면 Adobe에서 제공한 Environment Details 필드 그룹을 스키마에 추가할 수 있습니다.

고급 옵션 구성 advanced-options

고급 구성 옵션을 표시하려면 Advanced Options을(를) 선택하십시오. 여기에서 IP 난독화, 자사 ID 쿠키 등과 같은 추가 데이터스트림 설정을 구성할 수 있습니다.

고급 구성 옵션

IMPORTANT

정확한 지리적 위치 정보를 포함한 개인 데이터를 수집, 처리 및 전송하기 위해 해당 법률 및 규정에 따라 필요한 모든 권한, 동의, 승인 및 인증을 획득했는지 확인할 책임이 있습니다.

IP 주소 난독화 선택은 IP 주소에서 파생되어 구성된 Adobe 솔루션으로 전송되는 지리적 위치 정보 수준에 영향을 주지 않습니다. 지리적 위치 조회는 개별적으로 제한되거나 비활성화되어야 합니다.

설정

설명

IP Obfuscation

데이터스트림에 적용할 IP 난독화 유형을 표시합니다. 고객 IP를 기반으로 하는 모든 처리는 IP 난독화 설정의 영향을 받습니다. 데이터스트림에서 데이터를 수신하는 모든 Experience Cloud 서비스가 여기에 포함됩니다. IP 난독화는 이벤트가 데이터 준비와 같은 다운스트림 서비스로 전송되기 전에 발생합니다.

사용 가능한 옵션:

None: IP 난독화를 사용하지 않도록 설정합니다. 데이터 스트림을 통해 전체 사용자 IP 주소가 전송됩니다.
Partial: IPv4 주소의 경우 사용자 IP 주소의 마지막 옥텟을 난독화합니다. IPv6 주소의 경우 주소의 마지막 80비트를 난독화합니다.

예:
- IPv4: 1.2.3.4 -> 1.2.3.0
- IPv6: 2001:0db8:1345:fd27:0000:ff00:0042:8329 -> 2001:0db8:1345:0000:0000:0000:0000:0000
Full: 전체 IP 주소를 난독화합니다.

예:
- IPv4: 1.2.3.4 -> 0.0.0.0
- IPv6: 2001:0db8:1345:fd27:0000:ff00:0042:8329 -> 0:0:0:0:0:0:0:0

다른 Adobe 제품에 미치는 IP 난독화 영향:

Adobe Target: Adobe Target에서 수행된 IP obfuscation 전에 데이터 스트림 수준 IP obfuscation이(가) 요청에 있는 모든 IP 주소에 적용됩니다. 예를 들어 데이터 스트림 수준 IP obfuscation 옵션이 Full(으)로 설정되어 있고 Adobe Target IP 난독화 옵션이 Last octet obfuscation(으)로 설정되어 있으면 Adobe Target에서 완전히 난독화된 IP를 수신합니다. 데이터스트림 수준 IP obfuscation 옵션이 Partial(으)로 설정되어 있고 Adobe Target IP 난독화 옵션이 Full(으)로 설정되어 있으면 Adobe Target에서 부분적으로 난독화된 IP를 받은 다음 전체 난독화를 적용합니다. Adobe Target IP 난독화는 데이터 스트림 IP와 독립적으로 관리됩니다. 자세한 내용은 IP 난독화 및 지리적 위치에 대한 Adobe Target 설명서를 참조하십시오.
Audience Manager: Audience Manager에서 수행한 IP obfuscation 전에 데이터 스트림 수준 IP obfuscation 설정이 요청에 있는 모든 IP 주소에 적용됩니다. Audience Manager에서 수행한 모든 지리적 위치 조회는 데이터 스트림 수준 IP obfuscation 옵션의 영향을 받습니다. 완전히 난독화된 IP를 기반으로 하는 Audience Manager의 지리적 위치 조회는 알 수 없는 영역을 발생시키고, 결과 지리적 위치 데이터를 기반으로 하는 모든 세그먼트는 실현되지 않습니다. 자세한 내용은 IP 난독화에 대한 Audience Manager 설명서를 참조하십시오.
Adobe Analytics: 데이터 스트림 수준의 IP 난독화 설정이 Full(으)로 설정된 경우 Adobe Analytics에서는 IP 주소를 공백으로 취급합니다. 이는 지리적 위치 조회 및 IP 필터링과 같이 IP 주소에 따라 달라지는 모든 Analytics 처리에 영향을 줍니다. Analytics가 난독화되지 않은 또는 부분적으로 난독화된 IP 주소를 받으려면 IP 난독화 설정을 Partial 또는 None(으)로 설정하십시오. 부분적으로 난독화되고 난독화되지 않은 IP 주소는 Analytics 내에서 더 난독화될 수 있습니다. Analytics에서 IP 난독화를 사용하는 방법에 대한 자세한 내용은 Adobe Analytics 설명서를 참조하십시오. IP 주소가 완전히 난독화되고 페이지 히트에 ECID과(와) VisitorID이(가) 없는 경우 Analytics에서는 IP 주소를 부분적으로 기반으로 하는 대체 ID을(를) 생성하지 않고 히트를 삭제합니다.
Adobe Advertising: 데이터스트림 수준 IP 난독화가 Partial 또는 Full(으)로 설정된 경우 연결된 TV 광고를 제외한 Advertising DSP에서 지리적 보고 및 기능(측정 및 재타겟팅 포함)이 비활성화됩니다.

First Party ID Cookie

활성화되면 이 설정은 자사 디바이스 ID 조회 시 ID 맵에서 이 값을 조회하는 대신 지정된 쿠키를 참조하도록 Edge Network에 지시합니다.

이 설정을 사용할 때는 ID를 저장할 쿠키의 이름을 입력해야 합니다.

Third Party ID Sync

ID 동기화를 컨테이너로 그룹화하면 다른 시간대에 다른 ID 동기화를 실행할 수 있습니다. 활성화되면 이 설정을 사용하여 이 데이터스트림에 실행되는 ID 동기화의 컨테이너를 지정할 수 있습니다.

Third Party ID Sync Container ID

서드파티 ID 동기화에 사용할 컨테이너의 숫자 ID.

Container ID Overrides

이 섹션에서는 기본 ID를 재정의하는 데 사용할 수 있는 추가 타사 ID 동기화 컨테이너 ID를 정의할 수 있습니다.

Access Type

Edge Network가 데이터스트림에 대해 허용하는 인증 유형을 정의합니다.

Mixed Authentication: 이 옵션을 선택하면 Edge Network에서 인증된 요청과 인증되지 않은 요청을 모두 수락합니다. Edge Network API와 함께 웹 SDK 또는 모바일 SDK을(를) 사용하려면 이 옵션을 선택하십시오.
Authenticated Only: 이 옵션을 선택하면 Edge Network에서 인증된 요청만 수락합니다. Edge Network API만 사용하고 인증되지 않은 요청이 Edge Network에 의해 처리되지 않도록 하려는 경우 이 옵션을 선택합니다.

Media Analytics

Experience Platform SDK 또는 Media Edge API를 통해 Edge Network 통합을 위한 스트리밍 추적 데이터를 처리할 수 있습니다. 설명서에서 Media Analytics에 대해 알아보세요.

여기에서 Experience Platform에 대한 데이터스트림을 구성하는 경우 이 안내서로 돌아가기 전에 데이터 수집을 위한 데이터 준비의 자습서에 따라 데이터를 Experience Platform 이벤트 스키마에 매핑하십시오. 그렇지 않으면 Save을(를) 선택하고 다음 섹션으로 계속 진행하십시오.

데이터스트림 세부 사항 보기 view-details

새 데이터스트림을 구성하거나 보려는 기존 데이터스트림을 선택하면 해당 데이터스트림에 대한 세부 사항 페이지가 나타납니다. 여기에서 해당 ID가 포함된 데이터스트림에 대한 자세한 내용을 찾을 수 있습니다.

데이터 스트림 세부 정보 페이지입니다.

데이터스트림 세부 사항 화면에서 서비스를 추가하여 액세스 권한이 있는 Adobe Experience Cloud 제품의 기능을 활성화할 수 있습니다. 데이터스트림의 기본 구성을 편집하고, 매핑 규칙을 업데이트하고, 데이터스트림을 복사하거나 완전히 삭제할 수도 있습니다.

데이터스트림에 서비스 추가 add-services

데이터 스트림의 세부 정보 페이지에서 Add Service을(를) 선택하여 해당 데이터 스트림에 사용할 수 있는 서비스를 추가하십시오.

계속하려면 서비스 추가를 선택하십시오.

다음 화면에서 드롭다운 메뉴를 사용하여 이 데이터스트림에 대해 구성하는 서비스를 선택합니다. 액세스 권한이 있는 서비스만 이 목록에 표시됩니다.

목록에서 서비스를 선택하십시오.

원하는 서비스를 선택하고 표시되는 구성 옵션을 입력한 다음 Save을(를) 선택하여 데이터 스트림에 서비스를 추가합니다. 추가된 모든 서비스가 데이터스트림의 세부 사항 보기에 표시됩니다.

데이터스트림에 추가된 서비스

아래 하위 섹션에서는 각 서비스에 대한 구성 옵션에 대해 설명합니다.

NOTE

각 서비스 구성에는 서비스를 선택할 때 자동으로 활성화되는 Enabled 토글이 포함되어 있습니다. 이 데이터 스트림에 대해 선택한 서비스를 사용하지 않으려면 Enabled 전환을 다시 선택하십시오.

Adobe Advertising 설정 advertising

이 서비스는 Adobe Advertising과 Customer Journey Analytics의 통합에 필요합니다.

Adobe Analytics 설정 analytics

이 서비스는 데이터가 Adobe Analytics로 전송되는지 여부와 그 방법을 제어합니다. Adobe Analytics에 데이터 보내기를 참조하십시오.

Adobe Analytics 데이터스트림 설정.

설정

설명

Report Suite ID

(필수) 데이터를 전송하려는 Analytics 보고서 세트 ID. 이 ID는 Adobe Analytics UI의 Admin > ReportSuites에서 찾을 수 있습니다. 여러 보고서 세트가 지정된 경우 데이터는 각 보고서 세트에 복사됩니다.

Visitor ID namespace

(선택 사항) Adobe Analytics visitorID에 사용할 네임스페이스입니다. 이 네임스페이스에 대해 지정된 값이 있는 이벤트를 보내면 Analytics에서 visitorID(으)로 자동으로 사용됩니다.

Report Suite Overrides

이 섹션에서는 기본 ID 재정의에 사용할 수 있는 추가 보고서 세트 ID를 추가할 수 있습니다.

Adobe Audience Manager 설정 audience-manager

이 서비스는 데이터가 Adobe Audience Manager로 전송되는지 여부와 그 방법을 제어합니다. 이 섹션을 활성화하려면 Audience Manager로 데이터를 전송하면 됩니다. 다른 설정은 선택 사항이지만 사용하는 것이 좋습니다.

Adobe 대상자 데이터 스트림 설정 관리

설정

설명

Cookie Destinations Enabled

SDK는 Audience Manager의 쿠키 대상을 통해서 세그먼트 정보를 공유할 수 있습니다.

URL Destinations Enabled

SDK는 Audience Manager의 URL 대상을 통해서 세그먼트 정보를 공유할 수 있습니다.

Adobe Experience Platform 설정 aep

IMPORTANT

Experience Platform에 대한 데이터스트림을 활성화할 때 UI의 상단 리본에 표시된 대로 현재 사용 중인 Experience Platform 샌드박스를 주목하십시오.

샌드박스는 Adobe Experience Platform의 가상 파티션으로서 데이터와 구현 기능을 조직의 다른 사용자로부터 분리할 수 있습니다. 데이터스트림이 생성되면 해당 샌드박스는 변경될 수 없습니다. Experience Platform의 샌드박스 역할에 대한 자세한 내용은 샌드박스 설명서를 참조하십시오.

이 서비스는 데이터가 Adobe Experience Platform으로 전송되는지 여부와 그 방법을 제어합니다.

Adobe Experience Platform 데이터스트림 설정.

설정

설명

Event Dataset

(필수) 고객 이벤트 데이터를 스트리밍할 Experience Platform 데이터 세트를 선택하십시오. 이 스키마는 XDM ExperienceEvent 클래스를 사용해야 합니다. 데이터 세트를 더 추가하려면 Add Event Dataset을(를) 선택하십시오.

Profile Dataset

동의, 푸시 토큰 및 사용자 활동 영역 고객 특성을 보내는 데 사용할 Experience Platform 데이터 집합을 선택하십시오. 이 스키마는 XDM 개별 프로필 클래스를 사용해야 합니다.

Offer Decisioning

웹 SDK 구현용 Offer Decisioning을 활성화합니다. 자세한 구현 정보는 Web SDK에서 Offer Decisioning 사용에 대한 안내서를 참조하십시오.

Offer Decisioning 기능에 대한 자세한 내용은 Adobe Journey Optimizer 설명서를 참조하십시오.

Edge Segmentation

이 데이터 스트림에 대해 에지 세분화을(를) 사용합니다. Web SDK 또는 Edge Network API에서 에지 세분화가 활성화된 데이터 스트림을 통해 데이터를 보내면 해당 프로필에 대해 업데이트된 대상 멤버십이 응답으로 다시 전송됩니다.

이 옵션을 Personalization 대상과 함께 사용하여 Edge 대상, Offer Decisioning, Adobe Target 또는 Adobe Journey Optimizer을 통해 같은 페이지 및 다음 페이지 개인화 사용 사례를 만들 수 있습니다.

Personalization Destinations

이 데이터 스트림에 대해 사용자 지정 Personalization을(를) 사용하도록 설정합니다. 웹 SDK 또는 Edge Network API에서 개인화 대상이 활성화된 데이터 스트림을 통해 데이터를 보내면 해당 프로필에 대한 대상 멤버십 및 매핑된 프로필 속성(인증된 Edge Network API 요청에 대해서만)이 응답에서 다시 전송됩니다.

Adobe Journey Optimizer

이 데이터 스트림에 대해 Adobe Journey Optimizer을(를) 사용합니다.

이 옵션을 사용하면 데이터 스트림이 Adobe Journey Optimizer의 웹 및 앱 기반 인바운드 캠페인에서 개인화된 콘텐츠를 반환할 수 있습니다.

이 옵션을 사용하려면 선택한 데이터 집합이 Experience Event - Proposition Interactions 필드 그룹을 포함하는 스키마를 사용해야 합니다. 이 필드 그룹을 사용하여 Adobe Journey Optimizer 캠페인 및 경험에 대한 모든 사용자 상호 작용을 기록합니다.

Adobe Target 설정 target

이 서비스는 데이터가 Adobe Target로 전송되는지 여부와 그 방법을 제어합니다.

Adobe Target 데이터스트림 설정.

설정

설명

Property Token

Target에서는 고객이 속성을 사용하여 권한을 제어할 수 있습니다. 속성에 대한 자세한 내용은 Target 설명서의 Enterprise 권한 구성에 대한 안내서를 참조하십시오.

속성 토큰은 Adobe Target UI의 Setup > Properties에서 찾을 수 있습니다.

Target Environment ID

Adobe Target의 환경을 사용하여 모든 단계의 개발을 통해 구현을 관리할 수 있습니다. 이 설정은 이 데이터스트림과 함께 사용하려는 환경을 지정합니다.

각 dev, stage 및 prod 데이터스트림 환경에 대해서는 다르게 설정하여 작업을 단순하게 유지할 수 있습니다. 단, Adobe Target 환경이 이미 정의되어 있는 경우 해당 환경을 사용할 수 있습니다.

Target Third Party ID namespace

이 데이터스트림에 사용하려는 mbox3rdPartyId에 대한 ID 네임스페이스. Adobe Target과 Customer Attributes 통합을 사용하거나 thirdPartyId을(를) 사용하여 Adobe Target 프로필 API를 통해 프로필을 업데이트하거나 만드는 경우 원하는 네임스페이스 값을 제공해야 합니다. 고객 특성 파일 업로드나 프로필 업데이트 API 호출에 사용된 IdentityMap 또는 customerID을(를) 전송하려면 XDM 스키마의 thirdPartyId 섹션에서 이 네임스페이스를 사용해야 합니다. 자세한 내용은 Web SDK를 사용하여 mbox3rdPartyId 구현 안내서를 참조하십시오.

Property Token Overrides

이 섹션에서는 기본 속성 토큰을 재정의하는 데 사용할 수 있는 추가 속성 토큰을 정의할 수 있습니다.