Unterbreiten von Angeboten mithilfe der Batch Decisioning-API

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:

  1. Eine Batch-POST-Anfrage, um einen Workload zur Batch-Verarbeitung der Angebotsauswahl zu starten.

  2. 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

Bevor Sie diese API verwenden, müssen Sie die folgenden Schritte ausführen.

Entscheidungsvorbereitung

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

Alle Batch Decisioning-Anfragen erfordern zusätzlich zu den im Entwicklerhandbuch zur Entscheidungs-Management-API beschriebenen Kopfzeilen die folgenden Kopfzeilen:

• Content-Type: application/json
• x-request-id: Eine eindeutige Zeichenfolge, mit der die Anfrage identifiziert wird.
• x-sandbox-name: Der Sandbox-Name.
• x-sandbox-id: Die Sandbox-ID.

Starten eines Batch-Prozesses

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}/{CONTAINER_ID}/workloads/decisions

Anfrage

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

Weitere 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",
    "xdm:containerId": "0948b1c5-fff8-3b76-ba17-909c6b93b5a2",
    "ode:createDate": 1648078924834,
    "ode:status": "QUEUED"
}

Abrufen von Informationen zu einer Batch-Entscheidung

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}/{CONTAINER_ID}/workloads/decisions/{WORKLOAD_ID}

Anfrage

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

Antwort

{
    "@id": "f395ab1f-dfaf-48d4-84c9-199ad6354591",
    "xdm:imsOrgId": "{IMS_ORG}",
    "xdm:containerId": "0948b1c5-fff8-3b76-ba17-909c6b93b5a2",
    "ode:createDate": 1648076994405,
    "ode:status": "COMPLETED"
}

Nächste Schritte

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.