을 사용하여 오퍼 게재 Batch Decisioning API

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

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

이를 수행하려면 조직에서 다음을 수행합니다.

• 를 실행합니다. Batch Decisioning API - 두 개의 요청을 포함합니다.

  1. A 배치 POST 요청 작업 로드를 시작하여 배치 처리 오퍼 선택을 시작하려면 다음을 수행합니다.

  2. A 배치 GET 요청 배치 작업 로드 상태를 가져오려면

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

• 데이터 세트당 실행 중인 일괄 처리 작업 수: 데이터 세트당 한 번에 최대 5개의 배치 작업을 실행할 수 있습니다. 출력 데이터 세트가 동일한 다른 일괄 처리 요청이 큐에 추가됩니다. 이전 작업 실행이 완료되면 처리할 대기 중인 작업이 선택됩니다.
• 빈도 제한: 하루에 한 번 발생하는 프로필 스냅샷에서 일괄 처리가 실행됩니다. 다음 Batch Decisioning API는 빈도를 제한하고 항상 최신 스냅샷의 프로필을 로드합니다.

시작하기

이 API를 사용하기 전에 다음 전제 조건 단계를 완료했는지 확인하십시오.

결정 준비

하나 이상의 결정을 준비하려면 데이터 세트, 세그먼트 및 결정을 만들었는지 확인합니다. 이러한 전제 조건은 이 섹션.

API 요구 사항

모두 Batch Decisioning 요청에서는 의사 결정 관리 API 개발자 안내서:

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

배치 프로세스 시작

작업 로드를 배치 프로세스 결정에 시작하려면 /workloads/decisions 엔드포인트.

API 형식

POST {ENDPOINT_PATH}/{CONTAINER_ID}/workloads/decisions

요청

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
}'

자세한 내용은 의사 결정 관리 설명서 기본 개념 및 속성에 대한 개요입니다.

응답

{
    "@id": "47efef25-4bcf-404f-96e2-67c4f784a1f5",
    "xdm:imsOrgId": "9GTO98D5F@AdobeOrg",
    "xdm:containerId": "0948b1c5-fff8-3b76-ba17-909c6b93b5a2",
    "ode:createDate": 1648078924834,
    "ode:status": "QUEUED"
}

배치 결정에 대한 정보 검색

특정 결정에 대한 정보를 검색하려면 /workloads/decisions 결정에 해당하는 작업 로드 ID 값을 제공하는 중 끝점입니다.

API 형식

GET  {ENDPOINT_PATH}/{CONTAINER_ID}/workloads/decisions/{WORKLOAD_ID}

요청

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"
}

다음 단계

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

Business.Adobe.com 리소스