Adobe Experience Platform으로 샘플 데이터 가져오기

이 자습서에서는 탐색할 수 있는 샘플 데이터를 사용하여 Experience Platform 샌드박스 환경을 설정하는 방법을 다룹니다. 포스트만 컬렉션을 사용하여 mixin, 스키마, 데이터 세트를 만든 다음 샘플 데이터를 Experience Platform에 가져올 수 있습니다.

샘플 데이터 사용 사례

Experience Platform 비즈니스 사용자는 종종 mixin 식별, 스키마 만들기, 데이터 준비, 데이터 세트 생성, 데이터 수집 등과 같은 일련의 단계를 거쳐야 하며 Experience Platform이 제공하는 기능 중 일부를 탐색하기 전에 데이터를 수집해야 합니다. 이 자습서에서는 일부 단계를 자동화하고 가능한 한 빨리 Platform에서 데이터를 가져오는 쉬운 방법을 찾을 수 있습니다.

이 자습서에서는 Luma라는 가상의 소매 브랜드에 중점을 둡니다. Luma는 여러 국가에서 브릭 및 몰탈 스토어를 운영하고 있으며 웹 사이트 및 모바일 앱을 통해 온라인 사이트를 운영하고 있습니다. 충성도, CRM, 웹 및 오프라인 구매 데이터를 실시간 고객 프로필에 결합하고 이러한 프로필을 활성화하여 마케팅을 한 차원 끌어올리기 위해 Adobe Experience Platform에 투자하고 있습니다. Luma에 대해 생성된 샘플 데이터가 있으며 다음 섹션에서 데이터를 Experience Platform으로 가져오는 방법을 탐색할 수 있습니다.

이 자습서를 완료하려면 Postman 애플리케이션의 UI를 사용하거나 Collection Runner for Postman(Newman) 명령줄을 사용할 수 있습니다

사전 요구 사항

  • Experience Platform API를 인증하고 액세스할 수 있습니다. 그렇지 않은 경우 이 자습서를 따라 빠르게 설정할 수 있습니다.
  • Experience Platform 샌드박스 환경에 액세스할 수 있습니다.

Postman 사용

Postman Collection 가져오기 및 환경 변수 설정

