Custom metric dari Google Sheets

Custom metric memungkinkan rule AdOps bertindak atas angka yang tidak pernah dilihat Meta. Anda mengarahkan AdOps ke sebuah Google Spreadsheet ID, nama sheet, kolom lookup, dan kolom nilai; saat evaluasi AdOps mencari baris yang kolom lookup-nya cocok dengan campaign id lalu mengembalikan isi kolom nilai baris itu sebagai metrik.

Ini untuk apa?#

Margin, harga pokok, revenue offline, level stok, atau target per campaign yang dipelihara tim finance. Angka apa pun yang disimpan manusia di spreadsheet bisa menjadi condition sebuah rule, nominal budget, atau token yang distempelkan ke nama campaign.

Bentuk yang paling lazim adalah satu baris per campaign:

campaign_id	target_roas	margin
23851234567890123	2.5	0.42
23851234567890456	3.0	0.31

Dengan Column ID diisi campaign_id dan Value Column diisi target_roas, sebuah rule bisa membandingkan Purchase ROAS live terhadap target yang berbeda per campaign dan yang disunting tim Anda di spreadsheet.

Membuat metriknya#

Buka Custom Metrics di bawah menu Rule pada sidebar lalu tekan + Add New. Form-nya terdiri dari dua kartu.

Basic Information meminta Metric Name, Google Spreadsheet ID, dan Description. Field spreadsheet memakai hint “Found in the spreadsheet URL” dengan keterangan “Leave empty if not using Google Sheets”.

Metrics Configuration dimulai dari pilihan Data Source Type — “Select source type” atau “Google Sheets”. Memilih Google Sheets memunculkan Sheet Name, Column ID, dan Value Column.

Tekan Create Metric untuk menyimpan, atau Save as Draft untuk melanjutkannya nanti. Dalam mode sunting header-nya berbunyi Update Custom Metrics, tombol utamanya menjadi Update Metric, dan Save as Draft disembunyikan.

Kalau validasi gagal#

AdOps membaca sheet sebelum menyimpan dan memastikan kedua kolomnya ada. Kalau tidak ada, modal merah Google Sheets Validation Failed memuat setiap masalah — misalnya sebuah Column ID tidak ditemukan pada sheet tertentu, diikuti daftar kolom yang benar-benar ada — plus checklist How to fix.

Dua penyebab yang paling layak dicek lebih dulu: spreadsheet yang tidak bisa dibuka AdOps, dan nama kolom yang tidak persis sama dengan header sheet, termasuk soal huruf besar-kecil dan spasi di ujung.

Bagaimana angkanya dibaca saat rule berjalan#

AdOps mengambil sheet lewat endpoint CSV export milik Google dengan timeout 30 detik. Kalau gagal, ia mencoba lagi lewat Sheets API, dan kalau Google sama sekali tidak bisa dihubungi, ia melayani baris terakhir yang tersimpan untuk sheet tersebut.

Baris-baris itu juga disimpan di cache memori dengan kunci spreadsheet dan nama sheet, dengan jendela dua menit yang dihitung sejak akses terakhir. Itulah yang membuat ratusan campaign dalam satu batch berbagi satu pembacaan spreadsheet. Artinya juga jendela tersebut bisa terus memanjang saat diakses terus-menerus, jadi perlakukan custom metric sebagai angka yang diperbarui dalam hitungan menit, bukan detik.

Karena fallback MongoDB itu ada, spreadsheet yang izin berbaginya sudah dicabut masih bisa menghasilkan angka dari baris tersimpan. Setelah mengubah izin sebuah sheet, simpan ulang metriknya di AdOps untuk memastikan validasinya masih lolos.

Memakainya di dalam rule#

Setiap metric picker di rule builder punya dua tab: Meta Ads dan Custom metrics. Sebuah custom metric bisa menjadi:

• metrik pada sebuah condition,
• metrik pembanding pada condition antarmetrik,
• nilai untuk action budget, dengan menyetel value_3 ke custom_metric,
• token di dalam template Add to name, ditulis {custom_metric|<id>}.

Rule yang tersimpan menerjemahkan id menjadi nama metrik, sehingga ringkasan task terbaca “Blended ROAS” alih-alih id database, dan substitusi yang sama terjadi di log eksekusi. Id yang tidak lagi bisa diterjemahkan ditampilkan merah — itu tanda sebuah metrik dihapus padahal masih dirujuk sebuah rule.