Memperkenalkan Graph API v16.0 dan Marketing API v16.0 Facebook

Hari ini kami merilis Graph API v16.0 dan Marketing API v16.0 Facebook. 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 yang kami yakini relevan dengan integrasi aplikasi Anda dengan platform kami.

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

Pengumuman dan Pembaruan Umum

Tanggapan Kesalahan Platform WhatsApp Business

Sebagai bagian dari upaya berkelanjutan kami untuk meningkatkan perilaku tanggapan kesalahan API, kami telah melakukan perubahan berikut.

• Subkode kesalahan, yang jarang digunakan dan sebaiknya tidak diandalkan, tidak akan disertakan lagi dalam tanggapan kesalahan v16.0+. Gunakan kode dan detail sebagai gantinya.
• Kode kesalahan 100 ("code":100) memiliki beberapa judul unik yang menunjukkan sifat kesalahan tertentu. Semua kesalahan kode 100 kini akan menggunakan Invalid Parameter sebagai judulnya. Judul-judul lama yang mendeskripsikan sifat dari kesalahan kode 100 tertentu telah dipindahkan ke properti details. Perubahan ini sekarang juga terlihat dalam payload webhooks yang mendeskripsikan tanggapan kesalahan kode 100.
• Objek kesalahan webhook telah memperoleh properti pesan baru yang dipetakan ke properti pesan dalam payload tanggapan kesalahan API.

Platform Developer kini akan mewajibkan Verifikasi Bisnis untuk Akses Lanjutan ke API Apa Pun

Sebagaimana diumumkan pada tanggal 1 Februari 2023, Meta sekarang akan meminta developer untuk memverifikasi bisnis mereka agar bisa mendapatkan akses lanjutan untuk izin apa pun di Platform Developer Meta. Ini merupakan bagian dari proses kami untuk membantu mengonfirmasi keaslian dan legitimasi bisnis atau organisasi.

Untuk aplikasi yang dibuat setelah 1 Feb 2023, kami akan mulai meluncurkannya secara bertahap saat aplikasi baru meminta akses lanjutan. Aplikasi yang dibuat sebelum 1 Februari 2023 dengan akses lanjutan harus ditautkan ke bisnis terverifikasi mulai 1 Mei 2023. Untuk daftar izin yang memerlukan verifikasi bisnis agar bisa disetujui untuk akses lanjutan, lihat halaman ini.

Penghentian & Perubahan Sela

Menghentikan Pertimbangan Perjalanan

Pada tahun 2018, kami meluncurkan Pertimbangan Perjalanan sebagai tombol yang bisa diaktifkan oleh pengiklan perjalanan dan wisata yang akan memprioritaskan penayangan iklan kepada orang-orang yang telah menunjukkan minat jalan-jalan, tetapi belum memutuskan destinasinya. Pertimbangan Perjalanan digunakan dengan opsi penargetan yang ada untuk membantu pengiklan menayangkan iklan kepada orang yang tepat pada waktu yang tepat di Facebook, Instagram, dan Audience Network. Selama 4 tahun terakhir, melalui pengembangan berkelanjutan dari sistem pembelajaran mesin kami dan pengujian yang ekstensif, kini kami bisa membantu pengiklan wisata menjangkau konsumen yang ingin jalan-jalan dan meraih sasaran kinerja serupa tanpa penggunaan tombol sebagai opsi.

Mulai 2 Februari 2023, tombol Pertimbangan Perjalanan akan dihapus sebagai opsi di Pengelola Iklan dan API untuk kampanye baru. Kami telah memutuskan bahwa tombol ini tidak diperlukan lagi dan pengiklan diharapkan meraih kinerja yang sama tanpa tombol tersebut. Untuk sementara, mengaktifkan atau menonaktifkan tombol kemungkinan tidak akan berdampak signifikan pada kinerja kampanye.

Seiring dengan penyempurnaan model pembelajaran mesin, tujuan dan kinerja yang sama kini bisa diraih tanpa tombol sebagai opsi. Jadi, kami yakin dengan menghapusnya, kami bisa menghadirkan pengalaman yang lebih efisien.

Menghentikan Pencarian Prospek dalam Iklan Penerbangan

Pada bulan September 2018, kami berhasil meluncurkan Iklan Penerbangan untuk Pencarian Prospek. Pada pertengahan 2021, produk ini mulai mengalami tantangan teknis dan teridentifikasi kesalahan yang mencegah kampanye berjalan secara efisien. Oleh karena itu, kami memutuskan untuk secara proaktif memberi tahu pengiklan agar beralih ke opsi pencarian prospek lain. Kemampuan penargetan ulang masih ada dan bisa digunakan oleh pengiklan.

Jika Anda atau mitra Anda saat ini menggunakan pencarian prospek Iklan Penerbangan, sebaiknya semua kampanye yang ada dinonaktifkan paling lambat 1 Mei 2023.

Penghentian Penempatan Iklan Artikel Instan

Kami akan menghapus Artikel Instan dan penempatan iklan Artikel Instan dari Facebook mulai 20 April 2023. Kami pertama kali memperkenalkan Artikel Instan pada tahun 2015 agar penerbit bisa membuat artikel media interaktif di perangkat seluler dan memonetisasinya dengan iklan di Facebook. Namun, pencarian berita dari pengalaman Facebook bagi sebagian besar pengguna platform ini tidaklah signifikan, dan orang-orang melaporkan bahwa mereka ingin melihat lebih sedikit konten ini di Kabar mereka. Karena itu, kami menyesuaikan investasi kami agar lebih selaras dengan preferensi pengguna.

