Meta merilis Graph APIAPIPintu resmi yang dipakai 2 sistem untuk saling mengirim data, tanpa orang menyalin data secara manual.Buka glosarium v27.0 dan Marketing API v27.0 pada 4 November 2026, menurut pengumuman Graph API v27.0 dan Marketing API v27.0 di Meta for Developers. Rilis ini membawa 4 perubahan untuk aplikasi yang membuat iklan lewat API. 2 perubahan mengubah iklan tanpa pesan error. 2 perubahan lain membuat request gagal.

Perubahan ini mengenai aplikasi, tool partner, dan skrip yang memanggil Marketing API. Jika tim Anda hanya memakai Ads Manager, tanyakan versi API ke setiap tool yang membuat iklan atau audiens untuk akun Anda.

Apa yang berubah di Marketing API v27.0?

Marketing API v27.0 mengubah 2 pengaturan default dan menghentikan 2 bentuk request lama. Tabel ini merangkum isi pengumuman Graph API v27.0 dan Marketing API v27.0.

PerubahanYang terjadi bila tidak dicekField atau endpointVersi lama
Product showcaseMeta bisa menambah produk katalog ke iklan baruproduct_extensions.enroll_statusTidak berubah
Device ad set SalesIklan bisa tayang di device dan OS lainindividual_setting.deviceIkut berubah sekitar Februari 2027
LookalikeRequest dengan lokasi ditolaklookalike_specIkut berubah sekitar Februari 2027
Sync katalogUpdate produk gagal di v27.0/{catalog-id}/batchJalan sampai dukungan v26.0 berhenti

Iklan, ad set, dan lookalike yang sudah ada tidak berubah. Semua perubahan berlaku untuk objek baru yang dibuat lewat API.

Bagaimana Product showcase bisa menyala tanpa diminta?

Meta bisa menyalakan Product showcase pada iklan baru bila creative tidak membawa pengaturan Product showcase sama sekali. Meta melakukannya hanya bila Meta yakin 1 product set di katalog Anda cocok dengan iklan itu.

Product showcase menampilkan produk dari katalog di bawah iklan. Untuk iklan katalog, fitur ini bisa berguna. Untuk iklan lead, iklan chat WhatsApp, atau iklan 1 layanan, produk tambahan bisa mengalihkan klik dari tujuan iklan.

Perubahan ini mengenai 2 endpoint: POST /{ad-account-id}/ads dan POST /{ad-account-id}/adcreatives. Untuk menolak fitur ini, kirim field berikut pada creative:

"degrees_of_freedom_spec": {
  "creative_features_spec": {
    "product_extensions": {
      "enroll_status": "OPT_OUT",
      "action_metadata": { "type": "MANUAL" }
    }
  }
}

Contoh Meta memakai action_metadata dengan tipe MANUAL. Versi sebelum v27.0 tidak berubah. Menurut laporan PPC Land, pengumuman Meta tidak menyebut apakah default yang sama berlaku di Ads Manager. Pada 2025, Meta memakai pola opt-out enroll_status yang sama untuk dynamic media di iklan katalog Advantage+. Pola ini mirip dengan creative enhancements di ChatGPT Ads: platform menambah elemen iklan kecuali Anda menolak secara tertulis.

Kapan ad set Sales meluas ke device lain?

Ad set Sales baru yang menarget device atau OS tertentu bisa tayang di device lain bila field device tidak dikirim. Meta menamai pengaturan ini Reach more people across other mobile devices.

Contoh: Anda menjual aplikasi iOS dan menarget iPhone saja. Di v27.0, ad set baru bisa ikut tayang di Android bila payload tidak memuat field device. Untuk tetap di device pilihan Anda, kirim nilai 0:

"targeting": {
  "targeting_automation": {
    "individual_setting": { "device": 0 }
  }
}

Pengaturan ini tidak tersedia untuk conversionKonversiTindakan yang Anda hitung sebagai hasil, misalnya pesanan terbayar, pendaftaran, atau chat yang menjadi calon pembeli.Buka glosarium location Mobile App dan Special Ad Categories. Ad set yang sudah ada tidak berubah. Sekitar 90 hari setelah 4 November 2026, aturan ini berlaku di semua versi API. Meta menulis Februari 2027, tetapi tanggalnya belum final.

Mengapa request lookalike bisa ditolak?

Endpoint POST /act_{ad-account-id}/customaudiences menolak lookalike_spec yang memuat country atau location_spec. Lookalike sekarang mengambil lokasi dari ad set yang menargetnya.

Meta tidak memberi field pengganti. Hapus kedua field itu dari payload. Atur negara atau kota pada targeting ad set. Lookalike yang sudah ada dan iklannya tetap berjalan.

Aturan ini berlaku di v27.0 mulai 4 November 2026. Sekitar 90 hari kemudian, aturan ini juga berlaku di semua versi yang masih didukung. Jadi, tetap di v26.0 hanya menunda error sekitar 3 bulan.

Apa yang harus diganti pada sync katalog?

Endpoint /{catalog-id}/batch tidak bekerja di v27.0. Ganti dengan /{catalog-id}/items_batch sebelum aplikasi Anda naik versi.

Endpoint lama tetap jalan di v26.0 dan versi sebelumnya sampai Meta menghentikan dukungan v26.0. Masalah biasanya muncul saat tim menaikkan nomor versi di 1 konstanta, lalu sync produk gagal untuk semua item.

