Especificaciones de ejecución

La execution_spec de una regla determina la acción que aplica a todos los objetos que pasan la evaluación. Las reglas basadas en programación y activación admiten diferentes acciones. Las acciones se enumeran en execution_type.

Tipo de ejecución Descripción

NOTIFICATION

Envía una notificación destacada al creador de la regla o a la lista de usuarios especificada enuser_ids, si se proporciona esa opción.


Tipos de evaluación admitidos:SCHEDULE, TRIGGER

PAUSE

Pausa los objetos.


Tipos de evaluación admitidos:SCHEDULE, TRIGGER

UNPAUSE

Anula la pausa de los objetos.


Tipos de evaluación admitidos:SCHEDULE, TRIGGER

CHANGE_BUDGET

Cambia los presupuestos en función de un change_spec definido. Se aplica a conjuntos de anuncios únicamente.


Tipos de evaluación admitidos:SCHEDULE

CHANGE_CAMPAIGN_BUDGET

Cambia los presupuestos en función de un change_spec definido. Se aplica a campañas de anuncios únicamente.


Tipos de evaluación admitidos:SCHEDULE

CHANGE_BID

Cambia las pujas en función de un change_spec definido. Se aplica a conjuntos de anuncios únicamente.


Tipos de evaluación admitidos:SCHEDULE

ROTATE

Pausa el anuncio activo actualmente y activa el siguiente anuncio por identificador del 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 el criterio de evaluación y reequilibra sus presupuestos respecto del resto en función de un rebalance_spec definido. Se aplica a conjuntos de anuncios únicamente.


Tipos de evaluación admitidos:SCHEDULE

PING_ENDPOINT

Envía un ping a la suscripción de la aplicación a través de Webhooks. Consulta Reglas basadas en activación 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. execution_spec ofrece 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, al igual que los objetos filter de las especificaciones de evaluación.

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

A continuación, puedes ver las opciones de ejecución admitidas, qué valores de execution_type admiten y cómo estructurarlas. Por el momento, el único operador admitido para todas las opciones es EQUAL.

Campo de opción de ejecución Descripción

user_ids*

Los destinatarios de las notificaciones destacadas de NOTIFICATION o los destinatarios de correos electrónicos de resumen de reglas basadas en programación por cada execution_type.


Tipos de ejecución admitidos: TODOS los execution_type admitidos por las reglas basadas en programación


Valor (ejemplo):array ([123, 456])

change_spec

Especifica amount, limit, unit y target_field. Obligatorio como diccionario de los tipos admitidos. Si hay un target_field, es la escala de puja o presupuesto basada en la diferencia entre el valor actual del campo de objetivo y el valor objetivo especificado en amount. target_field debe ser un filtro de estadísticas válido.


Tipos de ejecución admitidos:CHANGE_BUDGET, CHANGE_BID


Valor (ejemplo):ejemplos de especificaciones de cambios en reglas de anuncios

rebalance_spec

Admite diferentes opciones que determinan cómo se reequilibran los presupuestos. Consulta este ejemplo para obtener más información.


Tipos de ejecución admitidos:REBALANCE_BUDGET


Valor (ejemplo):Reglas de anuncios de reequilibrio del presupuesto

execution_count_limit

Especifica el número máximo de veces que se toma una acción de cambio de presupuesto/puja por cada objeto publicitario individual de la regla. Si no se especifica, no tiene límite predeterminado.


Tipos de ejecución admitidos:CHANGE_BUDGET, CHANGE_BID


Valor (ejemplo): int (123)

action_frequency

Especifica la cantidad mínima de minutos que deben transcurrir para 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 el presupuesto aumentó en esa regla para el objeto A. Esa regla no aumenta el presupuesto para el objeto A por, como mínimo, una semana, incluso si el objeto A aprueba la evaluación de la regla durante esa semana.


Tipos de ejecución admitidos:CHANGE_BUDGET, CHANGE_BID


Valor (ejemplo): int (123)

user_ids

Si se proporcionan user_ids para reglas basadas en programación:

  • Generamos un correo electrónico diario para resumir las acciones realizadas por tu regla durante 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 a. m, según la zona horaria de la cuenta publicitaria.

Este correo electrónico de resumen reúne todas las notificaciones de todas las reglas a las que el usuario está suscripto. Si no se realizan acciones en ninguna de las reglas a las que está suscripto, el usuario no recibe un correo electrónico ese día.