Diffuser des offres à l’aide de l’API Batch Decisioning deliver-offers-batch

L’API Batch Decisioning permet aux organisations d’utiliser la fonctionnalité de prise de décision pour tous les profils d’une audience donnée en un seul appel. Le contenu de l’offre pour chaque profil de l’audience est placé dans un jeu de données Adobe Experience Platform où il est disponible pour les workflows par lots personnalisés.

Avec l’API Batch Decisioning, vous pouvez renseigner un jeu de données avec les meilleures offres pour tous les profils d’une audience Adobe Experience Platform pour les portées de décision. Par exemple, une organisation peut vouloir exécuter Batch Decisioning afin de pouvoir envoyer des offres à un fournisseur de diffusion de messages. Ces offres sont ensuite utilisées comme contenu envoyé pour la diffusion de messages par lots à une même audience d’utilisateurs et d’utilisatrices.

Pour ce faire, l'organisation :

Prise en main getting-started

Avant d'utiliser cette API, veillez à suivre les étapes préalables suivantes.

Préparer la décision prepare-decision

Pour préparer une ou plusieurs décisions, veillez à créer un jeu de données, une audience et une décision. Ces prérequis sont présentés dans cette section.

Exigences en termes d'API api-requirements

Toutes les requêtes Batch Decisioning nécessitent les en-têtes suivants en plus de ceux qui sont référencés dans le Guide du développeur de l'API Decision Management :

Démarrage d'un traitement par lot start-a-batch-process

Pour démarrer une charge de travail afin de prendre des décisions concernant le traitement par lots, envoyez une requête POST au point d’entrée /workloads/decisions.

Format d’API

POST {ENDPOINT_PATH}/workloads/decisions

Requête

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

Reportez-vous à la section Documentation de la gestion des décisions pour un aperçu des concepts et propriétés principaux.

Réponse

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

Récupération des informations sur une décision par lot retrieve-information-on-a-batch-decision

Pour récupérer des informations sur une décision spécifique, envoyez une requête GET au point d’entrée /workloads/decisions tout en fournissant la valeur d’ID de charge de travail correspondante pour votre décision.

Format d’API

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

Requête

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

Réponse

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

Étapes suivantes next-steps

En suivant ce guide de l'API, vous avez vérifié l'état de la charge de travail et envoyé des offres à l'aide de l'API Batch Decisioning. Pour plus d'informations, consultez la présentation de la gestion des décisions.