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

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

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

Pengumuman dan Pembaruan Umum

Menyederhanakan Kriteria Pembuatan Konversi Khusus

Untuk menyederhanakan proses pembuatan kampanye bagi pengiklan, konversi khusus yang baru dibuat akan memerlukan setidaknya satu aturan terkait dengan rilis Graph API v15.0. Konversi khusus yang tidak memerlukan aturan harus menggunakan pengoptimalan peristiwa khusus, yang memungkinkan kampanye iklan dioptimalkan langsung pada peristiwa khusus. Kami secara aktif bekerja untuk mentransisikan konversi khusus kami yang ada dari satu penawaran semua di satu tempat menjadi beberapa produk bernilai spesifik untuk lebih memenuhi kebutuhan dan kasus penggunaan pengiklan kami. Perubahan ini akan mendorong pengiklan dari konversi khusus berdasarkan peristiwa khusus ke pengoptimalan peristiwa khusus.

Pembaruan Ketentuan Platform

Kami memperbarui Ketentuan Platform mengenai kapan kami dapat menghapus akses aplikasi ke API Platform, izin, atau fitur apa pun yang belum digunakan atau diakses oleh aplikasi Anda dalam jangka waktu tertentu. Per 15 Desember 2022, Ketentuan Platform akan mewajibkan aktivitas dalam periode 28 hari agar dianggap aktif.

Jika Anda menerima pemberitahuan bahwa aplikasi Anda telah tidak aktif dan ingin memulihkan aplikasi, Anda dapat melakukannya dengan masuk ke peran admin aplikasi Anda dan mengaktifkannya kembali.

Anda dapat melihat Ketentuan Platform untuk melihat pratinjau lengkap dari perubahan ini di sini.

Penghentian & Perubahan Sela

Memperkenalkan Pemirsa Khusus Advantage

Mulai 19 September 2022, kami akan mulai meluncurkan pemirsa khusus Advantage. Pemirsa khusus Advantage menggunakan pemirsa khusus pengiklan untuk memandu penayangan dan membantu menemukan lebih banyak orang yang kemungkinan besar akan mencapai target pengoptimalan yang mereka nyatakan. Ini berarti kami akan menayangkan iklan di luar Pemirsa Khusus mereka jika kemungkinan besar akan meningkatkan kinerja. Pemirsa khusus Advantage adalah bagian dari rangkaian produk Penargetan Advantage kami, termasuk Advantage detailed targeting dan Serupa Advantage. Produk Penargetan Advantage kami memanfaatkan otomatisasi canggih dan teknologi pembelajaran mesin yang membantu meningkatkan kinerja kampanye pengiklan dengan sedikit upaya manual.

Untuk pengiklan yang memanfaatkan Pemirsa Khusus, mereka akan dapat memilih pemirsa khusus Advantage. Dengan pemirsa khusus Advantage, pengiklan akan terus membuat Pemirsa Khusus (situs web, aktivitas aplikasi, daftar pelanggan, atau interaksi) dan menerapkan penyertaan/pengecualian yang relevan, sambil memanfaatkan otomatisasi canggih dan teknologi pembelajaran mesin kami yang menggunakan pemirsa khusus Anda sebagai sumber untuk memandu penayangan agar menjangkau lebih banyak pengguna yang kemungkinan besar akan mencapai target pengoptimalan yang Anda nyatakan.

Pemirsa khusus Advantage akan secara otomatis diaktifkan ketika Anda membuat kampanye baru yang mencakup pemirsa khusus situs web, seluler, atau interaksi. Anda bisa memilih untuk tidak menggunakan produk ini dengan menghapus centang di kotak "Pemirsa khusus Advantage" di bagian Pemirsa Khusus pada fitur pembuatan iklan kami.

Penghentian Pemirsa Iklan Khusus

