Controlar la evaluación de audiencias por lotes con horarios de lotes flexibles

AVAILABILITY
Los horarios flexibles por lotes están disponibles actualmente en Disponibilidad limitada. Para obtener más información, póngase en contacto con el Servicio de atención al cliente de Adobe.

La segmentación por lotes es un método de evaluación que permite mover los datos de perfil todos a la vez para crear una audiencia correspondiente. Anteriormente, estas audiencias por lotes dependían de un único trabajo de segmentación fija que se ejecutaba una vez al día.

Con los horarios de lotes flexibles, puede controlar cuándo se evalúan las audiencias, lo que le ofrece más flexibilidad para priorizar los tiempos de evaluación y así escalar mejor a volúmenes de audiencia más grandes.

Creación de una programación create-schedule

Para utilizar programas por lotes flexibles, primero deberá crear un programa para las audiencias. Puede crear una programación mediante la IU o la API de Experience Platform.

IU

Para crear una programación mediante la interfaz de usuario de Experience Platform, primero deberá acceder a la sección Evaluación dentro del espacio de trabajo del servicio de segmentación.

Seleccione Audiencias en la sección Cliente, seguidas de Evaluación.

Los botones Audiencias y Evaluación aparecen resaltados y muestran cómo acceder a la página Evaluación.

Aparecerá la página Evaluación, que muestra todas las programaciones disponibles actualmente en su organización. Seleccione Crear programación para empezar a crearla.

El botón Crear programación está resaltado en la página Evaluación.

Aparece la ventana emergente Crear programación. En esta ventana emergente, puede rellenar los detalles de la programación, incluido el nombre, la cadencia y la hora del día a la que desea que se ejecute. Después de escribir todos los detalles necesarios, selecciona Crear para continuar.

Se muestra la ventana emergente Crear programación.

API

Para crear una programación mediante la API de Experience Platform, deberá realizar una petición POST al extremo /schedules.

Formato de API

code language-http
POST /schedules

Solicitud

accordion
Una solicitud de ejemplo para crear una programación.
code language-shell
curl -X POST https://platform.adobe.io/data/core/ups/config/schedules \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'Content-Type: application/json' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}'
 -d '
{
    "name": "Weekly VIP refresh",
    "type": "batch_segmentation",
    "schedule": "0 0 10 * * ?",
    "properties": {
        "segments": [
            "sample-audience-1",
            "sample-audience-2"
        ]
    },
    "state": "active"
}'

Al crear una programación, debe proporcionar un nombre, un tipo, una programación, las audiencias que le pertenecen y su estado. Para obtener información más detallada sobre cómo crear una programación mediante la API, lea la guía de extremo de programaciones.

Respuesta

accordion
Una respuesta de ejemplo al crear una programación.
code language-json
{
  "id": "cd585edf-962d-420d-94ad-3be03e619ac2",
  "name": "Weekly VIP Refresh",
  "type": "batch_segmentation",
  "schedule": "0 0 10 * * ?",
  "frequency": "weekly",
  "state": "active",
  "properties": {
    "segments": ["sample-audience-1", "sample-audience-2"]
  }
}

Una respuesta correcta devuelve el estado HTTP 200 con información sobre la programación recién creada. El campo frequency se completa automáticamente y se basa en el schedule proporcionado.

Asignar audiencias a una programación assign-audience

Después de crear una programación, puede asignar audiencias adicionales a la programación anterior. Puede asignar audiencias mediante la interfaz de usuario o la API de Experience Platform.

IU

Para asignar audiencias a una programación mediante la interfaz de usuario de Experience Platform, seleccione el icono de puntos suspensivos junto a la programación, seguido de Programar audiencias.

El botón Programar audiencias está resaltado.

Se muestra la ventana emergente Programar audiencias. Seleccione las audiencias que desee agregar a la programación, seguidas de Schedule para confirmar los cambios de programación.

Se muestra la ventana emergente Programar audiencias.

API

Para asignar audiencias a una programación mediante la API de Experience Platform, deberá realizar una petición POST al extremo /schedules/add-audiences.

Formato de API

code language-http
POST /schedules/add-audiences

Solicitud

