샘플 상태 끝점 미리 보기(프로필 미리 보기)

Adobe Experience Platform을 사용하면 각 개별 고객을 위해 강력하고 통합된 프로필을 빌드하기 위해 여러 소스에서 고객 데이터를 수집할 수 있습니다. 데이터를 Platform에 수집하면 샘플 작업이 실행하여 프로필 수 및 기타 실시간 고객 프로필 데이터 관련 지표를 업데이트합니다.

이 샘플 작업의 결과는 실시간 고객 프로필 API의 일부인 /previewsamplestatus 종단점을 사용하여 볼 수 있습니다. 이 종단점을 사용하여 데이터 세트와 ID 네임스페이스별로 프로필 배포를 나열할 수 있을 뿐만 아니라 조직의 프로필 저장소 구성을 표시하기 위해 여러 보고서를 생성할 수도 있습니다. 이 안내서에서는 /previewsamplestatus API 종단점을 사용하여 이러한 지표를 보는 데 필요한 단계를 안내합니다.

노트

예상 대상을 격리하는 데 도움이 되도록 세그먼트 정의에 대한 요약 수준 정보를 볼 수 있는 Adobe Experience Platform 세그멘테이션 서비스 API의 일부로 사용할 수 있는 예측 및 미리 보기 끝점이 있습니다. 세그먼트 미리 보기 및 예상 끝점을 사용하는 작업에 대한 자세한 단계를 보려면 Segmentation API 개발자 가이드의 일부인 미리 보기 및 예상 끝점 안내서를 참조하십시오.

시작하기

이 안내서에 사용된 API 엔드포인트는 Real-time Customer Profile API의 일부입니다. 계속하기 전에 시작 안내서에서 관련 설명서에 대한 링크, 이 문서에서 샘플 API 호출을 읽는 방법에 대한 안내서 및 Experience Platform API를 성공적으로 호출하는 데 필요한 필수 헤더에 대한 중요한 정보를 검토하십시오.

프로필 조각과 병합된 프로필 비교

이 안내서는 "프로필 조각"과 "병합된 프로필"을 모두 참조합니다. 계속 진행하기 전에 이러한 용어 간의 차이점을 이해하는 것이 중요합니다.

각 개별 고객 프로필은 병합되어 해당 고객의 단일 보기를 구성하는 여러 프로필 조각으로 구성됩니다. 예를 들어 고객이 여러 채널에서 브랜드와 상호 작용하는 경우 조직에는 여러 데이터 세트에 나타나는 해당 단일 고객과 관련된 여러 프로필 조각이 있을 수 있습니다.

프로필 조각을 Platform에 수집하면 병합 정책을 기반으로 하여 해당 고객에 대한 단일 프로필을 함께 병합합니다. 따라서 각 프로필은 여러 조각으로 구성되므로 총 프로필 조각 수는 병합된 프로필의 총 수보다 항상 높을 수 있습니다.

Experience Platform 내의 프로필 및 역할에 대해 자세히 알려면 실시간 고객 프로필 개요를 읽어 보십시오.

샘플 작업이 트리거되는 방식

실시간 고객 프로필에 대해 활성화된 데이터를 Platform에 수집하면 프로필 데이터 저장소 내에 저장됩니다. 프로필 저장소에 레코드를 섭취할 때 총 프로필 수가 5% 이상 증가 또는 감소하면 샘플링 작업이 트리거되어 카운트가 업데이트됩니다. 샘플이 트리거되는 방식은 사용 중인 수집 유형에 따라 다릅니다.

  • 데이터 스트리밍 워크플로우​의 경우, 5% 증가 또는 감소 임계값이 충족되었는지 확인하기 위해 시간별로 확인이 수행됩니다. 10번 이상 표시되었으면 카운트를 업데이트하도록 샘플 작업이 자동으로 트리거됩니다.
  • 일괄 처리 섭취​의 경우, 5% 증가 또는 감소 임계값이 충족되면 작업이 실행되어 카운트가 업데이트됩니다. 프로필 API를 사용하여 성공적인 최신 샘플 작업을 미리 볼 수 있을 뿐만 아니라 데이터 집합 및 ID 네임스페이스별 프로필 배포 목록을 만들 수 있습니다.

