스트리밍 데이터 수집

이 단원에서는 Web SDK를 사용하여 데이터를 Experience Platform으로 스트리밍합니다.

노트

Adobe Experience Platform Launch은 데이터 수집 기술 세트로 Adobe Experience Platform에 통합되고 있습니다. 인터페이스에서 이 컨텐츠를 사용하는 동안 알고 있어야 하는 몇 가지 용어 변경 사항이 롤아웃되었습니다.

  • platform launch(클라이언트측)는 이제 tags​입니다.
  • platform launch 서버 측은 이제 event forwarding​입니다.
  • 에지 구성은 이제 datastreams

Adobe Experience Platform Launch 인터페이스에서 완료해야 하는 두 가지 주요 작업이 있습니다.

  • 먼저, Web SDK에서 Edge 네트워크에 데이터를 보낸 후 Adobe 서버에 데이터(예: 플랫폼, Adobe Analytics, Adobe Target 등)가 이동해야 하는 위치를 알리는 Edge 구성을 만들어야 합니다. 이 단계는 웹 SDK를 배포하는 방법에 관계없이 모든 웹 SDK 고객이 수행해야 합니다
  • 두 번째, 웹 SDK를 구현해야 합니다. 웹 SDK는 Launch 인터페이스를 통해 배포하거나 원시 JavaScript 파일인 alloy.js를 사용하여 배포할 수 있습니다. 이 자습서에서는 Launch 인터페이스를 사용합니다. 이 자습서에서는 데이터를 Experience Platform에 스트리밍하기 위해 간단한 Web SDK 구현을 배포하는 데 필요한 최소한의 기능에 초점을 맞추고 있으며 전체 Launch 자습서가 아닙니다.

Data Engineer는 이 자습서를 벗어나는 스트리밍 데이터를 수집해야 합니다. Adobe Experience Platform의 Web 또는 Mobile SDK를 구현할 때 일반적으로 웹 또는 모바일 개발자도 태깅 및/또는 Launch 단계에 참여합니다.

연습을 시작하기 전에 다음 두 개의 짧은 비디오를 시청하여 스트리밍 데이터 섭취 및 웹 SDK에 대해 자세히 알아보십시오.

노트

이 자습서는 Web SDK를 사용하여 웹 사이트에서의 수집 스트리밍에 중점을 두지만, Mobile SDK Adobe, Apache Kafka Connect 및 기타 메커니즘을 사용하여 데이터를 스트리밍할 수도 있습니다.

필요한 권한

권한 구성 단원에서는 이 단원을 완료하는 데 필요한 모든 액세스 컨트롤을 설정합니다. 특히

  • 권한 항목 Launch > 속성 권한 > 승인, 개발, 환경 관리, 확장 관리게시
  • 권한 항목 Launch > 회사 권한 > 속성 관리
  • Luma Tutorial Launch 제품 프로필에 대한 사용자 역할 액세스
  • Luma Tutorial Launch 제품 프로필에 대한 관리자 역할 액세스
  • 권한 항목 플랫폼 > 데이터 수집 > 소스 보기소스 관리
  • 권한 항목 플랫폼 > 데이터 관리 > 데이터 세트 보기데이터 세트 관리
  • 권한 항목 Platform > 프로필 > 프로필 보기, 프로필 관리대상 세그먼트 내보내기
  • 권한 항목 Platform > 샌드박스 관리 > 샌드박스 보기
  • 권한 항목 Platform > 샌드박스 > Luma Tutorial
  • Luma Tutorial Platform 제품 프로필에 대한 사용자 역할 액세스

스트리밍 소스 만들기

  1. Experience Platform 사용자 인터페이스에 로그인

  2. 왼쪽 탐색 영역에서 소스​로 이동합니다.

  3. 스트리밍​을 선택하여 목록을 필터링합니다.

  4. HTTP API 섹션에서 구성 단추를 선택합니다
    HTTP API 스트리밍 소스 구성

  5. 인증 단계에서 Luma Web Events Source계정 이름​으로 입력하고 소스에 연결 단추를 선택합니다. 데이터는 웹 사이트 방문자가 보낸 데이터이므로 인증을 활성화할 필요가 없습니다.
    HTTP API 스트리밍 소스 구성

  6. 연결되면 다음 단추를 선택하여 워크플로우의 다음 단계로 진행합니다

  7. 데이터 선택 단계에서 기존 데이터 세트​를 선택하고 Luma Web Events Dataset를 선택한 다음 다음 단추를 선택합니다
    데이터 세트 선택

  8. 데이터 흐름 세부 정보 단계에서 다음 단추를 선택합니다.
    다음 선택

  9. 검토 단계에서 소스 세부 정보를 검토하고 완료 단추를 선택합니다.
    마침 선택

