에지 세분화
에지 세그멘테이션은 에지에서 즉시 Adobe Experience Platform의 세그먼트 정의를 평가하는 기능으로, 동일한 페이지 및 다음 페이지 개인화 사용 사례를 활성화합니다.
시작하기
이 개발자 안내서를 사용하려면 여러 가지 사항에 대한 작업 이해가 필요합니다 Adobe Experience Platform 에지 세분화와 관련된 서비스. 이 자습서를 시작하기 전에 다음 서비스에 대한 설명서를 검토하십시오.
- Real-Time Customer Profile: 여러 소스에서 집계한 데이터를 기반으로 통합 소비자 프로필을 실시간으로 제공합니다.
- Adobe Experience Platform Segmentation Service: 다음에서 대상자를 빌드할 수 있습니다. Real-Time Customer Profile 데이터.
- Experience Data Model (XDM): 표준화된 프레임워크 Platform 고객 경험 데이터를 구성합니다.
Experience Platform API 엔드포인트를 성공적으로 호출하려면 의 안내서를 참조하십시오. platform API 시작하기 필수 헤더와 샘플 API 호출을 읽는 방법에 대해 알아봅니다.
Edge 세그멘테이션 쿼리 유형 query-types
가장자리 세분화를 사용하여 세그먼트를 평가하려면 쿼리가 다음 지침을 준수해야 합니다.
chain(xEvent, timestamp, [A: WHAT(eventType = "addToCart")])
homeAddress.countryCode = "US"
homeAddress.countryCode = "US" and chain(xEvent, timestamp, [A: WHAT(eventType = "addToCart")])
not(chain(xEvent, timestamp, [A: WHAT(eventType = "homePageView")]))
chain(xEvent, timestamp, [X: WHAT(eventType = "addToCart") WHEN(< 24 hours before now)])
homeAddress.countryCode = "US" and chain(xEvent, timestamp, [X: WHAT(eventType = "addToCart") WHEN(< 24 hours before now)])
homeAddress.countryCode = "US" and not(chain(xEvent, timestamp, [X: WHAT(eventType = "addToCart") WHEN(< 24 hours before now)]))
chain(xEvent, timestamp, [A: WHAT(eventType = "homePageView") WHEN(< 24 hours before now) COUNT(5) ] )
homeAddress.countryCode = "US" and chain(xEvent, timestamp, [A: WHAT(eventType = "homePageView") WHEN(< 24 hours before now) COUNT(5) ] )
not(chain(xEvent, timestamp, [A: WHAT(eventType = "homePageView") WHEN(< 24 hours before now) COUNT(5) ] ))
chain(xEvent, timestamp, [X: WHAT(eventType = "homePageView") WHEN(< 24 hours before now)]) and chain(xEvent, timestamp, [X: WHAT(eventType = "checkoutPageView") WHEN(< 24 hours before now)])
homeAddress.countryCode = "US" and chain(xEvent, timestamp, [X: WHAT(eventType = "homePageView") WHEN(< 24 hours before now)]) and chain(xEvent, timestamp, [X: WHAT(eventType = "checkoutPageView") WHEN(< 24 hours before now)])
homeAddress.countryCode = "US" and inSegment("existing segment")
chain(xEvent, timestamp, [A: WHAT(eventType = "addToCart") WHERE(externalSegmentMapProperty.values().exists(stringProperty="active"))])
또한 세그먼트는 필수 edge에서 활성 상태인 병합 정책에 연결됩니다. 병합 정책에 대한 자세한 내용은 병합 정책 안내서.
세그먼트 정의는 아님 다음 시나리오에서 edge 세그멘테이션에 대해 활성화하십시오.
- 세그먼트 정의는 단일 이벤트와
inSegment
이벤트.- 그러나 세그먼트에 포함된 경우
inSegment
이벤트는 프로필 전용이며, 세그먼트 정의는 입니다. 의지 에지 세분화에 대해 활성화되어야 합니다.
- 그러나 세그먼트에 포함된 경우
에지 세그멘테이션에 대해 활성화된 모든 세그먼트 검색
에 GET 요청을 하여 조직 내에서 Edge 세그멘테이션에 대해 활성화된 모든 세그먼트 목록을 검색할 수 있습니다. /segment/definitions
엔드포인트.
API 형식
모서리 세그멘테이션에 대해 활성화된 세그먼트를 검색하려면 쿼리 매개 변수를 포함해야 합니다 evaluationInfo.synchronous.enabled=true
요청 경로에서.
GET /segment/definitions?evaluationInfo.synchronous.enabled=true
요청
curl -X GET \
'https://platform.adobe.io/data/core/ups/segment/definitions?evaluationInfo.synchronous.enabled=true' \
-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}'
응답
성공적인 응답은 조직에서 에지 세분화에 대해 활성화된 일련의 세그먼트를 반환합니다. 반환된 세그먼트 정의에 대한 자세한 내용은 세그먼트 정의 끝점 안내서.
{
"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": false
},
"continuous": {
"enabled": false
},
"synchronous": {
"enabled": true
}
},
"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": false
},
"continuous": {
"enabled": false
},
"synchronous": {
"enabled": true
}
},
"creationTime": 1572021085000,
"updateEpoch": 1572021086000,
"updateTime": 1572021086000
}
],
"page": {
"totalCount": 2,
"totalPages": 1,
"sortField": "creationTime",
"sort": "desc",
"pageSize": 2,
"limit": 100
},
"link": {}
}
가장자리 세분화가 활성화된 세그먼트 만들기
에 POST 요청을 하여 에지 세분화에 대해 활성화된 세그먼트를 만들 수 있습니다. /segment/definitions
다음 중 하나와 일치하는 엔드포인트 위에 나열된 에지 세분화 쿼리 유형.
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-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-d '{
"schema": {
"name": "_xdm.context.profile"
},
"ttlInDays": 30,
"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": false
},
"continuous": {
"enabled": false
},
"synchronous": {
"enabled": true
}
}
}'
응답
성공한 응답은 에지 세분화에 대해 활성화된 새로 생성된 세그먼트 정의의 세부 정보를 반환합니다.
{
"id": "f15063cb-2da8-4851-a2e2-bf59ddd2f004",
"schema": {
"name": "_xdm.context.profile"
},
"ttlInDays": 30,
"imsOrgId": "{ORG_ID}",
"sandbox": {
"sandboxId": "{SANDBOX_ID}",
"sandboxName": "{SANDBOX_NAME}",
"type": "production",
"default": true
},
"name": "Homepage_continuous",
"description": "People who are on their homepage - continuous",
"expression": {
"type": "PQL",
"format": "pql/text",
"value": "chain(xEvent, timestamp, [X: WHAT(var1._experience.analytics.endUser.firstWeb.webPageDetails.isHomePage = "true")])"
},
"evaluationInfo": {
"batch": {
"enabled": false
},
"continuous": {
"enabled": false
},
"synchronous": {
"enabled": true
}
},
"creationTime": 1572021085000,
"updateEpoch": 1572021086000,
"updateTime": 1572021086000
}
다음 단계
이제 에지 세그멘테이션이 활성화된 세그먼트를 만드는 방법을 알았으므로 이를 사용하여 동일 페이지 및 다음 페이지 개인화 사용 사례를 활성화할 수 있습니다.
Adobe Experience Platform 사용자 인터페이스를 사용하여 유사한 작업을 수행하고 세그먼트를 사용하는 방법을 알아보려면 다음을 방문하십시오. 세그먼트 빌더 사용 안내서.
부록
다음 섹션에는 에지 세분화에 대해 자주 묻는 질문이 나와 있습니다.
Edge Network에서 세그먼트를 사용할 수 있으려면 얼마나 걸립니까?
Edge Network에서 세그먼트를 사용할 수 있으려면 최대 1시간이 걸립니다.