일괄 처리 세그멘테이션 안내서
일괄 세분화는 프로필 데이터를 한 번에 이동하여 해당 대상자를 만들 수 있는 세분화 평가 방법입니다.
배치 세분화를 사용하면 상세하고 풍부한 대상을 만들고 세분화 작업을 실행하여 이 데이터를 다운스트림 서비스에 전파하려는 시기를 확인할 수 있습니다.
적격 쿼리 유형
모든 쿼리는 배치 세분화에 적합합니다.
대상자 만들기
세분화 서비스 API를 사용하거나 UI의 대상 포털을 통해 배치 세분화를 사용하여 평가되는 대상을 만들 수 있습니다.
API 형식
POST /segment/definitions
요청
배치 세분화가 활성화된 세그먼트 정의를 만들기 위한 샘플 요청
curl -X POST https://platform.adobe.io/data/core/ups/segment/definitions
-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 '{
"name": "People in the USA",
"description: "An audience that looks for people who live in the USA",
"expression": {
"type": "PQL",
"format": "pql/text",
"value": "homeAddress.country = \"US\""
},
"evaluationInfo": {
"batch": {
"enabled": true
},
"continuous": {
"enabled": false
},
"synchronous": {
"enabled": false
}
},
"schema": {
"name": "_xdm.context.profile"
}
}'
응답
성공적인 응답은 새로 생성된 세그먼트 정의에 대한 세부 정보와 함께 HTTP 상태 200을 반환합니다.
세그먼트 정의를 생성할 때 샘플 응답.
{
"id": "4afe34ae-8c98-4513-8a1d-67ccaa54bc05",
"schema": {
"name": "_xdm.context.profile"
},
"profileInstanceId": "ups",
"imsOrgId": "{ORG_ID}",
"sandbox": {
"sandboxId": "28e74200-e3de-11e9-8f5d-7f27416c5f0d",
"sandboxName": "prod",
"type": "production",
"default": true
},
"name": "People in the USA",
"description": "An audience that looks for people who live in the USA",
"expression": {
"type": "PQL",
"format": "pql/text",
"value": "homeAddress.country = \"US\""
},
"evaluationInfo": {
"batch": {
"enabled": true
},
"continuous": {
"enabled": false
},
"synchronous": {
"enabled": false
}
},
"dataGovernancePolicy": {
"excludeOptOut": true
},
"creationTime": 0,
"updateEpoch": 1579292094,
"updateTime": 1579292094000
}
이 끝점 사용에 대한 자세한 내용은 세그먼트 정의 끝점 안내서에서 확인할 수 있습니다.
대상 포털에서 대상 만들기 를 선택합니다.
팝오버가 나타납니다. 세그먼트 빌더를 입력하려면 규칙 작성 을 선택하십시오.
세그먼트 정의를 만든 후 일괄 처리 를 평가 메서드(으)로 선택합니다.
세그먼트 정의 만들기에 대한 자세한 내용은 세그먼트 빌더 안내서를 참조하세요.
대상자 검색
세분화 서비스 API를 사용하거나 UI의 대상 포털을 통해 배치 세분화를 사용하여 평가된 모든 대상을 검색할 수 있습니다.
/segment/definitions 끝점에 대한 GET 요청을 통해 조직 내에서 일괄 처리 세그먼테이션을 사용하여 평가되는 모든 세그먼트 정의 목록을 검색합니다.
API 형식
일괄 처리 세분화를 사용하여 평가된 세그먼트 정의를 검색하려면 요청 경로에 쿼리 매개 변수 evaluationInfo.batch.enabled=true을(를) 포함해야 합니다.
GET /segment/definitions?evaluationInfo.batch.enabled=true
요청
일괄 처리가 활성화된 모든 세그먼트 정의를 나열하는 샘플 요청
curl -X GET \
'https://platform.adobe.io/data/core/ups/segment/definitions?evaluationInfo.batch.enabled=true' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'Content-Type: application/json' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}'
응답
성공적인 응답은 배치 세그먼테이션을 사용하여 평가되는 조직의 세그먼트 정의 배열과 함께 HTTP 상태 200을 반환합니다.
조직의 모든 일괄 처리 세분화 평가 세그먼트 정의 목록을 포함하는 샘플 응답
{
"segments": [
{
"id": "15063cb-2da8-4851-a2e2-bf59ddd2f004",
"schema": {
"name": "_xdm.context.profile"
},
"ttlInDays": 30,
"imsOrgId": "{ORG_ID}",
"sandbox": {
"sandboxId": "",
"sandboxName": "",
"type": "production",
"default": true
},
"name": " People who are NOT on their homepage ",
"expression": {
"type": "PQL",
"format": "pql/text",
"value": "select var1 from xEvent where var1._experience.analytics.endUser.firstWeb.webPageDetails.isHomePage = false"
},
"evaluationInfo": {
"batch": {
"enabled": true
},
"continuous": {
"enabled": false
},
"synchronous": {
"enabled": false
}
},
"creationTime": 1572029711000,
"updateEpoch": 1572029712000,
"updateTime": 1572029712000
},
{
"id": "f15063cb-2da8-4851-a2e2-bf59ddd2f004",
"schema": {
"name": "_xdm.context.profile"
},
"ttlInDays": 30,
"imsOrgId": "{ORG_ID}",
"sandbox": {
"sandboxId": "",
"sandboxName": "",
"type": "production",
"default": true
},
"name": "Homepage_continuous",
"description": "People who are on their homepage - continuous",
"expression": {
"type": "PQL",
"format": "pql/text",
"value": "select var1 from xEvent where var1._experience.analytics.endUser.firstWeb.webPageDetails.isHomePage = true"
},
"evaluationInfo": {
"batch": {
"enabled": true
},
"continuous": {
"enabled": true
},
"synchronous": {
"enabled": false
}
},
"creationTime": 1572021085000,
"updateEpoch": 1572021086000,
"updateTime": 1572021086000
}
],
"page": {
"totalCount": 2,
"totalPages": 1,
"sortField": "creationTime",
"sort": "desc",
"pageSize": 2,
"limit": 100
},
"link": {}
}
반환된 세그먼트 정의에 대한 자세한 내용은 세그먼트 정의 끝점 안내서를 참조하십시오.
Audience Portal의 필터를 사용하여 조직 내에서 일괄 세분화에 대해 활성화된 모든 대상을 검색할 수 있습니다. 필터 목록을 표시하려면
사용 가능한 필터 내에서 빈도 업데이트(으)로 이동하여 "일괄 처리"을(를) 선택하십시오. 이 필터를 사용하면 배치 세분화를 사용하여 평가되는 조직의 모든 대상이 표시됩니다.
Experience Platform에서 대상자를 보는 방법에 대한 자세한 내용은 대상자 포털 안내서를 참조하십시오.