Jawaban singkat: Google Ads API v26, dirilis 14 Oktober 2026, memerlukan audit integrasi sebelum upgrade. Field enhanced_conversions_for_leads_enabled dihapus; pembacaan konfigurasi Enhanced Conversions beralih ke enablement_setting. Versi ini juga menambah effective_enablement_setting, kategori MESSAGE_LEAD, dan tipe atribusi CLICK. Jangan sekadar mengganti nomor versi SDK: periksa query, pemetaan enum, serta arti indikator dashboard yang dibaca tim pemasaran.
Panduan ini ditujukan untuk bisnis Indonesia dan agensi yang memakai konektor, laporan otomatis, atau aplikasi internal berbasis Google Ads API. Ini bukan pengumuman bahwa semua akun Indonesia mendapat fitur iklan baru. Pengguna antarmuka Google Ads tanpa integrasi API tidak perlu menjalankan migrasi kode hanya karena rilis ini. Tidak ada benchmark, hasil kampanye, atau pengalaman pelanggan yang diklaim.
Siapa yang perlu memeriksa integrasi sekarang?
Mulai dari pemilik sistem, bukan daftar fitur. Tanyakan apakah laporan mengambil data langsung melalui API, melalui vendor konektor, atau melalui ekspor manual. Sebuah spreadsheet bisa terlihat sederhana tetapi tetap bergantung pada konektor yang menyimpan query lama. Sebaliknya, dashboard yang mengambil data dari gudang data mungkin tidak memanggil API pada saat pengguna membukanya.
Buat inventaris jalur data: akun pengiklan, manager account, aplikasi pengambil data, penyimpanan, lalu laporan akhir. Catat versi API pada masing-masing konektor. Jangan menganggap satu pembaruan paket otomatis mengubah semua pekerjaan terjadwal. Pemilik agensi perlu memastikan akun klien tidak tercampur ketika membaca konfigurasi konversi lintas akun.
Artikel ini berbeda dari panduan konversi offline dan lead berkualitas. Panduan tersebut membahas alur pengukuran bisnis. Di sini fokusnya kompatibilitas API dan uji regresi laporan. Perbaikan migrasi tidak otomatis memperbaiki kualitas lead atau membuktikan atribusi penjualan.
Apa perubahan yang dapat membuat query lama gagal?
Catatan rilis v26 menempatkan penghapusan enhanced_conversions_for_leads_enabled pada bagian breaking changes. Field itu sebelumnya berada pada Customer.conversion_tracking_setting. Google mengarahkan pembaca ke ConversionTrackingSetting.enablement_setting untuk memeriksa pengaturan Enhanced Conversions tingkat akun.
Karena field lama berbentuk indikator yang berbeda dari konfigurasi enum baru, jangan menggantinya dengan konversi boolean sembarang. Temukan pemakaiannya pada query, serializer, cache, kondisi notifikasi, serta kolom ekspor. String nama field mungkin tersimpan dalam konfigurasi dashboard, bukan hanya kode aplikasi. Cari juga test fixture dan dokumentasi internal yang masih menyebut field lama.
| Area integrasi | Pemeriksaan sebelum upgrade | Bukti lulus |
|---|---|---|
| Query akun | Tidak meminta field yang dihapus | Query v26 selesai tanpa error field |
| Pemetaan respons | Enum tidak dipaksa menjadi boolean | Nilai asli tetap tersedia untuk audit |
| Dashboard | Label sesuai arti pengaturan | Pembaca memahami sumber konfigurasi |
| Manager account | Status efektif tidak tertukar dengan lokal | Akun sumber tercatat dengan benar |
| Alert otomatis | Nilai baru tidak memicu alarm palsu | Kasus regresi memiliki hasil terjelaskan |
Tabel ini adalah rancangan pengujian, bukan laporan pengujian akun nyata. Jalankan dengan kredensial dan data yang memang Anda berwenang akses. Jangan memakai data klien lain sebagai pengganti fixture yang belum tersedia.
Mengapa pengaturan lokal dan efektif harus dibedakan?
Referensi v26 menjelaskan enablement_setting sebagai pengaturan Enhanced Conversions tingkat akun. Field effective_enablement_setting adalah pengaturan efektif untuk customer. Jika memakai cross-account conversion tracking, nilai efektif diwarisi dari manager. Keduanya ditandai output only dan read-only.
Konsekuensi praktisnya: panel status perlu menyebut apa yang sedang ditampilkan. Label tunggal seperti “Enhanced Conversions aktif” bisa menyembunyikan perbedaan antara konfigurasi akun lokal dan konfigurasi yang berlaku melalui manager. Tampilkan konteks akun dan pengaturan efektif tanpa mengklaim bahwa indikator tersebut menjamin seluruh event terkirim dengan benar.
Jangan mencoba mengaktifkan fitur lewat mutation pada kedua field read-only ini. Untuk pekerjaan konfigurasi, gunakan prosedur pengaturan yang didokumentasikan secara terpisah. Audit pembacaan status dan audit pengiriman data merupakan dua pekerjaan berbeda. Respons API yang berhasil hanya membuktikan akses dan bentuk data pada request tersebut, bukan keberhasilan semua konversi.
Untuk bisnis dengan beberapa cabang, pastikan staf mengetahui akun mana yang mengendalikan tracking. Ini membantu menghindari diagnosis keliru ketika pengaturan lokal terlihat berbeda dari nilai efektif. Jangan menyalin pengaturan cabang lain tanpa mengecek struktur manager dan otorisasi.
Apakah MESSAGE_LEAD berarti chat otomatis menjadi penjualan?
Tidak. Referensi ConversionActionCategory mendeskripsikan MESSAGE_LEAD sebagai interaksi pesan atau chat yang menunjukkan ketertarikan terhadap penawaran pengiklan. Kategori ini bukan bukti transaksi, bukan ukuran pendapatan, dan bukan pengumuman dukungan otomatis untuk semua aplikasi pesan.
Pada bisnis Indonesia, tim sering membicarakan tombol WhatsApp, pesan masuk, konsultasi, dan transaksi dalam satu istilah “lead”. Pisahkan istilah tersebut pada laporan. Klik tombol belum tentu menghasilkan pesan; pesan belum tentu memenuhi syarat; lead berkualitas belum tentu membeli. Definisi event harus menjelaskan titik perjalanan pelanggan yang benar-benar diamati.
Sebelum memetakan kategori baru, periksa apakah conversion action yang relevan memang memakai kategori tersebut. Jangan mengubah seluruh event klik menjadi MESSAGE_LEAD hanya agar dashboard terlihat mengikuti rilis baru. Dokumentasi yang dibaca di sini tidak menyatakan bahwa kategori itu mengaktifkan pelacakan chat WhatsApp secara otomatis.
Diskusikan kamus konversi dengan tim penjualan. Kolom “chat tertarik”, “lead memenuhi syarat”, dan “penjualan” perlu definisi terpisah. Gunakan contoh sintetis yang ditandai sebagai fixture saat menyusun test, bukan angka yang kemudian disajikan sebagai performa perusahaan.
Mengapa penambahan CLICK bisa mengubah pembacaan laporan?
Catatan rilis menambah ConversionAttributionEventType.CLICK untuk konversi yang diatribusikan ke klik iklan. Google menjelaskan bahwa konversi ini sebelumnya termasuk dalam nilai UNKNOWN. Integrasi yang mengelompokkan enum berdasarkan daftar tetap perlu diperiksa.
Misalnya, sebuah pipeline mungkin meletakkan semua nilai tak dikenal ke bucket “lainnya”. Setelah migrasi, data bertipe CLICK dapat berpindah bucket. Perubahan komposisi tersebut tidak dengan sendirinya membuktikan perilaku pelanggan berubah. Tim harus memisahkan perubahan taksonomi dari perubahan hasil iklan.
Simpan versi API sebagai metadata pengambilan data. Jika membandingkan periode sebelum dan sesudah upgrade, jelaskan perbedaan klasifikasi yang relevan. Jangan menggabungkan dua definisi tanpa catatan lalu menyebutnya peningkatan performa. Hindari pula mengganti nilai historis UNKNOWN menjadi CLICK secara menyeluruh: Anda tidak memiliki bukti bahwa setiap nilai lama bermakna sama.
Pengujian minimum mencakup enum yang dikenali, nilai yang belum dikenal, serta respons yang tidak memiliki field opsional. Nilai belum dikenal sebaiknya tetap dapat diaudit, bukan dibuang diam-diam. Perlakuan terhadap data kosong harus berbeda dari angka nol jika laporan menggunakannya untuk keputusan operasional.
Bagaimana menguji migrasi tanpa mengubah kampanye?
Mulai dari jalur baca. Jalankan query yang telah disesuaikan pada akun berizin, simpan metadata request yang aman, lalu cocokkan respons dengan kontrak data internal. Hindari menyalin token, data pribadi pelanggan, atau header otorisasi ke tiket dan log publik.
Untuk perbandingan dashboard, tentukan periode dan zona waktu yang sama. Jangan membandingkan ekspor pagi dengan ekspor malam lalu menganggap selisih sebagai bug migrasi. Nyatakan apakah data masih dapat diperbarui karena pemrosesan konversi. Jika pipeline menggunakan pagination, periksa bahwa seluruh halaman respons diproses dan tidak menggandakan baris.
Pisahkan test query, test transformasi, dan test tampilan. Query bisa sukses sementara serializer membuang enum baru. Transformasi bisa benar sementara label antarmuka menyesatkan. Berikan pemilik yang jelas untuk tiap lapisan, supaya kegagalan tidak berakhir menjadi tanggung jawab “tim marketing” tanpa jalur perbaikan.
Bila integrasi juga melakukan mutation, audit jalur tersebut terpisah. Jangan memakai kampanye produksi sebagai tempat eksperimen tanpa persetujuan. Artikel ini tidak menyertakan perintah untuk mengubah anggaran, conversion goal, atau pengaturan bidding.
Checklist persetujuan rilis internal
- Versi API seluruh konektor tercatat.
- Query tidak meminta field yang dihapus.
- Nilai konfigurasi lokal dan efektif dibedakan.
- Tidak ada mutation pada field read-only.
-
MESSAGE_LEADmemiliki definisi bisnis yang tepat. -
CLICKtidak dibuang oleh pemetaan enum lama. - Zona waktu dan periode uji disamakan.
- Total baris dan duplikasi diperiksa.
- Token serta data pelanggan tidak muncul pada log publik.
- Rollback konektor mengikuti dukungan versi yang masih berlaku.
Apa perubahan lain yang patut dicatat, bukan langsung diaktifkan?
Rilis v26 juga menambah CurrencyConstant.demand_gen_info.minimum_budget_per_day_micros, yang menyatakan minimum anggaran harian Demand Gen dalam mata uang terkait. Google menyebut nilainya mengikuti perubahan minimum yang ditegakkan API. Jangan menerbitkan angka rupiah dari tebakan atau dari mata uang akun lain.
Jika aplikasi Anda membuat kampanye Demand Gen, baca nilai melalui integrasi yang sah dan dokumentasikan satuan micros. Jangan menganggap angka mentah sebagai rupiah penuh. Topik strategi kampanyenya tetap dapat dibaca terpisah pada panduan Demand Gen untuk UMKM.
Fitur LINE dan SMS pada business message assets juga muncul dalam rilis. Itu tidak cukup untuk menyatakan seluruh fitur tersedia di semua negara atau semua jenis akun. Begitu pula perubahan Local Services Performance Max: persyaratan API tidak menjadi bukti kelayakan bisnis lokal Indonesia. Verifikasi dukungan akun sebelum menyusun rekomendasi operasional.
Kapan migrasi dinyatakan berhasil?
Nyatakan berhasil ketika query, kontrak data, transformasi, dan dashboard lolos pemeriksaan yang telah ditetapkan. Bukan ketika paket SDK selesai diinstal. Indikator awal yang bisa dipantau adalah jumlah error field, nilai enum yang tidak terpetakan, baris duplikat, serta perbedaan label lokal dan efektif yang belum dijelaskan.
Jika setelah rilis laporan terlihat berubah, periksa definisi terlebih dahulu. Penambahan kategori atau pemindahan nilai dari UNKNOWN dapat menjelaskan sebagian perbedaan. Bila perubahan tidak bisa direkonsiliasi, tahan penggunaan dashboard untuk keputusan anggaran sampai sumber masalah diketahui. Jangan menjanjikan peningkatan ROAS dari upgrade API.
Panduan ini berbasis dokumentasi per 15 Oktober 2026. Tidak ada request Google Ads API pada akun pengiklan yang diuji. Contoh audit adalah rekomendasi kerja, bukan bukti implementasi Socta atau jaminan kompatibilitas vendor tertentu.
Sumber primer
- Google Ads API, Release notes v26, 14 Oktober 2026: https://developers.google.com/google-ads/api/docs/release-notes
- Google Ads API v26, ConversionTrackingSetting, diperbarui 13 Oktober 2026: https://developers.google.com/google-ads/api/reference/rpc/v26/ConversionTrackingSetting
- Google Ads API v26, ConversionActionCategory, diperbarui 13 Oktober 2026: https://developers.google.com/google-ads/api/reference/rpc/v26/ConversionActionCategoryEnum.ConversionActionCategory
Butuh dashboard yang dapat diperiksa tim marketing?
Mulai dari definisi konversi dan jalur data, bukan dekorasi grafik. Diskusikan kebutuhan website dan integrasi bisnis bersama Socta agar formulir, label event, serta laporan mempunyai arti yang sama untuk tim teknis dan pemasaran.
