설명서Experience Platform실시간 고객 프로필 안내서

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

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 주제:

작성 대상:

  • 개발자

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

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

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

시작하기

이 가이드에 사용된 API 끝점은 Real-Time Customer Profile API의 일부입니다. 계속하기 전에 시작 안내서를 검토하여 관련 문서에 대한 링크, 이 문서의 샘플 API 호출 읽기 지침 및 Experience Platform API를 성공적으로 호출하는 데 필요한 필수 헤더에 대한 중요 정보를 확인하십시오.

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

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

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

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

프로필 및 Experience Platform 내 역할에 대한 자세한 내용은 실시간 고객 프로필 개요를 참조하세요.

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

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

  • 스트리밍 데이터 워크플로 ​의 경우 5% 증가 또는 감소 임계값이 충족되었는지 확인하기 위해 시간별로 검사가 수행됩니다. 샘플 작업이 있는 경우, 샘플 작업이 자동으로 트리거되어 카운트를 업데이트합니다.
  • 일괄 처리 수집 ​의 경우, 일괄 처리를 프로필 스토어로 성공적으로 수집한 후 15분 이내에 5% 증가 또는 감소 임계값에 도달하면 카운트를 업데이트하는 작업이 실행됩니다. 프로필 API를 사용하면 최근에 성공한 샘플 작업을 미리 볼 수 있으며, 데이터 세트 및 ID 네임스페이스별로 프로필 분포를 나열할 수 있습니다.

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

마지막 샘플 상태 보기 view-last-sample-status

/previewsamplestatus 끝점에 대한 GET 요청을 수행하여 조직에 대해 마지막으로 실행된 성공적인 샘플 작업에 대한 세부 정보를 볼 수 있습니다. 여기에는 샘플의 총 프로필 수와 프로필 수 지표 또는 조직이 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: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \

응답

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

