Memperkenalkan Graph API v25.0 dan Marketing API v25.0

Berikut adalah sorotan perubahan GAPI/MAPI yang baru untuk V25. Kunjungi catatan perubahan kami untuk daftar lengkap perubahan dan detailnya.

Pembaruan Umum

Graph API: Memperkenalkan Metrik Pemirsa Halaman

Pada akhir Juni 2026, kami berencana memperkenalkan Metrik Pemirsa Halaman di Graph API. Metrik pemirsa dimaksudkan untuk menggantikan metrik jangkauan yang lama dan menyediakan pengukuran lintas platform (Facebook dan Instagram) yang konsisten terkait jumlah orang yang melihat suatu konten. Developer harus mulai merencanakan migrasi ke pemirsa untuk memastikan akses berkelanjutan ke insight audiens.

Apa yang berubah?

Metrik pemirsa akan tersedia di insight halaman & insight cerita

Insight Postingan/Halaman

• GET {page-id}/insights/page_total_media_view_unique*
• GET {post-id}/insights/post_total_media_view_unique*

Insight Cerita

• Metrik baru akan ditambahkan
• GET {stories-id}/insights/metric
  • PAGE_STORY_TOTAL_MEDIA_VIEW_UNIQUE

Graph API di atas akan tersedia setelah peluncuran V25. Kami sarankan developer memeriksa Catatan Perubahan Graph API untuk mendapatkan informasi terbaru.

Pembaruan Sertifikat mTLS Webhooks

Mulai 31 Maret 2026, Meta akan mulai menandatangani sertifikat mTLS Webhooks menggunakan Otoritas Sertifikat (CA) yang berbeda milik Meta.

Apa artinya bagi developer?

Jika server Anda dikonfigurasi untuk memerlukan dan memverifikasi sertifikat mTLS Webhooks, Anda harus memercayai CA Meta yang baru. Kegagalan memperbarui penyimpanan tepercaya Anda sebelum batas waktu akan mengakibatkan kegagalan handshake TLS, dan server Anda akan berhenti menerima semua peristiwa webhook.

Diperlukan tindakan: Perbarui Penyimpanan Kepercayaan Anda

Untuk memastikan penerimaan Webhooks tidak terganggu, Anda harus

1. Mengunduh sertifikat CA root Meta: Buka Mulai menggunakan webhook dan unduh file bernama meta-outbound-api-ca-2025-12.pem.
   CA root akan menandatangani sertifikat leaf yang akan disajikan dalam permintaan Webhook.
2. Menambahkan sertifikat ke penyimpanan tepercaya: Tambahkan sertifikat ini ke penyimpanan tepercaya dari server yang menerima Webhooks.
3. Mempertahankan sertifikat saat ini: Anda harus menambahkan sertifikat baru ke penyimpanan tepercaya Anda saat sertifikat saat ini masih aktif.

Penting: Jangan menunggu hingga tenggat waktu. Anda harus segera menambahkan sertifikat baru ke penyimpanan tepercaya Anda untuk memastikan transisi yang mulus pada tanggal 31 Maret.

Tenggat waktu: Sebelum 31 Maret 2026.

Mengapa perubahan ini terjadi

Sertifikat mTLS Webhooks saat ini ditandatangani oleh root CA DigiCert. Karena DigiCert menghentikan penggunaan Client Authentication EKU, sertifikat tidak bisa diperpanjang dengan root CA ini yang kedaluwarsa pada 15 April 2025.

Akibatnya, sertifikat mTLS Webhooks baru akan ditandatangani oleh root CA internal Meta. Sertifikat baru tersebut akan memiliki nama umum yang sama (client.webhooks.fbclientcerts.com) dengan sertifikat saat ini.

Dokumentasi publik tentang Webhooks mTLS telah diperbarui dengan notifikasi mengenai perubahan ini. Detail teknis lengkap dalam dokumentasi akan diperbarui secara permanen pada April 2026 setelah transisi selesai.

Penghentian & Perubahan Sela

Peningkatan Pesan Kesalahan untuk Ads Insights Async API