이 절차를 수행하기 전에 Postman 애플리케이션을 다운로드했고 Experience Platform API에 액세스할 수 있는지 확인하십시오. 이 자습서에서는 샌드박스 환경을 사용하게 됩니다. 프로덕션 환경에 리소스와 데이터를 혼합하지 않고 기능을 테스트할 수 있는 분리된 환경을 제공합니다. 그럼 시작해 보겠습니다.

  1. 이 자습서에 필요한 모든 파일이 포함된 platform-utils-main.zip 파일을 다운로드하십시오.

  2. 다운로드 폴더에서 platform-utils-main.zip 파일을 컴퓨터의 원하는 위치로 이동하고 압축을 해제합니다.

  3. FILE_PATH postman 환경 변수를 설정할 때 압축 해제된 파일의 위치를 나중에 메모해 주십시오

  4. Postman을 실행하고 새 작업 공간을 만듭니다.

  5. 새 작업 영역을 만들려면 Postman 왼쪽의 작업 공간 드롭다운 메뉴를 사용합니다. 기존 작업 공간을 선택하거나 프로젝트에 대한 새 작업 공간을 만들 수 있습니다.
    작업 공간 만들기

  6. 작업 영역에 대해 이름 및 선택적 요약​을 입력하고 작업 공간 만들기​를 클릭합니다. Postman을 만들면 새 작업 공간으로 전환됩니다.
    작업 공간 저장

  7. 이제 이 작업 영역에서 포스트맨 컬렉션을 실행하기 위한 몇 가지 추가 설정을 수행합니다. Postman의 헤더에서 공구모양 아이콘을 클릭하고 설정​을 선택하여 설정 모달을 엽니다. 키보드 단축키 (CMD/CTRL + )를 사용하여 모달을 열 수도 있습니다.

  8. General 탭에서 요청 시간 제한을 ms로 업데이트하여 5000 ms 를 활성화하겠습니다allow reading file outside this directory
    설정

    노트

    작업 디렉토리 내에서 파일을 로드하면 동일한 파일이 다른 장치에 저장되어 있으면 장치 간에 원활하게 실행됩니다. 그러나 작업 디렉토리 외부에서 파일을 실행하려면 설정을 켜서 동일한 의도를 나타내야 합니다. FILE_PATH이(가) 포스트맨의 작업 디렉토리 경로와 같지 않으면 이 옵션을 활성화해야 합니다.

  9. 설정 패널을 닫습니다.

  10. 환경 옵션을 선택하고 가져오기 옵션을 클릭합니다.
    환경 가져오기

  11. 다운로드한 json 환경 파일 DataInExperiencePlatform.postman_environment을 가져온 다음 가져오기​를 클릭합니다

    환경 가져오기

  12. Postman의 오른쪽 위 드롭다운에서 환경을 선택하고 눈 아이콘을 클릭하여 환경 변수를 확인합니다.
    환경 선택

  13. 다음 환경 변수가 채워졌는지 확인하십시오. 아래 환경 변수를 살펴보십시오. 값은 Adobe 개발자 콘솔 프로젝트에서 가져올 수 있습니다.

    • CLIENT_SECRET
    • API_KEY
    • TECHNICAL_ACCOUNT_ID
    • META_SCOPE
    • IMS
    • IMS_ORG
    • PRIVATE_KEY
    • SANDBOX_NAME
    • CONTAINER_ID
    • TENANT_ID
    • platform_end_point
    • FILE_PATH
    • PRIVATE_KEY
  14. FILE_PATH 변수를 platform-utils-main.zip 파일의 압축을 푼 로컬 폴더 경로로 업데이트합니다. 왼쪽의 환경에서 환경을 열거나 Postman의 오른쪽 상단에 있는 환경 빠른 모양(눈 단추)을 열고 편집을 클릭하여 변수를 편집할 수 있습니다.
    파일 경로

  15. 이제 다음 환경 변수의 값을 채워야 합니다. 이를 위해 컬렉션 파일을 작업 공간에 업로드해야 합니다.

    • JWT_TOKEN
    • ACCESS_TOKEN
  16. 컬렉션을 선택한 다음 가져오기 옵션을 선택합니다

    컬렉션

  17. 다음 컬렉션 파일을 postman으로 가져오기

    • Authentication.postman_collection.json
    • Luma-Loyalty-Data.postman_collection.json
    • Luma-CRM-Data.postman_collection.json
    • Luma-Product-Catalog.postman_collection.json
    • Luma-Offline-Purchase-Events.postman_collection.json

    컬렉션 가져오기

  18. Authentication 컬렉션을 열고 IMS: JWT Generate + Auth via User Token POST 요청을 선택한 다음 SEND 를 클릭하여 액세스 토큰을 인증하고 가져옵니다.

    컬렉션 가져오기

  19. 환경 변수를 검토하십시오. 그러면 이제 JWT_TOKENACCESS_TOKEN 이 채워져 있음을 알 수 있습니다.

  20. Luma-Loyalty-Data 컬렉션을 열고 개요 탭에서 실행​을 클릭하여 컬렉션 실행자를 시작합니다.

    컬렉션 가져오기

  21. 컬렉션 실행자 창에서 드롭다운에서 환경을 선택하고 지연 시간을 4000ms로 제공한 다음 응답 저장 옵션을 선택한 다음 실행 순서가 올바른지 확인합니다. Run Luma 충성도 데이터 단추를 클릭합니다.

    컬렉션 가져오기

    노트

    Luma-Contributes- Datacollection 실행에서는 고객 충성도 데이터를 포함하는 스키마를 만듭니다. 이 스키마는 사용자 정의 Mixins 및 데이터 세트를 포함하는 XDM Individual Profile 클래스를 기반으로 합니다. 또한 컬렉션은 스키마를 사용하여 데이터 세트를 만들고 샘플 고객 충성도 데이터를 Adobe Experience Platform에 업로드합니다.

    노트

    postman collection runner 동안 컬렉션 요청이 실패하면 실행을 중지하고 컬렉션 요청을 하나씩 실행합니다.

  22. 모든 것이 제대로 작동하면 Luma-Loyalty-Data 컬렉션의 모든 요청이 전달됩니다.

    충성도 결과

  23. 이제 Adobe Experience Platform UI에 로그인하고 데이터 세트로 이동합니다.

  24. Luma Loyalty Dataset 데이터 세트를 열고 데이터 세트 활동 창에서 1000개의 레코드를 수집한 성공적인 배치 실행을 볼 수 있습니다. 데이터 세트 미리 보기 옵션을 클릭하여 수집된 레코드를 확인할 수도 있습니다.
    충성도 데이터 세트

  25. 아래 컬렉션을 실행하려면 21~23단계를 반복합니다.

    • Luma-CRM-Data.postman_collection.json :컬렉션 실행에서는 고객의 CRM 데이터를 포함하는 스키마를 만듭니다. 이 스키마는 인구 통계 세부 사항, 개인 연락처 세부 사항 및 Luma Identity 프로필 Mixins를 포함하는 XDM 개별 프로필 클래스를 기반으로 합니다. 또한 스키마를 사용하여 데이터 세트를 만들고 샘플 고객 CRM 데이터를 Adobe Experience Platform에 업로드합니다.
    • Luma-Product-Catalog.postman_collection.json :컬렉션 실행에서는 제품 카탈로그 정보를 포함하는 스키마를 만듭니다. 이 스키마는 제품 카탈로그 mixin, 상거래 세부 사항 및 소비자 경험 이벤트 mixin을 포함하는 사용자 지정 클래스를 기반으로 합니다. 또한 컬렉션은 스키마를 사용하여 데이터 세트를 만들고 제품 데이터를 Adobe Experience Platform에 업로드합니다.
    • Luma-Offline-Purchase-Events.postman_collection.json:컬렉션 실행에서는 고객의 오프라인 구매 이벤트 데이터를 포함할 스키마를 만듭니다. 이 스키마는 XDM ExperienceEvent 클래스를 기반으로 하며, mixin을 사용하여 고객 충성도 정보와 오프라인 구매 이벤트를 캡처합니다. 또한 컬렉션은 스키마를 사용하여 데이터 세트를 만들고 오프라인 구매 이벤트 데이터를 Adobe Experience Platform에 업로드합니다.