에지 구성 만들기

다음으로, Edge 구성을 만듭니다. 에지 구성은 웹 SDK 호출에서 데이터를 받은 후 데이터를 보낼 위치를 Adobe Edge 네트워크에 알려줍니다. 예를 들어 데이터를 Experience Platform으로 보내시겠습니까? Adobe Analytics? Adobe Audience Manager? Adobe Target? Edge 구성은 Launch 사용자 인터페이스에서 관리되며, Launch를 통해 Web SDK를 구현하는지 여부에 관계없이, 웹 SDK를 사용하는 Platform 데이터 수집에 중요합니다.

에지 구성을 만들려면:

  1. Experience Platform Launch 사용자 인터페이스에 로그인

  2. 왼쪽 탐색 영역에서 Edge Configurations​로 이동합니다.

  3. 오른쪽 상단 모서리에서 새 에지 구성 단추를 선택합니다

    왼쪽 탐색 영역에서 Edge Configuration 아이콘으로 이동합니다.

  4. 친숙한 이름​에 Luma Platform Tutorial를 입력합니다(회사의 여러 사용자가 이 자습서를 작성하고 있는 경우 이름을 끝에 추가합니다.)

  5. 저장 단추를 선택합니다.

    Edge Configuration에 이름을 지정하고 저장합니다.

다음 화면에서 구성의 환경을 만듭니다. 여기에서 데이터를 보낼 위치를 지정합니다. 데이터를 Experience Platform에만 보내려면 다음을 수행하십시오.

  1. 추가 필드를 표시하려면 Adobe Experience Platform​을 전환합니다.
  2. Sandbox​에 대해 Luma Tutorial를 선택합니다.
  3. 스트리밍 입력​에 대해 Luma Web Events Source를 선택합니다.
  4. 이벤트 데이터 세트​에 대해 Luma Web Events Dataset를 선택합니다
  5. 다른 Adobe 응용 프로그램을 사용하는 경우 다른 섹션을 자유롭게 탐색하여 이러한 다른 솔루션의 Edge 구성에서 필요한 정보를 확인할 수 있습니다. Web SDK는 데이터를 Experience Platform으로 스트리밍할 뿐만 아니라 다른 Adobe 애플리케이션에서 사용하는 모든 이전 JavaScript 라이브러리를 대체하기 위해 개발되었습니다. 에지 구성은 데이터를 전송할 각 애플리케이션의 계정 세부 사항을 지정하는 데 사용됩니다.
  6. 저장 단추를 선택하여 구성을 저장합니다
    에지 구성 및 저장

Edge 구성이 저장되면 결과 화면에 개발, 스테이징 및 프로덕션에 대해 만들어진 세 가지 환경이 표시됩니다. 추가 개발 환경을 추가할 수 있습니다.
각 에지 구성에는 여러 환경이 있을 수 있습니다
이러한 환경 중 하나를 열어 방금 입력한 플랫폼 세부 사항을 확인하는 경우. 하지만 이러한 세부 사항은 환경에 따라 다르게 구성할 수 있습니다. Web SDK에서 다른 Edge 구성 환경에 데이터를 전송하도록 할 수 있습니다. 이렇게 하면 코드 배포 프로세스의 일부로 필요한 경우 데이터를 다른 애플리케이션 환경에 전달할 수 있습니다. 이 자습서에서는 Edge 구성에 대한 추가 사용자 지정을 수행하지 않습니다.

웹 SDK 확장 설치

속성 추가

먼저 Launch 속성을 만들어야 합니다. 속성은 웹 페이지에서 세부 정보를 수집하고 다양한 위치로 전송하는 데 필요한 모든 JavaScript, 규칙 및 기타 기능을 위한 컨테이너입니다.

속성을 만들려면:

  1. 왼쪽 탐색 영역에서 속성​으로 이동합니다.
  2. 새 속성 추가 단추를 선택합니다.
    새 속성 추가
  3. 이름​으로 Luma Platform Tutorial를 입력합니다(회사의 여러 사람이 이 자습서를 작성하고 있는 경우 이름을 끝에 추가합니다.)
  4. 도메인​으로 enablementadobe.com 를 입력합니다(나중에 설명)
  5. 저장 단추를 선택합니다.
    속성 세부 사항

