Spesifikasi Eksekusi

execution_spec aturan menentukan tindakan yang berlaku untuk semua objek yang lolos evaluasi. Jadwal dan Aturan Berbasis Pemicu mendukung tindakan yang berbeda. Tindakan terdaftar di bawah execution_type.

Jenis Eksekusi	Deskripsi
`NOTIFICATION`	Mengirimkan notifikasi permata ke pembuat aturan ini, atau daftar pengguna yang ditentukan dalam `user_ids`, jika opsi ini disediakan. Jenis Evaluasi yang Didukung:`SCHEDULE`, `TRIGGER`
`PAUSE`	Menjeda objek. Jenis Evaluasi yang Didukung:`SCHEDULE`, `TRIGGER`
`UNPAUSE`	Membatalkan jeda objek. Jenis Evaluasi yang Didukung:`SCHEDULE`, `TRIGGER`
`CHANGE_BUDGET`	Mengubah anggaran berdasarkan `change_spec` yang telah ditentukan. Ini hanya berlaku untuk set iklan. Jenis Evaluasi yang Didukung:`SCHEDULE`
`CHANGE_CAMPAIGN_BUDGET`	Mengubah anggaran berdasarkan `change_spec` yang telah ditentukan. Ini hanya berlaku untuk kampanye iklan. Jenis Evaluasi yang Didukung:`SCHEDULE`
`CHANGE_BID`	Mengubah penawaran berdasarkan `change_spec` yang ditentukan. Ini hanya berlaku untuk set iklan. Jenis Evaluasi yang Didukung:`SCHEDULE`
`ROTATE`	Menjeda iklan yang sedang aktif, dan mengaktifkan iklan berikutnya berdasarkan ID di set iklan. Memerlukan filter `id` dari set iklan, dan filter `entity_type` dari iklan. Jenis Evaluasi yang Didukung:`SCHEDULE`
`REBALANCE_BUDGET`	Menjeda objek yang sesuai dengan kriteria evaluasi, dan menyeimbangkan kembali anggarannya dengan anggaran lainnya berdasarkan `rebalance_spec` yang telah ditentukan. Ini hanya berlaku untuk set iklan. Jenis Evaluasi yang Didukung:`SCHEDULE`
`PING_ENDPOINT`	Mengirimkan ping ke langganan aplikasi melalui Webhooks. Lihat Aturan Berbasis Pemicu untuk detail selengkapnya tentang pengaturan. Jenis Evaluasi yang Didukung:`TRIGGER`

`execution_options`

Anda mungkin perlu memberikan informasi tambahan untuk melakukan beberapa tindakan ini. execution_spec menyediakan array execution_options opsional untuk menentukan parameter tambahan ini. Array berisi daftar objek execution_option, yang merupakan kamus dengan kunci field, value, dan operator persis seperti objekfilter Spesifikasi Evaluasi.

Aturan Berbasis Pemicu tidak memerlukan opsi eksekusi apa pun.

Di bawah ini, lihat opsi eksekusi yang didukung, nilai execution_type mana yang didukungnya, dan cara menyusunnya. Saat ini, satu-satunya operator yang didukung untuk semua opsi adalah EQUAL.

Kolom Opsi Eksekusi	Deskripsi
`user_ids`*	Penerima notifikasi Jewel untuk `NOTIFICATION`, atau penerima untuk email ringkasan Aturan Berbasis Jadwal untuk setiap `execution_type`. Jenis Eksekusi yang Didukung: SEMUA `execution_type` didukung oleh Aturan Berbasis Jadwal Nilai (Contoh):`array ([123, 456])`
`change_spec`	Menentukan `amount`, `limit`, `unit`, dan `target_field`. Diperlukan sebagai kamus untuk jenis yang didukung. Jika `target_field` ada, skala penawaran atau anggaran berdasarkan perbedaan antara nilai saat ini dari kolom target dan nilai target yang ditentukan dalam `amount`. `target_field` harus berupa filter Insight yang valid. Jenis Eksekusi yang Didukung:`CHANGE_BUDGET`, `CHANGE_BID` Nilai (Contoh):Contoh Spesifikasi Perubahan Aturan Iklan
`rebalance_spec`	Mendukung berbagai opsi yang menentukan bagaimana anggaran diseimbangkan kembali. Lihat contoh untuk detail selengkapnya. Jenis Eksekusi yang Didukung:`REBALANCE_BUDGET` Nilai (Contoh):Menyeimbangkan Kembali Aturan Iklan Anggaran
`execution_count_limit`	Menentukan frekuensi maksimum tindakan perubahan anggaran/penawaran dilakukan untuk setiap objek iklan untuk aturan tersebut. Jika tidak ditentukan, defaultnya adalah tanpa batas. Jenis Eksekusi yang Didukung:`CHANGE_BUDGET`, `CHANGE_BID` Nilai (Contoh): int (123)
`action_frequency`	Menentukan jumlah menit minimum hingga tindakan yang sama dapat dilakukan pada objek berdasarkan aturan. Contoh, jika nilainya adalah `10080` untuk aturan `CHANGE_BUDGET`, dan anggaran baru saja ditingkatkan berdasarkan aturan itu untuk objek A. Aturan itu tidak menambah anggaran untuk objek A setidaknya selama seminggu, bahkan jika objek A lolos evaluasi aturan selama minggu itu. Jenis Eksekusi yang Didukung:`CHANGE_BUDGET`, `CHANGE_BID` Nilai (Contoh): int (123)

`user_ids`

Jika user_ids disediakan untuk Aturan Berbasis Jadwal:

kami membuat email harian untuk meringkas tindakan yang dilakukan oleh aturan Anda dalam 24 jam terakhir
kami mengirimkan informasi ke daftar pengguna yang ditentukan di bawah user_ids
email dikirim pada pukul 12.30, menggunakan zona waktu akun iklan

Email ringkasan ini mengumpulkan notifikasi untuk semua aturan yang diikuti setiap pengguna. Jika tidak ada tindakan yang dilakukan oleh salah satu aturan berlangganan, pengguna tidak mendapatkan email untuk hari itu.