Kami terus berupaya untuk meningkatkan pengalaman developer dengan API kami. Untuk menyediakan transparansi yang lebih besar dan memungkinkan developer membangun aplikasi yang lebih kuat, kami menyempurnakan pelaporan kesalahan untuk endpoint GET {AD_REPORT_RUN_ID} Ads Insights Async API.

Dimulai dengan versi Graph API V25.0 berikutnya yang akan dirilis pada 18 Februari 2026, developer akan memiliki akses ke informasi kesalahan mendetail saat laporan asinkron gagal, sehingga mempermudah diagnosis kegagalan dan meningkatkan efisiensi integrasi API mereka. Untuk semua developer yang saat ini memiliki akses ke kolom error_code, jenisnya akan diubah dari uint menjadi int.

Apa yang Berubah?

Kami memperkenalkan kolom default baru berikut untuk tanggapan endpoint GET {AD_REPORT_RUN_ID} Ads Insights Async API untuk semua aplikasi:

• error_code: Kode kesalahan. Catatan: Kolom akan diubah dari uint menjadi int untuk semua developer yang saat ini memiliki akses ke kolom tersebut
• error_message: Pesan yang sesuai dengan error_code.
• error_subcode: Subkode spesifik untuk kesalahan.
• error_user_title: Judul yang ramah pengguna untuk subkode kesalahan.
• error_user_msg: Pesan yang ramah pengguna yang berisi detail subkode kesalahan.

Kolom ini akan diisi ketika proses pembuatan laporan gagal. Kami sarankan Anda untuk meninjau integrasi API Anda guna memastikan kompatibilitas dengan kolom default baru dalam tanggapan.

Pembaruan ini direncanakan untuk dirilis bersama versi Graph API berikutnya. Kami menyarankan developer memeriksa Catatan Perubahan Graph API untuk mendapatkan informasi terbaru. Dokumentasi developer juga telah diperbarui untuk mencerminkan perubahan ini.

Graph API: Parameter Kueri Metadata Ditiadakan

Dimulai dengan Graph API v25, kami akan menghentikan parameter kueri metadata=1. Parameter ini sebelumnya digunakan untuk menampilkan metadata tentang kolom dan koneksi node dalam tanggapan API. Fitur ini jarang digunakan dan akan dihentikan untuk menyederhanakan platform. Setelah penghentian, parameter metadata akan diabaikan dalam permintaan API.

Developer yang saat ini mengandalkan metadata=1 harus beralih ke dokumentasi API resmi kami untuk menemukan kolom dan koneksi yang tersedia untuk setiap jenis node.

Apa yang berubah?

Sebelum (v24 dan versi sebelumnya):

Menambahkan ?metadata=1 ke permintaan Graph API akan mengembalikan metadata tambahan tentang node, termasuk kolom dan koneksi yang tersedia.

Setelah (v25+):

Parameter metadata=1 akan diabaikan. Permintaan yang menyertakan parameter ini akan terus memberikan tanggapan standar tanpa metadata. Tidak akan terjadi kegagalan atau perubahan sela - permintaan Anda tidak akan mengalami kesalahan atau sela jika menyertakan metadata=1; parameter tersebut tidak memberikan efek apa pun.

Graph API: Penghentian Metrik Jangkauan/Tayangan Halaman

Pada Juni 2026, kami berencana untuk menghentikan metrik Jangkauan Postingan/Halaman, Impresi Video, dan Impresi Cerita di Graph API. Metrik lama ini tidak akan ditampilkan lagi di fitur Insight kami, tetapi masih tersedia melalui API hingga saat ini.

Untuk menyelaraskan produk dan API kami dalam satu kerangka kerja metrik yang konsisten, serta meningkatkan keandalan sistem secara keseluruhan, kami menghentikan metrik lama ini. Setelah penghentian, developer harus bermigrasi ke metrik Media View dan Media Viewer baru, yang menggantikan konsep impresi, jangkauan, dan pemirsa video lama.

Apa yang berubah?

Metrik berikut akan dihentikan pada Juni 2026 untuk semua versi API. Kami menyarankan developer memeriksa Catatan Perubahan Graph API untuk mendapatkan informasi terbaru:

Jangkauan Postingan/Halaman

• GET {page-id}/insights/page_impressions_unique*
• GET {page-id}/insights/page_impressions_paid_unique*
• GET {page-id}/insights/page_impressions_viral_unique*
• GET {page-id}/insights/page_impressions_nonviral_unique*
• GET {page-id}/insights/page_posts_impressions*
• GET {page-id}/insights/page_posts_impressions_unique*
• GET {page-id}/insights/page_posts_impressions_paid*
• GET {page-id}/insights/page_posts_impressions_paid_unique*
• GET {page-id}/insights/page_posts_impressions_organic_unique*
• GET {page-id}/insights/page_posts_served_impressions_organic_unique*
• GET {page-id}/insights/page_posts_impressions_viral*
• GET {page-id}/insights/page_posts_impressions_viral_unique*
• GET {page-id}/insights/page_posts_impressions_nonviral*
• GET {page-id}/insights/page_posts_impressions_nonviral_unique*
• GET {post-id}/insights/post_impressions_unique*
• GET {post-id}/insights/post_impressions_paid_unique*
• GET {post-id}/insights/post_impressions_fan_unique*
• GET {post-id}/insights/post_impressions_organic_unique*
• GET {post-id}/insights/post_impressions_viral_unique*
• GET {post-id}/insights/post_impressions_nonviral_unique*
• GET {post-id}/insights/post_impressions_nonviral_unique*

Impresi Video

• GET {video-id}/video_insights/post_impressions_unique
• GET {video-id}/video_insights/total_video_impressions
• GET {video-id}/video_insights/total_video_impressions_unique
• GET {video-id}/video_insights/total_video_impressions_paid_unique
• GET {video-id}/video_insights/total_video_impressions_paid
• GET {video-id}/video_insights/total_video_impressions_organic_unique
• GET {video-id}/video_insights/total_video_impressions_organic
• GET {video-id}/video_insights/total_video_impressions_viral_unique
• GET {video-id}/video_insights/total_video_impressions_viral
• GET {video-id}/video_insights/total_video_impressions_fan_unique
• GET {video-id}/video_insights/total_video_impressions_fan
• GET {video-id}/video_insights/total_video_impressions_fan_paid_unique
• GET {video-id}/video_insights/total_video_impressions_fan_paid

Impresi Cerita

• Dua metrik akan diganti
• GET {stories-id}/insights/metric
  • PAGE_STORY_IMPRESSIONS_BY_STORY_ID
  • PAGE_STORY_IMPRESSIONS_BY_STORY_ID_UNIQUE

Sebagai gantinya, kami sarankan untuk menggunakan metrik berikut:

• GET {page-id}/insights/page_total_media_view_unique
• GET {post-id}/insights/post_total_media_view_unique

Khusus untuk perincian antara jangkauan berbayar dan organik, kami sarankan Anda menggunakan metrik berikut, yang memberikan insight yang pada dasarnya serupa:

• GET {page-id}/insights/page_media_view
• GET {post-id}/insights/post_media_view

Graph API: Penghentian Metrik Pemirsa 3 Detik

Pada Juni 2026, kami berencana untuk menghentikan metrik pemirsa 3 detik. Metrik lama ini tidak akan ditampilkan lagi di fitur Insight kami, tetapi masih tersedia melalui Graph API hingga saat ini.

Untuk menyelaraskan produk dan API kami dalam satu kerangka kerja metrik yang konsisten, serta meningkatkan keandalan sistem secara keseluruhan, kami menghentikan metrik lama ini. Setelah penghentian, developer harus bermigrasi ke metrik Media View dan Media Viewer baru, yang menggantikan konsep impresi, jangkauan, dan pemirsa video lama.

Apa yang berubah?

Metrik berikut akan dihentikan pada Juni 2026 untuk semua versi API. Kami menyarankan developer memeriksa Catatan Perubahan Graph API untuk mendapatkan informasi terbaru:

• GET {page-id}/insights/page_video_views_unique
• GET {post-id}/insights/post_video_views_organic_unique
• GET {post-id}/insights/post_video_views_paid_unique
• GET {post-id}/insights/post_video_views_unique
• GET {video-id}/video_insights/total_video_views_organic_unique
• GET {video-id}/video_insights/total_video_views_paid_unique
• GET {video-id}/video_insights/total_video_views_unique

Sebagai gantinya, kami sarankan untuk menggunakan metrik berikut:

• GET {page-id}/insights/page_total_media_view_unique
• GET {post-id}/insights/post_total_media_view_unique

Khusus untuk perincian antara pemirsa 3 detik berbayar dan organik, kami sarankan untuk menggunakan metrik berikut, yang memberikan insight yang pada dasarnya serupa:

• GET {page-id}/insights/page_media_view
• GET {post-id}/insights/post_media_view

Marketing API: Penghentian ASC dan AAC

Penyatuan Otomatisasi mendorong kampanye Aplikasi, Penjualan, dan Prospek untuk secara default menggunakan penyiapan Advantage+ yang optimal dan berbasis otomatisasi. Selain itu, penyatuan ini mempermudah akses pengiklan dan mitra ke produk otomatisasi Meta yang terbaru dan berkinerja terbaik. Kami sedang melakukan penghentian bertahap untuk API versi lama dan migrasi ke Penyatuan Otomatisasi Advantage+ baru untuk developer Marketing API.

Mulai V25.0 (18 Februari 2026), kampanye ASC dan AAC tidak bisa dibuat atau diperbarui lagi menggunakan Marketing API. Perubahan ini akan diperluas ke semua versi MAPI setelah 90 hari (sebelum 19 Mei 2026).

Pada V26.0 (diperkirakan September 2026), semua kampanye ASC dan AAC lainnya akan dijeda.

Kampanye ASC atau AAC yang memanfaatkan Batas Anggaran Pelanggan yang Ada (ECBC) akan tetap bisa diedit sampai V26.0. Fitur ini tidak tersedia dengan kampanye Advantage+. Developer dengan kampanye ECBC harus mengambil tindakan menggunakan salah satu metode di bawah ini untuk mereplikasi kampanye ECBC sebelum V26.0:

• Duplikasi Manual: Buka kampanye ASC/AAC yang ada dengan ECBC di Pengelola Iklan, Anda akan diminta untuk ‘Duplikasi Kampanye’. Langkah 1 klik ini akan membuat kampanye baru yang mereplikasi penyiapan kampanye yang ada.
• Replikasi kampanye ECBC menggunakan API, gunakan panduan yang diberikan dalam dokumentasi developer untuk mereplikasi kampanye menggunakan API, di sini.
• Minta migrasi massal di level akun iklan, untuk mitra terkelola, kami bisa menyediakan tindakan satu kali untuk mereplikasi semua kampanye ECBC pada tanggal yang disepakati. Hubungi POC Meta Anda dan berikan ID Akun serta tanggal pilihan Anda untuk melakukan migrasi.

Catatan: Harap diingat bahwa semua duplikasi kampanye ECBC akan menghasilkan ID kampanye baru.

Perubahan ini berdampak pada endpoint berikut:

• POST /{campaign-id}
• POST /{campaign-id}/copies

Silakan periksa dokumen developer dan Pertanyaan Umum yang diperbarui untuk melihat semua detail perubahan ini.

Tautan ke dokumentasi developer

• Dokumen Developer - Pengalaman Kampanye Advantage+ untuk Penjualan, Aplikasi, dan Prospek

Tautan ke artikel bantuan tentang fitur

• Pusat Bantuan - Kampanye Advantage+
• Pusat Bantuan - Kategori Iklan Khusus

Penghentian Versi API:

Sebagai bagian dari jadwal versi Facebook untuk Graph API dan Marketing API, harap perhatikan penghentian yang akan datang:

Graph API

• 21 Mei 2026: Graph API v.19 akan dihentikan dan dihapus dari platform.
• 24 September 2026: Graph API v.20 akan dihentikan dan dihapus dari platform.

Untuk menghindari gangguan pada bisnis Anda, kami rekomendasikan untuk memigrasi semua panggilan ke API versi terbaru yang diluncurkan hari ini.