Sebagai bagian dari perjanjian kami dengan Departemen Perumahan dan Pengembangan Kota (HUD) AS, kami akan menghentikan Pemirsa Iklan Khusus, fitur yang memungkinkan pengiklan memperluas pemirsa mereka untuk set iklan yang terkait dengan perumahan, lowongan pekerjaan, dan kredit. Kami menghapus kemampuan untuk membuat Pemirsa Iklan Khusus melalui Marketing API mulai 15 September 2022.

Untuk pengiklan dan partner, pemblokiran pembuatan Pemirsa Iklan Khusus baru pada tanggal 15 September 2022 akan menghadirkan perubahan besar karena dengan perubahan non-versi ini, nilai sebelumnya tidak berlaku lagi. Pada tahun 2019, selain mengeliminasi opsi penargetan tertentu untuk iklan perumahan, lowongan pekerjaan, dan kredit, kami memperkenalkan Pemirsa Iklan Khusus sebagai alternatif Pemirsa Serupa. Namun, bidang keadilan dalam pembelajaran mesin adalah bidang yang dinamis dan berkembang, dan Pemirsa Iklan Khusus adalah cara awal untuk mengatasi masalah. Sekarang, fokus kami akan beralih ke pendekatan baru untuk meningkatkan keadilan, termasuk metode yang diumumkan sebelumnya.

Lihat di bawah daftar endpoint yang terpengaruh terkait dengan penghentian ini:

Untuk membaca pemirsa:

• endpoint gr:get:AdAccount/customaudiences
• kolom operation_status

Untuk pembuatan set iklan:

• endpoint gr:post:AdAccount/adsets
• subjenis kolom

Untuk pengeditan set iklan:

• endpoint gr:post:AdCampaign
• subjenis kolom

Untuk pembuatan pemirsa khusus:

• endpoint gr:post:AdAccount/customaudiences
• subjenis kolom

Untuk pengeditan pemirsa khusus:

• endpoint gr:post:CustomAudience

Silakan baca postingan blog sebelumnya dan dokumentasi developer untuk detail lebih lanjut guna mendukung penerapan kode.

Advantage detailed targeting/Keseimbangan serupa Advantage

Proyek ini menghadirkan keseimbangan untuk Penargetan Mendetail sebagai Sinyal (Advantage detailed targeting) untuk pengguna API yang menggunakan set iklan dengan Pesan/Penginstalan Aplikasi sebagai tujuan (setelah rilis Pengelola Iklan). Kami sebelumnya meluncurkan Advantage detailed targeting untuk API ke set iklan dengan Konversi sebagai tujuan dan Konversi/Nilai sebagai tujuan pengoptimalan (set iklan VO/OC).

Saat ini, ketika pengiklan membuat set iklan melalui API dengan pesan atau penginstalan aplikasi sebagai tujuan, mereka melewati dua hal sebagai bagian dari kriteria penargetan (L2). Mereka meneruskan daftar input penargetan mendetail (misalnya: kriket, sepak bola, anjing, dsb.) dan tanda yang menunjukkan apakah mereka ingin memperluas di luar input ini (disebut sebagai Advantage detailed targeting). Jika tanda diaktifkan, maka sistem kami memberikan pilihan penargetan di luar pilihan penargetan yang mendetail jika kemungkinan akan meningkatkan kinerja. Jika dinonaktifkan, sistem kami membatasi penayangan ke daftar pilihan yang disediakan pengiklan.

Ke depannya (setelah rilis Pengelola Iklan), saat pengiklan membuat kampanye baru dengan pesan atau penginstalan aplikasi seluler sebagai tujuan, penyertaan penargetan mendetail akan digunakan sebagai input (bukan batasan) untuk memandu penayangan iklan. Karena itu, kami tidak lagi menggunakan tanda DTE untuk tujuan ini dan menjadikan perluasan penargetan sebagai perilaku default dari pilihan penargetan mendetail. Saat melakukannya, kami dapat melampaui penyertaan penargetan mendetail mereka jika kemungkinan besar akan meningkatkan kinerja. Semua pilihan penargetan dan pengecualian lainnya tidak akan terpengaruh. Perubahan ini tidak akan berlaku untuk kategori khusus.

