Introducing Graph API v22.0 and Marketing API v22.0

Hari ini, kami merilis Graph API v22.0 dan Marketing API v22.0. Sebagai bagian dari rilis ini, kami menyoroti perubahan berikut yang kami yakini relevan dengan bagian dari komunitas developer kami. Perubahan ini mencakup pengumuman, pembaruan produk, dan notifikasi tentang penghentian integrasi aplikasi yang relevan dengan platform kami.

Untuk daftar lengkap semua perubahan dan detailnya, periksa catatan perubahan kami.

Pembaruan Umum

Perubahan Marketing API v22 pada penggunaan pemirsa khusus daftar pelanggan dalam kampanye perumahan, lowongan kerja, serta produk dan layanan keuangan (termasuk kredit)

Berlaku untuk ‘v22.0+’ dan akan diluncurkan ke semua versi pada Maret 2025

Pemirsa khusus daftar pelanggan tertentu akan tidak memenuhi syarat untuk penggunaan kampanye perumahan, lowongan kerja, serta produk dan layanan keuangan (termasuk kredit). Pelajari selengkapnya tentang pembaruan di sini dan apakah pembatasan berlaku untuk Anda. Selain itu, kolom is_sac_cfca_terms_certified akan ditambahkan ke level set iklan, lihat contoh. Anda akan diwajibkan menggunakan kolom ini untuk menyatakan bahwa setiap pemirsa khusus daftar pelanggan yang digunakan dalam Set Iklan untuk kampanye perumahan, lowongan kerja, serta produk dan layanan keuangan (termasuk kredit) sesuai dengan sertifikasi CLCA Meta. Mulai awal April 2025, kampanye/set iklan yang ada yang menggunakan pemirsa khusus daftar pelanggan yang tidak mengikuti persyaratan dapat dijeda. Jika hal ini terjadi, Anda akan melihat kesalahan di Pengelola Iklan dan Marketing API beserta petunjuknya.

Endpoint berikut akan terpengaruh:

• POST /{ad-account-id}/adsets
• POST /{ad_set_id}

Custom Audience API v22

Mulai 6 Januari 2025, Anda bisa menggunakan kolom is_eligible_for_sac_campaigns baru untuk mengidentifikasi apakah pemirsa khusus bisa digunakan dalam set iklan kampanye Kategori Iklan Khusus. Anda harus memberikan special_ad_categories dan special_ad_category_countries yang dimaksudkan dari kampanye Kategori Iklan Khusus yang akan menggunakan pemirsa tersebut, serta ad_account_id yang akan menggunakan pemirsa untuk membuat atau mengedit set iklan.

Endpoint berikut akan terpengaruh:

• GET /custom_audience_id

Menjangkau Orang yang Tertarik dengan Kota dan Wilayah Pilihan Anda

Dengan antusias kami mengumumkan peluncuran fitur baru untuk penargetan lokasi. Fitur baru ini akan membantu pengiklan mendorong peningkatan kinerja dengan memperluas jangkauan di luar kota atau wilayah target Anda. Dengan begitu, sistem iklan kami bisa fleksibel untuk menayangkan iklan kepada orang-orang yang telah menunjukkan minat terhadap suatu lokasi.

Fitur ini memperluas fitur penargetan lokasi kami yang sudah ada, dengan memungkinkan Anda menjangkau orang-orang yang telah menunjukkan niat untuk bepergian ke, melakukan pembelian di, atau minat umum terhadap kota dan wilayah yang Anda targetkan, di negara yang sama.

Selama pengujian, klien yang menggunakan fitur penargetan lokasi baru memperoleh 6,7% penurunan biaya per hasil.

Untuk mengetahui informasi selengkapnya, klik di sini.

Penghentian & Perubahan Sela

Mengganti endpoint Pengguna Instagram, Media Instagram, Carousel Instagram, dan Komentar Instagram dengan endpoint Pengguna IG, Media IG, dan Komentar IG

Kami melakukan perubahan pada Instagram Graph API dan Marketing API untuk mempermudah developer membangun solusi bagi bisnis. Dengan perubahan ini, kami akan menghentikan objek Pengguna Instagram, Media Instagram, Carousel Instagram, dan Komentar Instagram di Graph API v22 yang akan digantikan dengan objek Pengguna IG, Media IG yang ada, termasuk carousel, dan Komentar IG. Kami juga menambahkan fungsi pada objek baru ini untuk menghadirkan keseimbangan bagi sebagian besar kasus penggunaan.

Developer akan memiliki waktu hingga 21 Januari 2026 untuk memperbarui penggunaan endpoint Marketing API mereka yang terdampak dan hingga 21 April 2025 untuk memperbarui penggunaan endpoint Graph API mereka yang terdampak. Jika Anda otomatis memperbarui versi Graph API dalam panggilan API Anda, kami sarankan Anda segera meninjau perubahan ini setelah berlaku untuk developer yang menggunakan Graph API v22.

