Consegnare offerte tramite l'API Batch Decisioning deliver-offers-batch
L'API Batch Decisioning consente alle organizzazioni di utilizzare la funzionalità di decisioning per tutti i profili in un determinato pubblico in una chiamata. Il contenuto dell’offerta per ogni profilo del pubblico viene inserito in un set di dati Adobe Experience Platform dove è disponibile per flussi di lavoro batch personalizzati.
Con l'API Batch Decisioning, puoi popolare un set di dati con le offerte migliori per tutti i profili in un pubblico Adobe Experience Platform per ambiti decisionali. Ad esempio, un'organizzazione potrebbe voler eseguire Batch Decisioning in modo da poter inviare offerte a un fornitore di recapito messaggi. Tali offerte vengono quindi utilizzate come contenuto inviato per la consegna di messaggi in batch allo stesso pubblico di utenti.
A tal fine, l’organizzazione:
-
Eseguire l'API Batch Decisioning, che contiene due richieste:
-
Richiesta POST batch per avviare un carico di lavoro per elaborare in batch le selezioni delle offerte.
-
Richiesta batch di GET per ottenere lo stato del carico di lavoro batch.
-
-
Esporta il set di dati nell’API del fornitore per la consegna dei messaggi.
- Numero di processi batch in esecuzione per set di dati: è possibile eseguire fino a cinque processi batch alla volta per set di dati. Eventuali altre richieste batch con lo stesso set di dati di output vengono aggiunte alla coda. Un processo in coda viene selezionato per l'elaborazione al termine dell'esecuzione del processo precedente.
- Limitazione della frequenza: viene eseguito un batch dello snapshot del profilo che si verifica una volta al giorno. L'API Batch Decisioning limita la frequenza e carica sempre i profili dallo snapshot più recente.
Introduzione getting-started
Prima di utilizzare questa API, assicurati di completare i seguenti passaggi preliminari richiesti.
Preparare la decisione prepare-decision
Per preparare una o più decisioni, assicurati di aver creato un set di dati, un pubblico e una decisione. Tali prerequisiti sono descritti in questa sezione.
Requisiti API api-requirements
Tutte le Batch Decisioning richieste richiedono le intestazioni seguenti oltre a quelle indicate nella Guida per gli sviluppatori API per la gestione delle decisioni:
Content-Type:application/jsonx-request-id: stringa univoca che identifica la richiesta.x-sandbox-name: nome della sandbox.
Avviare un processo batch start-a-batch-process
Per avviare un carico di lavoro per elaborare in batch le decisioni, effettuare una richiesta POST all'endpoint /workloads/decisions.
Formato API
POST {ENDPOINT_PATH}/workloads/decisions
{ENDPOINT_PATH}https://platform.adobe.io/data/core/dwmRichiesta
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:activityIdxdm:dataSetId6196b4a1a63bd118dafe093cxdm:includeContentfalse per impostazione predefinita. Se true, il contenuto dell'offerta viene incluso negli eventi di decisione del set di dati.falsexdm:itemCountxcore:offer-activity:1410cdcda196707bxdm:placementIdxcore:offer-placement:1410c4117306488axdm:propositionRequestsplacementId e activityIdxdm:segmentIds609028e4-e66c-4776-b0d9-c782887e2273Per una panoramica dei concetti e delle proprietà principali, consulta la documentazione sulla gestione delle decisioni.
Risposta
{
"@id": "47efef25-4bcf-404f-96e2-67c4f784a1f5",
"xdm:imsOrgId": "9GTO98D5F@AdobeOrg",
"ode:createDate": 1648078924834,
"ode:status": "QUEUED"
}
@id5d0ffb5e-dfc6-4280-99b6-0bf3131cb8b8xdm:imsOrgId9GTO98D5F@AdobeOrgode:createDate1648078924834ode:statusode:status: "QUEUED"Recuperare informazioni su una decisione batch retrieve-information-on-a-batch-decision
Per recuperare informazioni su una decisione specifica, effettua una richiesta GET all'endpoint /workloads/decisions fornendo il valore ID del carico di lavoro corrispondente per la decisione.
Formato API
GET {ENDPOINT_PATH}/workloads/decisions/{WORKLOAD_ID}
{ENDPOINT_PATH}https://platform.adobe.io/data/core/dwm{WORKLOAD_ID}47efef25-4bcf-404f-96e2-67c4f784a1f5Richiesta
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}'
Risposta
{
"@id": "f395ab1f-dfaf-48d4-84c9-199ad6354591",
"xdm:imsOrgId": "{IMS_ORG}",
"ode:createDate": 1648076994405,
"ode:status": "COMPLETED"
}
@id5d0ffb5e-dfc6-4280-99b6-0bf3131cb8b8xdm:imsOrgId9GTO98D5F@AdobeOrgode:createDate1648076994405ode:statusode:status: "COMPLETED"ode:statusDetailPassaggi successivi next-steps
Seguendo questa guida API, hai controllato lo stato del carico di lavoro e hai consegnato le offerte utilizzando l’API Batch Decisioning. Per ulteriori informazioni, consulta la panoramica sulla gestione delle decisioni.