Unterbreiten von Angeboten mithilfe der Batch Decisioning-API deliver-offers-batch
Mit der Batch Decisioning-API können Unternehmen die Entscheidungsfunktion mit einem einzigen Aufruf auf alle Profile in einer bestimmten Zielgruppe anwenden. Der Angebotsinhalt für jedes Profil in der Zielgruppe wird in einen Adobe Experience Platform-Datensatz platziert, über den er für benutzerdefinierte Batch-Workflows zur Verfügung steht.
Mit der Batch Decisioning-API können Sie einen Datensatz mit den besten Angeboten für alle Profile in einer Adobe Experience Platform-Zielgruppe für Entscheidungsumfänge auffüllen. Beispiel: Ein Unternehmen möchte Batch Decisioning ausführen, damit es Angebote an einen Nachrichtenversand-Anbieter senden kann. Diese Angebote werden dann als Inhalt verwendet, der für den Batch-Nachrichtenversand an dieselbe Benutzerzielgruppe gesendet wird.
Dazu muss das Unternehmen folgendermaßen vorgehen:
-
Die Batch Decisioning-API ausführen, die zwei Anfragen enthält:
-
Eine Batch-POST-Anfrage, um einen Workload zur Batch-Verarbeitung der Angebotsauswahl zu starten.
-
Eine Batch-GET-Anfrage, um den Status des Batch-Workloads abzurufen.
-
-
Den Datensatz an die Nachrichtenversand-API des Anbieters exportieren
- Die Anzahl der ausgeführten Batch-Vorgänge pro Datensatz: Pro Datensatz können bis zu fünf Batch-Vorgänge gleichzeitig ausgeführt werden. Alle anderen Batch-Anfragen mit demselben Ausgabedatensatz werden der Warteschlange hinzugefügt. Ein in die Warteschlange gestellter Vorgang wird zur Verarbeitung aufgenommen, sobald der vorherige Vorgang abgeschlossen ist.
- Frequenzlimitierung: Ein Batch wird auf Basis eines Profil-Snapshots ausgeführt, der einmal täglich erfolgt. Die Batch Decisioning-API begrenzt die Häufigkeit und lädt Profile immer aus dem neuesten Snapshot.
Erste Schritte getting-started
Bevor Sie diese API verwenden, müssen Sie die folgenden Schritte ausführen.
Entscheidungsvorbereitung prepare-decision
Um eine oder mehrere Entscheidungen vorzubereiten, stellen Sie sicher, dass Sie einen Datensatz, eine Zielgruppe und eine Entscheidung erstellt haben. Diese Voraussetzungen werden in diesem Abschnitt näher erläutert.
API-Anforderungen api-requirements
Alle Batch Decisioning-Anfragen erfordern zusätzlich zu den im Entwicklerhandbuch zur Entscheidungs-Management-API beschriebenen Kopfzeilen die folgenden Kopfzeilen:
Content-Type:application/jsonx-request-id: Eine eindeutige Zeichenfolge, mit der die Anfrage identifiziert wird.x-sandbox-name: Der Sandbox-Name.
Starten eines Batch-Prozesses start-a-batch-process
Um einen Workload zur Batch-Verarbeitung von Entscheidungen zu starten, stellen Sie eine POST-Anfrage an den Endpunkt /workloads/decisions.
API-Format
POST {ENDPOINT_PATH}/workloads/decisions
{ENDPOINT_PATH}https://platform.adobe.io/data/core/dwmAnfrage
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:segmentIds609028e4-e66c-4776-b0d9-c782887e2273xdm:dataSetId6196b4a1a63bd118dafe093cxdm:propositionRequestsplacementId und die activityId enthältxdm:activityIdxcore:offer-activity:1410cdcda196707bxdm:placementIdxcore:offer-placement:1410c4117306488axdm:itemCount1xdm:includeContentfalse festgelegt ist. Wenn true festgelegt wird, wird der Angebotsinhalt in die Entscheidungsereignisse des Datensatzes eingeschlossen.falseWeitere Informationen zu den wichtigsten Konzepten und Eigenschaften finden Sie in der Dokumentation zum Entscheidungs-Management.
Antwort
{
"@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"Abrufen von Informationen zu einer Batch-Entscheidung retrieve-information-on-a-batch-decision
Um Informationen zu einer bestimmten Entscheidung abzurufen, stellen Sie eine GET-Anfrage an den Endpunkt /workloads/decisions und geben Sie die entsprechende Workload-ID für Ihre Entscheidung an.
API-Format
GET {ENDPOINT_PATH}/workloads/decisions/{WORKLOAD_ID}
{ENDPOINT_PATH}https://platform.adobe.io/data/core/dwm{WORKLOAD_ID}47efef25-4bcf-404f-96e2-67c4f784a1f5Anfrage
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}'
Antwort
{
"@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:statusDetailNächste Schritte next-steps
Jetzt wissen Sie, wie Sie den Workload-Status überprüfen und Angebote über die Batch Decisioning-API bereitstellen können. Weitere Informationen finden Sie unter Übersicht über das Entscheidungs-Management.