Lihat blog developer untuk detail selengkapnya tentang perubahan ini termasuk endpoint mana yang berubah, contoh penggunaan mana yang sudah tidak didukung, dan jadwal yang berlaku.

Penghapusan pengecualian Penargetan Terperinci

Sebagai bagian dari upaya berkelanjutan kami untuk membantu pengiklan mendorong kinerja, kami menghapus pengecualian Penargetan Terperinci. Sebagai bagian dari proses ini, kami akan terus mendukung kemampuan untuk mengecualikan karyawan Anda dalam kontrol Pemirsa di level akun. Untuk informasi selengkapnya tentang kontrol akun, lihat di sini.

Kami yakin perubahan ini akan membantu meningkatkan kinerja kampanye. Uji pengiklan menunjukkan bahwa median Biaya per Konversi turun sebesar 22,6% saat tidak menggunakan Pengecualian Penargetan Terperinci dibandingkan saat menggunakan Pengecualian Penargetan Terperinci.

Akibat perubahan ini, pemirsa khusus akan dihapus dalam kolom pengecualian. Anda masih bisa terus menggunakan pengecualian pemirsa khusus dengan menggunakan kolom excluded_custom_audiences.

Mulai 21 Januari 2025, developer bisa mulai menerapkan perubahan kode, dan akan memiliki waktu hingga 21 April 2025 untuk melakukan pembaruan ini. Perubahan ini akan dirilis pada v22. Baca blog developer untuk mengetahui daftar endpoint yang terpengaruh terkait perubahan ini.

Menghentikan Paket Penyempurnaan Standar dari Marketing API

Dampak Marketing API v22.0 terhadap Penyempurnaan Materi Iklan Advantage+

Dalam versi Marketing API yang baru ini, kami akan menghentikan paket Penyempurnaan Standar Materi Iklan Advantage+, yang akan digantikan dengan persetujuan setiap penyempurnaan materi iklan. Anda bisa mempelajari selengkapnya tentang Materi Iklan Advantage+ di sini.

Selanjutnya Anda bisa mempelajari informasi selengkapnya yang relevan dengan komunitas developer, dan detail tambahan bisa ditemukan dalam dokumentasi developer kami di sini.

Penyempurnaan standar tidak akan didukung lagi dengan endpoint ini:

• POST /{ad_account_id}/adcreatives
• POST /{ad_account_id}/ads
• GET /{ad_id}/previews

Memperkenalkan Metrik Tayangan Instagram dan Penghentian Metrik Impresi dan Pemutaran

Untuk terus menyelaraskan fungsi Instagram API dengan fungsi aplikasi Instagram, kami memperkenalkan metrik `tayangan` di semua versi API untuk insight media dan pengguna. Untuk insight media, objek Kabar, Cerita, dan Reels akan melaporkan tayangan. Untuk insight pengguna, API akan mendukung metrik `tayangan` dengan perincian multidimensi untuk jenis pengikut dan jenis produk media.

Selain itu, metrik berikut akan dihentikan mulai v22:

• pemutaran (insight media): Berapa kali reel mulai diputar setelah impresi dihitung.
• clips_replays_count (insight media): Berapa kali reel Anda mulai diputar lagi setelah pemutaran awal reel Anda. Ini didefinisikan sebagai pemutaran ulang selama 1mdtk atau lebih dalam sesi reel yang sama.
• ig_reels_aggregated_all_plays_count (insight media): Berapa kali reel Anda mulai diputar atau diputar ulang setelah impresi dihitung.
• impresi (insight media & pengguna): Total berapa kali objek Media Instagram telah dilihat.

Metrik 'impresi' insight media hanya akan dihentikan untuk media yang dibuat pada atau setelah 2 Juli 2024. Untuk media yang dibuat sebelum tanggal ini, API akan terus melaporkan nilai seperti biasa di semua versi.

Informasi selengkapnya bisa ditemukan dalam dokumentasi developer kami untuk Insight Pengguna Instagram dan Insight Media Instagram. Mohon imbau developer Anda untuk melakukan pembaruan paling lambat 21 April 2025 untuk menghindari masalah.

Meta Business SDK

Rilis Meta Business SDK v22

Rilis Meta Business SDK v22 akan segera diterbitkan segera setelah rilis Graph API v22. Rilis ini mencakup perbaikan bug, peningkatan dependensi, fitur baru, dan yang paling penting, pembaruan antarmuka API agar sesuai dengan Graph API v22.

Sebagai bagian dari jadwal penghentian 2 tahun kami untuk SDK Platform, harap perhatikan penghentian dan rencana penghentian yang akan datang:

• Mei 2025: Facebook Platform SDK v17.0 atau versi yang lebih lama akan dihentikan.

Penghentian Versi API:

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

Graph API

• 14 Mei 2025: Graph API v.16 akan dihentikan dan dihapus dari platform
• 12 September 2025: Graph API v.17 akan dihentikan dan dihapus dari platform

Marketing API

• 4 Februari 2025: Marketing API v19.0 akan dihentikan dan dihapus dari platform
• 6 Mei 2025: Marketing API v20.0 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.