를 사용하여 오퍼 게재 Batch Decisioning API deliver-offers-batch

다음 Batch Decisioning API를 사용하면 한 번의 호출로 주어진 대상의 모든 프로필에 대해 의사 결정 기능을 사용할 수 있습니다. 대상의 각 프로필에 대한 오퍼 콘텐츠는 사용자 지정 일괄 처리 워크플로우에 사용할 수 있는 Adobe Experience Platform 데이터 세트에 배치됩니다.

포함 Batch Decisioning API를 사용하면 의사 결정 범위를 위해 Adobe Experience Platform 대상의 모든 프로필에 대한 최상의 오퍼로 데이터 세트를 채울 수 있습니다. 예를 들어 조직에서 Batch Decisioning 따라서 메시지 게재 공급업체에 오퍼를 보낼 수 있습니다. 그런 다음 이러한 오퍼는 동일한 사용자 대상자에게 일괄 메시지 전달을 위해 전송되는 콘텐츠로 사용됩니다.

이를 위해 조직은 다음과 같은 작업을 수행합니다.

  • 실행 Batch Decisioning API에 포함된 두 개의 요청은 다음과 같습니다.

    1. A 일괄 POST 요청 작업 로드를 시작하여 오퍼 선택을 일괄 처리합니다.

    2. A 일괄 GET 요청 일괄 처리 작업 로드 상태를 가져옵니다.

  • 데이터 세트를 메시지 게재 공급업체 API로 내보냅니다.

NOTE
Journey Optimizer 인터페이스를 사용하여 일괄 의사 결정을 수행할 수도 있습니다. 자세한 내용은 다음을 참조하십시오. 이 섹션: 일괄 처리 의사 결정 사용 시 고려해야 할 글로벌 사전 요구 사항 및 제한 사항에 대한 정보를 제공합니다.
  • 데이터 세트당 실행 중인 일괄 처리 작업 수: 데이터 세트당 한 번에 최대 5개의 배치 작업을 실행할 수 있습니다. 출력 데이터 세트가 동일한 다른 모든 일괄 처리 요청이 큐에 추가됩니다. 이전 작업 실행이 완료되면 대기 중인 작업이 선택되어 처리됩니다.
  • 빈도 설정: 하루에 한 번 발생하는 프로필 스냅샷에서 배치가 실행됩니다. 다음 Batch Decisioning API는 빈도를 제한하며 항상 가장 최근 스냅샷에서 프로필을 로드합니다.

시작하기 getting-started

이 API를 사용하기 전에 다음 사전 요구 단계를 완료하십시오.

결정 준비 prepare-decision

하나 이상의 결정을 준비하려면 데이터 세트, 대상자 및 결정을 만들었는지 확인하십시오. 이러한 전제 조건은에 자세히 설명되어 있습니다. 이 섹션.

API 요구 사항 api-requirements

모두 Batch Decisioning 요청에는에서 참조한 헤더 외에 다음 헤더가 필요합니다. 의사 결정 관리 API 개발자 안내서:

  • Content-Type: application/json
  • x-request-id: 요청을 식별하는 고유한 문자열입니다.
  • x-sandbox-name: 샌드박스 이름입니다.

일괄 처리 시작 start-a-batch-process

일괄 처리 결정을 위해 작업 로드를 시작하려면 POST에 /workloads/decisions 엔드포인트.

NOTE
배치 작업의 처리 시간에 대한 자세한 내용은 다음 위치에서 확인할 수 있습니다. 이 섹션.

API 형식

POST {ENDPOINT_PATH}/workloads/decisions
매개변수
설명
{ENDPOINT_PATH}
저장소 API의 끝점 경로입니다.
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
다음을 포함하는 래퍼 placementIdactivityId
xdm:activityId
결정에 대한 고유 식별자.
xcore:offer-activity:1410cdcda196707b
xdm:placementId
고유 배치 식별자.
xcore:offer-placement:1410c4117306488a
xdm:itemCount
결정 범위에 대해 요청된 옵션과 같은 항목의 수를 표시하는 선택적 필드입니다. 기본적으로 API는 범위당 하나의 옵션을 반환하지만 이 필드를 지정하여 추가 옵션을 명시적으로 요청할 수 있습니다. 범위당 최소 1개에서 최대 30개의 옵션을 요청할 수 있습니다.
1
xdm:includeContent
선택 필드이며 다음과 같습니다. false 기본적으로. If true, 오퍼 콘텐츠는 데이터 세트의 의사 결정 이벤트에 포함됩니다.
false

다음을 참조하십시오. 의사 결정 관리 설명서 주요 개념 및 속성에 대한 개요를 제공합니다.

응답

{
    "@id": "47efef25-4bcf-404f-96e2-67c4f784a1f5",
    "xdm:imsOrgId": "9GTO98D5F@AdobeOrg",
    "ode:createDate": 1648078924834,
    "ode:status": "QUEUED"
}
속성
설명
@id
단일 워크로드를 식별하는 의사 결정 관리에 의해 생성된 UUID입니다.
5d0ffb5e-dfc6-4280-99b6-0bf3131cb8b8
xdm:imsOrgId
조직 ID입니다.
9GTO98D5F@AdobeOrg
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}
저장소 API의 끝점 경로입니다.
https://platform.adobe.io/data/core/dwm
{WORKLOAD_ID}
단일 워크로드를 식별하는 의사 결정 관리에 의해 생성된 UUID입니다.
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
단일 워크로드를 식별하는 의사 결정 관리에 의해 생성된 UUID입니다.
5d0ffb5e-dfc6-4280-99b6-0bf3131cb8b8
xdm:imsOrgId
조직 ID
9GTO98D5F@AdobeOrg
ode:createDate
의사 결정 작업 로드 요청이 생성된 시간입니다.
1648076994405
ode:status
작업 로드 상태가 "대기 중"으로 시작하며 "처리 중", "수집 중", "완료됨" 또는 "오류"로 변경됩니다.
ode:status: "COMPLETED"
ode:statusDetail
상태가 "PROCESSING" 또는 "INGESTING"인 경우 sparkJobId 및 batchID와 같은 자세한 정보를 표시합니다. 상태가 "ERROR"인 경우 오류 세부 정보가 표시됩니다.

다음 단계 next-steps

이 API 안내서에 따라 을 사용하여 작업 로드 상태 및 게재된 오퍼를 확인했습니다 Batch Decisioning] API. 자세한 내용은 의사 결정 관리 개요.

recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76