Introducing Facebook Graph API v10.0 and Marketing API v10.0

Hari ini kami merilis Graph API v10.0 dan Marketing API v10.0 Facebook.

Rilis ini memiliki banyak pengumuman, pembaruan, penghentian, dan "pembatalan penghentian" yang dapat memengaruhi bagaimana aplikasi Anda terintegrasi dengan platform kami. Postingan ini menguraikan pembaruan ini dan langkah-langkah yang perlu diambil developer untuk menghindari gangguan jika memungkinkan.

Informasi mendetail tentang semua perubahan disediakan di bawah ini. Untuk spesifikasi teknis, kunjungi catatan perubahan v10.0 kami.

Kunjungi Hub Inisiatif Platform untuk mempelajari selengkapnya tentang Platform Developer kami.

Pengumuman dan Pembaruan

Sertifikasi Pemeriksaan Penggunaan Data

Untuk menghindari kehilangan akses API Platform Facebook Anda, selesaikan Pemeriksaan Penggunaan Data (DUC) dalam waktu 60 hari sejak terdaftar. Anda dapat menyelesaikan DUC dengan membuka halaman "Aplikasi Saya" di Dasbor Aplikasi.

Musim gugur lalu, Facebook meluncurkan Pemeriksaan Penggunaan Data (DUC), persyaratan tahunan baru bagi Developer untuk mengesahkan akses API dan penggunaan data mereka sesuai dengan Ketentuan Platform dan Kebijakan Developer Facebook.

Sebagai bagian dari peluncuran bertahap kami bagi semua aplikasi, Anda akan menerima tanggal jatuh tempo dan instruksi lebih lanjut melalui pemberitahuan developer, bersama dengan email ke alamat kontak terdaftar dan notifikasi dalam daftar Tindakan Diperlukan di Dasbor Aplikasi.

Untuk petunjuk mendetail tentang menyelesaikan DUC, baca dokumentasi developer kami. Informasi selengkapnya juga terdapat di Pertanyaan Umum khusus DUC.

Level Akses Data dan Batas Data 90 Hari API Grup:

Mulai 24 Mei 2021, saat menggunakan API Grup, termin akses data aplikasi yang tersedia akan dibatasi hingga 90 hari.

Kami juga memperkenalkan akses API Grup bertingkat untuk aplikasi konsumen berdasarkan apakah mereka dalam Mode Pengembangan atau Mode Terbit. Izin API Grup sekarang akan berlaku mirip dengan Akses Standar dan Lanjutan untuk aplikasi bisnis.

Hari ini, aplikasi dalam Mode Pengembangan dapat mengakses semua konten Grup Publik & Grup Pribadi jika developer-nya menjadi admin grup. Setelah menyelesaikan Tinjauan Aplikasi, aplikasi ini dapat mengakses semua konten dari grup yang telah menginstal aplikasi.

Tanggal 24 Mei 2021, aplikasi dalam Mode Pengembangan hanya dapat mengakses kontennya sendiri di Grup Publik & Grup Pribadi jika developer-nya menjadi admin grup. Artinya, aplikasi tidak akan memiliki akses ke konten yang telah diterbitkan pengguna Grup lain (tanpa peran di aplikasi), seperti postingan dan komentar.

Pelajari selengkapnya di catatan perubahan v10.0

Level Akses untuk izin public_profile dan email untuk Aplikasi Bisnis

Sebagai bagian dari inisiatif berkelanjutan kami untuk untuk menjaga dan melindungi data pengguna, kami telah menambahkan izin public_profile (yakni Kolom Profil Publik Default) dan email ke model level akses yang kami umumkan dengan Graph v8.0 bagi aplikasi jenis bisnis yang baru maupun yang sudah ada.

Aplikasi jenis bisnis yang baru dibuat kini mulai dengan Akses Standar untuk izin public_profile dan email. Jika aplikasi memiliki Akses Standar ke public_profile, hanya pengguna dengan peran di aplikasi atau bisnis yang diklaim dapat menelusuri atau masuk ke aplikasi. Jika Anda membutuhkan pengguna eksternal untuk masuk ke aplikasi Anda, admin aplikasi dapat meminta Akses Lanjutan di Dasbor Aplikasi. Akses ini akan diberikan secara otomatis.

Pelajari selengkapnya di catatan perubahan v10.0

Pengingat Permintaan Penghapusan Data

Seperti yang diumumkan tanggal 10 November 2020, jenis aplikasi Pelanggan & Gaming yang mengajukan Tinjauan Aplikasi atau transisi dari Mode Pengembangan ke Mode Terbit akan diminta untuk memberikan callback permintaan penghapusan data, atau URL dengan petunjuk eksplisit bagi pengguna tentang cara meminta penghapusan data mereka. Kami berencana untuk memberlakukan persyaratan ini paling lambat 10 November 2022 dan akan mengingatkan developer aplikasi 60 hari sebelum penegakan.

