Referensi action

Satu task menjalankan tepat satu action. AdOps menyediakan 11 action yang ditampilkan di action picker dalam tiga kelompok — General, Budget, dan Name/Text. Setiap action menyimpan parameternya di objek action_value bernomor, dan lima dari sebelas action juga menerima action frequency yang membatasi seberapa sering task itu boleh menyala pada campaign yang sama.

Referensi lengkap#

Action key	Label picker	Grup	Parameter	Frequency
notify	Notify	General	tidak ada	ya
start_campaign	Start	General	tidak ada	tidak
pause_campaign	Pause	General	tidak ada	tidak
delete_campaign	Delete	General	tidak ada	tidak
duplicate_campaign	Duplicate	General	tidak ada	ya
increase_budget_campaign	Increase budget	Budget	value_1 nominal atau id custom metric · value_2 Maximum budget cap · value_3 value / percent / custom_metric	ya
decrease_budget_campaign	Decrease budget	Budget	value_1 nominal atau id custom metric · value_2 Minimum budget cap · value_3 value / percent / custom_metric	ya
set_budget_campaign	Set budget	Budget	value_1 nominal atau id custom metric · value_3 custom_metric, selain itu nilai literal di value_1	ya
add_name_campaign	Add to name	Name/Text	value_1 mode TEXT / APPEND / OVERWRITE · value_2 separator · value_3 template teks, satu token per baris	tidak
remove_name_campaign	Remove from name	Name/Text	value_1 teks yang dihapus	tidak
replace_name_campaign	Replace text in name	Name/Text	value_1 teks yang dicari · value_2 teks pengganti	tidak

Action General#

Start, Pause, dan Delete masing-masing menuliskan status ke objek campaign — berturut-turut ACTIVE, PAUSED, dan DELETED. Ketiganya tanpa parameter. Ketiganya juga tidak menulis blok Before → After pada rule result, jadi buktinya di log adalah badge Executed dan action yang tercatat, bukan perubahan nilai.

Duplicate mengirim async batch request ke edge /{campaign_id}/copies milik Meta dengan deep_copy=true, sehingga Meta menggandakan seluruh struktur campaign di latar belakang. AdOps tidak menangkap id campaign baru hasil penggandaan.

Notify dicatat pada rule result dan muncul sebagai task di Rule Logs serta Activity Log. Pengiriman pesannya belum tersambung pada rilis engine saat ini, jadi jangan mengandalkannya sebagai kanal alerting.

Action Budget#

Ketiganya membaca ulang daily_budget campaign langsung dari Meta tepat sebelum menulis, alih-alih memercayai angka yang dibawa job.

value_3 menentukan cara value_1 dibaca:

• value — nominal tetap.
• percent — persentase dari daily budget saat ini, hanya untuk Increase dan Decrease. Set budget tidak punya jalur persentase.
• custom_metric — value_1 berisi id custom metric dan engine menghitungnya dari Google Sheet Anda saat eksekusi.

Budget proyeksi dibulatkan ke bilangan bulat, lalu dijepit. Kalau Increase budget akan melewati Maximum budget cap di value_2, engine menuliskan tepat nilai cap-nya. Kalau Decrease budget akan jatuh di bawah Minimum budget cap, yang ditulis tepat nilai minimumnya.

{
  "action": "increase_budget_campaign",
  "action_frequency": "2_hours",
  "action_value": { "value_1": 20, "value_2": 1000000, "value_3": "percent" }
}

Task itu menaikkan daily budget sebesar 20%, paling sering sekali tiap 2 jam per campaign, dan tidak pernah melewati Rp 1.000.000.

Action nama dan teks#

Add to name menyusun string dari template multi-baris di value_3, menggabungkan bagian-bagiannya dengan separator di value_2, lalu menempatkan hasilnya sesuai mode di value_1:

• TEXT menambahkan teks apa adanya.
• APPEND menambahkan setelah bot separator ✚.
• OVERWRITE mengganti seluruh isi setelah bot separator terakhir.

Baris yang dibungkus kurung kurawal diterjemahkan sebelum ditulis:

Token	Hasilnya
{date}	tanggal dalam format YYYY-MM-DD
{time}	jam dalam format HH:MM:SS
{metric|<field>|<period>}	nilai Insights live untuk period tersebut
{metric|<field>}	field yang dibaca langsung dari objek campaign
{metric|custom_metric|<id>}	hasil hitungan custom metric
{custom_metric|<id>}	sama, dalam bentuk singkat

Modal Insert Shortcode menyusunkannya untuk Anda: pilih tipe (Facebook Metric, Custom Metric, Date, atau Time), metrik, dan period, periksa preview-nya, lalu tekan Insert Shortcode.

Remove from name menghapus potongan teks di value_1. Replace text in name menukar potongan di value_1 dengan teks di value_2. Keduanya membaca ulang nama campaign live lebih dulu, menulis nama baru, dan mencatat pasangan Before → After pada rule result.

Action frequency#

Notify, Duplicate, dan tiga action budget menerima cooldown per task, terpisah dari seberapa sering rule-nya dievaluasi: 15 minutes, 30 minutes, 1 hour, 2 hours, 3 hours, 6 hours, 12 hours, Once a day, Once in 2 days, Once in 3 days, Once in a lifetime.

Jadi sebuah rule bisa mengecek tiap 15 menit sementara satu campaign hanya dinaikkan budget-nya sekali tiap 2 jam. Once in a lifetime menetapkan waktu eksekusi berikutnya ke tahun 2100 — cara sebuah template menandai campaign tepat sekali dan tidak pernah lagi.

Ketika cooldown menahan sebuah task, AdOps tidak diam saja: ia menulis hasil Skipped dengan alasan next_execute_not_reached beserta waktu task itu boleh berjalan lagi.

Level dan cakupan penulisan#

Action dieksekusi di level campaign. Mengubah level rule menjadi Ad sets hanya mengubah level pembacaan Insights dan dicatat pada hasilnya; itu tidak memberi Anda penulisan di level ad.