使用傳遞優惠方案 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
:沙箱名稱。x-sandbox-id
:沙箱ID。
開始批次處理 start-a-batch-process
若要啟動工作負載以批次處理決策,請向以下專案發出POST請求: /workloads/decisions
端點。
API格式
POST {ENDPOINT_PATH}/{CONTAINER_ID}/workloads/decisions
{ENDPOINT_PATH}
https://platform.adobe.io/data/core/ode
{CONTAINER_ID}
e0bd8463-0913-4ca1-bd84-6309134ca1f6
要求
curl -X POST 'https://platform.adobe.io/data/core/ode/0948b1c5-fff8-3b76-ba17-909c6b93b5a2/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",
"xdm:containerId": "0948b1c5-fff8-3b76-ba17-909c6b93b5a2",
"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}/{CONTAINER_ID}/workloads/decisions/{WORKLOAD_ID}
{ENDPOINT_PATH}
https://platform.adobe.io/data/core/ode
{CONTAINER_ID}
e0bd8463-0913-4ca1-bd84-6309134ca1f6
{WORKLOAD_ID}
47efef25-4bcf-404f-96e2-67c4f784a1f5
要求
curl -X GET 'https://platform.adobe.io/data/core/ode/0948b1c5-fff8-3b76-ba17-909c6b93b5a2/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}",
"xdm:containerId": "0948b1c5-fff8-3b76-ba17-909c6b93b5a2",
"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。 如需詳細資訊,請參閱 決策管理概觀.