Kembali ke Beranda untuk Developer

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

23 Mei 2023OlehAyyad Farah

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

Penghentian & Perubahan Sela

Penghentian Strategi Iklan

Produk beta Strategi Iklan tidak digunakan lagi sejak 28 Oktober 2022. Oleh karena itu, kami menghentikan kolom ad_strategy_id dan ad_strategy_group_id pada endpoint kampanye bersamaan dengan rilis Marketing API v17.0.

Penghentian Offline Conversions API

Sejak Februari 2023, Conversions API sepenuhnya mendukung peristiwa offline, memastikan fitur paritas disediakan oleh endpoint Offline Conversions API saat ini. Dengan menggabungkan API peristiwa web dan offline kami ke dalam satu API, kami berharap dapat menyederhanakan dan meningkatkan cara pengiklan menggunakan data marketing lintas saluran untuk menyempurnakan pengoptimalan iklan, pemirsa khusus, dan pengukuran.

Mulai dari Graph API versi 17 dan seterusnya, yang dirilis pada tanggal 23 Mei 2023, Offline Conversions API tidak lagi mendukung peristiwa offline. Kami merekomendasikan agar pengiklan dengan integrasi Offline Conversions API mengubah integrasinya ke integrasi Conversions API dan tidak memperbarui Offline Conversions API sampai mereka berhasil mengubah integrasi.

Penghentian pembuatan tujuan Legasi

Seperti yang diumumkan pada bulan Desember 2021, kami mendesain ulang pengalaman pemilihan yang objektif saat membuat kampanye baru untuk memandu pengiklan secara efektif ke pengaturan kampanye yang membantu dalam mencapai target marketing mereka dengan lebih baik. Pengalaman baru, Pengalaman Iklan yang Didorong Hasil, menghasilkan perubahan pada Marketing API.

Kami akan memulai proses penghentian pengalaman dan tujuan lama, dimulai dengan rilis Marketing API v17.0. Saat menggunakan Marketing API v17.0, kampanye hanya dapat dibuat dengan tujuan Pengalaman Iklan yang Didorong Hasil, dan API tujuan lama tidak berlaku lagi. Kampanye versi lama yang ada dan duplikasi dari kampanye versi lama yang ada akan tetap didukung, dan tidak terpengaruh dalam versi ini. Detail selengkapnya dapat ditemukan di postingan blog developer terbaru kami.

Kolom penyempurnaan standar materi iklan Advantage+ diperlukan

Awal tahun ini kami merilis penyempurnaan standar materi iklan Advantage+ pada Marketing API. Mulai 23 Mei 2023, pengguna Marketing API akan diminta untuk menentukan pendaftaran iklan ke penyempurnaan standar materi iklan Advantage+ dengan memberikan 'OPT_IN' atau 'OPT_OUT' di kolom 'enroll_status'. Jika kolom dibiarkan kosong, pengguna akan menerima pesan kesalahan dan diarahkan untuk melengkapi kolom. Untuk mempelajari selengkapnya tentang penyempurnaan standar materi iklan Advantage+ pada Marketing API, baca postingan blog developer ini.

Endpoint berikut terpengaruh

  • POST /{ad-account-id}/adcreatives
  • POST /{ad-account-id}/ads

Penghentian Iklan Katalog Advantage+ untuk Streaming

Dengan rilis Marketing API v17, kami menghentikan penggunaan Iklan Katalog Advantage+ untuk Streaming (A+CA untuk Streaming). Iklan Katalog Dagang adalah rekomendasi alternatif A+CA untuk Streaming. Inilah panduan untuk menyiapkan Katalog Dagang. Endpoint di bawah ini akan dihentikan:

  • Membuat katalog A+CA untuk Streaming: Edge owned_product_catalogs dengan media_titles vertikal
  • Mengunggah Kabar Judul Media: Edge product_feeds untuk katalog A+CA untuk Streaming
  • Membuat Item Judul Media: Edge media_titles untuk katalog A+CA untuk Streaming
  • Membuat kampanye menggunakan katalog a A+CA untuk Streaming: Edge kampanye dengan katalog DAS di L3, L2, atau L1

Pada tanggal 21 Agustus 2023, perubahan di atas akan berlaku untuk semua versi Marketing API, dan kami akan menjeda semua kampanye yang memiliki lampiran A+CA untuk katalog Streaming di level L3, L2, atau L1.

Penghentian Instant Articles API

Karena produk Artikel Instan tidak berlaku lagi pada tanggal 20 April 2023, API yang memungkinkan penerbit mengelola artikel instan mereka tidak akan berlaku lagi sekarang.

Menegakkan Izin Pengelolaan Bisnis di Akun Pengguna

Sebelumnya, halaman tambahan yang dikelola bisnis ditampilkan tanpa akses izin business_management. Mulai 23 Mei 2023, jika Anda ingin terus menerima akses ke halaman yang dikelola bisnis, izin business_management akan diperlukan. Baca halaman business_management untuk detail selengkapnya terkait izin ini.

Penghentian Versi API:

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

Graph API

  • 8 Juni 2023: Graph API v10.0 akan dihentikan dan dihapus dari platform
  • 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

Marketing API

  • 15 Agustus 2023: Marketing API v14.0 akan dihentikan dan dihapus dari platform
  • 15 Agustus 2023: Marketing API v15.0 akan dihentikan 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