高度なスケジュール

このドキュメントでは、CUSTOMのschedule_typeの例をより詳しく紹介します。

schedule_typeがCUSTOMの場合、カスタムスケジュールのリストまたはルール実行のタイミングも指定する必要があります。scheduleリストでは、それぞれの個別の指定は以下のフィールドの組み合わせで構成できます。唯一の要件は、各エントリに少なくとも1つのstart_minuteまたはdaysが存在することです。

フィールド	説明
`start_minute`	午前0時からの経過分数。30分の倍数でなければなりません。これが設定されていて`end_minute`が存在しない場合、この値によってルール実行の正確な時刻が決定されます。それ以外の場合は、`end_minute`を使ってルール実行の時刻範囲が決定されます。これが設定されていない場合、ルールは`days`で指定されているそれぞれの日に、`SEMI_HOURLY`で実行されます。
`end_minute`	午前0時からの経過分数。30分の倍数でなければならず、`start_minute`より後でなければなりません。これを設定する場合は、`start_minute`を使ってルール実行の時刻範囲が決定されます。`end_minute`が`start_minute`と同じ場合、この値によりルール実行の正確な時刻も決まります。
`days`	ルールを実行する日のリスト。どの日も`0-6`の範囲の値でなければなりません。`0`は日曜日、`1`は月曜日、以降同様で、`6`が土曜日です。これが設定されていない場合、ルールはすべての曜日に、`start_minute`および(存在する場合は)`end_minute`に基づいて実行されます。

高度なスケジュールを使って、毎日午前10時に実行するルールの例を次に示します。daysを省略すると、自動的にこのスケジュール指定は毎日適用されます。

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

例

週末にだけ30分ごとに実行されるルールの例を次に示します。start_minuteを省略すると、指定された日にルールはSEMI_HOURLYとして実行されます。

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

水曜日の午前2時にしか実行されないルールの例を次に示します。end_minuteを省略すると、ルールは時間範囲ではなく特定の時間にのみ実行されます。

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

それぞれの個別のスケジュールは、他のスケジュールとのORとして独立して計算されます。平日は終日、週末は正午から午後1時のみに実行されるルールの例を次に示します。ここにend_minuteが指定されていると、時間範囲がstart_minuteから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

2番目のスケジュール指定でdaysを指定しなかった場合、最初の指定に週末の正午から午後1時が含まれているため、同等の動作になる点にご注意ください。