accordion
Una solicitud de ejemplo para añadir audiencias a una programación.
code language-shell
curl -X POST https://platform.adobe.io/data/core/ups/config/schedules/add-audiences \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'Content-Type: application/json' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -d '{
        "id": "cd585edf-962d-420d-94ad-3be03e619ac2",
        "segments": [
            "sample-audience-3",
            "sample-audience-4"
        ]
      }'

Cuando agregue audiencias a una programación, debe proporcionar el ID de programación así como los ID de las audiencias que desee agregar a la programación. Para obtener información más detallada sobre cómo agregar audiencias a una programación, lea la guía de extremo de programaciones.

Respuesta

accordion
Una respuesta correcta al añadir audiencias a una programación.
code language-json
{
    "added": ["sample-audience-3", "sample-audience-4"],
    "existing": [],
    "invalid": [],
    "segmentCount": {
        "previous": 2,
        "current": 4,
        "diff": 2
    }
}

Una respuesta correcta devuelve el estado HTTP 200 con información sobre las audiencias añadidas a la programación.

También puede asignar una programación a una audiencia durante la creación de audiencias. En Audience Builder, después de guardar la audiencia, vaya a la sección Programar de la sección de propiedades de audiencia y seleccione el icono de calendario .

Aparece la ventana emergente Programaciones de audiencias. En esta ventana emergente, puede asignar a qué programaciones debe pertenecer la audiencia.

Se muestra la ventana emergente Asignar programaciones, en la que se muestran las programaciones a las que pertenece una audiencia.

Ver la programación de una audiencia view-audience-schedule

Puede ver a qué programaciones pertenece una audiencia mediante la IU o la API de Experience Platform.

IU
note
NOTE
Solo puede ver las programaciones de las audiencias creadas con Generador de audiencias.

Para ver las programaciones a las que pertenece una audiencia mediante la interfaz de usuario de Experience Platform, ve a Portal de audiencias y selecciona la audiencia, seguida de Editar audiencia.

En Audience Builder, seleccione el icono de calendario . en la sección Schedule de la sección Audience properties para mostrar la ventana emergente Audience schedules. Esta ventana emergente muestra a qué programaciones pertenece la audiencia y le permite agregar o eliminar las programaciones a las que pertenece la audiencia.

Se muestra la ventana emergente Asignar programaciones, en la que se muestran las programaciones a las que pertenece una audiencia.

API

Para ver las programaciones a las que pertenece una audiencia mediante la API de Experience Platform, realice una petición POST al extremo /schedules/audience-map.

Formato de API

code language-http
POST /schedules/audience-map

Solicitud

accordion
Una solicitud de ejemplo para ver a qué programaciones pertenecen las audiencias enumeradas.
code language-shell
curl -X POST https://platform.adobe.io/data/core/ups/config/schedules/audience-map \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'Content-Type: application/json' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -d '{
        "segments": [
            "sample-audience-1",
            "sample-audience-2"
        ]
      }'

Para utilizar este punto de conexión, debe proporcionar los ID de las audiencias para las que desea ver las programaciones. Para obtener información más detallada sobre cómo ver las programaciones a las que pertenece una audiencia, lea la guía de extremo de programaciones.

Respuesta

accordion
Una respuesta correcta al recuperar las programaciones de las audiencias.
code language-json
{
  "audienceMap": {
    "sample-audience-1": ["cd585edf-962d-420d-94ad-3be03e619ac2"],
    "sample-audience-2": []
  },
  "schedules": {
    "cd585edf-962d-420d-94ad-3be03e619ac2": {
      "name": "Weekly VIP Refresh",
      "schedule": "0 0 10 * * ?",
      "frequency": "weekly"
    }
  }
}

Una respuesta correcta devuelve el estado HTTP 200 con información detallada sobre las programaciones a las que pertenecen las audiencias solicitadas.

Eliminación de audiencias de una programación remove-audience

Si desea eliminar audiencias de una programación ya creada, puede utilizar la interfaz de usuario o la API de Experience Platform.

IU

Para quitar audiencias de una programación mediante la interfaz de usuario de Experience Platform, seleccione el icono más junto a la programación, seguido de Programar audiencias.

El botón Programar audiencias está resaltado.

Se muestra la ventana emergente Programar audiencias. Seleccione las audiencias que desee eliminar de la programación, seguidas de Horario para confirmar los cambios de programación.