속성을 저장한 후에 아래와 같은 오류 메시지가 표시될 수 있습니다. 있는 경우 방금 만든 속성에 액세스할 수 없기 때문입니다. 이 문제를 해결하려면 Admin Console으로 이동하여 사용자 자신에게 액세스 권한을 제공해야 합니다.
프로필을 저장한 후 오류가 발생했습니다.

속성에 대한 액세스 권한을 자신에게 부여하려면:

  1. 별도의 브라우저 탭에서 Admin Console에 로그인합니다

  2. 위쪽 탐색에서 Products​로 이동합니다.

  3. 왼쪽 탐색에서 Adobe Experience Platform Launch​을 선택합니다

  4. Luma Tutorial Launch 제품 프로필로 이동합니다

  5. 권한 탭으로 이동합니다.

  6. 속성 행에서 편집​을 선택합니다.
    속성 권한 편집

  7. "+" 아이콘을 선택하여 Luma Platform Tutorial 속성을 오른쪽으로 이동하고 저장 단추를 선택하여 권한을 업데이트합니다

    새 속성 추가

이제 Launch 인터페이스가 열려 있는 브라우저 탭으로 다시 전환합니다. 페이지를 다시 로드하면 Luma Platform Tutorial 속성이 목록에 표시됩니다. 을(를) 선택하여 속성을 엽니다.

Luma Platform 자습서가 나타나야 합니다

웹 SDK 확장 추가

이제 속성이 있으므로 확장을 사용하여 웹 SDK를 추가할 수 있습니다. 확장은 Launch 인터페이스 및 클라이언트 기능을 확장하는 코드 패키지입니다. 확장을 추가하려면:

  1. 왼쪽 탐색 영역에서 확장​으로 이동합니다.

  2. 카탈로그 탭으로 이동합니다.

  3. Launch에 사용할 수 있는 확장 프로그램이 많습니다. 카탈로그를 Web SDK 용어로 필터링합니다.

  4. AEP 웹 SDK 확장에서 설치 단추를 선택합니다
    AEP 웹 SDK 확장 설치

  5. Web SDK 확장에 사용할 수 있는 구성은 몇 가지 있지만 이 자습서에는 두 가지 구성만 구성할 수 있습니다. Edge Domain​을 data.enablementadobe.com(으)로 업데이트합니다. 이 설정을 사용하면 웹 SDK 구현을 통해 자사 쿠키를 설정할 수 있으므로 권장됩니다. 이 단원의 뒷부분에서 enablementadobe.com 도메인의 웹 사이트를 Launch 속성에 매핑합니다. enablementadobe.com 도메인의 CNAME이 이미 구성되어 data.enablementadobe.com이(가) Adobe 서버에 전달되도록 구성되었습니다. 자체 웹 사이트에서 Web SDK를 구현하는 경우 사용자 고유의 데이터 수집 목적(예: data.YOUR_DOMAIN.com)으로 CNAME을 만들어야 합니다

  6. Edge Configuration 드롭다운에서 Luma Platform Tutorial 구성을 선택합니다.

  7. 다른 구성 옵션을 자유롭게 볼 수 있습니다(하지만 변경하지 마십시오!). 그런 다음 저장 단추를 선택합니다.

데이터를 보내는 규칙 만들기

이제 규칙을 사용하여 데이터를 Platform으로 보냅니다. 규칙은 Launch에 작업을 수행하도록 하는 이벤트, 조건 및 작업의 조합입니다. 규칙을 만들려면:

  1. 왼쪽 탐색 영역에서 Rules​로 이동합니다.
  2. 새 규칙 만들기 단추를 선택합니다.
    규칙 만들기
  3. 규칙 이름을 지정합니다 All Pages - Library Loaded
  4. Events Add 단추를 선택합니다.
  5. Core Extension​을 사용하고 Library Loaded (Page Top)​를 이벤트 유형​으로 선택합니다. 이 설정은 Launch 라이브러리가 페이지에 로드될 때마다 규칙이 실행됨을 의미합니다.
  6. 변경 내용 유지​를 선택하여 기본 규칙 화면으로 돌아갑니다
    Library Loaded 이벤트 추가
  7. Conditions​은 지정한 이름에 따라 모든 페이지에서 이 규칙이 실행되도록 하므로 비워 둡니다.
  8. 작업​에서 추가 단추를 선택합니다
  9. AEP 웹 SDK 확장​을 사용하고 이벤트 보내기​를 작업 유형​으로 선택합니다
  10. 오른쪽의 유형 드롭다운에서 web.webpagedetails.pageViews​를 선택합니다. 이 필드는 Luma Web Events Schema에 있는 XDM 필드 중 하나입니다
  11. 변경 내용 유지​를 선택하여 기본 규칙 화면으로 돌아갑니다
    이벤트 보내기 작업 추가
  12. 저장​을 선택하여 규칙을 저장합니다
    규칙 저장

