决策管理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中的应用程序内消息传送渠道使用offer decisioning对象。 如果您的组织使用应用程序内消息传送渠道,则对象的API列表请求将包含由应用程序内消息传送服务创建的对象,在offer decisioning用例中,这些对象可以忽略。 为应用程序内消息创建的对象将具有 createdBy = “Mobile_Sheliak”.

操作方法视频

以下视频旨在支持您对决策管理组件的了解。

在此页面上