네임스페이스 지표별 프로필 수 및 프로필은 Experience Platform UI의 프로필 섹션에서도 사용할 수 있습니다. UI를 사용하여 프로필 데이터에 액세스하는 방법에 대한 자세한 내용은 Profile UI 안내서를 참조하십시오.

마지막 샘플 상태 보기

/previewsamplestatus 종단점에 대한 GET 요청을 수행하여 IMS 조직에 대해 실행된 마지막으로 성공한 샘플 작업에 대한 세부 사항을 볼 수 있습니다. 여기에는 샘플의 총 프로필 수, 프로필 수 지표 또는 조직이 Experience Platform 내에 가지고 있는 총 프로필 수가 포함됩니다.

프로필 수는 프로필 조각을 병합한 후 생성되어 각 개별 고객에 대한 단일 프로필을 형성합니다. 즉, 프로필 조각을 함께 병합하면 모두 동일한 개인과 관련되어 있으므로 "1" 프로필 수가 반환됩니다.

프로필 카운트에는 속성(레코드 데이터)이 있는 프로필과 Adobe Analytics 프로필과 같은 시계열(이벤트) 데이터만 포함된 프로필도 모두 포함됩니다. Platform 내의 최신 총 프로필 수를 제공하기 위해 프로필 데이터를 수집할 때 샘플 작업이 정기적으로 새로 고쳐집니다.

API 형식

GET /previewsamplestatus

요청

curl -X GET \
  https://platform.adobe.io/data/core/ups/previewsamplestatus \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \

응답

응답에는 조직에 대해 실행된 마지막으로 성공한 샘플 작업에 대한 세부 정보가 포함됩니다.

노트

이 응답 예제에서 numRowsToReadtotalRows은 서로 같습니다. 조직에서 Experience Platform에 가지고 있는 프로필 수에 따라 이러한 경우가 해당될 수 있습니다. 그러나 일반적으로 이 두 숫자는 다르며, 이 두 숫자는 전체 프로필 수(totalRows)의 하위 집합으로 샘플을 나타내므로 numRowsToRead 숫자가 더 작습니다.

{
  "numRowsToRead": "41003",
  "sampleJobRunning": {
    "status": true,
    "submissionTimestamp": "2020-08-01 17:57:57.0"
  },
  "cosmosDocCount": "\"300803\"",
  "totalFragmentCount": 47429,
  "lastSuccessfulBatchTimestamp": "\"null\"",
  "streamingDriven": "\"false\"",
  "totalRows": "41003",
  "lastBatchId": "\"null\"",
  "status": "TASK_FINISHED",
  "samplingRatio": 1.0,
  "mergeStrategy": "timestampOrdered_auto",
  "lastSampledTimestamp": "2020-08-01 17:57:57.0"
}
속성 설명
numRowsToRead 샘플에서 병합된 프로필의 총 수입니다.
sampleJobRunning 샘플 작업이 진행 중일 때 true을 반환하는 부울 값입니다. 배치 파일을 업로드한 시점부터 프로필 저장소에 실제로 추가될 때까지의 지연에 대한 투명성을 제공합니다.
cosmosDocCount Cosmos의 총 문서 수입니다.
totalFragmentCount 프로필 저장소의 총 프로필 조각 수입니다.
lastSuccessfulBatchTimestamp 마지막으로 성공한 배치 수집 타임스탬프.
streamingDriven 이 필드는 더 이상 사용되지 않으며 응답에 대한 의미를 포함하지 않습니다.
totalRows Experience Platform에 병합된 프로필의 총 수('프로필 수'라고도 함)입니다.
lastBatchId 마지막 배치 수집 ID.
status 마지막 샘플의 상태입니다.
samplingRatio 병합된 프로필의 비율(numRowsToRead)이 총 병합된 프로필(totalRows)이며, 십진수 형식으로 백분율로 표시됩니다.
mergeStrategy 샘플에 사용된 병합 전략입니다.
lastSampledTimestamp 마지막으로 성공한 샘플 타임스탬프.