라이브러리에 규칙 게시

규칙의 유효성을 검사하려면 속성에 있는 항목이 포함된 라이브러리를 게시해야 합니다. Launch의 게시 섹션에서 수행해야 하는 몇 가지 빠른 단계가 있습니다.

호스트 만들기

Launch 라이브러리는 Adobe의 CDN(Content Delivery Network) 또는 자체 서버에서 호스팅할 수 있습니다. 이 자습서에서는 설정하는 것이 더 빠르므로 Adobe의 CDN을 사용합니다.

  1. 왼쪽 탐색 영역에서 호스트​로 이동합니다.
  2. 새 호스트 만들기 단추를 선택합니다.
    새 호스트 만들기
  3. 이름​에 대해 Adobe CDN를 입력합니다
  4. Type​에 대해 Adobe​에서 관리 를 선택합니다.
  5. 저장 단추를 선택하여 호스트 설정을 완료합니다
    호스트 구성

환경 만들기

환경에서는 게시 작업 과정을 수용하도록 다른 게시 환경에서 라이브러리의 다른 버전을 사용할 수 있습니다. 예를 들어, 완전히 테스트된 버전의 라이브러리는 프로덕션 환경에 게시할 수 있으며, 개발 환경에서 새로운 변경 사항이 작성됩니다. 각 환경에 대해 서로 다른 호스트를 사용할 수도 있습니다. 환경을 만들려면:

  1. 왼쪽 탐색 영역에서 환경​으로 이동합니다.
  2. 새 환경 만들기 단추를 선택합니다.
    새 환경 만들기
  3. 개발​에서 선택
    환경 유형을 선택합니다
  4. 이름​에 대해 Development를 입력합니다
  5. 호스트 선택 드롭다운에 대해 Adobe CDN 를 선택합니다.
  6. 저장 단추를 선택하여 환경 설정을 완료합니다
    환경 구성
  7. 이 라이브러리의 URL 및 기타 구현 세부 정보가 있는 모달이 표시됩니다. 이는 실제 Launch 구현에 매우 중요하지만 이 자습서에서는 이러한 구현을 걱정할 필요가 없습니다. Close 단추를 선택하여 모달을 종료합니다.

라이브러리 만들기 및 게시

이제 속성의 콘텐츠(현재 확장 및 규칙)를 라이브러리에 번들로 제공하겠습니다. 라이브러리를 만들려면:

  1. 왼쪽 탐색 영역에서 게시 흐름​으로 이동합니다.
  2. 새 라이브러리 추가 단추를 선택합니다.
    Add New Library 단추를 선택합니다.
  3. 이름​에 대해 Luma Platform Tutorial를 입력합니다
  4. 환경​에 대해 Development를 선택합니다
  5. 변경된 모든 리소스 추가 단추를 선택합니다. (AEP 웹 SDK 확장 및 All Pages - Library Loaded 규칙 외에도 모든 Launch 웹 속성에 필요한 기본 JavaScript가 포함된 코어 확장도 표시됩니다.)
  6. Save & Build for Development 단추를 선택합니다.
    라이브러리 만들기 및 빌드

라이브러리를 빌드하는 데 몇 분이 걸릴 수 있고 라이브러리가 완료되면 라이브러리 이름 왼쪽에 녹색 점이 표시됩니다.
빌드 완료

게시 흐름 화면에서 볼 수 있듯이 이 자습서의 범위를 벗어난 Launch의 게시 프로세스에 대한 더 많은 정보가 있습니다. 개발 환경에서 단일 라이브러리를 사용할 것입니다.

요청에서 데이터의 유효성 검사

Adobe Experience Platform Debugger 추가

