Spécification d’exécution

La valeur execution_spec d’une règle détermine l’action appliquée à tous les objets qui réussissent l’évaluation. Les règles avec calendrier et avec déclencheur prennent en charge différentes actions. Ces actions sont répertoriées sous execution_type.

Type d’exécution	Description
`NOTIFICATION`	Envoie une notification avec icône au créateur de la règle, ou à la liste d’utilisateur·ices spécifiée dans `user_ids`, si cette option est fournie. Types d’évaluation pris en charge :`SCHEDULE`, `TRIGGER`
`PAUSE`	Met les objets en pause. Types d’évaluation pris en charge :`SCHEDULE`, `TRIGGER`
`UNPAUSE`	Réactive les objets. Types d’évaluation pris en charge :`SCHEDULE`, `TRIGGER`
`CHANGE_BUDGET`	Modifie les budgets en fonction d’une valeur `change_spec` définie. Ceci s’applique uniquement aux ensembles de publicités. Types d’évaluation pris en charge :`SCHEDULE`
`CHANGE_CAMPAIGN_BUDGET`	Modifie les budgets en fonction d’une valeur `change_spec` définie. Ceci s’applique uniquement aux campagnes publicitaires. Types d’évaluation pris en charge :`SCHEDULE`
`CHANGE_BID`	Modifie les enchères en fonction d’une valeur `change_spec` définie. Ceci s’applique uniquement aux ensembles de publicités. Types d’évaluation pris en charge :`SCHEDULE`
`ROTATE`	Met la publicité actuellement active en pause et active la publicité suivante (dans l’ordre des ID) de l’ensemble de publicités. Nécessite un filtre `id` pour les ensemble de publicités et un filtre `entity_type` pour les publicités. Types d’évaluation pris en charge :`SCHEDULE`
`REBALANCE_BUDGET`	Met en pause les objets qui correspondent aux critères d’évaluation et rééquilibre les budgets correspondants vers les autres en fonction d’une valeur `rebalance_spec` définie. Ceci s’applique uniquement aux ensembles de publicités. Types d’évaluation pris en charge :`SCHEDULE`
`PING_ENDPOINT`	Envoie un ping à l’abonnement de l’application via Webhooks. Reportez-vous à Règles avec déclencheur pour en savoir plus sur la configuration. Types d’évaluation pris en charge :`TRIGGER`

`execution_options`

Vous devrez peut-être fournir des informations supplémentaires pour effectuer certaines actions. execution_spec fournit un tableau execution_options facultatif qui permet de définir ces paramètres supplémentaires. Le tableau contient une liste d’objets execution_option. Il s’agit de dictionnaires comportant les clés field, value et operator, comme avec les objets filter de la spécification d’évaluation.

Les règles avec déclencheur ne requièrent pas d’options d’exécution.

Vous trouverez ci-après les options d’exécution prises en charge, les valeurs execution_type qu’elles prennent en charge et la façon de les structurer. À l’heure actuelle, le seul opérateur pris en charge pour toutes les options est EQUAL.

Champ d’option d’exécution	Description
`user_ids`*	Destinataires des notifications avec icône pour `NOTIFICATION` ou des e-mails récapitulatifs des règles avec calendrier pour chaque valeur `execution_type`. Types d’exécution pris en charge : TOUTES les valeurs `execution_type` prises en charge par les règles avec calendrier Valeur (exemple) :`array ([123, 456])`
`change_spec`	Indique `amount`, `limit`, `unit` et `target_field`. Requis en tant que dictionnaire pour les types pris en charge. Si `target_field` existe, redimensionnement de l’enchère ou du budget en fonction de la différence entre la valeur actuelle du champ cible et la valeur cible indiquée dans `amount`. La valeur `target_field` doit être un filtre statistique valide. Types d’exécution pris en charge :`CHANGE_BUDGET`, `CHANGE_BID` Valeur (exemple) :Spécification de modification des règles publicitaires, Exemples
`rebalance_spec`	Prend en charge différentes options qui déterminent la façon dont les budgets sont rééquilibrés. Consultez l’exemple pour en savoir plus. Types d’exécution pris en charge :`REBALANCE_BUDGET` Valeur (exemple) :Règles publicitaires avec rééquilibrage du budget
`execution_count_limit`	Indique le nombre maximal de fois où une action de modification de budget ou d’enchère peut être effectuée sur chaque objet publicitaire pour la règle. Si ce paramètre n’est pas précisé, aucune limite n’est appliquée. Types d’exécution pris en charge :`CHANGE_BUDGET`, `CHANGE_BID` Valeur (exemple) : int (123)
`action_frequency`	Indique la durée minimale (en minutes) devant s’écouler avant que la même action puisse être effectuée sur un objet par une règle. Par exemple, si la valeur d’une règle `CHANGE_BUDGET` est `10080` et que le budget de l’objet A vient d’être augmenté par cette règle, cette dernière n’augmentera pas le budget de l’objet A pendant au moins une semaine, même si cet objet réussit l’évaluation de la règle au cours de la semaine. Types d’exécution pris en charge :`CHANGE_BUDGET`, `CHANGE_BID` Valeur (exemple) : int (123)

`user_ids`

Si des valeurs user_ids sont fournies pour des règles avec calendrier :

nous générons un e-mail quotidien récapitulant les actions réalisées par votre règle au cours des dernières 24 heures
nous envoyons les informations aux utilisateur·ices répertorié·es dans la liste indiquée sous user_ids
l’e-mail est envoyé à 0:30 (fuseau horaire du compte publicitaire)

Cet e-mail récapitulatif regroupe les notifications correspondant à toutes les règles auxquelles chaque utilisateur·ice est abonné·e. Si aucune des règles faisant l’objet d’un abonnement n’effectue d’action, l’utilisateur·ice ne reçoit pas d’e-mail ce jour-là.