Aanbiedingen leveren met behulp van de Batch Decisioning API deliver-offers-batch

Met de API van Batch Decisioning kunnen organisaties de beslissingsfunctionaliteit voor alle profielen in een bepaald publiek in één aanroep gebruiken. De aanbiedingsinhoud voor elke profielen in het publiek wordt geplaatst in een dataset van Adobe Experience Platform waar het voor de werkschema's van de douanepartij beschikbaar is.

Met de API van Batch Decisioning kunt u een dataset vullen met de beste aanbiedingen voor alle profielen in een Adobe Experience Platform-publiek voor beslissingsbereik. Een organisatie wil bijvoorbeeld Batch Decisioning uitvoeren, zodat ze aanbiedingen naar een leverancier van berichten kan verzenden. Die aanbiedingen worden dan gebruikt als inhoud die voor partijberichtlevering aan het zelfde publiek van gebruikers wordt verzonden.

Om dit te doen, zou de organisatie:

Aan de slag getting-started

Voordat u deze API gebruikt, moet u de volgende vereiste stappen uitvoeren.

De beslissing voorbereiden prepare-decision

Om één of meerdere besluiten voor te bereiden, zorg ervoor u een dataset, een publiek, en een besluit hebt gecreeerd. Die eerste vereisten zijn gedetailleerd in deze sectie.

API-vereisten api-requirements

Alle Batch Decisioning verzoeken vereisen de volgende kopballen naast degenen die in de gids van de ontwikkelaar van het Beheer API van het Besluitworden bedoeld:

Een batchproces starten start-a-batch-process

Als u een werkbelasting wilt starten om beslissingen over batchprocessen te nemen, vraagt u een POST naar het /workloads/decisions -eindpunt.

API formaat

POST {ENDPOINT_PATH}/workloads/decisions

Verzoek

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

Verwijs naar de documentatie van het Beheer van het Besluitvoor een overzicht van de belangrijkste concepten en eigenschappen.

Reactie

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

Informatie ophalen over een batchbeslissing retrieve-information-on-a-batch-decision

Om informatie over een specifieke beslissing terug te winnen, doe een verzoek van de GET aan het /workloads/decisions eindpunt terwijl het verstrekken van de overeenkomstige waarde van werklastidentiteitskaart voor uw besluit.

API formaat

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

Verzoek

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

Reactie

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

Volgende stappen next-steps

Door deze API-handleiding te volgen, hebt u de status van de werkbelasting gecontroleerd en aanbiedingen gedaan via de API Batch Decisioning. Voor meer informatie, zie het overzicht over het Beheer van het Besluit.