Penempatan iklan Artikel Instan tidak akan tersedia lagi untuk pembuatan kampanye baru di Pengelola Iklan dan Marketing API mulai 20 April 2023. Setelah 20 April 2023, set iklan sebelumnya yang secara eksklusif memuat penempatan Artikel Instan akan dijeda, dan semua set iklan lain yang menyertakan penempatan Artikel Instan akan diperbarui secara otomatis untuk mengecualikan penempatan tersebut.

Menyembunyikan tanggapan, komentar, dan tanda pada konten yang diposting ke profil pengguna

Dengan rilis ini, kami menerapkan perubahan yang akan menyembunyikan komentar, tanggapan, dan tanda pengguna sesi. Kolom "via" dan "sharedposts" juga akan memberikan data kosong untuk postingan di profil pengguna. Perubahan ini hanya akan memengaruhi konten yang diposting ke profil pengguna.

Menghentikan dukungan untuk versi TLS di bawah 1.2

Demi meningkatkan kondisi keamanan, kami akan menghentikan dukungan Graph API untuk versi TLS di bawah TLS 1.2. Jika menggunakan TLS 1.2, akses menggunakan sandi RSA statis (AES128-GCM-SHA256, AES256-GCM-SHA384, AES128-SHA, AES256-SHA, DES-CBC3-SHA) juga akan dihentikan. Permintaan API yang dibuat dengan versi TLS lama akan menerima kesalahan setelah 90 hari.

Kami juga akan menolak traffic web ke developer.facebook.com setelah 1 Mei 2023 dari browser yang menggunakan versi TLS lama (lebih lama dari TLS 1.2 dan menggunakan sandi RSA statis [AES128-GCM-SHA256, AES256-GCM-SHA384, AES128-SHA, AES256-SHA, DES-CBC3-SHA] jika menggunakan TLS1.2).

Kategori template WhatsApp

Tahun lalu, kami memperbarui jenis kategori template di Pengelola WhatsApp dan API untuk mencatat kasus penggunaan baru yang dikirim di Platform WhatsApp Business. Pada tanggal 2 Februari 2023, kami akan mengganti nama kategori template ini agar mencerminkan kasus penggunaan ini secara lebih akurat:

• Template marketing akan terus diberi nama marketing (tidak ada perubahan)
• Template transaksional akan diganti namanya menjadi utilitas
• Template OTP akan diganti namanya menjadi autentikasi

Bisnis harus menggunakan kategori template yang diperbarui ini jika membuat atau mengedit template menggunakan Graph v16. Pada tanggal 1 Mei, perubahan ini akan diterapkan ke semua versi. Jadi, setiap upaya untuk membuat atau mengedit template menggunakan versi apa pun harus menggunakan kategori baru ini. Untuk memastikan tidak ada gangguan pada proses pembuatan atau pengeditan template, bisnis dan BSP harus memprioritaskan pembaruan panggilan API mereka untuk menggunakan nilai dan template kategori baru paling lambat 1 Mei 2023.

Beberapa tanggal dan pertimbangan penting lainnya ada di bawah ini:

• Migrasi template: Pada 1 April, WhatsApp akan mengalihkan semua template yang ada ke kategori template baru. Bisnis bisa melihat kategorisasi baru template mereka di Pengelola WhatsApp dan akan bisa meninjaunya hingga 15 Mei. Jika bisnis tidak setuju dengan kategorisasi tersebut, mereka bisa mengajukan banding hingga 15 Mei. Setiap template yang baru dibuat atau diedit menggunakan Graph API v15 atau versi lama antara 1 April dan 1 Mei akan bermigrasi pada 5 Mei. Oleh karena itu, kami menyarankan Anda mulai menggunakan v16 untuk pembuatan template mulai 1 April. Mulai 1 Mei, setiap template yang dibuat di Pengelola WhatsApp atau versi Graph API apa pun akan mencerminkan kategori template baru.
• Pembuatan template dalam kategori template baru: Mulai 1 April, semua template yang dibuat di Graph API v16 dan Pengelola WhatsApp akan memerlukan validasi kategori untuk disetujui. Template yang baru dibuat atau diedit bisa ditolak jika WhatsApp mendeteksi bahwa kategori yang dipilih salah. Alasan penolakan ini akan menjelaskan bahwa kategori yang dipilih tidak sesuai dengan konten template, sesuai pedoman template kami. Bisnis kemudian bisa memilih untuk mengubah pilihan kategori dan mengirimkannya lagi, mengedit template, atau mengajukan banding atas keputusan tersebut. Mulai 1 Mei, template yang baru dibuat dengan variabel akan membutuhkan contoh in-line. Mulai 1 Juni, bisnis akan ditagih berdasarkankartu tarif baru sesuai kategori template.

Platform Messenger API

Kami menyederhanakan notifikasi berulang dengan menghapus opsi untuk menentukan frekuensi pesan mulai v16. Untuk info selengkapnya, lihat Catatan Perubahan Messenger.

Penghentian Versi API:

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

Graph API

• 23 Februari 2023: Graph API v9.0 tidak akan berlaku lagi dan dihapus dari platform
• 8 Juni 2023: Graph API v10.0 tidak akan berlaku lagi dan dihapus dari platform
• 14 September 2023: Graph API v11.0 tidak akan berlaku lagi dan dihapus dari platform

Marketing API

• 25 April 2023: Marketing API v14.0 tidak akan berlaku lagi dan dihapus dari platform

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

Platform Facebook SDK

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

• Juni 2023: Rencana penghentian Platform Facebook SDK v9.0 ke bawah
• Oktober 2023: Rencana penghentian Platform Facebook SDK v11.0 ke bawah
• Februari 2024: Rencana penghentian Platform Facebook SDK v12.0 ke bawah