Aturan Berbasis Jadwal

Pantau status iklan Anda dengan memeriksanya pada interval yang ditetapkan untuk melihat apakah iklan tersebut memenuhi kriteria evaluation_spec. Untuk Aturan Berbasis Jadwal, diperlukan schedule_spec tambahan.

curl \
-F 'name=Rule 1' \
-F 'evaluation_spec={
    ...
   }' \
-F 'execution_spec={
    ...
   }' \
-F 'schedule_spec={
     "schedule_type": "DAILY"
   }' \

-F "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<VERSION>/<AD_ACCOUNT_ID>/adrules_library

Spesifikasi Jadwal

schedule_spec suatu aturan menentukan seberapa sering Anda ingin aturan tersebut dijalankan. Kami menunjukkan interval ini dalam kolom schedule_type.

Jenis Jadwal	Deskripsi
`DAILY`	Menjalankan aturan pada pukul 00.00 dalam zona waktu akun iklan.
`HOURLY`	Menjalankan aturan pada setiap awal jam.
`SEMI_HOURLY`	Menjalankan aturan pada setiap awal setengah jam.
`CUSTOM` (Contoh)	Menjalankan aturan pada jadwal yang disesuaikan.

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. Satu-satunya persyaratan adalah harus ada setidaknya 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. Sebaliknya, gunakan `end_minute` untuk 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, gunakan `start_minute` untuk menentukan rentang waktu untuk menjalankan aturan. Jika `end_minute` sama dengan `start_minute`, ini juga 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, dan seterusnya, diakhiri dengan `6` sebagai hari Sabtu. Jika ini tidak diatur, aturan berjalan pada semua 7 hari berdasarkan `start_minute` dan, jika ada, `end_minute`.

Untuk informasi selengkapnya tentang cara menggunakan jenis jadwal CUSTOM, lihat Penjadwalan Lanjutan.

Berikut adalah contoh evaluation_spec. Aturan ini berlaku untuk semua objek dalam daftar id awal yang, dalam 7 hari terakhir, memiliki lebih dari 10000 impresi. Dalam hal ini, kita tidak memerlukan filter entity_type, karena kita telah mendefinisikan daftar statis objek awal menggunakan filter id tanpa awalan.

curl \
-F 'name=Rule 1' \
-F 'schedule_spec={
    ...
   }' \
-F 'evaluation_spec={
      "evaluation_type" : "SCHEDULE",
      "filters" : [
       {
         "field": "time_preset",
         "value": "LAST_7_DAYS",
         "operator": "EQUAL"
       },
       {
         "field": "effective_status",
         "value": ["ACTIVE"],
         "operator": "IN"
       },
       {
         "field": "id",
         "value": [101, 102, 103],
         "operator": "IN"
       },
       {
         "field": "impressions",
         "value": 10000,
         "operator": "GREATER_THAN"
       }
     ]
   }' \
-F 'execution_spec={
    ...
   }' \
-F "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<VERSION>/<AD_ACCOUNT_ID>/adrules_library

Berikut contoh lain. Aturan ini berlaku untuk semua set iklan di bawah kampanye iklan dengan ID 101, 102, 103 yang hanya menggunakan anggaran sepanjang masa promosi, dan dibuat kurang dari 48 jam terakhir. Dalam hal ini, kita tidak memerlukan filter time_preset, karena tidak ada filter Insight.

curl \
-F 'name=Rule 1' \
-F 'schedule_spec={
    ...
   }' \
-F 'evaluation_spec={
      "evaluation_type" : "SCHEDULE",
      "filters" : [
       {
         "field": "entity_type",
         "value": "ADSET",
         "operator": "EQUAL"
       },
       {
         "field": "campaign.id",
         "value": [101, 102, 103],
         "operator": "IN"
       },
       {
         "field": "budget_reset_period",
         "value": ["LIFETIME"],
         "operator": "IN"
       },
       {
         "field": "hours_since_creation",
         "value": 48,
         "operator": "LESS_THAN"
       },
     ]
   }' \
-F 'execution_spec={
    ...
   }' \
-F "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<VERSION>/<AD_ACCOUNT_ID>/adrules_library

Berikut adalah contoh execution_spec. Aturan ini meningkatkan anggaran semua objek yang cocok sebesar 10%, dengan batas eksekusi maksimum 5 kali. Artinya, untuk setiap objek yang berpotensi dicocokkan, masing-masing hanya dapat mengalami maksimal lima kali kenaikan anggaran sebesar 10%.

curl \
-F 'name=Rule 1' \
-F 'schedule_spec={
    ...
   }' \
-F 'evaluation_spec={
    ...
   }' \
-F 'execution_spec={
     "execution_type": "CHANGE_BUDGET",
     "execution_options": [
       {
         "field": "change_spec",
         "value": {
           "amount": 10,
           "unit": "PERCENTAGE"
         },
         "operator": "EQUAL"
       },
       {
         "field": "execution_count_limit",
         "value": 5,
         "operator": "EQUAL"
       }
     ]
   }' \
-F "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<VERSION>/<AD_ACCOUNT_ID>/adrules_library

Berikut contoh lain. Aturan ini menjeda semua objek yang cocok dan mengirimkan email ke daftar pengguna.

curl \
-F 'name=Rule 1' \
-F 'schedule_spec={
    ...
   }' \
-F 'evaluation_spec={
    ...
   }' \
-F 'execution_spec={
     "execution_type": "PAUSE",
     "execution_options": [
       {
         "field": "user_ids",
         "value": [1001, 1002],
         "operator": "EQUAL"
       }
     ]
   }' \
-F "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<VERSION>/<AD_ACCOUNT_ID>/adrules_library