Especificación de ejecución

El parámetro execution_spec de una regla determina la acción que se aplica a todos los objetos que superan la evaluación. Las reglas basadas en programaciones y en activadores admiten diferentes acciones. Las acciones se indican en execution_type.

Tipo de ejecución	Descripción
`NOTIFICATION`	Envía una notificación adornada al creador de esta regla o a la lista de usuarios especificada en `user_ids`, si se proporciona esta opción. Tipos de evaluación admitidos:`SCHEDULE` y `TRIGGER`.
`PAUSE`	Pausa los objetos. Tipos de evaluación admitidos:`SCHEDULE` y `TRIGGER`.
`UNPAUSE`	Reactiva los objetos. Tipos de evaluación admitidos:`SCHEDULE` y `TRIGGER`.
`CHANGE_BUDGET`	Cambia los presupuestos en función de un parámetro `change_spec` definido. Se aplica solo a los conjuntos de anuncios. Tipos de evaluación admitidos:`SCHEDULE`.
`CHANGE_CAMPAIGN_BUDGET`	Cambia los presupuestos en función de un parámetro `change_spec` definido. Se aplica solo a las campañas publicitarias. Tipos de evaluación admitidos:`SCHEDULE`.
`CHANGE_BID`	Cambia las pujas en función de un parámetro `change_spec` definido. Se aplica solo a los conjuntos de anuncios. Tipos de evaluación admitidos:`SCHEDULE`.
`ROTATE`	Pausa el anuncio activo actualmente y activa el siguiente según el identificador en el conjunto de anuncios. Requiere un filtro `id` de conjuntos de anuncios y un filtro `entity_type` de un anuncio. Tipos de evaluación admitidos:`SCHEDULE`.
`REBALANCE_BUDGET`	Pausa los objetos que coinciden con los criterios de evaluación y reajusta los presupuestos con respecto al resto en función de un parámetro `rebalance_spec` definido. Se aplica solo a los conjuntos de anuncios. Tipos de evaluación admitidos:`SCHEDULE`.
`PING_ENDPOINT`	Envía un ping a la suscripción de la aplicación mediante webhooks. Consulta Reglas basadas en activadores para obtener más información sobre la configuración. Tipos de evaluación admitidos:`TRIGGER`.

`execution_options`

Puede que necesites proporcionar información adicional para realizar algunas de estas acciones. El parámetro execution_spec proporciona una matriz execution_options opcional para especificar estos parámetros adicionales. La matriz contiene una lista de objetos execution_option, que son diccionarios con claves de field, value y operator, igual que los objetos filter de la especificación de evaluación.

Las reglas basadas en activadores no requieren ninguna opción de ejecución.

A continuación, consulta las opciones de ejecución admitidas, los valores de execution_type que admiten y la forma en que estructurarlas. Actualmente, el único operador admitido para todas las opciones es EQUAL.

Campo de opción de ejecución	Descripción
`user_ids`*	Destinatarios de las notificaciones adornadas de `NOTIFICATION` o destinatarios de los correos electrónicos de resumen de las reglas basadas en programaciones para cada `execution_type`. Tipos de ejecución admitidos: TODOS los valores de `execution_type` que admiten las reglas basadas en programaciones. Valor (ejemplo):`array ([123, 456])`.
`change_spec`	Especifica `amount`, `limit`, `unit` y `target_field`. Obligatorio como diccionario para los tipos admitidos. Si existe `target_field`, la escala de presupuesto o puja según la diferencia entre el valor actual del campo de destino y el valor de destino especificado en `amount`. El valor de `target_field` debe ser un filtro de insights válido. Tipos de ejecución admitidos:`CHANGE_BUDGET` y `CHANGE_BID`. Valor (ejemplo):ejemplos de la especificación de cambios de reglas de anuncios.
`rebalance_spec`	Admite diferentes opciones que determinan cómo se reajustan los presupuestos. Consulta este ejemplo para obtener más información. Tipos de ejecución admitidos:`REBALANCE_BUDGET`. Valor (ejemplo):reajustar las reglas de anuncios de presupuesto
`execution_count_limit`	Especifica el número máximo de veces que se realiza una acción de cambio de presupuesto o puja para cada objeto de anuncio individual de la regla. Si no se especifica, no hay ningún límite de forma predeterminado. Tipos de ejecución admitidos:`CHANGE_BUDGET` y `CHANGE_BID`. Valor (ejemplo): entero (123).
`action_frequency`	Especifica la cantidad mínima de minutos que deben pasar hasta que una regla pueda realizar la misma acción en un objeto. Por ejemplo, si el valor es `10080` para una regla `CHANGE_BUDGET` y dicha regla acaba de aumentar el presupuesto para el objeto A. La regla no aumenta el presupuesto para el objeto A durante al menos una semana, aunque el objeto A supere la evaluación de la regla durante esa semana. Tipos de ejecución admitidos:`CHANGE_BUDGET` y `CHANGE_BID`. Valor (ejemplo): entero (123).

`user_ids`

Si se proporcionan valores de user_ids para las reglas basadas en programaciones:

Generamos un correo electrónico diario para resumir las acciones realizadas por la regla en las últimas 24 horas.
Enviamos la información a la lista de usuarios especificada en user_ids.
El correo electrónico se envía a las 12:30, con la zona horaria de la cuenta publicitaria.

Este correo electrónico de resumen agrega las notificaciones de todas las reglas a las que cada usuario está suscrito. Si ninguna de las reglas suscritas realiza ninguna acción, el usuario no recibe el correo electrónico de ese día.