邊緣分段（測試版）

邊緣區段是指能夠即時評估Adobe Experience Platform邊緣區段的能力，讓相同的頁面和下一頁個人化使用案例。

快速入門

本開發人員指南需要對邊緣區隔相關的各種Adobe Experience Platform服務有良好的瞭解。 在開始本教學課程之前，請先閱讀下列服務的檔案：

• Real-time Customer Profile:根據來自多個來源的匯總資料，即時提供統一的消費者個人檔案。
• Segmentation:提供從資料建立區段和觀眾的 Real-time Customer Profile 能力。
• Experience Data Model (XDM):組織客戶體驗資 Platform 料的標準化架構。

為了成功呼叫Data Prep API端點，請閱讀平台API快速入門手冊，以瞭解必要標題以及如何讀取範例API呼叫。

邊緣分段查詢類型

若要使用邊緣分段來評估區段，查詢必須符合下列准則：

下列查詢類型為​not，目前受邊緣分段支援：

擷取所有啟用邊緣區段的區段

您可以向/segment/definitions端點提出GET請求，以擷取IMS組織內啟用邊緣分段的所有區段清單。

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}'

回應

成功的回應會傳回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": {}
}

建立已啟用邊緣區段的區段

您可以建立區段，並透過向/segment/definitions端點提出POST要求來啟用邊緣區段。 除了匹配上述🔗所列的邊緣分段查詢類型之外，您還必須將裝載中的evaluationInfo.synchronous.enabled標幟設為true。

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"
    },
    "evaluationInfo": {
        "synchronous": {
            "enabled": 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": "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
}

後續步驟

現在您知道如何建立啟用邊緣區段的區段，您可以使用這些區段來啟用相同頁面和下一頁的個人化使用案例。

若要瞭解如何使用Adobe Experience Platform使用者介面執行類似動作及使用區段，請造訪區段產生器使用指南。