데이터 집합별 프로필 배포 나열

데이터 집합별 프로필 배포를 보려면 /previewsamplestatus/report/dataset 종단점에 대한 GET 요청을 수행할 수 있습니다.

API 형식

GET /previewsamplestatus/report/dataset
GET /previewsamplestatus/report/dataset?{QUERY_PARAMETERS}
매개 변수 설명
date 보고서 반환 날짜를 지정합니다. 날짜에 여러 개의 보고서가 실행된 경우 해당 날짜에 대한 최신 보고서가 반환됩니다. 지정된 날짜에 대한 보고서가 없으면 404(찾을 수 없음) 오류가 반환됩니다. 날짜를 지정하지 않으면 가장 최근 보고서가 반환됩니다. 형식: YYYY-MM-DD. 예: date=2024-12-31

요청

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

curl -X GET \
  https://platform.adobe.io/data/core/ups/previewsamplestatus/report/dataset?date=2020-08-01 \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \

응답

응답에는 데이터 집합 개체 목록이 포함된 data 배열이 포함되어 있습니다. 표시된 응답이 3개의 데이터 세트를 표시하도록 잘렸습니다.

노트

날짜에 대해 여러 개의 보고서가 있는 경우 최신 보고서만 반환됩니다. 제공된 날짜에 대해 데이터 집합 보고서가 없으면 HTTP 상태 404(찾을 수 없음)가 반환됩니다.

{
  "data": [
    {
      "sampleCount": 12577,
      "samplePercentage": 0.306734,
      "fullIDsCount": 20988,
      "fullIDsPercentage": 0.511865,
      "name": "CRM Profiles",
      "description": "Profiles from the CRM.",
      "value": "5f160106be34361915754b9c",
      "streamingIngestionEnabled": "",
      "createdUser": "{CREATED_USER}",
      "reportTimestamp": "2020-08-01T17:57:58.697",
    },
    {
      "sampleCount": 12938,
      "samplePercentage": 0.315538,
      "fullIDsCount": 21796,
      "fullIDsPercentage": 0.531571,
      "name": "AAM Authenticated Profiles",
      "description": "This data set contains AAM authenticated profiles.",
      "value": "5dc77ec6eed47f18a796ca90",
      "streamingIngestionEnabled": "",
      "createdUser": "{CREATED_USER}",
      "reportTimestamp": "2020-08-01T17:57:58.697"
    },
    {
      "sampleCount": 22725,
      "samplePercentage": 0.554228,
      "fullIDsCount": 41003,
      "fullIDsPercentage": 1.0,
      "name": "Loyalty Program Members",
      "description": "Members of the loyalty program at all levels.",
      "value": "5d0fda92274e55144d4de620",
      "streamingIngestionEnabled": "",
      "createdUser": "{CREATED_USER}",
      "reportTimestamp": "2020-08-01T17:57:58.697"
    }
  ],
  "reportTimestamp": "2020-08-01T17:57:58.697"
}
속성 설명
sampleCount 이 데이터 세트 ID를 사용하여 병합된 프로필의 총 수입니다.
samplePercentage 샘플 병합된 총 프로필 수(마지막 샘플 상태에서 반환되는 numRowsToRead 값)의 백분율로, 십진수 형식으로 표시됩니다.sampleCount
fullIDsCount 이 데이터 세트 ID와 병합된 총 프로필 수입니다.
fullIDsPercentage 병합된 전체 프로필 수의 백분율로 fullIDsCount(마지막 샘플 상태에서 반환된 totalRows 값)은 십진수 형식으로 표시됩니다.
name 데이터 세트를 만드는 동안 제공된 데이터 세트의 이름입니다.
description 데이터 세트를 만드는 동안 제공된 데이터 세트에 대한 설명입니다.
value 데이터 세트의 ID입니다.
streamingIngestionEnabled 데이터 세트가 스트리밍 수집에 활성화되었는지 여부.
createdUser 데이터 세트를 만든 사용자의 사용자 ID입니다.
reportTimestamp 보고서의 타임스탬프입니다. 요청 중에 date 매개 변수가 제공된 경우 반환된 보고서는 제공된 날짜에 대한 것입니다. date 매개 변수가 제공되지 않으면 가장 최근 보고서가 반환됩니다.

