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

12 September 2023OlehNaveen Santhanavel

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

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

Pembaruan Umum

Penggabungan Opsi Status Lokasi Pemirsa untuk Penargetan Lokasi

Sebagaimana diumumkan sebelumnya pada bulan Mei 2023, kami telah menggabungkan Status Lokasi Pemirsa ke opsi default kami saat ini, yaitu "Orang yang tinggal atau baru-baru ini berada di lokasi ini" saat memilih jenis pemirsa untuk dijangkau dalam pilihan Penargetan Lokasi mereka. Pembaruan ini mencerminkan penggabungan opsi lain yang tersedia sebelumnya dan penghapusan opsi "Orang yang bepergian ke lokasi ini".

Kami melakukan perubahan ini sebagai bagian dari upaya berkelanjutan kami untuk memberikan nilai lebih bagi bisnis, menyederhanakan sistem iklan, dan merampingkan opsi penargetan kami demi meningkatkan efisiensi kinerja dan menghapus opsi yang jarang digunakan.

Pembaruan ini akan diterapkan ke kampanye baru atau hasil duplikasi. Kampanye lama yang dibuat sebelum peluncuran tidak akan terpengaruh perubahan ini kecuali kampanye itu masih berupa draf atau merupakan hasil duplikasi.

Menambahkan "add_security_recommendation" dan "code_expiration_minutes" ke WA Message Templates API

Pada awal tahun ini, kami merilis solusi autentikasi WhatsApp yang memungkinkan pembuatan dan pengiriman template autentikasi dengan tombol native dan pesan autentikasi preset. Dengan dirilisnya Graph API v18, kami melakukan penyempurnaan pada pengambilan template autentikasi agar mempermudah proses template autentikasi end-to-end bagi BSP dan bisnis.

Dengan Graph API v18, BSP dan bisnis bisa memiliki visibilitas yang lebih baik terhadap konten template pesan autentikasi preset setelah pembuatannya. Secara khusus, payload akan mengembalikan opsi konfigurasi konten preset, selain teks yang digunakan oleh WhatsApp. Penyempurnaan ini memungkinkan BSP dan bisnis membuat UI "edit" untuk template autentikasi yang bisa dibuat selain API.

Perhatikan bahwa kesalahan bisa terjadi saat meningkatkan ke Graph API v18 jika BSP atau bisnis mengambil seluruh tanggapan dari permintaan GET dan mengembalikannya ke permintaan POST untuk memperbarui template. Untuk mengatasinya, kolom teks body/header/footer harus dihapus sebelum meneruskannya kembali ke API.

Meluncurkan kembali dokumen dev dan catatan perubahan untuk membuat Iklan Telepon

Penempatan Facebook Reels untuk Iklan Telepon
Meta merilis opsi untuk menayangkan Iklan Telepon melalui platform Facebook Reels. Iklan telepon memungkinkan pengguna menelepon bisnis pada saat mereka dalam tahap pertimbangan ketika melihat iklan, dan membantu bisnis mendorong diskusi yang lebih kompleks dengan pengguna yang berminat. Ini adalah peluang bagi bisnis untuk beriklan dengan iklan telepon berdasarkan perilaku realtime orang-orang di Facebook. Di bagian Level Set iklan dalam Pengelola Iklan, bisnis bisa memilih untuk menambahkan "Facebook Reels" di bagian Penempatan.
Meluncurkan Ulang Iklan Telepon melalui API
Pada September 12, 2023, kami menyediakan panduan yang diperbarui tentang cara membuat Iklan Telepon melalui API. Kami memperkenalkan dokumentasi khusus untuk Iklan Telepon agar developer 3P bisa lebih mudah membuat kampanye Iklan Telepon dan mengetahui cara melihat insight tentang kampanye iklan telepon mereka yang sedang berlangsung, termasuk metrik terkait panggilan telepon. Ke depannya, kami juga berencana mendukung Add-on Telepon melalui platform API kami. Developer harus memiliki akses ke izin umum yang diperlukan untuk membuat iklan umum agar bisa membuat Iklan Telepon melalui platform API.

Silakan periksa dokumentasi developer untuk mendapatkan informasi tambahan.

Penghentian & Perubahan Sela

Perubahan Graph API untuk fitur izin granular pengguna

Kami sedang memperbarui dua endpoint graph API untuk Akun WhatsApp Business. Endpoint ini adalah sebagai berikut:

Mengambil template pesan yang terkait dengan Akun WhatsApp Business
Mengambil nomor telepon yang terkait dengan Akun WhatsApp Business

Dengan v18, kami meluncurkan fitur "izin granular pengguna" baru. Semua pengguna lama yang sudah ditambahkan ke Akun WhatsApp Business akan mengalami backfill dan akan terus memiliki akses (tidak terpengaruh).

Admin memiliki fleksibilitas untuk mengubah izin ini. Jika admin mengubah izin dan menghapus akses untuk melihat template pesan atau nomor telepon salah satu penggunanya, pengguna tersebut akan mulai menerima pesan kesalahan yang menyatakan Anda tidak memiliki izin untuk melihat template pesan atau nomor telepon di semua versi v18 dan yang lebih lama.

Menghentikan penggunaan nama metrik lama untuk Insight Media dan Pengguna IG

Mulai 12 September, Instagram akan menghapus metrik insight lama yang duplikat dari Instagram Graph API demi menyediakan satu sumber metrik bagi developer kami.

Peningkatan baru ini mengurangi kebingungan serta meningkatkan keandalan dan kualitas pelaporan kami.

Setelah 90 hari sejak peluncuran ini (yakni, 11 Desember 2023), kami akan menghapus semua metrik insight duplikat dan lama ini dari Instagram Graph API di semua versi agar lebih sesuai dengan aplikasi Instagram.

Kami menghargai semua masukan yang kami terima dari komunitas developer kami, dan berharap bisa terus bekerja sama.

Silakan periksa dokumentasi developer insight media dan insight pengguna untuk mempelajari selengkapnya.

Menghentikan semua endpoint Facebook Wi-Fi v1 dan Facebook Wi-Fi v2

Facebook Wi-Fi dirancang untuk meningkatkan pengalaman terhubung ke hotspot Wi-Fi di tempat bisnis. Produk ini memungkinkan pelanggan pelapak mendapatkan Wi-Fi gratis cukup dengan singgah di Facebook. Produk ini juga memungkinkan pelapak mengontrol siapa yang bisa menggunakan Wi-Fi mereka dan berapa lama, serta diintegrasikan dengan iklan agar bisa menargetkan pelanggan yang sudah menggunakan Wi-Fi pelapak tersebut. Produk ini dihentikan pada 12 Juni 2023. Karena periode pemberitahuan mitra sudah berakhir, semua endpoint yang digunakan oleh Facebook Wi-Fi v1 dan Facebook Wi-Fi v2 sudah dihentikan dan dihapus.

Penghentian Versi API:

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

Graph API

14 September 2023: Graph API v11.0 akan dihentikan dan dihapus dari platform
8 Februari 2024: Graph API v12.0 akan dihentikan dan dihapus dari platform
28 Mei 2024: Graph API v13.0 akan dihentikan dan dihapus dari platform

Marketing API

20 September 2023: Marketing API v14.0 akan dihentikan dan dihapus dari platform
20 September 2023: Marketing API v15.0 akan dihentikan dan dihapus dari platform
6 Februari 2024: Marketing API v16.0 akan dihentikan dan dihapus dari platform

Agar bisnis Anda tidak terganggu, kami merekomendasikan Anda untuk memigrasi semua panggilan ke API versi terbaru yang diluncurkan hari ini.