Mengubah Spesifikasi Aturan Iklan

Halaman ini membahas change_spec secara lebih terperinci, khususnya tentang cara membangun opsi eksekusi dan cara menggunakan fitur yang lebih canggih.

change_spec digunakan untuk jenis eksekusi seperti CHANGE_BUDGET dan CHANGE_BID, dan berisi parameter berikut: amount, limit, unit, target_field.

Kolom	Deskripsi
`amount`	Wajib. Menentukan besar perubahan anggaran atau tawaran. Nilai parameter lain dalam `change_spec` menentukan bagaimana persisnya angka ini akan digunakan. Nilai yang Didukung: Nilai numerik, seperti `3000` atau `-50`
`limit`	Opsional. Menentukan jumlah anggaran atau tawaran maksimum atau minimum. Misalnya, jika anggaran atau tawaran dinaikkan, jumlah ini adalah batas atas. Jika `target_field` ada, ini menentukan rentang dari batas bawah ke batas atas nilai. Nilai yang Didukung: Mata uang, seperti `5000` untuk mewakili $50 USD, atau untuk `target_field`, rentang mata uang seperti `[4000, 6000]` untuk mewakili $40 hingga $60 USD.
`unit`	Wajib, kecuali jika `target_field` ada. Menentukan satuan untuk nilai `amount`. Misalnya, jika satuannya `PERCENTAGE`, `amount` sebesar `-50` adalah `-50%`. Nilai yang Didukung:`ACCOUNT_CURRENCY` atau `PERCENTAGE`
`target_field`	Opsional. Menentukan apakah akan menyesuaikan anggaran atau tawaran sebesar suatu nilai target atau tidak. Jika ini ada, `amount` adalah nilai target dari kolom target. Anggaran atau tawaran meningkat atau menurun secara proporsional, berdasarkan apakah nilai set iklan saat ini untuk kolom target lebih rendah atau lebih tinggi dari `amount`. Nilai yang Didukung: Kolom insight, seperti `cost_per_mobile_app_install` atau `mobile_app_purchase_roas`

Contoh

Berikut ini contoh aturan CHANGE_BUDGET yang menurunkan anggaran sebesar 30% untuk semua set iklan yang berkinerja rendah, dengan kami mendefinisikan kinerja rendah sebagai stabil memiliki frequency seumur hidup yang tinggi. Aturan ini hanya berjalan pada pukul 00.00 pada hari Selasa dan Jumat.

curl \
-F 'name=Test Change Budget Rule' \
-F 'schedule_spec={
     "schedule_type": "CUSTOM",
     "schedule": [
       {
          "start_minute": 0,
         "days": [2, 5]
       }
     ]
   }' \
-F 'evaluation_spec={
     "evaluation_type": "SCHEDULE",
     "filters": [
       {
         "field": "entity_type",
         "value": "ADSET",
         "operator": "EQUAL"
       },
       {
         "field": "time_preset",
         "value": "LIFETIME",
         "operator": "EQUAL"
       },
       {
         "field": "impressions",
         "value": 8000,
         "operator": "GREATER_THAN"
       },
       {
         "field": "frequency",
         "value": 5.0,
         "operator": "GREATER_THAN"
       }
     ]
   }' \
-F 'execution_spec={
     "execution_type": "CHANGE_BUDGET",
     "execution_options": [
       {
         "field": "change_spec",
         "value": {
           "amount": -30,
           "unit": "PERCENTAGE"
         },
         "operator": "EQUAL"
       },
     ]
   }' \
-F "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<VERSION>/<AD_ACCOUNT_ID>/adrules_library

Berikut ini contoh lain, yaitu tawaran disesuaikan setiap hari berdasarkan nilai target cost_per_mobile_app_install untuk set iklan 123.

Kami juga menambahkan filter rentang untuk cost_per_mobile_app_install untuk menyertakan jendela toleransi 10%. Dengan adanya filter ini, perubahan proporsional kecil tidak dilakukan, jika nilai saat ini cukup dekat dengan nilai target.

curl \
-F 'name=Test Change Bid Rule' \
-F 'schedule_spec={
     "schedule_type": "DAILY"
   }' \
-F 'evaluation_spec={
     "evaluation_type": "SCHEDULE",
     "filters": [
       {
         "field": "id",
         "value": [123],
         "operator": "IN"
       },
       {
         "field": "time_preset",
         "value": "LIFETIME",
         "operator": "EQUAL"
       },
       {
         "field": "mobile_app_install",
         "value": 100,
         "operator": "GREATER_THAN"
       },
       {
         "field": "cost_per_mobile_app_install",
         "value": [4.5, 5.5],
         "operator": "NOT_IN_RANGE"
       }
     ]
   }' \
-F 'execution_spec={
     "execution_type": "CHANGE_BID",
     "execution_options": [
       {
         "field": "change_spec",
         "value": {
           "amount": 5.0,
           "limit": [2.0, 10.0],
           "target_field": "cost_per_mobile_app_install"
         },
         "operator": "EQUAL"
       },
     ]
   }' \
-F "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<VERSION>/<AD_ACCOUNT_ID>/adrules_library

Sebagai contoh, jika nilai saat ini adalah 4.0, tawaran meningkat sebesar 25%, karena itu adalah selisih proporsional antara nilai target 5.0 dan nilai saat ini.

Batas ini menjaga agar penawaran tidak meningkat di atas 10.0 dan menurun di bawah 2.0.