에지 세그먼테이션(베타)

노트

다음 문서에서는 API를 사용하여 에지 세그멘테이션을 수행하는 방법을 설명합니다. UI를 사용하여 에지 세분화를 수행하는 방법에 대한 자세한 내용은 edge segmentation UI 안내서. 또한 에지 세그먼테이션은 현재 베타에 있습니다. 설명서 및 기능은 변경될 수 있습니다.

Edge Segmentation은 Adobe Experience Platform의 세그먼트를 즉시 평가하여 동일한 페이지와 다음 페이지 개인화 사용 사례를 가능하게 하는 기능입니다.

시작하기

이 개발자 안내서를 사용하려면 다양한 Adobe Experience Platform 에지 세그먼테이션과 관련된 서비스. 이 자습서를 시작하기 전에 다음 서비스에 대한 설명서를 검토하십시오.

  • Real-time Customer Profile: 여러 소스에서 집계된 데이터를 기반으로 실시간으로 통합 소비자 프로필을 제공합니다.
  • Segmentation: 에서 세그먼트와 대상을 만들 수 있는 기능을 제공합니다. Real-time Customer Profile 데이터.
  • Experience Data Model (XDM): 표준화된 프레임워크 Platform 고객 경험 데이터를 구성합니다.

Experience Platform API 엔드포인트를 성공적으로 호출하려면 다음 안내서를 참조하십시오 플랫폼 API 시작 필요한 헤더와 샘플 API 호출을 읽는 방법에 대해 알아봅니다.

에지 세그멘테이션 쿼리 유형

에지 세그먼테이션을 사용하여 세그먼트를 평가하려면 쿼리가 다음 지침을 준수해야 합니다.

쿼리 유형 세부 사항
단일 이벤트 시간 제한 없이 단일 수신 이벤트를 참조하는 모든 세그먼트 정의입니다. 장바구니에 항목을 추가한 사람.
프로필을 참조하는 단일 이벤트 하나 이상의 프로필 속성 및 시간 제한 없이 단일 수신 이벤트를 참조하는 모든 세그먼트 정의입니다. 미국에 거주하는 사람들이 홈페이지를 방문했습니다.
프로필 속성을 사용하여 단일 이벤트 무효화 무효화된 단일 수신 이벤트와 하나 이상의 프로필 속성을 참조하는 모든 세그먼트 정의 미국에 살고 not 홈 페이지를 방문했습니다.
24시간 시간 기간 내 단일 이벤트 24시간 이내에 들어오는 단일 이벤트를 참조하는 모든 세그먼트 정의입니다. 지난 24시간 동안 홈페이지를 방문한 사람들.
24시간 시간 창 내에서 프로필 속성이 있는 단일 이벤트 24시간 이내에 하나 이상의 프로필 속성 및 무효화된 단일 수신 이벤트를 참조하는 모든 세그먼트 정의. 미국에 거주하는 사람들이 지난 24시간 동안 홈페이지를 방문했습니다.
24시간 시간 창 내에서 프로필 속성이 있는 단일 이벤트가 무효화됨 24시간 이내에 하나 이상의 프로필 속성 및 무효화된 단일 수신 이벤트를 참조하는 모든 세그먼트 정의. 미국에 살고 not 지난 24시간 동안 홈페이지를 방문했다.
24시간 시간 기간 내의 빈도 이벤트 24시간의 시간 창 내에서 특정 시간에 발생하는 이벤트를 참조하는 모든 세그먼트 정의입니다. 홈 페이지를 방문한 사람 적어도 지난 24시간 동안 5번
24시간 시간 창 내에 프로필 속성이 있는 빈도 이벤트 하나 이상의 프로필 속성 및 24시간의 시간 창 내에서 특정 횟수를 발생하는 이벤트를 참조하는 모든 세그먼트 정의입니다. 홈페이지를 방문한 미국 출신 적어도 지난 24시간 동안 5번
24시간 시간 창 내에서 프로필이 무효화된 빈도 이벤트 24시간의 시간 창 내에서 특정 시간에 발생하는 하나 이상의 프로필 속성 및 무효화된 이벤트를 참조하는 모든 세그먼트 정의. 홈 페이지를 방문하지 않은 사람 자세히 지난 24시간 동안 5번 이상
24시간의 시간 프로필 내에 여러 수신 히트 24시간의 시간 창 내에서 발생하는 여러 이벤트를 참조하는 모든 세그먼트 정의입니다. 홈 페이지를 방문한 사람 또는 지난 24시간 내에 체크아웃 페이지를 방문했습니다.
24시간 기간 내에 프로필이 있는 여러 이벤트 24시간의 시간 창 내에서 발생하는 하나 이상의 프로필 속성 및 여러 이벤트를 참조하는 모든 세그먼트 정의입니다. 홈페이지를 방문한 미국 출신 지난 24시간 내에 체크아웃 페이지를 방문했습니다.

또한 세그먼트가 반드시 에지 상태에서 활성화된 병합 정책에 연결 병합 정책에 대한 자세한 내용은 정책 병합 안내서.

에지 세그먼테이션에 대해 활성화된 모든 세그먼트 검색

IMS 조직 내에서 Edge Segmentation에 사용할 수 있는 모든 세그먼트 목록은 /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: {IMS_ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

응답

성공적으로 응답하면 Edge Segmentation에 대해 활성화된 IMS 조직의 세그먼트 배열이 반환됩니다. 반환된 세그먼트 정의에 대한 자세한 내용은 세그먼트 정의 끝점 안내서.

{
    "segments": [
        {
            "id": "15063cb-2da8-4851-a2e2-bf59ddd2f004",
            "schema": {
                "name": "_xdm.context.profile"
            },
            "ttlInDays": 30,
            "imsOrgId": "{IMS_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": "{IMS_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 다음 중 하나와 일치하는 끝점입니다. 위에 나열된 edge segmentation 쿼리 유형.

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: {IMS_ORG}' \
  -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"
    }
}'

응답

성공적으로 응답하면 에지 세그멘테이션에 대해 활성화된 새로 생성된 세그먼트 정의의 세부 사항이 반환됩니다.

{
    "id": "f15063cb-2da8-4851-a2e2-bf59ddd2f004",
    "schema": {
        "name": "_xdm.context.profile"
    },
    "ttlInDays": 30,
    "imsOrgId": "{IMS_ORG}",
    "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 사용자 인터페이스를 사용하여 유사한 작업을 수행하고 세그먼트를 작업하는 방법을 배우려면 세그먼트 빌더 사용 안내서.

이 페이지에서는