데이터 세트 중복 보고서 생성

데이터 세트 중복 보고서는 주소 지정 가능한 대상(프로필)에 가장 많이 기여하는 데이터 세트를 노출하여 조직의 Profile 저장소 구성에 대한 가시성을 제공합니다.

이 보고서는 데이터에 대한 통찰력을 제공하는 것 외에도 특정 데이터의 수명 제한 설정과 같은 라이선스 사용을 최적화하는 작업을 수행하는 데 도움이 될 수 있습니다.

이 튜토리얼에서는 Real-Time Customer Profile API를 사용하여 데이터 집합 중복 보고서를 생성하고 조직의 결과를 해석하는 데 필요한 단계를 간략하게 설명합니다.

시작하기

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

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

  • Authorization: Bearer {ACCESS_TOKEN}: Authorization 헤더에는 Bearer 단어 앞에 액세스 토큰이 있어야 합니다. 24시간마다 새 액세스 토큰 값을 생성해야 합니다.
  • x-api-key: {API_KEY}: API Key은(는) Client ID이라고도 하며 한 번만 생성하면 되는 값입니다.
  • x-gw-ims-org-id: {ORG_ID}: 조직 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: {ORG_ID}' \
매개변수
설명
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 개체가 포함되어 있습니다. 보고서를 읽는 방법에 대한 자세한 내용은 데이터 집합 중복 보고서 데이터 해석에 대한 섹션을 참조하십시오.

데이터 세트 중복 보고서 데이터 해석 interpret-the-report

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

보고서 타임스탬프

reportTimestamp이(가) API 요청에 제공된 날짜와 일치하거나 제공된 날짜가 없는 경우 가장 최근 보고서의 타임스탬프입니다.

데이터 세트 ID 목록

data 개체에는 데이터 세트 ID의 고유한 조합이 해당 데이터 세트 조합의 각 프로필 카운트와 함께 쉼표로 구분된 목록으로 포함되어 있습니다.

NOTE
데이터 세트 중복 보고서의 각 행과 연결된 모든 프로필 수의 합계는 조직의 총 프로필 수와 같아야 합니다.

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

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

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

  • 5d92921872831c163452edc8, 5da7292579975918a851db57, 5eb2cdc6fa3f9a18a7592a98 데이터 세트에서 오는 데이터로 구성된 123개의 프로필이 있습니다.
  • 5d92921872831c163452edc8과(와) 5eb2cdc6fa3f9a18a7592a98 데이터 세트에서 가져온 데이터로 구성된 454,412개의 프로필이 있습니다.
  • 데이터 집합 5eeda0032af7bb19162172a7의 데이터로만 구성된 107개의 프로필이 있습니다.
  • 조직에 총 454,642개의 프로필이 있습니다.

다음 단계

이 자습서를 완료하면 이제 실시간 고객 프로필 API를 사용하여 데이터 세트 중복 보고서를 생성할 수 있습니다. API와 Experience Platform UI에서 프로필 데이터를 사용하는 방법에 대한 자세한 내용은 프로필 개요 설명서를 참조하세요.

recommendation-more-help
54550d5b-f1a1-4065-a394-eb0f23a2c38b