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

Last update: Wed May 24 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

주제:
Profiles

작성 대상:

User

데이터 세트 중복 보고서는 조직의 구성에 대한 가시성을 제공합니다. 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 요청을 사용하여 GET 요청을에 수행하여 데이터 세트 중복 보고서를 생성할 수 있습니다. /previewsamplestatus/report/dataset/overlap.

요청

다음 요청은 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

요청 유형, 헤더, 값 및 경로가 완료된 후 다음을 선택합니다. 보내기 를 클릭하여 API 요청을 전송하고 보고서를 생성합니다.

응답

요청이 성공하면 HTTP 상태 200(OK) 및 데이터 세트 겹치기 보고서가 반환됩니다. 이 보고서에는 data 쉼표로 구분된 데이터 세트 목록과 해당 프로필 수가 포함된 개체. 보고서를 읽는 방법에 대한 자세한 내용은 데이터 세트 중복 보고서 데이터 해석.

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

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

보고서 타임스탬프

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

데이터 세트 ID 목록

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

NOTE

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

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

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

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

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

다음 단계

이 자습서를 완료하면 이제 실시간 고객 프로필 API를 사용하여 데이터 세트 중복 보고서를 생성할 수 있습니다. API 및 Experience Platform UI에서 프로필 데이터 작업에 대한 자세한 내용은 다음을 읽는 것부터 시작하십시오. 프로필 개요 설명서.

recommendation-more-help

54550d5b-f1a1-4065-a394-eb0f23a2c38b