Erweiterte Planung

Dieses Dokument enthält genauere Beispiele für den schedule_typeCUSTOM.

Die Hauptdokumentation gibt Folgendes an:

Wenn der schedule_typeCUSTOM ist, musst du außerdem eine Liste individueller Zeitpläne oder Zeitpunkte, zu denen die Regel ausgeführt wird, angeben. In der schedule-Liste darf jede einzelne Spezifikation aus einer Kombination der folgenden Felder bestehen. Die einzige Bedingung besteht darin, dass jeder Eintrag mindestens start_minute oder days enthalten muss.

Feld	Beschreibung
`start_minute`	Zeit in Minuten nach 00:00 Uhr. Muss ein Vielfaches von 30 Minuten sein. Wenn dieser Wert festgelegt ist und keine `end_minute` vorhanden ist, bestimmt er die genaue Zeit, zu der die Regel ausgeführt wird. Ansonsten bestimmt `end_minute` den Zeitraum, in dem die Regel ausgeführt wird. Wenn dieser Wert nicht festgelegt ist, wird die Regel an jedem in `days` angegebenen Tag im Intervall `SEMI_HOURLY` ausgeführt.
`end_minute`	Zeit in Minuten nach 00:00 Uhr. Muss ein Vielfaches von 30 Minuten sein und nach `start_minute` liegen. Wenn dieser Wert festgelegt ist, bestimmt er mit `start_minute` den Zeitraum, in dem die Regel ausgeführt wird. Wenn `end_minute` mit `start_minute` identisch ist, bestimmt das auch den genauen Zeitpunkt, zu dem die Regel ausgeführt wird.
`days`	Liste der Tage, an denen die Regel ausgeführt wird. Jeder Tag muss ein Wert von `0-6` sein. `0` ist Sonntag, `1` ist Montag usw. Der letzte Wert `6` ist Samstag. Wenn dieser Wert nicht festgelegt ist, wird die Regel an allen 7 Wochentagen unter Berücksichtigung von `start_minute` und, wenn vorhanden, `end_minute` ausgeführt.

In diesem Beispiel siehst du, wie du mit der erweiterten Planung festlegst, dass die Regel täglich um 10:00 Uhr ausgeführt wird. Indem du days weglässt, gibst du an, dass diese Zeitplanspezifikation für jeden Tag gilt.

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

Beispiel

Hier siehst du ein Beispiel für eine Regel, die nur an Wochenenden alle 30 Minuten ausgeführt wird. Da start_minute nicht angegeben ist, wird die Regel alle halbe Stunde (SEMI_HOURLY) an den angegebenen Tagen ausgeführt.

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

Hier siehst du ein Beispiel für eine Regel, die nur mittwochs um 02:00 Uhr ausgeführt wird. Da end_minute nicht angegeben ist, wird die Regel nur zu einer bestimmten Uhrzeit und nicht an mehreren Zeiten ausgeführt.

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

Jeder einzelne Zeitplan wird unabhängig von den anderen Zeitplänen als ODER-Bedingung berechnet. Hier siehst du ein Beispiel für eine Regel, die an Werktagen den ganzen Tag lang, aber an Wochenenden nur zwischen 12:00 und 13:00 Uhr ausgeführt wird. Da hier end_minute angegeben ist, wird der Zeitraum von start_minute bis end_minute berücksichtigt.

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

Wenn du days in der zweiten Zeitplanspezifikation nicht angibst, funktioniert der Plan genauso, da die erste Spezifikation die Angabe von 12:00 bis 13:00 Uhr an Werktagen enthält.