데이터 세트 오버랩 보고서 생성

데이터 집합 오버랩 보고서는 주소 지정 가능한 대상(프로필)에 가장 많이 기여하는 데이터 집합을 노출하여 조직의 Profile 저장소 구성을 표시합니다.

이 보고서를 사용하면 데이터에 대한 통찰력을 제공할 뿐만 아니라 특정 데이터의 수명에만 제한을 설정하는 등 라이센스 사용량을 최적화하는 작업을 수행할 수 있습니다.

이 자습서에서는 Real-time Customer Profile API를 사용하여 데이터 세트 오버랩 보고서를 생성하고 조직의 결과를 해석하는 데 필요한 단계를 설명합니다.

시작하기

Adobe Experience Platform API를 사용하려면 먼저 인증 자습서를 완료하여 필요한 헤더에 필요한 값을 수집해야 합니다. Experience Platform API에 대한 자세한 내용은 플랫폼 API 시작하기 설명서를 참조하십시오.

이 자습서의 모든 API 호출에 대한 필수 헤더는 다음과 같습니다.

  • Authorization: Bearer {ACCESS_TOKEN}:헤더 Authorization 는 단어 앞에 있는 액세스 토큰이 필요합니다 Bearer. 24시간마다 새로운 액세스 토큰 값을 생성해야 합니다.
  • x-api-key: {API_KEY}:변수 API KeyClient ID 한 번만 생성되어야 하는 값이라고도 합니다.
  • x-gw-ims-org-id: {IMS_ORG}:변수 IMS Org 는 한 Organization ID 번만 생성되어야 하며

인증 자습서를 완료하고 필수 헤더에 대한 값을 수집한 후 실시간 고객 API를 호출할 준비가 되었습니다.

명령줄을 사용하여 데이터 세트 오버랩 보고서 생성

명령줄 사용에 익숙한 경우 다음 cURL 요청을 사용하여 /previewsamplestatus/report/dataset/overlap에 대한 GET 요청을 수행하여 데이터 세트 오버랩 보고서를 생성할 수 있습니다.

요청

다음 요청에서는 date 매개 변수를 사용하여 지정된 날짜에 대한 최신 보고서를 반환합니다.

curl -X GET \
  https://platform.adobe.io/data/core/ups/previewsamplestatus/report/dataset/overlap?date=2021-04-19 \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
매개 변수 설명
date 보고서 반환 날짜를 지정합니다. 날짜에 여러 보고서가 실행되면 해당 날짜에 대한 최근 보고서가 반환됩니다. 지정된 날짜에 보고서가 존재하지 않으면 HTTP 상태 404(찾을 수 없음) 오류가 반환됩니다. 날짜를 지정하지 않으면 가장 최근 보고서가 반환됩니다. 형식:YYYY-MM-DD. 예: date=2024-12-31

응답

요청이 성공하면 HTTP 상태 200(OK) 및 데이터 세트 오버랩 보고서가 반환됩니다. 보고서에는 데이터 세트 및 해당 프로필 수를 쉼표로 구분된 목록으로 포함하는 data 개체가 포함되어 있습니다. 보고서를 읽는 방법에 대한 자세한 내용은 이 자습서의 뒷부분에 있는 데이터 세트 겹치기 보고서 데이터🔗 해석의 섹션을 참조하십시오.

{
    "data": {
        "5d92921872831c163452edc8,5da7292579975918a851db57,5eb2cdc6fa3f9a18a7592a98": 123,
        "5d92921872831c163452edc8,5eb2cdc6fa3f9a18a7592a98": 454412,
        "5eeda0032af7bb19162172a7": 107
    },
    "reportTimestamp": "2021-04-19T19:55:31.147"
}

Postman을 사용하여 데이터 집합 오버랩 보고서 생성

Postman은 API 개발을 위한 협업 플랫폼으로 API 호출을 시각화하는 데 유용합니다. Postman 웹 사이트에서 무료로 다운로드할 수 있으며 API 호출을 수행하는 데 사용하기 쉬운 UI를 제공합니다. 다음 스크린샷은 Postman 인터페이스를 사용합니다.

요청