Opsi Perubahan Graph AdsInsight API untuk Proyek Pengurangan Retensi

UI Pengelola Iklan tidak lagi mendukung pelaporan data metrik insight iklan yang lebih lama dari 37 bulan. API akan mengembalikan kesalahan saat permintaan berisi rentang tanggal di luar retensi 37 bulan. Kami menonaktifkan "date_preset = lifetime" dan menggantinya dengan "date_preset = maximum".

Perubahan Graph API v10.0 untuk AdsInsight, kecuali untuk "date_preset = lifetime" akan diterapkan ke semua Graph API versi lain setelah 90 hari. Kolom spesifik yang dipanggil tidak perlu diubah. Akan ada fungsi preset, dan semua panggilan "Sepanjang waktu" akan default ke retensi maksimum 37 bulan.

Perubahan ini tidak akan memengaruhi data yang terkait dengan materi iklan, pemirsa, pengaturan penayangan, atau nama objek iklan, dan tidak akan ada perubahan pada penghitungan metrik yang ada. Perubahan ini akan berlaku di seluruh permukaan pelaporan iklan, termasuk Pengelola Iklan, Pelaporan Iklan, dan Pengalaman Iklan Ringan.

• Tanggal Rilis 23/02/2021:
  • Versi 10.0
    • Aktifkan "date_preset = maximum"
    • Nonaktifkan "date_preset = lifetime"
    • Mengembalikan kesalahan saat permintaan berisi rentang tanggal eksplisit yang berada di luar retensi 37 bulan
  • Versi 9.0 dan sebelumnya
    • Tidak ada perubahan pada fungsi saat ini
• 90 Hari Pasca Rilis - 24/05/2021:
  • Versi 9.0 dan sebelumnya
    • Aktifkan "date_preset = maximum" (sama seperti versi baru)
    • Mengembalikan kesalahan saat permintaan berisi rentang tanggal eksplisit yang berada di luar retensi 37 bulan (sama seperti versi baru)
    • "date_preset = lifetime" masih bisa berfungsi tetapi hanya mengembalikan data dalam 37 bulan, artinya, berperilaku seperti maksimum

Pelajari selengkapnya di catatan perubahan v10.0

Kebijakan Penghapusan Baru untuk data yang dimiliki secara eksternal di ThreatExchange

Mulai 24 Mei 2021, saat partner mengatur expire_time pada data yang mereka unggah ke ThreatExchange, kami akan "menghapus permanen" data pada waktu kedaluwarsa yang disebutkan. Jika Anda ingin menunjukkan bahwa data tidak lagi valid, atur kolom "expired_on" untuk menghapus secara otomatis.

Sebelumnya, penghapusan "ringan" berarti kami memberi label konten yang kedaluwarsa sebagai kedaluwarsa. Kami tidak lagi mendukung penghapusan ringan, dan setelah konten kedaluwarsa, konten tersebut akan dihapus secara permanen dan tidak akan terlihat lagi di ThreatExchange.

Selain itu, semua ThreatDescriptors non-Facebook di ThreatExchange akan dihapus secara permanen setelah kedaluwarsa. Waktu kedaluwarsa akan terus diatur oleh kreator ThreatDescriptor. Penghapusan kemudian akan dimulai pada semua ThreatDescriptors yang kedaluwarsa dan bukan buatan Facebook. Jika aplikasi Anda saat ini telah kedaluwarsa ThreatDescriptors yang tidak ingin Anda hapus saat kebijakan ini berlaku, Anda harus menekan tanggal kedaluwarsa atau mengaturnya ke "0" untuk memastikan bahwa data tidak pernah kedaluwarsa.

Klik di sini untuk mempelajari selengkapnya tentang perubahan tersebut

Perubahan Penargetan dalam API baru

Mulai 24 Mei 2021, kami tidak lagi meminta parameter location_spec dan negara saat membuat Pemirsa Khusus Serupa di semua versi API.

Saat membuat Pemirsa Serupa, pengguna memilih sumber Serupa dan rasio yang diinginkan. Lokasi untuk Serupa tersebut akan ditentukan oleh lokasi negara dalam spesifikasi penargetan kampanye. Tidak akan ada dampak pada kampanye yang ada mengingat perubahan ini. Perubahan ini hanya akan memengaruhi kampanye baru dan yang diedit.

Meluncurkan halaman Status Terbit Platform baru

Halaman Status Bisnis Facebook yang baru akan meningkatkan transparansi dan komunikasi proaktif dengan developer eksternal menggunakan Produk Platform Facebook. Halaman ini akan menyediakan tempat terpusat untuk memeriksa status platform produk bisnis Facebook (Iklan, API WhatsApp Business, Platform Developer Facebook, dsb.). Halaman tersebut saat ini aktif untuk Pengelola Iklan dan API Whatsapp Business, dan produk bisnis tambahan akan ditambahkan sampai Mei 2021.

