Planification avancée

Ce document fournit des exemples détaillés pour le schedule_typeCUSTOM.

Comme indiqué dans la documentation principale :

Si schedule_type est défini sur CUSTOM, vous devez renseigner la liste des calendriers personnalisés ou la fréquence d’exécution de la règle. Dans la liste schedule, chaque spécification peut comprendre un ou plusieurs des champs suivants, doit contenir au moins un champ start_minute ou days.

Champ	Description
`start_minute`	Temps en minutes après minuit. Par incréments de 30 minutes. En l’absence de `end_minute`, ce champ détermine l’heure exacte à laquelle la règle sera exécutée. Quand `end_minute` est précisé, il détermine la plage horaire d’exécution de la règle. Quand ce champ n’est pas utilisé, la règle est exécutée toutes les 30 minutes (`SEMI_HOURLY`) chaque jour spécifié dans le champ `days`.
`end_minute`	Temps en minutes après minuit. Par incréments de 30 minutes ; doit être ultérieur à `start_minute`. Quand il est précisé, il détermine avec `start_minute` la plage horaire d’exécution de la règle. Si les valeurs de `end_minute` et `start_minute` sont identiques, elles déterminent l’heure exacte à laquelle la règle sera exécutée.
`days`	Jours pendant lesquels la règle sera exécutée. Chaque jour correspond à une valeur comprise entre `0-6` : `0` correspond à dimanche, `1` à lundi, et ainsi de suite, jusqu’à `6` pour samedi. Si ce champ n’est pas utilisé, la règle sera exécutée chaque jour de la semaine en fonction des valeurs de `start_minute` et, le cas échéant, de `end_minute`.

Voici un exemple de planification avancée qui déclenche l’exécution d’une règle tous les jours à 10 h 00. Omettre days implique automatiquement que cette spécification sera appliquée tous les jours.

curl \
-F 'name=Test Advanced Scheduling Rule' \
-F 'schedule_spec={
     "schedule_type": "CUSTOM",
     "schedule": [
       {
         "start_minute": 600,
       }
     ]
   }' \
-F 'evaluation_spec={
     ...
   }' \
-F 'execution_spec={
     ...
   }' \
-F "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<VERSION>/<AD_ACCOUNT_ID>/adrules_library

Exemple

Dans cet exemple, la règle est exécutée toutes les 30 minutes, uniquement les week-ends. Omettre start_minute implique que la règle sera exécutée toutes les demi-heures (SEMI_HOURLY) les jours spécifiés.

curl \
-F 'name=Test Advanced Scheduling Rule' \
-F 'schedule_spec={
     "schedule_type": "CUSTOM",
     "schedule": [
       {
         "days": [0, 6]
       }
     ]
   }' \
-F 'evaluation_spec={
     ...
   }' \
-F 'execution_spec={
     ...
   }' \
-F "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<VERSION>/<AD_ACCOUNT_ID>/adrules_library

Dans cet exemple, la règle est exécutée tous les mercredis à 2 h 00. Omettre end_minute implique que la règle est exécutée à une heure précise, plutôt qu’à un intervalle spécifique.

curl \
-F 'name=Test Advanced Scheduling Rule' \
-F 'schedule_spec={
     "schedule_type": "CUSTOM",
     "schedule": [
       {
         "start_minute": 120,
         "days": [3]
       }
     ]
   }' \
-F 'evaluation_spec={
     ...
   }' \
-F 'execution_spec={
     ...
   }' \
-F "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<VERSION>/<AD_ACCOUNT_ID>/adrules_library

Chaque calendrier est calculé indépendant des autres calendriers avec l’opérateur logique OR. Dans cet exemple, la règle est exécutée toute la journée pendant les jours de semaine, mais uniquement entre 12 h et 13 h les week-ends. Ajouter end_minute implique que la règle est exécutée pendant une plage horaire comprise entre start_minute et end_minute.

curl \
-F 'name=Test Advanced Scheduling Rule' \
-F 'schedule_spec={
     "schedule_type": "CUSTOM",
     "schedule": [
       {
         "days": [1, 2, 3, 4, 5]
       },
       {
         "start_minute": 720,
         "end_minute": 780,
         "days": [0, 6]
       }
     ]
   }' \
-F 'evaluation_spec={
     ...
   }' \
-F 'execution_spec={
     ...
   }' \
-F "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<VERSION>/<AD_ACCOUNT_ID>/adrules_library

Omettre days dans le second calendrier a le même effet, car le premier calendrier inclut la plage 12–13 h les jours de semaine.