Se muestra la ventana emergente Programar audiencias.

API

Para quitar audiencias de una programación, deberá realizar una petición POST al extremo /schedules/remove-audiences.

Formato de API

code language-http
POST /schedules/remove-audiences

Solicitud

accordion
Una solicitud de ejemplo para eliminar audiencias de una programación
code language-shell
curl -X POST https://platform.adobe.io/data/core/ups/config/schedules/remove-audiences/
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}'
 -d '
 {
    "id": "cd585edf-962d-420d-94ad-3be03e619ac2",
    "segments": [
        "sample-audience-1"
    ]
 }
 '

Cuando elimine audiencias de una programación, debe proporcionar el ID de programación así como los ID de las audiencias que desee eliminar de la programación. Para obtener información más detallada sobre cómo quitar audiencias a una programación, lea la guía de extremo de programaciones.

Respuesta

accordion
Una respuesta correcta al eliminar audiencias de una programación.
code language-json
{
    "removed": ["sample-audience-1"],
    "existing": [],
    "invalid": [],
    "segmentCount": {
        "previous"
    }
}

Ejecutar una programación manualmente run-manually

En lugar de esperar a que se ejecute la programación, puede almacenar en déclencheur manualmente una programación existente para ejecutarla mediante la IU o la API de Experience Platform.

IU

Para ejecutar manualmente una programación en la interfaz de usuario de Experience Platform, seleccione el icono más junto a la programación que desee evaluar en la página Evaluación, seguido de Ejecutar programación.

El botón Ejecutar programación está resaltado.

Aparecerá una ventana emergente de confirmación. Seleccione Iniciar para comenzar inmediatamente la ejecución de la programación.

Se muestra la ventana emergente Ejecutar programación.

API

Para ejecutar manualmente una programación en la API de Experience Platform, deberá realizar una petición POST al extremo /schedules/trigger.

Formato de API

code language-http
POST /schedules/trigger

Solicitud

accordion
Una solicitud de muestra para almacenar en déclencheur la evaluación de una programación.
code language-shell
curl -X POST https://platform.adobe.io/data/core/ups/config/schedules/trigger \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'Content-Type: application/json' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -d '{
    "id": "cd585edf-962d-420d-94ad-3be03e619ac2"
    }'

Cuando almacene en déclencheur una evaluación de programación, debe proporcionar el ID de la programación que desea evaluar. Solo puede evaluar una programación a la vez. Para obtener información más detallada sobre cómo activar una evaluación de programación, lea la guía de extremo de programaciones.

Respuesta

Una respuesta correcta devuelve el estado HTTP 200 sin contenido.

Habilitar o deshabilitar una programación

Puede habilitar o deshabilitar una programación mediante la IU o la API de Experience Platform.

IU

Para habilitar o deshabilitar una programación mediante la interfaz de usuario de Experience Platform, seleccione el icono más que está junto a la programación. Si desea habilitar una programación deshabilitada actualmente, seleccione Habilitar. Si desea deshabilitar una programación habilitada actualmente, seleccione Deshabilitar.

El botón Deshabilitar programación está resaltado.

API

Para habilitar o deshabilitar una programación mediante la API de Experience Platform, deberá realizar una petición PATCH al extremo /schedules, proporcionando el identificador de la programación que desea actualizar.

Formato de API

code language-http
PATCH /schedules/{SCHEDULE_ID}

Solicitud

accordion
Una solicitud de ejemplo para actualizar una programación
code language-shell
curl -X PATCH https://platform.adobe.io/data/core/ups/config/schedules/cd585edf-962d-420d-94ad-3be03e619ac2 \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'Content-Type: application/json' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -d '[
        {
            "op": "replace",
            "path": "/state",
            "value": "inactive"
        }
      ]'

Al actualizar la programación, debe proporcionar la operación, la ruta y el valor para la programación. Si desea habilitar una programación deshabilitada, deberá establecer value en active. Si desea deshabilitar una programación habilitada, deberá establecer value en inactive. Para obtener información más detallada sobre cómo actualizar una programación, lea la guía de extremo de programaciones.

Respuesta

Una respuesta correcta devuelve el estado HTTP 204 sin contenido.

Próximos pasos