NOTE
이 예제 응답에서 numRowsToRead과(와) totalRows은(는) 서로 같습니다. 조직이 Experience Platform 중인 프로필의 수에 따라 다를 수 있습니다. 그러나 일반적으로 이 두 숫자는 다릅니다. numRowsToRead은(는) 샘플을 총 프로필 수(totalRows)의 하위 집합으로 나타내므로 더 작은 숫자입니다.
{
  "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: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \

응답

응답에는 데이터 집합 개체 목록이 포함된 data 배열이 포함됩니다. 표시된 응답이 잘려서 3개의 데이터 세트를 표시합니다.

NOTE
날짜에 여러 보고서가 있는 경우 최신 보고서만 반환됩니다. 입력한 날짜에 데이터 세트 보고서가 없는 경우 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
sampleCount은(는) 십진수 형식으로 표현되는, 샘플링된 병합된 프로필의 총 수(마지막 샘플 상태에서 반환된 numRowsToRead 값)의 백분율입니다.
fullIDsCount
이 데이터 세트 ID를 가진 병합된 프로필의 총 수입니다.
fullIDsPercentage
fullIDsCount은(는) 10진수 형식으로 표현되는 병합된 프로필 총 수(마지막 샘플 상태에서 반환된 totalRows 값)의 백분율입니다.
name
데이터 세트 생성 시 제공된 데이터 세트의 이름입니다.
description
데이터 세트 생성 중 제공된 데이터 세트에 대한 설명입니다.
value
데이터 세트의 ID입니다.
streamingIngestionEnabled
스트리밍 수집에 데이터 세트를 사용할 수 있는지 여부입니다.
createdUser
데이터 세트를 만든 사용자의 사용자 ID입니다.
reportTimestamp
보고서의 타임스탬프. 요청 중에 date 매개 변수가 제공된 경우 반환된 보고서는 제공된 날짜에 대한 것입니다. date 매개 변수를 제공하지 않으면 가장 최근 보고서가 반환됩니다.

ID 네임스페이스별 목록 프로필 배포

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

ID 네임스페이스는 고객 데이터와 관련된 컨텍스트의 지표 역할을 하는 Adobe Experience Platform ID 서비스의 중요한 구성 요소입니다. 자세한 내용을 보려면 ID 네임스페이스 개요를 읽는 것부터 시작하십시오.

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

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: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \

응답

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

{
  "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
sampleCount은(는) 십진수 형식으로 표현되는 샘플링된 병합 프로필(마지막 샘플 상태에서 반환된 numRowsToRead 값)의 백분율입니다.
reportTimestamp
보고서의 타임스탬프. 요청 중에 date 매개 변수가 제공된 경우 반환된 보고서는 제공된 날짜에 대한 것입니다. date 매개 변수를 제공하지 않으면 가장 최근 보고서가 반환됩니다.
fullIDsFragmentCount
네임스페이스의 총 프로필 조각 수입니다.
fullIDsCount
네임스페이스에 병합된 총 프로필 수입니다.
fullIDsPercentage
fullIDsCount은(는) 10진수 형식으로 표현되는 총 병합 프로필 비율(마지막 샘플 상태에서 반환된 totalRows 값)입니다.
code
네임스페이스에 대한 code입니다. 이 ID는 Adobe Experience Platform ID 서비스 API를 사용하여 네임스페이스로 작업할 때 찾을 수 있으며 Experience Platform UI에서 ID 기호라고도 합니다. 자세한 내용은 ID 네임스페이스 개요를 참조하세요.
value
네임스페이스에 대한 id 값입니다. ID 서비스 API를 사용하여 네임스페이스로 작업할 때 찾을 수 있습니다.

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

데이터 세트 겹치기 보고서는 주소 지정 가능한 대상(병합된 프로필)에 가장 많이 기여하는 데이터 세트를 노출하여 조직의 프로필 저장소 구성을 볼 수 있도록 합니다. 이 보고서는 데이터에 대한 통찰력을 제공하는 것 외에도 특정 데이터 세트에 대한 만료 설정과 같은 라이선스 사용을 최적화하는 작업을 수행하는 데 도움이 될 수 있습니다.

/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: {ORG_ID}' \

응답

요청이 성공하면 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

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

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

ID 네임스페이스 중복 보고서 생성 identity-overlap-report

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: {ORG_ID}' \

응답

요청이 성공하면 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 ID 서비스 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, ECID 및 Email 표준 ID로 구성된 142개의 프로필이 있습니다.
  • AAID 및 ECID ID 네임스페이스로 구성된 24개의 프로필이 있습니다.
  • ECID ID만 포함하는 프로필이 6,565개 있습니다.

연결되지 않은 프로필 보고서 생성

연결되지 않은 프로필 보고서를 통해 조직의 프로필 저장소 구성을 더 잘 볼 수 있습니다. "연결되지 않은" 프로필은 하나의 프로필 조각만 포함하는 프로필입니다. "알 수 없는" 프로필은 ECID 및 AAID과(와) 같은 익명 ID 네임스페이스와 연결된 프로필입니다. 알 수 없는 프로필은 비활성 상태이며, 이는 지정된 기간 동안 새로운 이벤트를 추가하지 않았음을 의미합니다. 연결되지 않은 프로필 보고서는 7, 30, 60, 90 및 120일 동안의 프로필 분류를 제공합니다.

/previewsamplestatus/report/unstitchedProfiles 끝점에 대한 GET 요청을 수행하여 연결되지 않은 프로필 보고서를 생성할 수 있습니다.

API 형식

GET /previewsamplestatus/report/unstitchedProfiles

요청

다음 요청은 연결되지 않은 프로필 보고서를 반환합니다.

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

응답

요청이 성공하면 HTTP 상태 200(OK) 및 연결되지 않은 프로필 보고서가 반환됩니다.

NOTE
이 안내서에서는 보고서가 "120days" 및 “7days” 기간만 포함하도록 잘렸습니다. 전체 연결되지 않은 프로필 보고서는 7, 30, 60, 90 및 120일 동안의 프로필 분류를 제공합니다.
{
  "data": {
      "totalNumberOfProfiles": 63606,
      "totalNumberOfEvents": 130977,
      "unstitchedProfiles": {
          "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 수입니다.
unstitchedProfiles
기간별로 연결되지 않은 프로필의 분류가 포함된 객체입니다. 연결되지 않은 프로필 보고서는 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개의 ExperienceEvent가 있습니다.
  • ECID의 ID 네임스페이스에서 단일 프로필 조각을 포함하는 연결되지 않은 프로필은 1,734개입니다.
  • ECID의 ID 네임스페이스에서 단일 프로필 조각을 포함하는 1,734개의 연결되지 않은 프로필과 연결된 28,591개의 이벤트가 있습니다.

다음 단계

이제 프로필 저장소에서 샘플 데이터를 미리 보고 데이터에 대한 여러 보고서를 실행하는 방법을 알았으므로, 세그먼테이션 서비스 API의 예상 및 미리 보기 끝점을 사용하여 세그먼트 정의와 관련된 요약 수준 정보를 볼 수도 있습니다. 다음은 예상 대상을 격리하는 데 유용한 정보입니다. Segmentation API를 사용하여 미리 보기 및 예상 작업을 수행하는 방법에 대한 자세한 내용은 미리 보기 및 예상 끝점 안내서를 참조하십시오.

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