샘플 상태 끝점 미리 보기(프로필 미리 보기)
Adobe Experience Platform을 사용하면 여러 소스에서 고객 데이터를 수집하여 각 개별 고객을 위한 강력하고 통합된 프로필을 구축할 수 있습니다. 데이터가 Experience Platform에 수집되면 샘플 작업이 실행되어 프로필 수 및 기타 실시간 고객 프로필 데이터 관련 지표를 업데이트합니다.
이 샘플 작업의 결과는 실시간 고객 프로필 API의 일부인 /previewsamplestatus 끝점을 사용하여 볼 수 있습니다. 이 끝점을 사용하여 데이터 세트와 ID 네임스페이스 모두로 프로필 분포를 나열할 수 있을 뿐만 아니라 조직의 프로필 저장소 구성을 가시적으로 확인할 수 있도록 여러 보고서를 생성할 수도 있습니다. 이 안내서에서는 /previewsamplestatus API 끝점을 사용하여 이러한 지표를 보는 데 필요한 단계를 안내합니다.
시작
이 가이드에 사용된 API 끝점은 Real-Time Customer Profile API의 일부입니다. 계속하기 전에 시작 안내서를 검토하여 관련 문서에 대한 링크, 이 문서의 샘플 API 호출 읽기 지침 및 Experience Platform API를 성공적으로 호출하는 데 필요한 필수 헤더에 대한 중요 정보를 확인하십시오.
프로필 조각과 병합된 프로필
이 안내서는 "프로필 조각"과 "병합된 프로필"을 모두 참조합니다. 진행하기 전에 이러한 용어 간의 차이점을 이해하는 것이 중요합니다.
각 개별 고객 프로필은 해당 고객에 대한 단일 보기를 형성하기 위해 병합된 여러 프로필 조각으로 구성됩니다. 예를 들어, 고객이 여러 채널에서 브랜드와 상호 작용하는 경우 조직에는 여러 데이터 세트에 표시되는 단일 고객과 관련된 여러 프로필 조각이 있을 수 있습니다.
프로필 조각을 Experience Platform에 수집하면 해당 고객을 위한 단일 프로필을 만들기 위해 프로필 조각이 함께 병합 정책에 따라 병합됩니다. 따라서 각 프로필이 여러 조각으로 구성되므로 총 프로필 조각 수는 병합된 프로필 총 수보다 항상 높을 수 있습니다.
Experience Platform에서 프로필 및 프로필의 역할에 대해 자세히 알아보려면 실시간 고객 프로필 개요를 읽어 보십시오.
샘플 작업이 트리거되는 방법
실시간 고객 프로필에 대해 활성화된 데이터가 Experience Platform에 수집되면 프로필 데이터 저장소 내에 저장됩니다. 프로필 스토어로 레코드를 수집하면 총 프로필 수가 3% 이상 증가하거나 감소하면 샘플링 작업이 트리거되어 수를 업데이트합니다. 샘플이 트리거되는 방법은 사용 중인 수집 유형에 따라 다릅니다.
- 스트리밍 데이터 워크플로의 경우 매시간 3% 증가 또는 감소 임계값이 충족되었는지 확인합니다. 샘플 작업이 있는 경우, 샘플 작업이 자동으로 트리거되어 카운트를 업데이트합니다.
- 일괄 처리 수집의 경우, 일괄 처리를 프로필 스토어로 성공적으로 수집한 후 15분 이내에 3% 증가 또는 감소 임계값에 도달하면 카운트를 업데이트하는 작업이 실행됩니다. 프로필 API를 사용하면 최근에 성공한 샘플 작업을 미리 볼 수 있으며, 데이터 세트 및 ID 네임스페이스별로 프로필 분포를 나열할 수 있습니다.
네임스페이스 지표별 프로필 개수 및 프로필은 Experience Platform UI의 Profiles 섹션 내에서도 사용할 수 있습니다. UI를 사용하여 프로필 데이터에 액세스하는 방법에 대한 자세한 내용은 Profile UI 안내서를 참조하십시오.
마지막 샘플 상태 보기 view-last-sample-status
/previewsamplestatus 끝점에 대한 GET 요청을 수행하여 조직에 대해 마지막으로 실행된 성공적인 샘플 작업에 대한 세부 정보를 볼 수 있습니다. 이 보고서에는 샘플에 있는 총 프로필 수와 프로필 수 지표 또는 조직이 Experience Platform 내에 있는 총 프로필 수가 포함됩니다.
프로필 수는 프로필 조각을 병합하여 각 개별 고객에 대한 단일 프로필을 형성한 후 생성됩니다. 즉, 프로필 조각이 함께 병합되면 모두 동일한 개인과 관련되므로 "1" 프로필 수를 반환합니다.
프로필 카운트에는 속성이 있는 프로필(레코드 데이터)과 Adobe Analytics 프로필과 같이 시계열(이벤트) 데이터만 포함된 프로필이 모두 포함됩니다. Experience Platform 내에서 최신 총 프로필 수를 제공하기 위해 프로필 데이터가 수집되면 샘플 작업이 정기적으로 새로 고쳐집니다.
API 형식
GET /previewsamplestatus
요청
| code language-shell |
|---|
|
응답
성공적인 응답은 HTTP 상태 200을 반환하며, 조직에 대해 실행된 마지막으로 성공한 샘플 작업에 대한 세부 정보를 포함합니다.
| note note |
|---|
| NOTE |
이 예제 응답에서 numRowsToRead과(와) totalRows은(는) 서로 같습니다. 조직이 Experience Platform에 보유하고 있는 프로필 수에 따라 달라질 수 있습니다. 그러나 일반적으로 이 두 숫자는 다릅니다. numRowsToRead은(는) 샘플을 총 프로필 수(totalRows)의 하위 집합으로 나타내므로 더 작은 숫자입니다. |
| code language-json |
|---|
|
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2 11-row-2 12-row-2 | |
|---|---|
| 속성 | 설명 |
numRowsToRead |
샘플에서 병합된 총 프로필 수입니다. |
sampleJobRunning |
샘플 작업이 진행 중일 때 true을(를) 반환하는 부울 값입니다. 일괄 처리 파일이 업로드된 시점부터 실제로 프로필 저장소에 추가될 때까지의 지연 시간을 투명하게 제공합니다. |
docCount |
데이터베이스의 총 문서 수입니다. |
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}
datedate=2024-12-31요청
다음 요청은 date 매개 변수를 사용하여 지정된 날짜에 대한 가장 최근 보고서를 반환합니다.
| code language-shell |
|---|
|
응답
성공적인 응답은 HTTP 상태 200을 반환하며 데이터 집합 개체 목록이 포함된 data 배열을 포함합니다.
| note note |
|---|
| NOTE |
| 표시된 다음 응답은 3개의 데이터 세트를 표시하도록 잘렸습니다. |
| code language-json |
|---|
|
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2 | |
|---|---|
| 속성 | 설명 |
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 네임스페이스 개요를 읽는 것부터 시작하십시오.
API 형식
GET /previewsamplestatus/report/namespace
GET /previewsamplestatus/report/namespace?{QUERY_PARAMETERS}
dateYYYY-MM-DD.date=2025-6-20요청
다음 요청은 date 매개 변수를 지정하지 않으며 가장 최근 보고서를 반환합니다.
| code language-shell |
|---|
|
응답
성공적인 응답은 HTTP 상태 200을 반환하고 data 배열을 포함하며, 개별 개체에는 각 네임스페이스에 대한 세부 정보가 들어 있습니다. 표시된 응답이 4개의 네임스페이스를 표시하도록 잘렸습니다.
| code language-json |
|---|
|
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 | |
|---|---|
| 속성 | 설명 |
sampleCount |
네임스페이스에서 샘플링된 병합된 프로필의 총 수입니다. |
samplePercentage |
sampleCount은(는) 십진수 형식으로 표현되는 샘플링된 병합 프로필(numRowsToRead마지막 샘플 상태에서 반환된 값)의 백분율입니다. |
reportTimestamp |
보고서의 타임스탬프. 요청 중에 date 매개 변수가 제공된 경우 반환된 보고서는 제공된 날짜에 대한 것입니다. date 매개 변수를 제공하지 않으면 가장 최근 보고서가 반환됩니다. |
fullIDsFragmentCount |
네임스페이스의 총 프로필 조각 수입니다. |
fullIDsCount |
네임스페이스에 병합된 총 프로필 수입니다. |
fullIDsPercentage |
fullIDsCount은(는) 10진수 형식으로 표현되는 총 병합 프로필 비율(totalRows마지막 샘플 상태에서 반환된 값)입니다. |
code |
네임스페이스에 대한 code입니다. 이 ID는 Adobe Experience Platform ID 서비스 API를 사용하여 네임스페이스로 작업할 때 찾을 수 있으며 Experience Platform UI에서 Identity symbol이라고도 합니다. 자세한 내용은 ID 네임스페이스 개요를 참조하세요. |
value |
네임스페이스에 대한 id 값입니다. ID 서비스 API를 사용하여 네임스페이스로 작업할 때 찾을 수 있습니다. |
데이터 세트 통계 나열 dataset-stats
/previewsamplestatus/report/dataset_stats 끝점에 GET 요청을 하여 데이터 집합에 대한 통계를 제공하는 보고서를 생성할 수 있습니다.
API 형식
GET /previewsamplestatus/report/dataset_stats
요청
| code language-shell |
|---|
|
응답
성공적인 응답은 데이터 세트의 통계에 대한 정보와 함께 HTTP 상태 200을 반환합니다.
| note note |
|---|
| NOTE |
| 다음 응답은 3개의 데이터 세트를 표시하도록 잘렸습니다. |
| code language-json |
|---|
|
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2 11-row-2 12-row-2 13-row-2 14-row-2 | |
|---|---|
| 속성 | 설명 |
120days |
120일의 데이터 만료 후 데이터 집합에 남아 있는 레코드 수입니다. |
14days |
14일의 데이터 만료 후 데이터 집합에 남아 있는 레코드 수입니다. |
30days |
30일 데이터 만료 후 데이터 집합에 남아 있는 레코드 수입니다. |
365days |
365일의 데이터 만료 후 데이터 집합에 남아 있는 레코드 수입니다. |
60days |
데이터 만료 후 60일이 지나면 데이터 세트에 남아 있게 되는 레코드 수입니다. |
7days |
데이터 만료 후 7일이 지나면 데이터 세트에 남아 있게 되는 레코드 수입니다. |
90days |
데이터 만료 후 90일 동안 데이터 집합에 남아 있는 레코드 수입니다. |
datasetId |
데이터 세트의 ID입니다. |
datasetType |
데이터 세트 유형. 이 값은 Profiles 또는 ExperienceEvents일 수 있습니다. |
percentEvents |
데이터 세트 내에 있는 경험 이벤트 레코드의 백분율입니다. |
percentProfiles |
데이터 세트 내에 있는 프로필 레코드의 백분율입니다. |
profileFragments |
데이터 세트에 있는 총 프로필 조각 수입니다. |
records |
데이터 세트에 수집된 총 프로필 레코드 수입니다. |
totalProfiles |
데이터 세트에 수집된 총 프로필 수입니다. |
데이터 세트 크기 가져오기 character-count
이 끝점을 사용하여 주 단위로 데이터 세트의 크기를 바이트 단위로 가져올 수 있습니다.
API 형식
GET /previewsamplestatus/report/character_count
요청
| code language-shell |
|---|
|
응답
성공적인 응답은 주 동안의 데이터 세트 크기에 대한 정보와 함께 HTTP 상태 200을 반환합니다.
| note note |
|---|
| NOTE |
| 다음 응답은 3개의 데이터 세트를 표시하도록 잘렸습니다. |
| code language-json |
|---|
|
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 | |
|---|---|
| 속성 | 설명 |
datasetId |
데이터 세트의 ID입니다. |
recordType |
데이터 세트 내의 데이터 유형입니다. 레코드 종류는 weeks 변수의 값에 영향을 줍니다. 지원되는 값은 keyvalue 및 timeseries입니다. |
weeks |
데이터 세트에 대한 크기 정보를 포함하는 배열입니다. 레코드 종류 keyvalue의 데이터 세트의 경우 가장 최근 주와 데이터 세트의 총 크기(바이트)가 포함됩니다. 레코드 종류 timeseries의 데이터 세트의 경우, 여기에는 데이터 세트의 수집부터 가장 최근 주까지 매주 및 해당 주마다 데이터 세트의 총 크기(바이트)가 포함됩니다. |
modelName |
데이터 세트에 대한 모델의 이름입니다. 가능한 값은 _xdm.context.profile 및 _xdm.context.experienceevent입니다. |
reportTimestamp |
보고서가 생성된 날짜와 시간입니다. |
다음 단계
이제 프로필 저장소에서 샘플 데이터를 미리 보고 데이터에 대한 여러 보고서를 실행하는 방법을 알았으므로, 세그먼테이션 서비스 API의 예상 및 미리 보기 끝점을 사용하여 세그먼트 정의와 관련된 요약 수준 정보를 볼 수도 있습니다. 다음은 예상 대상을 격리하는 데 유용한 정보입니다. Segmentation API를 사용하여 미리 보기 및 예상 작업을 수행하는 방법에 대한 자세한 내용은 미리 보기 및 예상 끝점 안내서를 참조하십시오.