使用交付优惠 Batch Decisioning API deliver-offers-batch
此 Batch Decisioning API允许组织在一次调用中对给定受众中的所有用户档案使用决策功能。 受众中每个用户档案的选件内容都放在Adobe Experience Platform数据集中,可用于自定义批量工作流。
使用 Batch Decisioning API之后,您可以在数据集中填充用于决策范围的Adobe Experience Platform受众中所有用户档案的最佳选件。 例如,组织可能希望运行 Batch Decisioning 以便他们向消息投放供应商发送选件。 这些选件随后将用作发送出去、以批量消息方式发送给相同用户受众的内容。
为此,本组织将:
-
运行 Batch Decisioning API,其中包含两个请求:
-
A 批量POST请求 启动工作负载以批处理选件选择。
-
A 批量GET请求 获取批处理工作负载状态。
-
-
将数据集导出到消息投放供应商API。
- 每个数据集运行的批处理作业数:每个数据集一次最多可以运行五个批处理作业。 具有相同输出数据集的任何其他批处理请求都将添加到队列中。 一旦前一个作业运行完成,系统会选取已排队作业进行处理。
- 频率封顶:批处理每天运行一次的配置文件快照。 此 Batch Decisioning API会限制频率并始终从最新快照加载配置文件。
快速入门 getting-started
在使用此API之前,请确保完成以下先决步骤。
准备决策 prepare-decision
要准备一个或多个决策,请确保已创建数据集、受众和决策。 有关这些先决条件的详情,请参见 本节.
API要求 api-requirements
全部 Batch Decisioning 除了中提到的标头外,请求还需要以下标头 Decision Management API开发人员指南:
Content-Type
:application/json
x-request-id
:标识请求的唯一字符串。x-sandbox-name
:沙盒名称。
启动批处理 start-a-batch-process
POST要启动工作负载以批量处理决策,请向 /workloads/decisions
端点。
API格式
POST {ENDPOINT_PATH}/workloads/decisions
{ENDPOINT_PATH}
https://platform.adobe.io/data/core/dwm
请求
curl -X POST 'https://platform.adobe.io/data/core/dwm/workloads/decisions' \
-H 'x-request-id: f671a589-eb7b-432f-b6b9-23d5b796b4dc' \
-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}' \
-H 'x-sandbox-id: {SANDBOX_ID}' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-d '{
"xdm:segmentIds": [
"609028e4-e66c-4776-b0d9-c782887e2273"
],
"xdm:dataSetId": "6196b4a1a63bd118dafe093c",
"xdm:propositionRequests": [
{
"xdm:activityId": "xcore:offer-activity:1410cdcda196707b",
"xdm:placementId": "xcore:offer-placement:1410c4117306488a",
"xdm:itemCount": 1
}
],
"xdm:includeContent": false
}'
xdm:segmentIds
609028e4-e66c-4776-b0d9-c782887e2273
xdm:dataSetId
6196b4a1a63bd118dafe093c
xdm:propositionRequests
placementId
和 activityId
xdm:activityId
xcore:offer-activity:1410cdcda196707b
xdm:placementId
xcore:offer-placement:1410c4117306488a
xdm:itemCount
1
xdm:includeContent
false
默认情况下。 如果 true
时,选件内容包含在数据集的决策事件中。false
请参阅 决策管理文档 有关主要概念和属性的概述。
响应
{
"@id": "47efef25-4bcf-404f-96e2-67c4f784a1f5",
"xdm:imsOrgId": "9GTO98D5F@AdobeOrg",
"ode:createDate": 1648078924834,
"ode:status": "QUEUED"
}
@id
5d0ffb5e-dfc6-4280-99b6-0bf3131cb8b8
xdm:imsOrgId
9GTO98D5F@AdobeOrg
xdm:containerId
0948b1c5-fff8-3b76-ba17-909c6b93b5a2
ode:createDate
1648078924834
ode:status
ode:status: "QUEUED"
检索有关批次决策的信息 retrieve-information-on-a-batch-decision
GET要检索有关特定决策的信息,请向 /workloads/decisions
端点,同时为您的决策提供相应的工作负载ID值。
API格式
GET {ENDPOINT_PATH}/workloads/decisions/{WORKLOAD_ID}
{ENDPOINT_PATH}
https://platform.adobe.io/data/core/dwm
{WORKLOAD_ID}
47efef25-4bcf-404f-96e2-67c4f784a1f5
请求
curl -X GET 'https://platform.adobe.io/data/core/dwm/workloads/decisions/f395ab1f-dfaf-48d4-84c9-199ad6354591' \
-H 'x-request-id: 7832a42a-d4e5-413b-98e8-e49bef056436' \
-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}' \
-H'x-sandbox-id: {SANDBOX_ID}' \
-H 'Authorization: Bearer {ACCESS_TOKEN}'
响应
{
"@id": "f395ab1f-dfaf-48d4-84c9-199ad6354591",
"xdm:imsOrgId": "{IMS_ORG}",
"ode:createDate": 1648076994405,
"ode:status": "COMPLETED"
}
@id
5d0ffb5e-dfc6-4280-99b6-0bf3131cb8b8
xdm:imsOrgId
9GTO98D5F@AdobeOrg
xdm:containerId
0948b1c5-fff8-3b76-ba17-909c6b93b5a2
ode:createDate
1648076994405
ode:status
ode:status: "COMPLETED"
ode:statusDetail
后续步骤 next-steps
通过遵循此API指南,您已使用检查工作负荷状态和提供的选件 Batch Decisioning] API。 欲了解更多信息,请参见 决策管理概述.