Después de leer esta guía, ahora sabe cómo utilizar los horarios de lotes flexibles mediante la API o la interfaz de usuario de Experience Platform. Para obtener más información sobre la interfaz de usuario Programaciones flexibles por lotes, lea la descripción general de la interfaz de usuario del servicio de segmentación. Para obtener más información sobre la API de programaciones, lea la guía de extremo de programaciones. Para saber cómo funciona la Programación flexible por lotes con su capacidad y créditos, lea la descripción general del uso y las capacidades de la licencia.

Vídeo video

El siguiente vídeo muestra cómo usar programaciones por lotes flexibles, describiendo cómo crear programaciones personalizadas, monitorizar trabajos de segmentación y administrar créditos dentro de la pestaña Evaluación.

Apéndice appendix

En el siguiente apéndice se enumera cómo funcionan las dependencias entre programas y las preguntas más frecuentes sobre las programaciones de lotes flexibles.

Dependencias de programación cruzada cross-schedule-dependencies

Si una audiencia se refiere a otra audiencia como una dependencia, esa dependencia puede arrastrar a esa audiencia a una programación a la que no pertenece.

Tenga en cuenta las cuatro audiencias y los dos horarios siguientes:

Anexo A: Audiencia 1, Audiencia 4
Anexo B: Audiencia 2, Audiencia 3

La audiencia 1 hace referencia a la audiencia 2 a través de una dependencia, por lo que la audiencia 1 necesita la pertenencia evaluada de la audiencia 2 para calcular la suya propia.

Cuando se ejecuta el Programa A, la Audiencia 1 y la Audiencia 4 lo evalúan, según lo esperado. Sin embargo, la audiencia 2 también se ejecuta, ya que es una dependencia de la audiencia 1.

Cuando se ejecuta el Programa B, la Audiencia 2 y la Audiencia 3 lo evalúan, según lo esperado. En este escenario, la Audiencia 1 no se evalúa, ya que la Audiencia 2 no depende de la Audiencia 1.

Como resultado, esto significa que las audiencias que dependen de otras audiencias (como la Audiencia 2 en el escenario anterior) pueden evaluarse más de una vez al día, una vez como parte de su propia evaluación programada y otra vez como parte de la programación de la audiencia que depende de la otra audiencia.

Preguntas frecuentes faq

¿Debo hacer algo para seguir usando la evaluación diaria que tengo actualmente?

Respuesta
No. La programación del sistema continúa ejecutándose automáticamente. Nada cambia a menos que cree una programación personalizada.

¿Se puede asignar una audiencia a más de una programación personalizada?

Respuesta
¡Sí! Se puede asignar una audiencia a más de una programación personalizada.

¿Pueden las audiencias de streaming o Edge usar programaciones personalizadas?

Respuesta
No. Las audiencias de streaming y Edge siempre se evalúan según la programación del sistema.

¿Puedo asignar una composición de audiencia a una programación personalizada?

Respuesta
No. Las composiciones de audiencias se evalúan automáticamente como parte de la programación del sistema. Esto incluye cualquier audiencia interna que forme parte de la composición.

¿Cuántas programaciones puedo ejecutar?

Respuesta
Puede ejecutar hasta 4 programaciones por día. Este(a) incluye la programación del sistema.

¿Necesito horarios de lotes flexibles para tener más de 4000 audiencias de lotes?

Respuesta
Sí. Se requieren horarios de lotes flexibles para tener 10 000 audiencias de lotes.

¿Costó algo crear una programación personalizada?

Respuesta
Se incluye una programación personalizada semanal (52 ejecuciones programadas) con Experience Platform. Además, la programación del sistema siempre es gratuita. Si desea crear programaciones personalizadas adicionales, las ejecuciones programadas adicionales consumirán créditos. Para obtener más información, lea la descripción general del uso y las capacidades de la licencia.

¿Cómo puedo ver si mi programación se ejecutó?

Respuesta
Puede ver si la programación se ejecutó dentro de la vista de monitorización del trabajo de segmentación. Seleccione Supervisión seguida de Panel, Audiencias y Trabajo de segmentación. Desde aquí, seleccione el icono de filtro junto al momento en que se ejecutó la programación para ver la lista de audiencias evaluadas por la programación.
recommendation-more-help
experience-platform-help-segmentation