Penghentian

Penghentian Dialog Siarkan Langsung

Mulai 24 Mei 2021, SDK Dialog Siarkan Langsung (GLD SDK) tidak berlaku lagi. Penghentian fitur produksi siaran langsung legasi ini akan terjadi di semua versi API. Perubahan ini hanya akan memengaruhi siaran langsung di Facebook. Kami mendorong developer untuk menggunakan Live Producer dan Live API untuk semua solusi produksi siaran langsung yang dipesan lebih dahulu.

Solusi untuk siarkan langsung setelah GLD SDK tidak berlaku lagi:

• Akses Live Producer secara langsung melalui facebook.com/live/producer (atau titik masuk lainnya di Facebook seperti tombol "Video Siaran Langsung" di Halaman atau Profil)
• Integrasikan solusi khusus dengan Live API

Pelajari selengkapnya di catatan perubahan v10.0

Penghentian Penargetan Koneksi

Mulai 24 Mei 2021, Penargetan Koneksi tidak lagi didukung saat membuat/mengedit set iklan. Persyaratan ini hanya akan memengaruhi kampanye baru dan yang diedit, dan tidak akan berdampak pada kampanye yang ada.

Pelajari selengkapnya di catatan perubahan v10.0

Pembatalan Penghentian

Pembatalan penghentian untuk endpoint gr:delete:Page/tabs

Saat meluncurkanGraph API v8.0, endpoint untuk Tab Halaman gr:delete:Page/tabs tidak berlaku lagi. Kami telah memutuskan untuk segera membatalkan penghentian endpoint ini untuk Graph API v10.0 dan akan memulihkan aksesnya mulai 24 Mei 2021 di semua versi Graph API lainnya.

Pelajari selengkapnya di catatan perubahan v10.0

Pembatalan penghentian endpoint gr:post:Business/business_users, gr:post:Business/system_users, dan gr:post:User/access_tokens

Saat meluncurkan Graph API v9.0, kami membatasi akses ke tiga endpoint bisnis:

• gr:post:Business/business_users
• gr:post:Business/system_users
• gr:post:User/access_tokens

Mulai peluncuran Graph API v10.0, kami akan membuka kembali endpoint ini ke panggilan API saat aplikasi memenuhi salah satu dari dua kondisi berikut:

• Bisnis target adalah bisnis yang memiliki aplikasi panggilan
• Bisnis target adalah bisnis turunan (dalam model Bisnis 2 Tingkat) dari bisnis yang memiliki aplikasi panggilan

Pelajari selengkapnya di catatan perubahan v10.0

Kalender Item Tindakan

Penghentian Versi Marketing API:

Sebagai bagian dari jadwal versi Marketing API , catatlah penghentian versi Marketing API yang akan datang:

• 3 Maret 2021: Marketing API v7.0 tidak berlaku lagi dan dihapus dari platform
• 4 Mei 2021: Marketing API v8.0 tidak berlaku lagi dan dihapus dari platform
• 25 Agustus 2021: Marketing API v9.0 tidak berlaku lagi dan dihapus dari platform

Untuk menghindari gangguan pada bisnis Anda, sebaiknya migrasikan semua panggilan ke Marketing API versi terbaru yang diluncurkan hari ini. (Kunjungi catatan perubahan untuk detail selengkapnya).

Penghentian Versi Graph API:

Sebagai bagian dari jadwal versi Graph API , catatlah penghentian versi Graph API yang terdaftar di bawah:

• 4 Mei 2021: Graph API v3.2 tidak berlaku lagi dan dihapus dari platform
• 3 Agustus 2021: Graph API v3.3 tidak berlaku lagi dan dihapus dari platform

Penghentian Umum

• 24 Mei 2021:
  • Dialog Siarkan Langsung tidak berlaku lagi dan dihapus dari platform
  • Penargetan Koneksi tidak berlaku lagi dan dihapus dari platform

Tindakan Developer Diperlukan

• Pendaftaran Bergulir: Sertifikasi Pemeriksaan Penggunaan Data
  • Setelah terdaftar, wajib diselesaikan dalam 60 hari
  • Bagian Pertanyaan Umum khusus DUC.
• 23 Februari 2021: Peluncuran perubahan Graph AdsInsight API hanya untuk Graph API v10.0
• 24 Mei 2021:
  • Peluncuran perubahan Graph AdsInsight API untuk Graph API v9.0 dan sebelumnya
  • Perubahan Level Akses Berdasarkan Tinjauan Aplikasi mulai berlaku
    • Akses data API Grup dibatasi sampai 90 hari
    • Penerapan level data bertingkat API Grup
    • Perubahan ke izin public_profile dan Email untuk Aplikasi Bisnis mulai berlaku
  • Kebijakan data "Hard Deletion" baru di ThreatExchange diterapkan
• 10 November 2022: Batas Waktu Permintaan Penghapusan Data