Batch Decisioning API를 사용하여 오퍼 게재 deliver-offers-batch
Batch Decisioning API를 사용하면 한 번의 호출로 주어진 대상의 모든 프로필에 대해 의사 결정 기능을 사용할 수 있습니다. 대상의 각 프로필에 대한 오퍼 콘텐츠는 사용자 지정 일괄 처리 워크플로우에 사용할 수 있는 Adobe Experience Platform 데이터 세트에 배치됩니다.
Batch Decisioning API를 사용하면 의사 결정 범위를 위해 Adobe Experience Platform 대상의 모든 프로필에 대한 최상의 오퍼로 데이터 세트를 채울 수 있습니다. 예를 들어 조직에서 Batch Decisioning을(를) 실행하여 메시지 게재 공급업체에 오퍼를 보낼 수 있습니다. 그런 다음 이러한 오퍼는 동일한 사용자 대상자에게 일괄 메시지 전달을 위해 전송되는 콘텐츠로 사용됩니다.
이를 위해 조직은 다음과 같은 작업을 수행합니다.
-
두 개의 요청이 포함된 Batch Decisioning API 실행:
-
오퍼 선택 항목을 일괄 처리하는 작업을 시작하는 일괄 POST 요청.
-
일괄 처리 작업 상태를 가져오기 위한 일괄 처리 GET 요청.
-
-
데이터 세트를 메시지 게재 공급업체 API로 내보냅니다.
- 데이터 집합당 실행 중인 일괄 처리 작업 수: 데이터 집합당 한 번에 최대 5개의 일괄 처리 작업을 실행할 수 있습니다. 출력 데이터 세트가 동일한 다른 모든 일괄 처리 요청이 큐에 추가됩니다. 이전 작업 실행이 완료되면 대기 중인 작업이 선택되어 처리됩니다.
- 빈도 제한: 하루에 한 번 발생하는 프로필 스냅숏에서 일괄 처리가 실행됩니다. Batch Decisioning API는 빈도를 제한하며 항상 가장 최근 스냅숏의 프로필을 로드합니다.
시작하기 getting-started
이 API를 사용하기 전에 다음 사전 요구 단계를 완료하십시오.
결정 준비 prepare-decision
하나 이상의 결정을 준비하려면 데이터 세트, 대상자 및 결정을 만들었는지 확인하십시오. 이러한 필수 구성 요소는 이 섹션에 자세히 설명되어 있습니다.
API 요구 사항 api-requirements
모든 Batch Decisioning 요청에는 의사 결정 관리 API 개발자 안내서에서 참조한 헤더 외에 다음 헤더가 필요합니다.
Content-Type:application/jsonx-request-id: 요청을 식별하는 고유한 문자열입니다.x-sandbox-name: 샌드박스 이름입니다.
일괄 처리 시작 start-a-batch-process
일괄 처리 결정에 대한 작업 로드를 시작하려면 /workloads/decisions 끝점에 POST 요청을 합니다.
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:segmentIds609028e4-e66c-4776-b0d9-c782887e2273xdm:dataSetId6196b4a1a63bd118dafe093cxdm:propositionRequestsplacementId 및 activityId이(가) 포함된 래퍼입니다.xdm:activityIdxcore:offer-activity:1410cdcda196707bxdm:placementIdxcore:offer-placement:1410c4117306488axdm:itemCount1xdm:includeContentfalse입니다. true이면 오퍼 콘텐츠가 데이터 집합의 결정 이벤트에 포함됩니다.false주요 개념 및 속성에 대한 개요는 의사 결정 관리 설명서를 참조하세요.
응답
{
"@id": "47efef25-4bcf-404f-96e2-67c4f784a1f5",
"xdm:imsOrgId": "9GTO98D5F@AdobeOrg",
"ode:createDate": 1648078924834,
"ode:status": "QUEUED"
}
@id5d0ffb5e-dfc6-4280-99b6-0bf3131cb8b8xdm:imsOrgId9GTO98D5F@AdobeOrgode:createDate1648078924834ode:statusode:status: "QUEUED"일괄 처리 결정에 대한 정보 검색 retrieve-information-on-a-batch-decision
특정 결정에 대한 정보를 검색하려면 결정에 해당하는 작업 로드 ID 값을 제공하는 동안 /workloads/decisions 끝점에 GET 요청을 하십시오.
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"
}
@id5d0ffb5e-dfc6-4280-99b6-0bf3131cb8b8xdm:imsOrgId9GTO98D5F@AdobeOrgode:createDate1648076994405ode:statusode:status: "COMPLETED"ode:statusDetail다음 단계 next-steps
이 API 안내서를 따라 Batch Decisioning API를 사용하여 작업 로드 상태 및 게재된 오퍼를 확인했습니다. 자세한 내용은 의사 결정 관리에 대한 개요를 참조하십시오.