Consegnare offerte tramite Batch Decisioning API deliver-offers-batch
Il Batch Decisioning API 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 il Batch Decisioning API, 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 che possano inviare offerte a un fornitore di consegna dei 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:
-
Esegui il Batch Decisioning API, che contiene due richieste:
-
A Richiesta Batch POST per avviare un carico di lavoro per elaborare in batch le selezioni delle offerte.
-
A 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 di frequenza: un batch viene eseguito dallo snapshot del profilo che si verifica una volta al giorno. Il Batch Decisioning L’API 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
Tutti Batch Decisioning Le richieste di richiedono le seguenti intestazioni oltre a quelle indicate nella Guida per gli sviluppatori API per la gestione delle decisioni:
Content-Type
:application/json
x-request-id
: stringa univoca che identifica la richiesta.x-sandbox-name
: nome della sandbox.x-sandbox-id
: ID della sandbox.
Avviare un processo batch start-a-batch-process
Per avviare un carico di lavoro per l'elaborazione in batch delle decisioni, effettuare una richiesta POST al /workloads/decisions
endpoint.
Formato API
POST {ENDPOINT_PATH}/{CONTAINER_ID}/workloads/decisions
{ENDPOINT_PATH}
https://platform.adobe.io/data/core/ode
{CONTAINER_ID}
e0bd8463-0913-4ca1-bd84-6309134ca1f6
Richiesta
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
}'
xdm:segmentIds
609028e4-e66c-4776-b0d9-c782887e2273
xdm:dataSetId
6196b4a1a63bd118dafe093c
xdm:propositionRequests
placementId
e activityId
xdm:activityId
xcore:offer-activity:1410cdcda196707b
xdm:placementId
xcore:offer-placement:1410c4117306488a
xdm:itemCount
1
xdm:includeContent
false
per impostazione predefinita. Se true
, il contenuto dell’offerta è incluso negli eventi decisionali del set di dati.false
Consulta la sezione Documentazione di Gestione delle decisioni per una panoramica dei concetti e delle proprietà principali.
Risposta
{
"@id": "47efef25-4bcf-404f-96e2-67c4f784a1f5",
"xdm:imsOrgId": "9GTO98D5F@AdobeOrg",
"xdm:containerId": "0948b1c5-fff8-3b76-ba17-909c6b93b5a2",
"ode:createDate": 1648078924834,
"ode:status": "QUEUED"
}
@id
5d0ffb5e-dfc6-4280-99b6-0bf3131cb8b8
xdm:imsOrgId
9GTO98D5F@AdobeOrg
xdm:containerId
0948b1c5-fff8-3b76-ba17-909c6b93b5a2
ode:createDate
1648078924834
ode:status
ode:status: "QUEUED"
Recuperare informazioni su una decisione batch retrieve-information-on-a-batch-decision
Per recuperare informazioni su una decisione specifica, invia una richiesta GET al /workloads/decisions
fornendo il corrispondente valore ID del carico di lavoro per la decisione.
Formato API
GET {ENDPOINT_PATH}/{CONTAINER_ID}/workloads/decisions/{WORKLOAD_ID}
{ENDPOINT_PATH}
https://platform.adobe.io/data/core/ode
{CONTAINER_ID}
e0bd8463-0913-4ca1-bd84-6309134ca1f6
{WORKLOAD_ID}
47efef25-4bcf-404f-96e2-67c4f784a1f5
Richiesta
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}'
Risposta
{
"@id": "f395ab1f-dfaf-48d4-84c9-199ad6354591",
"xdm:imsOrgId": "{IMS_ORG}",
"xdm:containerId": "0948b1c5-fff8-3b76-ba17-909c6b93b5a2",
"ode:createDate": 1648076994405,
"ode:status": "COMPLETED"
}
@id
5d0ffb5e-dfc6-4280-99b6-0bf3131cb8b8
xdm:imsOrgId
9GTO98D5F@AdobeOrg
xdm:containerId
0948b1c5-fff8-3b76-ba17-909c6b93b5a2
ode:createDate
1648076994405
ode:status
ode:status: "COMPLETED"
ode:statusDetail
Passaggi successivi next-steps
Seguendo questa guida API, hai controllato lo stato del carico di lavoro e hai consegnato le offerte utilizzando Batch Decisioning API. Per ulteriori informazioni, vedere panoramica sulla gestione delle decisioni.