뉴먼 사용

단계를 따르기 전에 Experience Platform API에 대한 액세스 권한이 있는지 확인하십시오. 이 자습서에서는 리소스와 데이터를 프로덕션 환경과 혼합하지 않고 기능을 테스트할 수 있는 분리된 환경을 제공하므로 샌드박스 환경을 사용합니다.

NodeJs 및 Newman 설치

  1. Newman을 실행하려면 Node.js >= v10이 있는지 확인합니다. 패키지 관리자를 통해 Node.js를 설치합니다.

  2. node -v 명령을 실행하여 노드가 설치되어 있는지 확인합니다.

  3. 뉴먼을 설치하는 가장 쉬운 방법은 NPM을 사용하는 것입니다. Node.js가 설치되어 있는 경우 NPM도 설치되어 있을 수 있습니다.

  4. 여기에 따라 시스템에 뉴만을 설치합니다

  5. newman -v 명령을 실행하여 newman이 설치되어 있는지 확인합니다.

  6. 이 자습서에 필요한 모든 파일이 포함된 platform-utils-main.zip 파일을 다운로드하십시오.

  7. 다운로드 폴더에서 platform-utils-main.zip 파일을 컴퓨터의 원하는 위치로 이동하고 압축을 해제합니다.

  8. FILE_PATH postman 환경 변수를 설정할 때 압축 해제된 파일의 위치를 나중에 메모해 주십시오

  9. 터미널 창에서 platform-utils-main 폴더를 엽니다.

  10. Luma-Loyalty-Data.postman_collection.json을 실행하여 Mixins, 스키마, 데이터 세트를 작성하고 샘플 충성도 데이터를 Adobe Experience Platform에 수집하십시오

    • newman run Luma-Loyalty-Data.postman_collection.json -e DataInExperiencePlatform.postman_environment.json --export-environment DataInExperiencePlatform.postman_environment.json —insecure --delay-request 4000
  11. 모든 것이 제대로 작동하면 Luma-Loyalty-Data 컬렉션의 모든 요청이 전달됩니다.

  12. 이제 Adobe Experience Platform UI에 로그인하고 데이터 세트로 이동합니다.

  13. Luma Loyalty Dataset 데이터 세트를 열고 데이터 세트 활동 창에서 1000개의 레코드를 수집한 성공적인 배치 실행을 볼 수 있습니다. 데이터 세트 미리 보기 옵션을 클릭하여 수집된 레코드를 확인할 수도 있습니다.

    충성도 데이터 세트

  14. 컬렉션 아래에서 실행하려면 10~13단계를 반복합니다.

    • Luma-CRM-Data.postman_collection.json을 실행하여 mixin, schema, dataset을 작성하고 샘플 CRM 데이터를 Adobe Experience Platform에 수집합니다.
      • newman run Luma-CRM-Data.postman_collection.json -e DataInExperiencePlatform.postman_environment.json --export-environment DataInExperiencePlatform.postman_environment.json --insecure --delay-request 4000
    • Luma-Product-Catalog.postman_collection.json을 실행하여 mixin, schema, dataset을 작성하고 샘플 제품 데이터를 Adobe Experience Platform에 수집합니다.
      • newman run Luma-Product-Catalog.postman_collection.json -e DataInExperiencePlatform.postman_environment.json --export-environment DataInExperiencePlatform.postman_environment.json --insecure --delay-request 4000
    • Luma-Offline-Purchase-Events.postman_collection.json을 실행하여 mixin, schema, dataset을 작성하고 샘플 제품 데이터를 Adobe Experience Platform에 수집합니다.
      • newman run Luma-Offline-Purchase-Events.postman_collection.json -e DataInExperiencePlatform.postman_environment.json --export-environment DataInExperiencePlatform.postman_environment.json --insecure --delay-request 4000

샌드박스 환경 재설정

비프로덕션 샌드박스를 재설정하면 샌드박스의 이름 및 관련 권한을 유지하면서 해당 샌드박스와 연결된 모든 리소스(스키마, 데이터 세트 등)가 삭제됩니다. 이 "clean" 샌드박스는 액세스 권한이 있는 사용자에 대해 동일한 이름으로 계속 사용할 수 있습니다.

샌드박스 환경을 재설정하려면 여기단계를 따르십시오.

이 페이지에서는