Penjadwalan Lanjutan

Dokumen ini berisi beberapa contoh schedule_type jenis CUSTOM secara lebih lengkap.

Sebagaimana dirujuk dari dokumentasi utama:

Jika schedule_type merupakan CUSTOM, Anda juga harus menentukan daftar jadwal khusus, atau kapan saja aturan tersebut harus dijalankan. Dalam daftar schedule, setiap spesifikasi dapat terdiri dari kombinasi kolom berikut, dengan satu-satunya persyaratan adalah harus ada start_minute atau days di setiap entri.

Kolom	Deskripsi
`start_minute`	Waktu dalam menit setelah pukul 00.00. Harus kelipatan 30 menit. Jika ini diatur dan tidak ada `end_minute`, ini menetapkan waktu persis untuk menjalankan aturan. Jika tidak, ini bersama `end_minute` akan menentukan rentang waktu untuk menjalankan aturan. Jika ini tidak diatur, aturan berjalan `SEMI_HOURLY` setiap hari selama `days`.
`end_minute`	Waktu dalam menit setelah pukul 00.00. Harus kelipatan 30 menit dan setelah `start_minute`. Jika diatur, ini bersama `start_minute` akan menentukan rentang waktu untuk menjalankan aturan. Jika `end_minute` sama dengan `start_minute`, hal ini juga akan menentukan waktu persis untuk menjalankan aturan.
`days`	Daftar hari untuk menjalankan aturan. Setiap hari harus merupakan nilai `0-6`. `0` adalah hari Minggu, `1` adalah hari Senin, ..., `6` adalah hari Sabtu. Jika ini tidak diatur, aturan akan dijalankan selama 7 hari berdasarkan `start_minute` dan, jika ada, `end_minute`.

Berikut ini contoh penggunaan Penjadwalan Lanjutan untuk menjadwalkan aturan agar berjalan setiap hari pada pukul 10.00. Dengan menghilangkan days, kita secara otomatis menyimpulkan bahwa spesifikasi jadwal ini akan berlaku untuk setiap hari.

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

Contoh

Berikut ini contoh aturan yang berjalan setiap 30 menit hanya pada akhir pekan. Dengan menghilangkan start_minute, kita menyimpulkan bahwa aturan akan dijalankan SEMI_HOURLY untuk hari yang ditentukan.

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

Berikut ini contoh aturan yang hanya berjalan pada hari Rabu pukul 02.00. Dengan menghilangkan end_minute, kita menyimpulkan bahwa aturan hanya berjalan pada satu waktu tertentu, bukan selama rentang waktu tertentu.

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

Setiap jadwal dihitung secara mandiri sebagai OR dengan jadwal lainnya. Berikut ini contoh aturan yang berjalan sepanjang hari pada hari kerja, tetapi hanya pukul 12.00-13.00 pada akhir pekan. Dengan adanya end_minute di sini, kita sekarang melihat rentang waktu dari start_minute ke 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

Perhatikan, tidak menentukan days dalam spesifikasi jadwal kedua juga akan berfungsi sama, karena spesifikasi pertama mencakup pukul 12.00-13.00 pada hari kerja.