Cara kerjanya:

Sebelumnya, pengiklan akan meneruskan tanda targeting_optimization dengan nilai expansion_all atau tidak sama sekali untuk mengaktifkan atau menonaktifkan Perluasan Penargetan Mendetail. Mengingat perubahan dalam semantik tentang bagaimana penargetan terperinci akan beroperasi untuk set iklan ini, pengiklan tidak perlu meneruskan tanda ini saat membuat set iklan dengan pesan atau penginstalan aplikasi sebagai tujuan, karena hal itu tidak akan berdampak pada set iklan yang baru mereka buat. Semua set iklan yang baru dibuat ini akan selalu menggunakan penyertaan penargetan mendetail sebagai sinyal ke sistem backend kami, yang mungkin memutuskan untuk menayangkan iklan di luar pilihan ini jika itu berarti kinerja yang lebih baik bagi pengiklan.

Mengingat bahwa tanda targeting_optimization tidak akan berpengaruh pada set iklan yang baru dibuat, kami berencana untuk menghentikan kolom ini untuk kampanye baru dengan pesan dan/atau penginstalan aplikasi sebagai tujuan ke depannya.

• Untuk efek ini, jika pengiklan meneruskan tanda targeting_optimization saat membuat set iklan MAI/pesan baru atau saat meng-kueri estimasi penayangan set iklan yang baru dibuat ini, kami akan menampilkan pesan kesalahan yang meminta mereka untuk tidak mengirim parameter ini lagi.
• Kolom baru bernama targeting_as_signal akan diatur di backend selama penginstalan aplikasi baru/pembuatan set iklan pesan. Kolom ini tersedia pada perintah GET hanya untuk membantu pengiklan memverifikasi apakah set iklan mereka melampaui penyertaan penargetan mendetail.

CATATAN: Perubahan pada Penargetan Mendetail ini sebagai sinyal hanya akan berlaku untuk set iklan yang baru dibuat dengan pesan dan/atau penginstalan aplikasi sebagai tujuan.

Endpoint API dalam Lingkup:

• gr:post:/act_XXXX/ adsets
• gr:get:/<adset_id>/delivery_estimate

Penghentian Tab Halaman

Kami mengumumkan bahwa fitur API Tab Khusus Halaman tidak akan tersedia lagi melalui Graph API. Selagi kami menggulirkan pengalaman Halaman baru, ada beberapa fitur Pages API yang tidak akan berlaku lagi ke depannya. Fitur Tab Khusus Halaman tidak akan tersedia lagi di pengalaman Halaman baru, jadi kami akan menghentikan dukungan API untuk fitur ini. Kami membagikan pembaruan ini sekarang untuk memberikan cukup waktu bagi developer dan klien mereka guna menyampaikan penghentian fitur ini dari halaman mereka dan membuat perubahan yang diperlukan pada halaman mereka. Fitur ini akan dihentikan sepenuhnya pada tanggal 14 Desember 2022.

Penghentian Versi API:

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

Graph API

• 1 November 2022: Graph API v8.0 tidak berlaku lagi dan akan dihapus dari platform
• 23 Februari 2023: Graph API v9.0 tidak berlaku lagi dan akan dihapus dari platform
• 8 Juni 2023: Graph API v10.0 tidak berlaku lagi dan akan dihapus dari platform

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

Platform Facebook SDK

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

• Januari 2023: Rencana penghentian Platform Facebook SDK v8.0 ke bawah
• Juni 2023: Rencana penghentian Platform Facebook SDK v9.0 ke bawah
• Oktober 2023: Rencana penghentian Platform Facebook SDK v11.0 ke bawah