ID 네임스페이스별 프로필 배포 나열

프로필 저장소에 있는 병합된 모든 프로필의 ID 네임스페이스별 분류를 보려면 /previewsamplestatus/report/namespace 종단점에 GET 요청을 수행할 수 있습니다. 여기에는 Adobe에서 제공하는 표준 ID와 조직에서 정의한 사용자 정의 ID가 모두 포함됩니다.

ID 네임스페이스는 Adobe Experience Platform Identity Service의 중요한 구성 요소이며 고객 데이터와 관련된 컨텍스트의 지표 역할을 합니다. 자세한 내용은 ID 네임스페이스 개요를 읽으십시오.

노트

네임스페이스별 총 프로필 수(각 네임스페이스에 대해 표시된 값을 함께 추가)는 한 개의 프로필이 여러 네임스페이스와 연결될 수 있으므로 프로필 수 지표보다 높을 수 있습니다. 예를 들어 고객이 둘 이상의 채널에서 브랜드와 상호 작용하는 경우 여러 네임스페이스가 해당 개별 고객과 연결됩니다.

API 형식

GET /previewsamplestatus/report/namespace
GET /previewsamplestatus/report/namespace?{QUERY_PARAMETERS}
매개 변수 설명
date 보고서 반환 날짜를 지정합니다. 날짜에 여러 개의 보고서가 실행된 경우 해당 날짜에 대한 최신 보고서가 반환됩니다. 지정된 날짜에 대한 보고서가 없으면 404(찾을 수 없음) 오류가 반환됩니다. 날짜를 지정하지 않으면 가장 최근 보고서가 반환됩니다. 형식: YYYY-MM-DD. 예: date=2024-12-31

요청

다음 요청은 date 매개 변수를 지정하지 않으므로 최신 보고서를 반환합니다.

curl -X GET \
  https://platform.adobe.io/data/core/ups/previewsamplestatus/report/namespace \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \

응답

응답에는 각 네임스페이스에 대한 세부 정보가 포함된 개별 개체가 있는 data 배열이 포함됩니다. 표시된 응답이 네 개의 네임스페이스를 표시하도록 잘렸습니다.