Postman을 사용하여 데이터 집합 오버랩 보고서를 요청하려면 다음 단계를 완료하십시오.

  • 드롭다운을 사용하여 GET을 요청 유형으로 선택합니다.
  • KEY 열에 필요한 헤더를 입력합니다.
    • Authorization
    • x-api-key
    • x-gw-ims-org-id
  • 인증 중에 생성한 값을 VALUE 열에 입력하여 중괄호({{ }}) 및 중괄호 안의 모든 내용을 대체합니다.
  • 선택적 date 매개 변수를 사용하거나 사용하지 않고 요청 경로를 입력합니다.
    https://platform.adobe.io/data/core/ups/previewsamplestatus/report/dataset/overlap
    또는
    https://platform.adobe.io/data/core/ups/previewsamplestatus/report/dataset/overlap?date=YYYY-MM-DD
매개 변수 설명
date 보고서 반환 날짜를 지정합니다. 날짜에 여러 보고서가 실행되면 해당 날짜에 대한 최근 보고서가 반환됩니다. 지정된 날짜에 보고서가 존재하지 않으면 HTTP 상태 404(찾을 수 없음) 오류가 반환됩니다. 날짜를 지정하지 않으면 가장 최근 보고서가 반환됩니다.
형식:YYYY-MM-DD. 예: date=2024-12-31

요청 유형, 헤더, 값 및 경로가 완료되면 보내기​를 선택하여 API 요청을 보내고 보고서를 생성합니다.

응답

요청이 성공하면 HTTP 상태 200(OK) 및 데이터 세트 오버랩 보고서가 반환됩니다. 보고서에는 데이터 세트 및 해당 프로필 수를 쉼표로 구분된 목록으로 포함하는 data 개체가 포함되어 있습니다. 보고서를 읽는 방법에 대한 자세한 내용은 데이터 세트 오버랩 보고서 데이터🔗의 해석에서 을 참조하십시오.

데이터 집합 오버랩 보고서 데이터 해석

생성된 데이터 집합 겹침 보고서는 보고서의 날짜 및 시간을 보여주는 타임스탬프와 데이터 집합 ID의 고유한 조합을 쉼표로 구분된 목록으로 포함하는 데이터 개체를 제공합니다. 다음 섹션에서는 보고서 구성 요소에 대한 추가 정보를 제공합니다.

보고서 타임스탬프

reportTimestamp은 API 요청에 제공된 날짜와 일치하거나, 날짜가 제공되지 않은 경우 가장 최근 보고서의 타임스탬프와 일치합니다.

데이터 집합 ID 목록

data 개체에는 데이터 집합 ID의 고유한 조합이 해당 데이터 집합 조합에 대한 각 프로필 수와 함께 쉼표로 구분된 목록으로 포함됩니다.

노트

데이터 세트 겹침 보고서의 각 행과 연관된 모든 프로필 수 합계는 조직의 전체 프로필 수와 같아야 합니다.

보고서의 결과를 해석하려면 다음 예를 고려하십시오.

  "5d92921872831c163452edc8,5da7292579975918a851db57,5eb2cdc6fa3f9a18a7592a98": 123,
  "5d92921872831c163452edc8,5eb2cdc6fa3f9a18a7592a98": 454412,
  "5eeda0032af7bb19162172a7": 107

이 보고서는 다음 정보를 제공합니다.

  • 다음 데이터 세트에서 나오는 데이터로 구성된 123개의 프로필이 있습니다.5d92921872831c163452edc8, 5da7292579975918a851db57, 5eb2cdc6fa3f9a18a7592a98.
  • 다음 두 데이터 세트에서 나오는 데이터로 구성된 454,412개의 프로필이 있습니다.5d92921872831c163452edc85eb2cdc6fa3f9a18a7592a98.
  • 데이터 세트 5eeda0032af7bb19162172a7의 데이터만 구성하는 107개의 프로필이 있습니다.
  • 조직에는 총 454,642개의 프로필이 있습니다.

다음 단계

이 자습서를 완료한 후 실시간 고객 프로필 API를 사용하여 데이터 세트 오버랩 보고서를 생성할 수 있습니다. API와 Experience Platform UI 모두에서 프로필 데이터를 사용하여 작업하는 방법에 대한 자세한 내용은 프로필 개요 설명서를 읽으십시오.

이 페이지에서는