Pengalaman kami saat memindahkan sync katalog Konektor: bentuk body kedua endpoint berbeda. items_batch membaca retailer id dari data.id. Body lama dengan retailer_id di level atas dijawab Meta dengan error field hilang untuk setiap produk. Jadi, ganti URL dan bentuk body bersama-sama.

Kapan versi lama ikut berubah?

Versi lama hanya menunda 2 perubahan, yaitu device dan lookalike, sekitar 90 hari sampai kira-kira Februari 2027. Product showcase dan sync katalog hanya berubah saat Anda naik ke v27.0.

Garis waktu: v27.0 rilis 4 Nov 2026, v21.0 dihapus 21 Jan 2027, aturan device dan lookalike ke semua versi sekitar Feb 2027, v22.0 dihapus 20 Mei 2027.
Jadwal perubahan v27.0 dan penghapusan versi lama. Sumber: Meta for Developers, 4 November 2026. Tanggal Februari 2027 belum final.

Meta juga menghapus 2 versi Graph API. v21.0 berhenti pada 21 Januari 2027. v22.0 berhenti pada 20 Mei 2027. Tanggal rilis v27.0 tercatat di riwayat versi Marketing API.

Apa lagi yang berubah di Graph API v27.0?

Graph API v27.0 juga mengubah 3 hal di luar iklan. Perubahan ini penting bila aplikasi Anda mengelola Page atau membaca insight video.

  • Saat mengedit post Page, aplikasi bisa mengirim is_ai_generated. Nilai true menambah label konten AI. Nilai false menghapusnya. Field kosong menyimpan nilai lama.
  • Mulai awal November 2026, metrik total_video_consumption_rate tidak keluar lagi di semua versi. Meta tidak memberi pengganti.
  • Aplikasi baru tidak bisa memakai 6 fitur lama: ids, date_format, method, .as(...), callback, dan asyncbatch. Aplikasi lama harus berhenti memakainya sebelum naik ke v28.0.

Business SDK v27 juga menambah field phone_otp_verification_type untuk lead form. Field ini mengatur verifikasi nomor telepon: wajib, opsional, atau mati. Opsi opsional hanya tersedia untuk akun iklan tertentu.

Bagaimana cara mengecek integrasi Anda hari ini?

Cari nomor versi API, lalu cek 4 field di setiap jalur yang membuat iklan, ad set, audiens, atau produk katalog. Diagram ini merangkum nilai yang aman untuk tiap field.

Empat field untuk dicek: opt-out Product showcase, device = 0, hapus lokasi di lookalike_spec, dan ganti /batch katalog ke /items_batch.
Amber berarti iklan tetap tayang tetapi berbeda dari rencana. Merah berarti request gagal. Sumber: Meta for Developers, 4 November 2026.
  1. Cari string graph.facebook.com/v di kode atau konfigurasi. Catat setiap nomor versi yang muncul.
  2. Tambahkan opt-out Product showcase pada creative untuk iklan non-katalog.
  3. Kirim device bernilai 0 pada ad set Sales yang menarget device atau OS tertentu.
  4. Hapus country dan location_spec dari lookalike_spec. Pindahkan lokasi ke targeting ad set.
  5. Ganti /batch katalog ke /items_batch, lalu sesuaikan bentuk body.
  6. Buat 1 iklan uji di v27.0 dengan status PAUSED. Buka preview, lalu pastikan tidak ada produk katalog tambahan.

Jika Anda memakai tool pihak ketiga, kirim daftar ini ke vendor. Minta jawaban tertulis untuk versi API dan 4 field di atas.

Apakah perubahan ini mengubah strategi iklan Anda?

Tidak secara langsung, karena v27.0 mengubah default, bukan cara lelang atau cara Meta memilih audiens. Default baru itu tetap menggeser distribusi iklan bila payload Anda diam.

Meta terus memperluas otomatisasi pada iklan, seperti yang kami bahas di artikel cara kerja algoritma Meta Ads Andromeda. Sikap yang aman: tulis pilihan Anda secara eksplisit di setiap payload. Uji fitur otomatis sebagai eksperimen terpisah, bukan sebagai default yang tidak terlihat.

Butuh bantuan mengaudit akun dan tracking Meta Ads? Lihat Meta Ads Performance Management atau jadwalkan sesi 30 menit dengan tim kami.

Tanya jawab

Apakah pengguna Ads Manager terkena perubahan Marketing API v27.0?

Tidak langsung. Perubahan ini mengenai request API. Namun tool partner, aplikasi CRM, atau skrip yang membuat iklan untuk akun Anda bisa terkena. Tanyakan versi API ke setiap tool itu.

Apakah iklan yang sudah berjalan ikut berubah?

Tidak. Meta menulis bahwa iklan, ad set, dan lookalike yang sudah ada tidak berubah. Perubahan berlaku untuk objek baru yang dibuat lewat v27.0, dan untuk device serta lookalike juga di versi lama mulai sekitar Februari 2027.

Apakah aman tetap memakai Marketing API v26.0?

Hanya sementara. Product showcase dan endpoint katalog tidak berubah di v26.0. Aturan device dan lookalike tetap masuk ke semua versi sekitar 90 hari setelah 4 November 2026.

Apakah Product showcase buruk untuk iklan saya?

Tidak selalu. Untuk toko online dengan katalog rapi, produk tambahan bisa membantu. Untuk iklan lead atau chat WhatsApp, produk tambahan bisa mengalihkan klik. Uji fitur ini secara terpisah dan ukur hasilnya sebelum memakainya di semua iklan.