Experience Platform 디버거는 웹 페이지에서 구현된 Adobe 기술을 보는 데 도움이 되는 Chrome 및 Firefox 브라우저에서 사용할 수 있는 확장입니다. 기본 브라우저의 버전을 다운로드합니다.

이전에 디버거를 사용한 적이 없고 기존 Adobe Experience Cloud Debugger와 다른 경우 이 5분 개요 비디오를 볼 수 있습니다.

Luma 웹 사이트 를 엽니다.

이 자습서에서는 Luma 데모 웹 사이트의 공개 호스팅 버전을 사용합니다. 열어 책갈피로 지정합니다.

  1. 새 브라우저 탭에서 Luma 웹 사이트를 엽니다.
  2. 자습서의 나머지 부분에서 사용할 페이지를 책갈피로 지정합니다

이 호스팅된 웹 사이트는 초기 Launch 속성 구성의 도메인 필드에서 enablementadobe.com을 사용하고 AEP 웹 SDK 확장에서 data.enablementadobe.com을(를) 자사 도메인으로 사용한 이유입니다. 계획이 있어!

Luma 홈 페이지

Experience Platform 디버거를 사용하여 Launch 속성에 매핑

Experience Platform 디버거에는 기존 태그 속성을 다른 태그 속성으로 바꾸거나 태그가 구현되지 않은 사이트에 태그 속성을 주입할 수 있는 멋진 기능이 있습니다. 이 메서드는 유효성 검사에 유용하며 이 자습서에서는 웹 개발자만 관련 있는 여러 구현 단계를 건너뛸 수 있습니다.

  1. Luma 사이트가 열려 있는지 확인하고 Debugger 확장 프로그램 아이콘을 선택합니다.

  2. 디버거가 열리고 이 자습서와 관련이 없는 하드코딩된 구현의 세부 정보가 표시됩니다(디버거를 연 후 Luma 사이트를 다시 로드해야 할 수 있음)

  3. 아래 그림과 같이 디버거가 "Connected to Luma"인지 확인한 다음 "lock" 아이콘을 선택하여 디버거를 Luma 사이트로 잠급니다. 이 작업을 수행하지 않으면 디버거가 계속해서 전환하여 포커스가 있는 모든 브라우저 탭에 대한 구현 세부 사항을 표시하므로 혼동될 수 있습니다.

  4. 인증할 오른쪽 상단에 있는 로그인 단추를 선택합니다. Launch 인터페이스를 사용하여 브라우저 탭을 이미 연 경우 인증 단계가 자동으로 수행되며 사용자 이름과 암호를 다시 입력할 필요가 없습니다.

  5. 이제 왼쪽 탐색에서 Launch​로 이동합니다

  6. 구성 탭을 선택합니다

  7. 오른쪽에 페이지 포함 코드​가 표시되면 작업 드롭다운을 열고 바꾸기​를 선택합니다

    Actions > Replace 를 선택합니다.

  8. 인증되므로 디버거가 사용 가능한 Launch 속성 및 환경을 가져옵니다. Luma Platform Tutorial 속성을 선택합니다

  9. Development 환경 선택

  10. 적용 단추를 선택합니다.
    대체 Launch 속성 선택

  11. Luma 웹 사이트가 이제 Launch 속성​_을(를) 사용하여_을(를) 다시 로드합니다. 도와줘! 해킹 당했어! 농담이지
    Launch 속성이 대체됨

  12. 왼쪽 탐색 메뉴에서 Summary​로 이동하여 Launch 속성의 세부 정보를 확인합니다
    요약 탭

  13. 이제 왼쪽 탐색 메뉴에서 AEP 웹 SDK​로 이동하여 네트워크 요청​을 확인합니다

  14. events 행을 엽니다.

    AEP 웹 SDK 요청

  15. 이벤트 보내기 작업과 AEP Web SDK ExperienceEvent Mixin 형식을 사용하는 기타 기본 변수에 지정된 web.webpagedetails.pageView 이벤트 유형을 볼 수 있는 방법을 참고하십시오
    이벤트 세부 사항

  16. 이러한 유형의 요청 세부 사항은 브라우저의 웹 개발자 도구 네트워크 탭에서도 볼 수 있습니다. 페이지를 열고 페이지를 다시 로드합니다. interact 을 사용하여 호출을 찾아 선택한 다음 헤더 탭, 요청 페이로드 영역을 찾습니다.
    네트워크 탭

  17. 응답 탭으로 이동하여 ECID 값이 응답에 포함되는 방식을 확인합니다. 다음 연습에서 프로필 정보의 유효성을 검사하는 데 사용할 것처럼 이 값을 복사합니다.
    네트워크 탭

