Entrega de ofertas utilizando Batch Decisioning API

El Batch Decisioning La API permite a las organizaciones utilizar la funcionalidad de toma de decisiones para todos los perfiles de una audiencia determinada en una llamada. El contenido de la oferta para cada perfil de la audiencia se coloca en un conjunto de datos de Adobe Experience Platform, donde está disponible para flujos de trabajo por lotes personalizados.

Con el Batch Decisioning API, puede rellenar un conjunto de datos con las mejores ofertas para todos los perfiles de una audiencia de Adobe Experience Platform para los ámbitos de decisión. Por ejemplo, una organización puede querer ejecutar Batch Decisioning para que puedan enviar ofertas a un proveedor de entrega de mensajes. Estas ofertas se utilizan como contenido que se envía para la entrega de mensajes por lotes a la misma audiencia de usuarios.

Para ello, la organización debería:

• Ejecute el Batch Decisioning API, que contiene dos solicitudes:

  1. A Solicitud del POST del lote para iniciar una carga de trabajo para procesar por lotes las selecciones de ofertas.

  2. A Solicitud de GET por lotes para obtener el estado de carga de trabajo por lotes.

• Exporte el conjunto de datos a la API del proveedor de entrega de mensajes.

• Número de trabajos por lotes en ejecución por conjunto de datos: Se pueden ejecutar hasta cinco trabajos por lotes a la vez, por conjunto de datos. Cualquier otra solicitud por lotes con el mismo conjunto de datos de salida se agrega a la cola. Se selecciona un trabajo en cola para procesarlo una vez que el trabajo anterior ha terminado de ejecutarse.
• Límite de frecuencia: Un lote se ejecuta fuera de la instantánea de perfil que se produce una vez al día. El Batch Decisioning La API limita la frecuencia y siempre carga perfiles de la instantánea más reciente.

Introducción

Antes de utilizar esta API, asegúrese de completar los siguientes pasos previos.

Preparar la decisión

Para preparar una o más decisiones, asegúrese de haber creado un conjunto de datos, una audiencia y una decisión. Estos requisitos previos se detallan en esta sección.

Requisitos de API

Todo Batch Decisioning Las solicitudes de requieren los siguientes encabezados, además de los mencionados en la Guía para desarrolladores de API de Administración de decisiones:

• Content-Type: application/json
• x-request-id: una cadena única que identifica la solicitud.
• x-sandbox-name: Nombre de la zona protegida.
• x-sandbox-id: ID de la zona protegida.

Iniciar un proceso por lotes

Para iniciar una carga de trabajo para procesar las decisiones por lotes, realice una solicitud de POST al /workloads/decisions punto final.

Formato de API

POST {ENDPOINT_PATH}/{CONTAINER_ID}/workloads/decisions

Solicitud

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

Consulte la Documentación de Gestión de decisiones para obtener una descripción general de los conceptos y las propiedades principales.

Respuesta

{
    "@id": "47efef25-4bcf-404f-96e2-67c4f784a1f5",
    "xdm:imsOrgId": "9GTO98D5F@AdobeOrg",
    "xdm:containerId": "0948b1c5-fff8-3b76-ba17-909c6b93b5a2",
    "ode:createDate": 1648078924834,
    "ode:status": "QUEUED"
}

Recuperar información sobre una decisión por lotes

Para recuperar información sobre una decisión específica, realice una solicitud de GET al /workloads/decisions al tiempo que proporciona el valor de ID de carga de trabajo correspondiente para su decisión.

Formato de API

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

Solicitud

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

Respuesta

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

Pasos siguientes

Al seguir esta guía de API, ha comprobado el estado de la carga de trabajo y ha enviado ofertas utilizando Batch Decisioning API. Para obtener más información, consulte la información general sobre Administración de decisiones.