Leverera erbjudanden med Batch Decisioning API deliver-offers-batch

The Batch Decisioning Med API kan organisationer använda beslutsfunktioner för alla profiler i en viss målgrupp i ett enda anrop. Erbjudandeinnehållet för varje profil i målgruppen placeras i en Adobe Experience Platform-datauppsättning där det är tillgängligt för anpassade grupparbetsflöden.

Med Batch Decisioning API kan ni fylla i en datauppsättning med de bästa erbjudandena för alla profiler i en Adobe Experience Platform-målgrupp för beslutsomfattningar. En organisation kanske vill köra Batch Decisioning så att de kan skicka erbjudanden till en meddelandeleverantör. Erbjudandena används sedan som innehåll som skickas ut för batchmeddelandeleverans till samma målgrupp.

För att göra detta skulle organisationen:

Komma igång getting-started

Innan du använder detta API måste du utföra följande steg.

Förbered beslutet prepare-decision

Om du vill förbereda ett eller flera beslut måste du skapa en datauppsättning, en målgrupp och ett beslut. Dessa förutsättningar beskrivs närmare i det här avsnittet.

API-krav api-requirements

Alla Batch Decisioning kräver följande rubriker förutom de som anges i Utvecklarhandbok för API för beslutshantering:

Starta en gruppbearbetning start-a-batch-process

Om du vill starta en arbetsbelastning för att gruppbearbeta beslut, skickar du en POST till /workloads/decisions slutpunkt.

API-format

POST {ENDPOINT_PATH}/workloads/decisions

Begäran

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

Se Beslutsledningens dokumentation om du vill ha en översikt över de viktigaste begreppen och egenskaperna.

Svar

{
    "@id": "47efef25-4bcf-404f-96e2-67c4f784a1f5",
    "xdm:imsOrgId": "9GTO98D5F@AdobeOrg",
    "ode:createDate": 1648078924834,
    "ode:status": "QUEUED"
}

Hämta information om ett batchbeslut retrieve-information-on-a-batch-decision

Om du vill hämta information om ett visst beslut skickar du en GET-förfrågan till /workloads/decisions slutpunkt när du anger motsvarande ID-värde för arbetsbelastning för ditt beslut.

API-format

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

Begäran

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

Svar

{
   "@id": "f395ab1f-dfaf-48d4-84c9-199ad6354591",
    "xdm:imsOrgId": "{IMS_ORG}",
    "ode:createDate": 1648076994405,
    "ode:status": "COMPLETED"
}

Nästa steg next-steps

Genom att följa den här API-guiden har du kontrollerat arbetsbelastningsstatus och levererade erbjudanden med hjälp av Batch Decisioning] API. Mer information finns i Översikt över beslutsfattandet.