Experience Platform의 데이터 유효성 검사

Luma Web Events Dataset에 도착하는 데이터 배치를 보고 데이터가 플랫폼에 랜딩되는지 확인할 수 있습니다. (스트리밍 데이터 수집이라고 하지만 지금은 일괄 처리로 도착하고 있습니다.) 이 변수는 Profile에 실시간으로 스트리밍되므로 실시간 세그먼테이션 및 활성화에 사용할 수 있지만 15분마다 데이터 레이크로 일괄적으로 전송됩니다.)

데이터의 유효성을 검사하려면:

  1. 플랫폼 UI에서 왼쪽 탐색 영역에서 데이터 세트​로 이동합니다
  2. Luma Web Events Dataset을 열고 일괄 처리가 도착했는지 확인합니다. 15분마다 전송되므로 일괄 처리가 표시될 때까지 기다려야 할 수 있습니다.
  3. 데이터 집합 미리 보기 단추를 선택합니다.
    데이터 세트를 엽니다.
  4. 미리 보기 모달에서 왼쪽에 있는 스키마의 다른 필드를 선택하여 해당 특정 데이터 포인트를 미리 보는 방법을 확인합니다.
    필드 미리 보기

새 프로필이 표시되는지 확인할 수도 있습니다.

  1. 플랫폼 UI에서 왼쪽 탐색 영역에서 프로필​로 이동합니다
  2. ECID 네임스페이스를 선택하고 ECID 값을 검색합니다(마지막 연습에 설명된 대로 웹 개발자 도구 네트워크 탭의 응답에서 복사).
  3. 프로필에는 ECID와 별도의 자체 ID가 있습니다. 이 ID를 선택하여 프로필을 엽니다
    프로필 찾기 및 열기
  4. 별로 들어 있지 않을 수 있지만 이벤트 탭에서 본 페이지를 적어도 볼 수 있어야 합니다
    프로필 이벤트

이벤트에 사용자 지정 데이터 추가

페이지 이름에 대한 데이터 요소 만들기

  1. Launch UI의 Luma Platform Tutorial 속성 오른쪽 상단에 있는 작업 라이브러리 선택 드롭다운을 열고 Luma Platform Tutorial 라이브러리를 선택합니다. 이 설정을 사용하면 라이브러리에 추가 업데이트를 쉽게 게시할 수 있습니다.

  2. 이제 왼쪽 탐색에서 데이터 요소​로 이동합니다

  3. 새 데이터 요소 만들기 단추를 선택합니다.

    새 데이터 요소 만들기

  4. 이름​으로 Page Name를 입력합니다.

  5. 데이터 요소 유형​으로 JavaScript Variable를 선택합니다

  6. JavaScript 변수 이름​으로 digitalData.page.pageInfo.pageName를 입력합니다

  7. 값의 형식을 표준화하려면 소문자 값Clean text 상자를 선택합니다

  8. Luma Platform Tutorial 이 작업 라이브러리로 선택되어 있는지 확인하고 라이브러리에 저장 단추를 선택합니다
    페이지 이름에 대한 데이터 요소 만들기

페이지 이름을 XDM 개체 데이터 요소에 매핑합니다

이제 페이지 이름을 웹 SDK에 매핑합니다.

중요

이 작업을 완료하려면 사용자가 먼저 Prod Sandbox에 액세스할 수 있는지 확인해야 합니다. 다른 제품 프로필에서 Prod 샌드박스에 액세스할 수 없는 경우 Luma Tutorial Platform 프로필을 빨리 열고 권한 항목 Sandboxes > Prod​를 추가합니다.
Prod 샌드박스 추가

  1. Prod 샌드박스를 포함하도록 권한을 업데이트한 경우 데이터 요소 페이지에서 SHIFT-Reload를 수행하여 캐시를 지웁니다
  2. Launch의 데이터 요소 화면에서 XDM Object이름​을 사용하여 다른 데이터 요소를 만듭니다
  3. 확장​으로 AEP Web SDK를 선택합니다.
  4. 데이터 요소 유형​으로 XDM Object를 선택합니다
  5. Platform 샌드박스 및 스키마 목록을 검색합니다. 샌드박스로 Luma Tutorial 샌드박스를 선택합니다
  6. 스키마​로 Luma Web Events Schema를 선택합니다
  7. 스키마가 Launch UI에 로드됩니다. web.webPageDetails.name 필드를 선택합니다
  8. ​으로 아이콘을 선택하여 데이터 요소 선택 모달을 열고 Page Name 데이터 요소를 선택합니다
  9. Save to Library 단추를 선택합니다.
    페이지 이름을 XDM 개체 데이터 요소에 매핑합니다

