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

23 Januari 2024OlehMohamed Amr Abouelhassan

Hari ini, kami merilis Facebook Graph API v19.0 dan Marketing API v19.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 tentang semua perubahan dan detailnya, kunjungi catatan perubahan kami.

Pembaruan Umum

Mengaktifkan Advantage Detailed Targeting untuk Semua Tujuan dan Pengoptimalan Kampanye

Sebagai bagian dari upaya berkelanjutan kami untuk membantu pengiklan meningkatkan kinerja, kami memperluas ketersediaan produk Advantage detailed targeting untuk semua tujuan dan pengoptimalan kampanye.

Advantage detailed targeting adalah bagian dari rangkaian produk Advantage kami yang memanfaatkan teknologi otomatisasi dan pembelajaran mesin yang canggih untuk meningkatkan kinerja kampanye pengiklan. Secara khusus, Advantage detailed targeting bisa membantu meningkatkan kinerja kampanye dengan memungkinkan sistem kami menjangkau kelompok orang yang lebih luas daripada yang ditentukan dalam pilihan penargetan terperinci awal pengiklan, jika sistem kami memprediksi hal tersebut berpotensi meningkatkan kinerja.

Pada 23 Januari 2024, kami akan meluncurkan beberapa perubahan berikut untuk pengiklan dan mitra yang menggunakan Marketing API:

Kampanye yang dioptimalkan untuk impresi, tayangan video, jangkauan, interaksi, atau peningkatan ad recall kini memiliki opsi untuk menggunakan Advantage detailed targeting.
Pada kampanye yang dioptimalkan untuk prospek, Advantage detailed targeting akan otomatis diterapkan dengan opsi untuk tidak menggunakannya.
- Catatan: opsi penggunaan akan diaktifkan untuk kampanye/set iklan yang baru dan diduplikasi. Anda juga bisa menggunakan tombol ini jika ingin menonaktifkannya.
Pada kampanye yang dioptimalkan untuk klik tautan atau tayangan halaman tujuan, Advantage detailed targeting akan otomatis diterapkan tanpa opsi untuk tidak menggunakannya.

Bagi pengiklan dan mitra yang menggunakan Marketing API, perubahan ini akan menyebabkan kerusakan. Mulai 23 Januari 2024, developer bisa mulai menerapkan perubahan kode dan memiliki waktu hingga 22 April 2024 untuk melakukan perubahan ini. Perubahan ini akan dirilis dalam rilis API baru V19.

<Impacted endpoints>

Jenis Permintaan	Endpoint	Perubahan
GET	/act_{ad-account-id}/delivery_estimate /{adset-id}/delivery_estimate	Kolom 'targeting_optimization' tidak akan diterima untuk kampanye yang dioptimalkan untuk klik tautan atau tayangan halaman tujuan. Ini juga berlaku untuk pengoptimalan sebelumnya yang sudah disertakan dalam Advantage Detailed Targeting tanpa opsi untuk tidak menggunakannya, termasuk konversi, nilai, penginstalan aplikasi, peristiwa aplikasi, dan konversi. Kolom targeting_as_signal harus bernilai nol atau 0 untuk kampanye yang dioptimalkan untuk impresi, tayangan video, jangkauan, interaksi, peningkatan ad recall, atau prospek. Jika tidak, akan terjadi kesalahan.
POST	/act_{ad_account_id}/{adsets} /{adset-id}	Kolom 'targeting_optimization' tidak akan diterima untuk kampanye yang dioptimalkan untuk klik tautan atau tayangan halaman tujuan. Ini juga berlaku untuk pengoptimalan sebelumnya yang sudah disertakan dalam Advantage Detailed Targeting tanpa opsi untuk tidak menggunakannya, termasuk konversi, nilai, penginstalan aplikasi, peristiwa aplikasi, dan konversi. Untuk semua pengoptimalan yang menggunakan Advantage Detailed Targeting tanpa opsi untuk tidak menggunakannya, kami akan otomatis menetapkan kolom targeting_as_signal ke 1 atau 3 berdasarkan rangkaian tujuan + pengoptimalan.

Jenis Permintaan

Endpoint

Perubahan

GET

/act_{ad-account-id}/delivery_estimate

/{adset-id}/delivery_estimate

Kolom 'targeting_optimization' tidak akan diterima untuk kampanye yang dioptimalkan untuk klik tautan atau tayangan halaman tujuan. Ini juga berlaku untuk pengoptimalan sebelumnya yang sudah disertakan dalam Advantage Detailed Targeting tanpa opsi untuk tidak menggunakannya, termasuk konversi, nilai, penginstalan aplikasi, peristiwa aplikasi, dan konversi.
Kolom targeting_as_signal harus bernilai nol atau 0 untuk kampanye yang dioptimalkan untuk impresi, tayangan video, jangkauan, interaksi, peningkatan ad recall, atau prospek. Jika tidak, akan terjadi kesalahan.

POST

/act_{ad_account_id}/{adsets}

/{adset-id}

Kolom 'targeting_optimization' tidak akan diterima untuk kampanye yang dioptimalkan untuk klik tautan atau tayangan halaman tujuan. Ini juga berlaku untuk pengoptimalan sebelumnya yang sudah disertakan dalam Advantage Detailed Targeting tanpa opsi untuk tidak menggunakannya, termasuk konversi, nilai, penginstalan aplikasi, peristiwa aplikasi, dan konversi.
Untuk semua pengoptimalan yang menggunakan Advantage Detailed Targeting tanpa opsi untuk tidak menggunakannya, kami akan otomatis menetapkan kolom targeting_as_signal ke 1 atau 3 berdasarkan rangkaian tujuan + pengoptimalan.

