決策管理API開發人員指南

本開發人員指南提供了幫助您開始使用 Offer Library API。 然後，本指南提供了使用決策管理引擎執行關鍵操作的示例API調用。

➡️ 瞭解有關此視頻中決策管理元件的更多資訊

先決條件

本指南要求對Adobe Experience Platform的下列組成部分有工作上的理解：

• Experience Data Model (XDM) System:標準化框架 Experience Platform 組織客戶體驗資料。
  • 架構組合的基礎:瞭解XDM架構的基本構建塊。
• 決策管理:說明一般和特別是Offer decisioning中用於經驗決策的概念和元件。 說明了在客戶體驗期間用於選擇最佳選擇的策略。
• Profile Query Language (PQL):PQL是一種功能強大的語言，可在XDM實例上編寫表達式。 PQL用於定義決策規則。

讀取示例API調用

本指南提供了示例API調用，以演示如何格式化請求。 這些包括路徑、必需的標頭和正確格式化的請求負載。 還提供了API響應中返回的示例JSON。 有關示例API調用文檔中使用的約定的資訊，請參見上的 如何讀取示例API調用 Experience Platform 疑難解答指南。

收集所需標題的值

為了呼叫 Adobe Experience Platform API，必須首先完成 驗證教程。 完成身份驗證教程將提供所有中每個必需標頭的值 Experience Platform API調用，如下所示：

• Authorization: Bearer {ACCESS_TOKEN}
• x-api-key: {API_KEY}
• x-gw-ims-org-id: {IMS_ORG}

包含負載(POST、PUT、PATCH)的所有請求都需要附加的標頭：

• Content-Type: application/json

管理對容器的訪問

容器是一種隔離機構，用於將不同的問題分開。 容器ID是所有儲存庫API的第一個路徑元素。 所有決策對象都駐留在容器中。

管理員可以將類似的承擔者、資源和訪問權限分組到配置式中。 這減輕了管理負擔，並受 Adobe Admin Console。 您必須是組織中Adobe Experience Platform的產品管理員才能建立配置檔案並為其分配用戶。 只需在一次性步驟中建立與某些權限相匹配的產品配置檔案，然後將用戶添加到這些配置檔案即可。 配置檔案充當已授予權限的組，該組中的每個實際用戶或技術用戶都繼承這些權限。

給定管理員權限，您可以通過 Adobe Admin Console。 有關詳細資訊，請參見 訪問控制概述。

列出可供用戶和整合訪問的容器

API格式

GET /{ENDPOINT_PATH}?product={PRODUCT_CONTEXT}&property={PROPERTY}==decisioning

要求

curl -X GET \
  'https://platform.adobe.io/data/core/xcore/?product=acp&property=_instance.containerType==decisioning' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

回應

成功的響應返回有關決策管理容器的資訊。 這包括 instanceId 屬性，其值為容器ID。

{
    "_embedded": {
        "https://ns.adobe.com/experience/xcore/container": [
            {
                "instanceId": "{INSTANCE_ID}",
                "schemas": [
                    "https://ns.adobe.com/experience/xcore/container;version=0.5"
                ],
                "productContexts": [
                    "acp"
                ],
                "repo:etag": 2,
                "repo:createdDate": "2020-09-16T07:54:28.319959Z",
                "repo:lastModifiedDate": "2020-09-16T07:54:32.098139Z",
                "repo:createdBy": "{CREATED_BY}",
                "repo:lastModifiedBy": "{MODIFIED_BY}",
                "repo:createdByClientId": "{CREATED_CLIENT_ID}",
                "repo:lastModifiedByClientId": "{MODIFIED_CLIENT_ID}",
                "_instance": {
                    "containerType": "decisioning",
                    "repo:name": "{REPO_NAME}",
                    "dataCenter": "{DATA_CENTER}",
                    "parentName": "{PARENT_NAME}",
                    "parentId": "{PARENT_ID}"
                },
                "_links": {
                    "self": {
                        "href": "/containers/{INSTANCE_ID}"
                    }
                }
            }
        ]
    },
    "_links": {
        "self": {
            "href": "/?product=acp&property=_instance.containerType==decisioning",
            "@type": "https://ns.adobe.com/experience/xcore/hal/home"
        }
    }
}

後續步驟

本文檔涵蓋了呼叫 Offer Library API，包括獲取容器ID。 現在，您可以繼續閱讀本開發人員指南中提供的示例調用，並按照其說明進行操作。

How-to視頻

以下視頻旨在支援您對「決策管理」元件的瞭解。