{
  "data": [
    {
      "sampleCount": 12148,
      "samplePercentage": 0.296271,
      "reportTimestamp": "2020-08-01T17:57:58.697",
      "fullIDsFragmentCount": 13141,
      "fullIDsCount": 12631,
      "fullIDsPercentage": 0.308051,
      "code": "Email",
      "value": "6"
    },
    {
      "sampleCount": 6989,
      "samplePercentage": 0.170451,
      "reportTimestamp": "2020-08-01T17:57:58.697",
      "fullIDsFragmentCount": 7543,
      "fullIDsCount": 7042,
      "fullIDsPercentage": 0.171744,
      "code": "ECID",
      "value": "4"
    },
    {
      "sampleCount": 888,
      "samplePercentage": 0.021657,
      "reportTimestamp": "2020-08-01T17:57:58.697",
      "fullIDsFragmentCount": 3801,
      "fullIDsCount": 3206,
      "fullIDsPercentage": 0.078189,
      "code": "AAID",
      "value": "10"
    },
    {
      "sampleCount": 21809,
      "samplePercentage": 0.531888,
      "reportTimestamp": "2020-08-01T17:57:58.697",
      "fullIDsFragmentCount": 27023,
      "fullIDsCount": 21936,
      "fullIDsPercentage": 0.534985,
      "code": "Phone",
      "value": "7"
    }
  ],
  "reportTimestamp": "2020-08-01T17:57:58.697"
}
속성 설명
sampleCount 네임스페이스에서 샘플링된 병합된 프로필의 총 수입니다.
samplePercentage 샘플 병합된 프로필의 비율(numRowsToRead 값이 마지막 샘플 상태에서 반환됨)으로서, 10진수 형식으로 표시됩니다.sampleCount
reportTimestamp 보고서의 타임스탬프입니다. 요청 중에 date 매개 변수가 제공된 경우 반환된 보고서는 제공된 날짜에 대한 것입니다. date 매개 변수가 제공되지 않으면 가장 최근 보고서가 반환됩니다.
fullIDsFragmentCount 네임스페이스에 있는 총 프로필 조각 수입니다.
fullIDsCount 네임스페이스에 있는 병합된 프로필의 총 수입니다.
fullIDsPercentage 병합된 전체 프로필의 비율(totalRows 값(마지막 샘플 상태에서 반환되는 값)으로서, 십진수 형식으로 표현된 fullIDsCount 값.
code 네임스페이스의 code 이 ID는 Adobe Experience Platform Identity Service API를 사용하여 네임스페이스로 작업할 때 찾을 수 있으며, Experience Platform UI에서 ID 기호라고도 합니다. 자세한 내용은 ID 네임스페이스 개요를 참조하십시오.
value 네임스페이스의 id 값입니다. 이 ID는 ID 서비스 API를 사용하여 네임스페이스로 작업할 때 찾을 수 있습니다.

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

데이터 집합 겹치기 보고서는 지정 대상(병합된 프로필)에 가장 많이 기여하는 데이터 세트를 노출하여 조직의 프로필 저장소 구성에 대한 가시성을 제공합니다. 이 보고서를 통해 데이터에 대한 통찰력을 제공할 뿐만 아니라 특정 데이터 세트에 대해 TTL 설정과 같은 라이센스 사용을 최적화하는 작업을 수행할 수 있습니다.

/previewsamplestatus/report/dataset/overlap 종단점에 대한 GET 요청을 수행하여 데이터 집합 겹치기 보고서를 생성할 수 있습니다.

명령줄 또는 Postman UI를 사용하여 데이터 집합 겹치기 보고서를 생성하는 방법에 대한 단계별 지침은 데이터 집합 겹치기 보고서 만들기 자습서를 참조하십시오.

API 형식

GET /previewsamplestatus/report/dataset/overlap
GET /previewsamplestatus/report/dataset/overlap?{QUERY_PARAMETERS}
매개 변수 설명
date 보고서 반환 날짜를 지정합니다. 동일한 날짜에 여러 보고서가 실행된 경우 해당 날짜에 대한 최신 보고서가 반환됩니다. 지정된 날짜에 대한 보고서가 없으면 404(찾을 수 없음) 오류가 반환됩니다. 날짜를 지정하지 않으면 가장 최근 보고서가 반환됩니다. 형식: YYYY-MM-DD. 예: date=2024-12-31

요청

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

curl -X GET \
  https://platform.adobe.io/data/core/ups/previewsamplestatus/report/dataset/overlap?date=2021-12-29 \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \

응답

요청이 성공하면 HTTP 상태 200(OK) 및 데이터 집합 겹치기 보고서를 반환합니다.

{
    "data": {
        "5d92921872831c163452edc8,5da7292579975918a851db57,5eb2cdc6fa3f9a18a7592a98": 123,
        "5d92921872831c163452edc8,5eb2cdc6fa3f9a18a7592a98": 454412,
        "5eeda0032af7bb19162172a7": 107
    },
    "reportTimestamp": "2021-12-29T19:55:31.147"
}
속성 설명
data data 개체에는 쉼표로 구분된 데이터 세트 목록과 각 프로필 수가 포함되어 있습니다.
reportTimestamp 보고서의 타임스탬프입니다. 요청 중에 date 매개 변수가 제공된 경우 반환된 보고서는 제공된 날짜에 대한 것입니다. date 매개 변수가 제공되지 않으면 가장 최근 보고서가 반환됩니다.

데이터 집합 중복 보고서 해석

보고서 결과는 응답의 데이터 세트 및 프로필 카운트에서 해석할 수 있습니다. 다음 예제 보고서 data 개체를 생각해 보십시오.

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

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

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

ID 네임스페이스 중복 보고서 생성

ID 네임스페이스 겹치기 보고서는 주소 지정 가능한 대상(병합된 프로필)에 가장 많이 기여하는 ID 네임스페이스를 노출하여 조직의 프로필 저장소 구성에 대한 가시성을 제공합니다. 여기에는 Adobe에서 제공하는 표준 ID 네임스페이스와 조직에서 정의한 사용자 정의 ID 네임스페이스가 모두 포함됩니다.

/previewsamplestatus/report/namespace/overlap 종단점에 대한 GET 요청을 수행하여 ID 네임스페이스 겹치기 보고서를 생성할 수 있습니다.

API 형식

GET /previewsamplestatus/report/namespace/overlap
GET /previewsamplestatus/report/namespace/overlap?{QUERY_PARAMETERS}
매개 변수 설명
date 보고서 반환 날짜를 지정합니다. 동일한 날짜에 여러 보고서가 실행된 경우 해당 날짜에 대한 최신 보고서가 반환됩니다. 지정된 날짜에 대한 보고서가 없으면 404(찾을 수 없음) 오류가 반환됩니다. 날짜를 지정하지 않으면 가장 최근 보고서가 반환됩니다. 형식: YYYY-MM-DD. 예: date=2024-12-31

요청

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

curl -X GET \
  https://platform.adobe.io/data/core/ups/previewsamplestatus/report/namespace/overlap?date=2021-12-29 \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \

응답

요청이 성공하면 HTTP 상태 200(OK) 및 ID 네임스페이스 겹치기 보고서를 반환합니다.

{
    "data": {
        "Email,crmid,loyal": 2,
        "ECID,Email,crmid": 7,
        "ECID,Email,mobilenr": 12,
        "AAID,ECID,loyal": 1,
        "mobilenr": 25,
        "AAID,ECID": 1508,
        "ECID,crmid": 1,
        "AAID,ECID,crmid": 2,
        "Email,crmid": 328,
        "CORE": 49,
        "AAID": 446,
        "crmid,loyal": 20988,
        "Email": 10904,
        "crmid": 249,
        "ECID,Email": 74,
        "Phone": 40,
        "Email,Phone,loyal": 48,
        "AAID,AVID,ECID": 85,
        "Email,loyal": 1002,
        "AAID,ECID,Email,Phone,crmid": 5,
        "AAID,ECID,Email,crmid,loyal": 23,
        "AAID,AVID,ECID,Email,crmid": 2,
        "AVID": 3,
        "AAID,ECID,Phone": 1,
        "loyal": 43,
        "ECID,Email,crmid,loyal": 6,
        "AAID,ECID,Email,Phone,crmid,loyal": 1,
        "AAID,ECID,Email": 2,
        "AAID,ECID,Email,crmid": 142,
        "AVID,ECID": 24,
        "ECID": 6565
    },
    "reportTimestamp": "2021-12-29T16:55:03.624"
}
속성 설명
data data 개체에는 ID 네임스페이스 코드와 해당 프로필 수의 고유한 조합이 있는 쉼표로 구분된 목록이 포함되어 있습니다.
네임스페이스 코드 code은 각 ID 네임스페이스 이름에 대한 짧은 형식입니다. Adobe Experience Platform Identity 서비스 API를 사용하여 해당 code에 대한 매핑을 찾을 수 있습니다. name code은 Experience Platform UI에서 ID 기호라고도 합니다. 자세한 내용은 ID 네임스페이스 개요를 참조하십시오.
reportTimestamp 보고서의 타임스탬프입니다. 요청 중에 date 매개 변수가 제공된 경우 반환된 보고서는 제공된 날짜에 대한 것입니다. date 매개 변수가 제공되지 않으면 가장 최근 보고서가 반환됩니다.

ID 네임스페이스 겹치기 보고서 해석

보고서 결과는 응답의 ID 및 프로필 카운트에서 해석할 수 있습니다. 각 행의 숫자 값은 표준 및 사용자 지정 ID 네임스페이스의 정확한 조합으로 구성되는 프로필의 수를 알려줍니다.

data 개체에서 발췌한 다음 내용을 생각해 보십시오.

  "AAID,ECID,Email,crmid": 142,
  "AVID,ECID": 24,
  "ECID": 6565

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

  • 사용자 지정 crmid ID 네임스페이스뿐만 아니라 AAID, ECIDEmail 표준 ID로 구성된 142개의 프로필이 있습니다.
  • AAIDECID ID 네임스페이스로 구성된 24개의 프로필이 있습니다.
  • ECID ID만 포함된 6,565개의 프로필이 있습니다.

알 수 없는 프로필 보고서 생성

알 수 없는 프로필 보고서를 통해 조직의 프로필 저장소 구성을 추가로 표시할 수 있습니다. 알 수 없는 프로필은 지정된 기간 동안 연결되지 않은 프로필과 비활성 상태인 모든 프로필을 나타냅니다. 연결되지 않은 프로필은 하나의 프로필 조각만 포함하는 프로필이며, "비활성" 프로필은 지정된 기간 동안 새 이벤트를 추가하지 않은 프로필입니다. 알 수 없는 프로필 보고서는 7일, 30일, 60일, 90일 및 120일 동안의 프로필 분류를 제공합니다.

/previewsamplestatus/report/unknownProfiles 종단점에 대한 GET 요청을 수행하여 알 수 없는 프로필 보고서를 생성할 수 있습니다.

API 형식

GET /previewsamplestatus/report/unknownProfiles

요청

다음 요청은 알 수 없는 프로필 보고서를 반환합니다.

curl -X GET \
  https://platform.adobe.io/data/core/ups/previewsamplestatus/report/unknownProfiles \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \

응답

성공적인 요청은 HTTP 상태 200(OK) 및 알 수 없는 프로필 보고서를 반환합니다.

노트

이 안내서의 목적을 위해 보고서는 "120days" 및 “7days” 기간만 포함하도록 잘렸습니다. 전체 알 수 없는 프로필 보고서는 7일, 30일, 60일, 90일 및 120일 동안의 프로필 분류를 제공합니다.

{
  "data": {
      "totalNumberOfProfiles": 63606,
      "totalNumberOfEvents": 130977,
      "unknownProfiles": {
          "120days": {
              "countOfProfiles": 1644,
              "eventsAssociated": 26824,
              "nsDistribution": {
                  "Email": {
                      "countOfProfiles": 18,
                      "eventsAssociated": 95
                  },
                  "loyal": {
                      "countOfProfiles": 26,
                      "eventsAssociated": 71
                  },
                  "ECID": {
                      "countOfProfiles": 1600,
                      "eventsAssociated": 26658
                  }
              }
          },
          "7days": {
              "countOfProfiles": 1782,
              "eventsAssociated": 29151,
              "nsDistribution": {
                  "Email": {
                      "countOfProfiles": 19,
                      "eventsAssociated": 97
                  },
                  "ECID": {
                      "countOfProfiles": 1734,
                      "eventsAssociated": 28591
                  },
                  "loyal": {
                      "countOfProfiles": 29,
                      "eventsAssociated": 463
                  }
              }
          }
      }
  },
  "reportTimestamp": "2025-08-25T22:14:55.186"
}
속성 설명
data data 개체에는 알 수 없는 프로필 보고서에 대해 반환된 정보가 포함되어 있습니다.
totalNumberOfProfiles 프로필 저장소에 있는 고유 프로필의 총 수입니다. 이는 대응 가능 대상 수와 같습니다. 여기에는 알려진 프로필과 알 수 없는 프로필이 모두 포함되어 있습니다.
totalNumberOfEvents 프로필 저장소의 총 ExperienceEvents 수입니다.
unknownProfiles 기간별 알 수 없는 프로필(연결되지 않은 프로필과 비활성)의 분류가 포함된 객체입니다. 알 수 없는 프로필 보고서는 7, 30, 60, 90 및 120일 기간에 대한 프로필 분류를 제공합니다.
countOfProfiles 기간 동안 알 수 없는 프로필 수 또는 네임스페이스에 대한 알 수 없는 프로필 수입니다.
eventsAssociated 시간 범위에 대한 ExperienceEvents 수 또는 네임스페이스에 대한 이벤트 수입니다.
nsDistribution 각 네임스페이스에 대해 알 수 없는 프로필과 이벤트가 배포되는 개별 ID 네임스페이스가 포함된 객체입니다. 참고: nsDistribution 개체의 각 ID 네임스페이스에 대한 총 countOfProfiles을(를) 함께 추가하는 것은 기간 동안 countOfProfiles와 같습니다. 네임스페이스당 eventsAssociated 및 기간당 총 eventsAssociated에도 동일하게 적용됩니다.
reportTimestamp 보고서의 타임스탬프입니다.

알 수 없는 프로필 보고서 해석

보고서 결과를 통해 조직에서 프로필 스토어 내에 있는 결합되지 않은 프로필과 비활성 프로필의 수에 대한 통찰력을 제공할 수 있습니다.

data 개체에서 발췌한 다음 내용을 생각해 보십시오.

  "7days": {
    "countOfProfiles": 1782,
    "eventsAssociated": 29151,
    "nsDistribution": {
      "Email": {
        "countOfProfiles": 19,
        "eventsAssociated": 97
      },
      "ECID": {
        "countOfProfiles": 1734,
        "eventsAssociated": 28591
      },
      "loyal": {
        "countOfProfiles": 29,
        "eventsAssociated": 463
      }
    }
  }

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

  • 하나의 프로필 조각만 포함하고 지난 7일 동안 새 이벤트가 없는 1,782개의 프로필이 있습니다.
  • 1,782개의 알 수 없는 프로필과 연결된 29,151개의 ExperienceEvents가 있습니다.
  • ECID의 ID 네임스페이스에서 단일 프로필 조각을 포함하는 알 수 없는 프로필은 1,734개입니다.
  • ECID의 ID 네임스페이스에서 가져온 단일 프로필 조각을 포함하는 1,734개의 알 수 없는 프로필과 연결된 28,591개의 이벤트가 있습니다.

다음 단계

이제 프로필 스토어에서 샘플 데이터를 미리 보고 데이터에 대해 여러 보고서를 실행하는 방법을 알므로 세그멘테이션 서비스 API의 예측 및 미리 보기 종단점을 사용하여 세그먼트 정의에 대한 요약 수준 정보를 볼 수도 있습니다. 이 정보는 세그먼트에서 예상되는 대상을 구분하도록 하는 데 도움이 됩니다. 세그멘테이션 API를 사용하여 세그먼트 미리 보기 및 예상 작업에 대한 자세한 내용은 미리 보기 및 예상 끝점 안내서를 참조하십시오.

이 페이지에서는