Iklan, set iklan, dan kampanye baru Marketing API yang menggunakan tujuan awal

Dimulai dengan Marketing API v19.0, iklan, set iklan, dan kampanye baru yang menggunakan tujuan awal (tercantum di bawah) tidak bisa lagi dibuat melalui salinan iklan. Tujuan iklan harus diperbarui agar sesuai dengan tujuan kami yang disederhanakan.

Dimulai dengan Marketing API versi 20, membuat iklan dan set iklan berdasarkan kampanye tujuan awal tidak lagi didukung. Namun, semua versi API sebelum v20 (yaitu v19, v18) akan tetap memungkinkan fungsi ini. Tidak diperlukan tindakan langsung untuk iklan yang ada yang menggunakan tujuan awal.

Tujuan awal yang terpengaruh

BRAND_AWARENESS
CONVERSIONS
EVENT_RESPONSES
LEAD_GENERATION
LINK_CLICKS
LOCAL_AWARENESS
MESSAGES
OFFER_CLAIMS
PAGE_LIKES
POST_ENGAGEMENT
REACH
STORE_VISITS
VIDEO_VIEWS

Endpoint POST yang terpengaruh

/{ad_id}/copies
/{campaign_id}/copies
/{adset_id}/copies

Sebagai referensi, artikel ini adalah postingan blog developer sebelumnya terkait perubahan API pada pembuatan kampanye yang menggunakan tujuan awal.

Pertanyaan Umum

T: Apakah perubahan ini mengharuskan pembaruan kode?

J: Ya, ada beberapa panggilan API untuk V18 yang tidak berfungsi di V19 (yakni, iklan, set iklan, dan kampanye baru yang menggunakan tujuan awal tidak bisa lagi dibuat melalui salinan iklan).

T: Apa ekspektasi perilaku sebelum dan sesudah perubahan?

J: Sebelumnya, panggilan API untuk menduplikasi iklan, set iklan, atau kampanye yang menggunakan tujuan awal akan berhasil, setelah ini panggilan itu akan gagal.

T: Kapan jadwal implementasi perubahan kode?

J: Hingga penghentian v18.0, untuk sementara dilakukan pada September 2024.

Dokumentasi developer tambahan

Artikel bantuan

PPCA (izin Akses Konten Publik Halaman)

Kasus penggunaan untuk data yang dikumpulkan dengan penggunaan PPCA (izin Akses Konten Publik Halaman) telah berubah. Untuk detailnya, buka tautan ini.

Memperkenalkan Advantage+ audience API

Pada Oktober tahun lalu, kami meluncurkan pemirsa Advantage+, pengalaman pembuatan pemirsa yang baru dan disederhanakan untuk membantu meningkatkan kinerja kampanye dengan cara memperluas pemirsa berpotensi yang menjadi target iklan, sambil tetap menayangkan iklan ke orang yang paling ingin dijangkau oleh pengiklan.

Kini kami meluncurkan pemirsa Advantage+ di Marketing API.

Untuk menggunakannya, atur parameter targeting_automation dalam advantage_audience ke 1.
Untuk tidak menggunakannya, atur parameter targeting_automation dalam advantage_audience ke 0.

Penghentian & Perubahan Sela

Menghentikan Facebook Groups API

Facebook Groups API dihentikan di v19 dan dalam 90 hari akan dihapus dari semua versi. Penghentian ini mencakup semua Izin (publish_to_groups, groups_access_member_info) dan Fitur yang Bisa Ditinjau (Groups API) yang terkait dengan Facebook Groups API.

Kasus penggunaan paling umum untuk Groups API adalah Balasan Pribadi di grup. Kami meluncurkan perubahan lain di v19 yang akan memungkinkan kasus penggunaan tersebut tanpa mengharuskan developer menggunakan Groups API. Untuk sebagian besar developer Balasan Pribadi, tidak perlu dilakukan perubahan di v19. Untuk developer yang mengandalkan panggilan ke beberapa endpoint Postingan Grup melalui Groups API setelah menerima webhook Balasan Pribadi, developer tersebut kini harus memastikan mereka menggunakan Token Akses Halaman untuk permintaan tersebut.

Developer tidak yakin apakah endpoint mereka yang menggunakan izin yang berakhir bisa memverifikasi ini dengan menguji endpoint di Versi 19.0

Perubahan Page Insights API - Penghentian metrik

Saat kami bermigrasi dari Halaman Klasik ke pengalaman Halaman baru di Facebook, kami akan menghentikan sejumlah metrik Page Insights API. Untuk informasi selengkapnya, buka tautan ini.

Penghentian Versi API:

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

Graph API

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
17 September 2024: Graph API v14.0 akan dihentikan dan dihapus dari platform

Marketing API

6 Februari 2024: Marketing API v16.0 akan dihentikan dan dihapus dari platform
14 Mei 2024: Marketing API v17.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.

Meta Business SDK

Rilis Meta Business SDK v19

Rilis Meta Business SDK v19 akan diterbitkan segera setelah perilisan Graph API v19. Perilisan ini mencakup perbaikan bug, upgrade dependensi, fitur baru, dan yang paling penting, pembaruan antarmuka API agar sesuai dengan Graph API v19. Ke depannya, kami berencana untuk lebih sering merilis SDK agar selaras dengan rangkaian pembaruan API. Dengan begitu, developer bisa selalu mengetahui API, fungsi, dan fitur terbaru.

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