이와 동일한 기본 프로세스는 웹 사이트의 모든 사용자 지정 데이터를 XDM 스키마 필드에 매핑하는 데 사용됩니다.

이벤트 보내기 작업에 XDM 데이터 추가

이제 XDM 필드에 데이터가 매핑되었으므로 이벤트 보내기 작업에 이 데이터를 포함할 수 있습니다.

  1. Rules 화면으로 이동하여 All Pages - Library Loaded 규칙을 엽니다

  2. AEP Web SDK - Send Event 작업을 엽니다.

  3. XDM 데이터 로 아이콘을 선택하여 데이터 요소 선택 모달을 열고 XDM Object 데이터 요소를 선택합니다

  4. 변경 내용 유지 단추를 선택합니다.
    이벤트 보내기 작업에 XDM 데이터 추가

  5. 이제 지난 여러 연습에 대해 작업 라이브러리로 Luma Platform Tutorial 을 선택했으므로 최근 변경 사항이 라이브러리에 직접 저장되었습니다. 게시 흐름 화면을 통해 변경 사항을 게시하지 않고 파란색 단추에서 드롭다운을 열고 라이브러리에 저장 및 빌드​를 선택할 수 있습니다.

    라이브러리 및 빌드에 저장

이렇게 하면 방금 수행한 3가지 변경 사항으로 새 Launch 라이브러리를 빌드하기 시작합니다.

XDM 데이터 유효성 검사

이전에 보여드린 대로 디버거를 사용하여 Launch 속성에 매핑되는 동안 Luma 홈 페이지를 다시 로드할 수 있으며 페이지 이름 필드가 요청에서 채워지는지 확인해야 합니다.
XDM 데이터 유효성 검사

데이터 세트 및 프로필을 미리 보고 Platform에서 페이지 이름 데이터가 수신되었는지 확인할 수도 있습니다.

추가 ID 보내기

이제 웹 SDK 구현에서 Experience Cloud ID(ECID)가 있는 이벤트를 기본 식별자로 보냅니다. ECID는 웹 SDK에 의해 자동으로 생성되며 장치 및 브라우저별로 고유합니다. 단일 고객은 사용 중인 장치 및 브라우저에 따라 여러 ECID를 가질 수 있습니다. 그러면 이 고객에 대한 통합 보기를 가져오고 해당 온라인 활동을 CRM, 충성도 및 오프라인 구매 데이터에 어떻게 연결할 수 있습니까? 이렇게 하려면 세션 중에 추가 ID를 수집하고 ID 결합을 통해 프로필을 결정적으로 연결합니다.

기억하시다면 ID 매핑 단원에서 웹 데이터의 ID로 ECID 및 CRM ID를 사용할 것이라고 언급했습니다. 따라서 웹 SDK로 CRM ID를 수집하겠습니다.

CRM ID에 대한 데이터 요소 추가

먼저 데이터 요소에 CRM ID를 저장합니다.

  1. Launch 인터페이스에서 CRM Id 이라는 데이터 요소를 만듭니다.
  2. 데이터 요소 유형​으로 JavaScript 변수​를 선택합니다.
  3. JavaScript 변수 이름​으로 digitalData.user.0.profile.0.attributes.username를 입력합니다
  4. Save to Library 단추를 선택합니다(Luma Platform Tutorial가 여전히 작업 라이브러리여야 함).
    CRM ID에 대한 데이터 요소 추가

CRM ID를 ID 맵 데이터 요소에 추가합니다

