엔드포인트 미리 보기 및 예측
세그먼트 정의를 개발할 때, Adobe Experience Platform 내의 예상 및 미리 보기 도구를 사용하여 요약 수준 정보를 볼 수 있으므로 예상한 대상자를 격리하는 데 도움이 됩니다.
-
미리 보기 세그먼트 정의에 대해 자격이 있는 프로필의 페이지가 매겨진 목록을 제공하여 예상한 결과와 비교할 수 있도록 합니다.
-
예상 예상 대상 크기, 신뢰 구간 및 오류 표준 편차와 같은 세그먼트 정의에 대한 통계 정보를 제공합니다.
시작하기
이 안내서에 사용된 끝점은 Adobe Experience Platform Segmentation Service API. 계속하기 전에 다음을 검토하십시오. 시작 안내서 필수 헤더와 예제 API 호출을 읽는 방법 등 API를 성공적으로 호출하기 위해 알아야 하는 중요한 정보입니다.
예상 생성 방법
프로필 스토어로 레코드를 수집하면 총 프로필 수가 5% 이상 증가하거나 감소하면 샘플링 작업이 트리거되어 수를 업데이트합니다. 데이터 샘플링이 트리거되는 방식은 수집 방법에 따라 다릅니다.
- 일괄 처리 수집: 일괄 처리 수집의 경우, 프로필 스토어에 일괄 처리를 성공적으로 수집한 후 15분 이내에 5% 증가 또는 감소 임계값이 충족되면 카운트를 업데이트하는 작업이 실행됩니다.
- 스트리밍 수집: 스트리밍 데이터 워크플로의 경우 5% 증가 또는 감소 임계값이 충족되었는지 확인하기 위해 시간별로 검사가 수행됩니다. 이 경우 카운트를 업데이트하기 위해 작업이 자동으로 트리거됩니다.
스캔의 샘플 크기는 프로필 스토어에 있는 전체 엔티티 수에 따라 다릅니다. 이러한 샘플 크기는 다음 표에 나와 있습니다.
새 미리보기 만들기 create-preview
에 POST 요청을 하여 새 미리보기를 만들 수 있습니다. /preview
엔드포인트.
API 형식
POST /preview
요청
curl -X POST https://platform.adobe.io/data/core/ups/preview \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'Content-Type: application/json' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-sandbox-name: {SANDBOX_NAME}'
-d '
{
"predicateExpression": "xEvent.metrics.commerce.abandons.value > 0",
"predicateType": "pql/text",
"predicateModel": "_xdm.context.profile",
"graphType": "none"
}'
predicateExpression
predicateType
predicateExpression
. 현재 이 속성에 대해 허용되는 유일한 값은 입니다. pql/text
.predicateModel
graphType
none
(id 결합을 수행하지 않음) 및 pdg
(개인 id 그래프를 기반으로 id 결합을 수행합니다.)응답
성공한 응답은 새로 만든 미리보기에 대한 세부 정보와 함께 HTTP 상태 201(생성됨)을 반환합니다.
{
"state": "NEW",
"previewQueryId": "e890068b-f5ca-4a8f-a6b5-af87ff0caac3",
"previewQueryStatus": "NEW",
"previewId": "MDphcHAtMzJiZTAzMjgtM2YzMS00YjY0LThkODQtYWNkMGM0ZmJkYWQzOmU4OTAwNjhiLWY1Y2EtNGE4Zi1hNmI1LWFmODdmZjBjYWFjMzow",
"previewExecutionId": 0
}
state
previewId
특정 미리보기 결과 검색 get-preview
에 GET 요청을 하여 특정 미리보기에 대한 자세한 정보를 검색할 수 있습니다. /preview
엔드포인트 및 요청 경로에 미리보기 ID 제공
API 형식
GET /preview/{PREVIEW_ID}
{PREVIEW_ID}
previewId
검색할 미리보기 값.요청
curl -X GET https://platform.adobe.io/data/core/ups/preview/MDphcHAtMzJiZTAzMjgtM2YzMS00YjY0LThkODQtYWNkMGM0ZmJkYWQzOmU4OTAwNjhiLWY1Y2EtNGE4Zi1hNmI1LWFmODdmZjBjYWFjMzow \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-sandbox-name: {SANDBOX_NAME}'
응답
성공한 응답은 지정된 미리 보기에 대한 자세한 정보와 함께 HTTP 상태 200을 반환합니다.
{
"results": [{
"XID_ADOBE-MARKETING-CLOUD-ID-1": {
"_href": "https://platform.adobe.io/data/core/ups/models/profile/XID_ADOBE-MARKETING-CLOUD-ID-1",
"endCustomerIds": {
"XID_COOKIE_ID_1": {
"_href": "https://platform.adobe.io/data/core/ups/models/profile/XID_COOKIE_ID_1"
},
"XID_PROFILE_ID_1": {
"_href": "https://platform.adobe.io/data/core/ups/models/profile/XID_PROFILE_ID_1"
}
}
}
},
{
"XID_COOKIE-ID-2": {
"_href": "https://platform.adobe.io/data/core/ups/models/profile/XID_COOKIE-ID-2",
"endCustomerIds": {
"XID_COOKIE_ID_2-1": {
"_href": "https://platform.adobe.io/data/core/ups/models/profile/XID_COOKIE_ID_2-1"
},
"XID_PROFILE_ID_2": {
"_href": "https://platform.adobe.io/data/core/ups/models/profile/XID_PROFILE_ID_2"
}
}
},
"XID_ADOBE-MARKETING-CLOUD-ID-3": {
"_href": "https://platform.adobe.io/data/core/ups/models/profile/XID_ADOBE-MARKETING-CLOUD-ID-1000"
}
}],
"state": "RESULT_READY",
"links": {
"_self": "https://platform.adobe.io/data/core/ups/preview?expression=<expr-1>&limit=1000",
"next": "",
"prev": ""
},
"page": {
"offset": 0,
"size": 3
}
}
results
특정 예상 작업의 결과 검색 get-estimate
미리보기 작업을 생성했으면 미리보기 작업을 사용할 수 있습니다 previewId
에 대한 GET 요청 경로 /estimate
예상 대상 크기, 신뢰 구간 및 오류 표준 편차를 포함하여 세그먼트 정의에 대한 통계 정보를 보기 위한 끝점입니다.
API 형식
GET /estimate/{PREVIEW_ID}
{PREVIEW_ID}
previewId
미리보기 작업이 생성될 때 값이 반환되었습니다.요청
다음 요청은 특정 예상 작업의 결과를 검색합니다.
curl -X GET https://platform.adobe.io/data/core/ups/estimate/MDoyOjRhNDVlODUzLWFjOTEtNGJiNy1hNDI2LTE1MDkzN2I2YWY1Yzo0Mg \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-sandbox-name: {SANDBOX_NAME}'
응답
성공적인 응답은 예상 작업의 세부 정보와 함께 HTTP 상태 200을 반환합니다.
{
"estimatedSize": 4275,
"numRowsToRead": 4275,
"estimatedNamespaceDistribution": [
{
"namespaceId": "4",
"profilesMatchedSoFar": 35
},
{
"namespaceId": "6",
"profilesMatchedSoFar": 4275
}
],
"state": "RESULT_READY",
"profilesReadSoFar": 4275,
"standardError": 0,
"error": {
"description": "",
"traceback": ""
},
"profilesMatchedSoFar": 4275,
"totalRows": 4275,
"confidenceInterval": "95%",
"_links": {
"preview": "https://platform.adobe.io/data/core/ups/preview/app-32be0328-3f31-4b64-8d84-acd0c4fbdad3/execution/0?previewQueryId=e890068b-f5ca-4a8f-a6b5-af87ff0caac3"
}
}
estimatedNamespaceDistribution
state
_links.preview
state
는 "RESULT_READY"이며 이 필드는 예상치를 볼 수 있는 URL을 제공합니다.다음 단계
이 안내서를 읽은 후에는 Segmentation API를 사용하여 미리보기 및 예상 값을 사용하는 방법을 더 잘 이해할 수 있습니다. 특정 네임스페이스 또는 프로필 데이터 저장소 전체에서 프로필 조각 및 병합된 프로필의 총 수와 같은 실시간 고객 프로필 데이터와 관련된 지표에 액세스하는 방법을 알아보려면 다음을 방문하십시오. 프로필 미리 보기(/previewsamplestatus
) 엔드포인트 가이드.