데이터 집합 중복 보고서 생성

데이터 집합 겹치기 보고서는 지정 대상(프로필)에 가장 많이 기여하는 데이터 세트를 노출하여 조직의 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 OrgOrganization 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을 사용하여 데이터 집합 Overlap Report를 요청하려면 다음 단계를 완료하십시오.

  • 드롭다운을 사용하여 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

요청 유형, 헤더, 값 및 경로가 완료되면 Send 를 선택하여 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 모두에서 프로필 데이터 작업에 대한 자세한 내용은 프로필 개요 설명서를 읽어서 시작하십시오.

이 페이지에서는