이제 CRM Id 값을 캡처했으므로 ID 맵 데이터 요소라는 특수 데이터 요소 유형과 연결해야 합니다.

  1. 이름이 Identities인 데이터 요소를 만듭니다.

  2. 확장​으로 AEP 웹 SDK​를 선택합니다.

  3. 데이터 요소 유형​으로 ID 맵​을 선택합니다

  4. 네임스페이스로 이전 단원에서 만든 ID 기호인 lumaCRMId을 입력합니다

    경고

    AEP 웹 SDK 확장 버전 2.2를 사용하면 Platform 계정의 실제 값을 사용하여 미리 채워진 드롭다운에서 네임스페이스 를 선택할 수 있습니다. 안타깝게도 이 기능은 아직 "샌드박스 인식"이 아니므로 lumaCRMId 값이 드롭다운에 표시되지 않을 수 있습니다. 이 경우 이 연습을 완료하지 못할 수 있습니다. 확인되면 해결 방법을 게시합니다.

  5. ID​로 아이콘을 선택하여 데이터 요소 선택 모달을 열고 CRM Id 데이터 요소를 선택합니다

  6. 인증된 상태​로 인증됨​을 선택합니다.

  7. Primary 선택 취소​를 둡니다. Luma 웹 사이트의 대부분의 방문자에 대해 CRM ID가 없으므로 반드시 ECID를 기본 식별자​로 재정의하지 않으려는 것입니다. ECID 이외의 항목을 기본 식별자로 사용하는 경우는 거의 없습니다. 일반적으로 이러한 지침에 기본 설정을 언급하지는 않지만, 나중에 자체 구현에서 두통을 방지하는 데 도움이 되도록 이 설정을 호출됩니다.

  8. Save to Library 단추를 선택합니다(Luma Platform Tutorial가 여전히 작업 라이브러리여야 함).
    CRM ID를 ID 맵 데이터 요소에 추가합니다

노트

ID 맵 데이터 유형을 사용하여 여러 식별자를 전달할 수 있습니다.

XDM 개체에 IdentityMap 데이터 요소 추가

업데이트해야 하는 데이터 요소 즉, XDM 개체 데이터 요소가 한 개 더 있습니다. 이 하나의 ID를 전달하려면 세 개의 개별 데이터 요소를 업데이트해야 하는 것이 이상하게 보일 수 있지만 이 프로세스는 여러 상태의 여러 ID에 대해 크기가 조정되도록 설계되었습니다. 걱정 마, 이 수업 다 끝냈어!

  1. XDM Object 데이터 요소를 엽니다.
  2. IdentityMap XDM 필드를 엽니다
  3. 데이터 요소를 제공하는 개체​로 아이콘을 선택하여 데이터 요소 선택 모달을 열고 Identities 데이터 요소를 선택합니다
  4. 이제 지난 여러 연습에 대해 작업 라이브러리로 Luma Platform Tutorial 을 선택했으므로 최근 변경 사항이 라이브러리에 직접 저장되었습니다. 게시 흐름 화면을 통해 변경 사항을 게시하지 않고 파란색 단추에서 드롭다운을 열고 라이브러리에 저장 및 빌드​를 선택할 수 있습니다.
    XDM 개체에 IdentityMap 데이터 요소 추가

ID의 유효성 검사

이제 웹 SDK에서 CRM ID를 전송하고 있는지 확인하려면:

  1. Luma 웹 사이트를 엽니다.
  2. 이전 지침에 따라 디버거를 사용하여 자신의 Launch 속성에 매핑합니다
  3. Luma 웹 사이트의 오른쪽 상단에 있는 로그인 링크를 선택합니다
  4. 자격 증명 test@adobe.com/test을 사용하여 로그인합니다.
  5. 인증되면 디버거에서 Experience Platform 웹 SDK 호출을 검사하십시오(AEP Web SDK > 네트워크 요청 > 최신 요청의 events). 그러면 lumaCrmId가 표시됩니다.
    디버거에서 ID의 유효성 검사
  6. ECID 네임스페이스와 값을 사용하여 사용자 프로필을 다시 조회합니다. 프로필에 CRM ID, 충성도 ID 및 이름 및 전화 번호와 같은 프로필 세부 사항이 표시됩니다. 모든 ID와 데이터가 하나의 실시간 고객 프로필로 결합되었습니다!
    Platform에서 ID 유효성 검사

기타 리소스

잘했어요! 웹 SDK 및 Launch에 대한 많은 정보입니다. 전반적인 구현에 더 많은 작업이 포함되어 있지만 이를 통해 Platform을 시작하고 결과를 확인할 수 있습니다.

노트

이제 스트리밍 수집 단원을 완료했으므로 Luma Tutorial Platform 제품 프로필에서 Prod 샌드박스를 제거할 수 있습니다

Data Engineer를 참조하십시오. 원하는 경우 쿼리 단원을 실행합니다.

데이터 설계자. 정책 병합🔗

이 페이지에서는