엔드포인트 미리 보기 및 예측
세그먼트 정의를 개발할 때, Adobe Experience Platform 내의 예상 및 미리 보기 도구를 사용하여 요약 수준 정보를 볼 수 있으므로 예상한 대상자를 격리하는 데 도움이 됩니다.
-
미리 보기 에서는 세그먼트 정의에 대해 페이지 번호를 매긴 프로필 목록을 제공하므로 결과를 예상한 결과와 비교할 수 있습니다.
-
예상 값 은(는) 예상 대상 크기, 신뢰 구간 및 오류 표준 편차와 같은 세그먼트 정의에 대한 통계 정보를 제공합니다.
시작하기
이 가이드에 사용된 끝점은 Adobe Experience Platform Segmentation Service API의 일부입니다. 계속하기 전에 시작 안내서에서 필수 헤더와 예제 API 호출을 읽는 방법 등 API를 성공적으로 호출하기 위해 알아야 하는 중요한 정보를 검토하십시오.
예상 생성 방법
프로필 스토어로 레코드를 수집하면 총 프로필 수가 5% 이상 증가하거나 감소하면 샘플링 작업이 트리거되어 수를 업데이트합니다. 데이터 샘플링이 트리거되는 방식은 수집 방법에 따라 다릅니다.
- 일괄 처리 수집: 일괄 처리 수집의 경우, 일괄 처리를 Profile Store에 성공적으로 수집한 후 15분 이내에 5% 증가 또는 감소 임계값이 충족되면 카운트를 업데이트하는 작업이 실행됩니다.
- 스트리밍 수집: 스트리밍 데이터 워크플로의 경우 5% 증가 또는 감소 임계값이 충족되었는지 확인하기 위해 시간별로 검사를 수행합니다. 이 경우 카운트를 업데이트하기 위해 작업이 자동으로 트리거됩니다.
검사의 샘플 크기는 프로필 스토어에 있는 전체 엔티티 수에 따라 다릅니다. 이러한 샘플 크기는 다음 표에 나와 있습니다.
새 미리보기 만들기 create-preview
/preview
끝점에 대한 POST 요청을 수행하여 새 미리 보기를 만들 수 있습니다.
API 형식
POST /preview
요청
code language-shell |
---|
|
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 | |
---|---|
속성 | 설명 |
predicateExpression |
데이터를 쿼리할 PQL 표현식. |
predicateType |
predicateExpression 아래의 쿼리 식에 대한 조건자 형식입니다. 현재 이 속성에 허용되는 유일한 값은 pql/text 입니다. |
predicateModel |
프로필 데이터의 기반이 되는 Experience Data Model (XDM) 스키마 클래스의 이름입니다. |
graphType |
클러스터를 가져올 그래프 유형입니다. 지원되는 값은 none (ID 결합을 수행하지 않음) 및 pdg (개인 ID 그래프를 기반으로 ID 결합을 수행)입니다. |
응답
성공한 응답은 새로 만든 미리보기에 대한 세부 정보와 함께 HTTP 상태 201(생성됨)을 반환합니다.
code language-json |
---|
|
table 0-row-2 1-row-2 2-row-2 | |
---|---|
속성 | 설명 |
state |
미리보기 작업의 현재 상태입니다. 처음 생성될 때 "NEW" 상태가 됩니다. 그런 다음 처리가 완료될 때까지 "RUNNING" 상태가 되고 이 시점에서 "RESULT_READY" 또는 "FAILED"가 됩니다. |
previewId |
다음 섹션에 설명된 대로 예상 또는 미리보기를 볼 때 조회 목적으로 사용되는 미리보기 작업의 ID입니다. |
특정 미리보기 결과 검색 get-preview
/preview
끝점에 대한 GET 요청을 만들고 요청 경로에 미리 보기 ID를 제공하여 특정 미리 보기에 대한 자세한 정보를 검색할 수 있습니다.
API 형식
GET /preview/{PREVIEW_ID}
{PREVIEW_ID}
previewId
값입니다.요청
code language-shell |
---|
|
응답
성공한 응답은 지정된 미리 보기에 대한 자세한 정보와 함께 HTTP 상태 200을 반환합니다.
code language-json |
---|
|
table 0-row-2 1-row-2 | |
---|---|
속성 | 설명 |
results |
관련 ID와 함께 엔티티 ID 목록입니다. 제공된 링크는 프로필 액세스 API 끝점을 사용하여 지정된 엔터티를 조회하는 데 사용할 수 있습니다. |
특정 예상 작업의 결과 검색 get-estimate
미리 보기 작업을 만든 후에는 /estimate
끝점에 대한 GET 요청 경로에서 previewId
을(를) 사용하여 예상 대상 크기, 신뢰 구간 및 오류 표준 편차를 포함한 세그먼트 정의에 대한 통계 정보를 볼 수 있습니다.
API 형식
GET /estimate/{PREVIEW_ID}
{PREVIEW_ID}
previewId
값입니다.요청
다음 요청은 특정 예상 작업의 결과를 검색합니다.
code language-shell |
---|
|
응답
성공적인 응답은 예상 작업의 세부 정보와 함께 HTTP 상태 200을 반환합니다.
code language-json |
---|
|
table 0-row-2 1-row-2 2-row-2 3-row-2 | |
---|---|
속성 | 설명 |
estimatedNamespaceDistribution |
세그먼트 정의 내의 프로필 수를 ID 네임스페이스별로 분류한 오브젝트 배열입니다. 하나의 프로필이 여러 네임스페이스와 연결될 수 있으므로 네임스페이스별 총 프로필 수(각 네임스페이스에 대해 표시된 값을 함께 추가)는 프로필 수 지표보다 높을 수 있습니다. 예를 들어 고객이 둘 이상의 채널에서 브랜드와 상호 작용하는 경우 여러 네임스페이스가 해당 개별 고객과 연결됩니다. |
state |
미리보기 작업의 현재 상태입니다. 처리가 완료될 때까지 상태는 "RUNNING"이 되며, 이 시점에서 상태는 "RESULT_READY" 또는 "FAILED"가 됩니다. |
_links.preview |
state 이(가) "RESULT_READY"이면 이 필드에 예상 값을 볼 수 있는 URL이 제공됩니다. |
다음 단계
이 안내서를 읽은 후에는 Segmentation API를 사용하여 미리보기 및 예상 값을 사용하는 방법을 더 잘 이해할 수 있습니다. 특정 네임스페이스 또는 프로필 데이터 저장소 내의 프로필 조각 및 병합된 프로필의 총 수와 같은 실시간 고객 프로필 데이터와 관련된 지표에 액세스하는 방법은 프로필 미리 보기(/previewsamplestatus
) 엔드포인트 가이드를 참조하십시오.