決策管理API開發人員指南

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

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

先決條件

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

讀取示例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
參數 說明 範例
{ENDPOINT_PATH} 儲存庫API的終結點路徑。 https://platform.adobe.io/data/core/xcore/
{PRODUCT_CONTEXT} 按容器與產品上下文的關聯篩選容器清單。 acp
{PROPERTY} 篩選返回的容器類型。 _instance.containerType==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。 現在,您可以繼續閱讀本開發人員指南中提供的示例調用,並按照其說明進行操作。

注意

Adobe Journey Optimizer的In-app消息通道使用offer decisioning對象。 如果您的組織使用應用內消息傳遞通道,則對象的API清單請求將包括應用內消息傳遞服務建立的對象,並且可以忽略這些對象以用於offer decisioning使用案例。 為應用內消息建立的對象將具有 createdBy = “Mobile_Sheliak”

How-to視頻

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

本頁內容