Introducing Graph API v20.0 and Marketing API v20.0

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

Pembaruan Umum

Peningkatan otomatis versi Marketing API

Untuk meningkatkan pengalaman API secara keseluruhan dengan membuatnya lebih mulus dan efisien, kami dengan senang hati mengumumkan peluncuran fitur peningkatan otomatis versi MAPI yang akan datang. Mulai hari ini, kami akan mengaktifkan fitur peningkatan versi otomatis untuk endpoint Marketing API yang tidak terpengaruh antar-versi. Ini berarti antara versi yang akan dihentikan dan versi berikutnya yang tersedia, jika endpoint tidak terpengaruh, platform akan secara otomatis meningkatkan panggilan ke versi berikutnya yang tersedia, alih-alih secara langsung menggagalkan permintaan.

Untuk mempelajari selengkapnya tentang perilaku ini, lihat Peningkatan Versi Marketing API dan blog peluncuran.

Untuk memeriksa endpoint yang terpengaruh pada setiap versi, harap lihat catatan perubahan.

Untuk pembaruan v20.0 lebih spesifik, lanjutkan membaca artikel ini.

Iklan Pengingat untuk Marketing API

Sebelum 13 Mei 2024, developer tidak bisa mendukung pembuatan iklan pengingat Instagram melalui Instagram Marketing API dan pelanggan mereka hanya bisa membuat iklan pengingat di Pengelola Iklan Meta. Kekurangan kompatibilitas ini menciptakan gangguan yang tidak diinginkan bagi mitra kami dan pelanggan mereka yang ingin menjalankan iklan pengingat.

Setelah terus mendengarkan saran tentang inkompatibilitas, kini kami mendukung penciptaan iklan pengingat melalui Instagram Marketing API pada 13 Mei 2024.

Kami mengapresiasi saran yang diterima dari komunitas developer kami dan klien mereka, serta berharap untuk terus meningkatkan pengalaman iklan pengingat yang tersedia melalui Marketing API.

Tentang iklan pengingat Instagram

Iklan pengingat Instagram membantu pengiklan menjembatani jarak antara promosi dan waktu peluncuran dengan mendorong orang yang tertarik untuk mengatur pengingat. Orang yang menyetujuinya akan menerima pengingat di saat yang paling penting sebelum acara.

Tentang pembuatan dan pengeditan peristiwa

Iklan pengingat Instagram menggunakan waktu dan tanggal mulai acara untuk menentukan kapan pengingat akan dikirimkan. Perubahan ini memungkinkan developer untuk membuat dan mengedit peristiwa di Instagram Graph API. Anda bisa membuat iklan pengiklan melalui Instagram Marketing API setelah melampirkan acara ke materi iklan.

API baru di Node Akun Iklan

Pembaruan Node Akun Iklan baru bukan merupakan perubahan yang merusak. Perubahan ini adalah penambahan API. Memanggil API ini akan menampilkan daftar semua kampanye di akun iklan tersebut yang memiliki rekomendasi panduan, beserta panduan dan perkiraan peningkatan Biaya Per Tindakan (CPA).

API baru ini akan memungkinkan pengiklan untuk melihat panduan Meta terkait kampanye mereka. Data ini sudah ada di Pusat Mitra untuk semua mitra. Namun, data ini tersedia melalui UI yang mengharuskan pengguna memilih akun iklan tunggal secara manual untuk melihat panduan tersebut.

Dengan mengotomatiskan akses data ini melalui CPA_GUIDANCE API, kami berharap untuk bisa menghilangkan langkah manual untuk memeriksa panduan per akun iklan. Bagi mitra kami, akses ke API ini akan memungkinkan mereka untuk membangun tampilan khusus secara internal dan melihat tren seiring waktu.

Jika bisnis Anda mengelola ratusan atau ribuan akun, sulit untuk memeriksa metrik mereka satu per satu, khususnya pada saat yang mendesak (rekomendasi RSS diperbarui setiap hari dan mempertimbangkan kampanye aktif dalam 28 hari terakhir). API ini akan memungkinkan agensi untuk mengidentifikasi kampanye paling menjanjikan yang bisa dioptimalkan menggunakan rekomendasi yang diberikan, yang kemudian akan digabungkan ke sistem mereka.

CPA_GUIDANCE API utamanya memungkinkan agensi untuk memberikan panduan ke mitra merek mereka tentang produk atau kategori yang memiliki biaya per akuisisi tertinggi (CPA). Dengan membagikan informasi ini, agensi bisa membantu mitra merek mereka mengoptimalkan pengeluaran iklan dan meningkatkan kinerja keseluruhan kampanye kolaboratif mereka.

Agensi juga akan bisa melacak apakah rekomendasi panduan telah ditindaklanjuti dengan mengamati tren CPA yang meningkat.

Iklan multi-pengiklan

Hari ini, kami memperkenalkan kemampuan bagi pengiklan untuk menyetujui iklan multi-pengiklan melalui Marketing API. Sebelum pembaruan ini, developer tidak bisa mendukung pembuatan iklan multi-pengiklan melalui API dan pelanggan mereka hanya bisa memilih iklan multi-pengiklan di Pengelola Iklan Meta.

Tentang iklan multi-pengiklan

Iklan multi-pengiklan bisa membantu orang menemukan produk dan layanan dari beberapa bisnis. Untuk penempatan tertentu di Facebook dan Instagram, iklan Anda bisa ditampilkan bersama iklan lain di unit iklan yang sama untuk mempermudah orang menemukan produk dan layanan dari bisnis yang dipersonalisasi untuk mereka. Unit iklan adalah wadah yang menampilkan beberapa iklan, biasanya pada halaman yang sama. Pelajari selengkapnya di Pusat Bantuan Bisnis.

Artinya bagi developer

Saat peluncuran, penayangan iklan multi-pengiklan yang dibuat melalui Marketing API dinonaktifkan secara default, yang berarti developer harus menerapkan perubahan kode bagi iklan pelanggan mereka agar memenuhi syarat untuk menayangkan pengalaman. Pembuatan iklan multi-pengiklan didukung di semua versi Marketing API, tetapi semua permintaan pembuatan iklan yang memenuhi syarat untuk iklan multi-pengiklan harus menentukan apakah iklan tersebut menyetujui penggunaannya atau tidak. Pada 19 Agustus 2024, iklan multi-pengiklan akan berubah menjadi aktif secara default dan developer yang belum menerapkan perubahan kode harus melakukannya agar bisa memberikan pelanggan kemampuan untuk menolak pengalaman tersebut.

Fitur materi iklan AI generatif yang hadir di Marketing API: Pembuatan Iklan, Perluasan Gambar, dan Pembuatan Latar Belakang

Pada bulan Oktober 2023, kami mengumumkan peluncuran fitur materi iklan yang didukung AI generatif pertama kami - Pembuatan Teks, Perluasan Gambar, dan Pembuatan Latar Belakang - bagi bisnis di Pengelola Iklan. Hari ini, kami ingin memberi tahu Anda bahwa kami menghadirkan fitur materi iklan AI generatif ini kepada pengiklan melalui Marketing API (MAPI) kami agar para mitra, agensi, dan pengiklan juga bisa memanfaatkan penawaran GenAI Meta melalui MAPI.

Fitur ini memungkinkan pembuatan beberapa variasi materi iklan dengan cepat dan otomatis. Fitur ini membuka era baru kreativitas yang memaksimalkan produktivitas, kustomisasi, dan kinerja semua pengiklan:

• Pembuatan Latar Belakang: Membuat hingga empat latar belakang untuk melengkapi gambar produk, agar bisa memberikan diversifikasi materi iklan untuk pemirsa Anda. Latar belakang yang dibuat akan berdasarkan gambar produk asli Anda dan biasanya berupa latar belakang sederhana dengan warna dan pola.

• Perluasan Gambar: Menyesuaikan aset materi iklan gambar dengan mulus agar sesuai untuk berbagai rasio aspek di seluruh tampilan, dimulai dari Kabar dan akan segera diperluas ke Reels. Dengan begitu, Anda bisa menghemat waktu dan sumber daya untuk menggunakan kembali materi iklan.

• Pembuatan Teks: Membuat beberapa versi teks iklan berdasarkan teks asli, yang menyorot poin penjualan produk/jasa dan membuat beberapa opsi teks agar bisa meragamkan iklan Anda bagi pemirsa.

Hari ini, kami membawa fitur ini ke lebih banyak pengiklan dan kami dengan senang hati memberi kekuatan AI generatif kami ke pemirsa yang lebih luas.

Selaras dengan pendekatan kami untuk menguji produk baru yang mungkin memerlukan pengawasan tambahan, vertikal industri tertentu seperti Jasa Keuangan dan Farmasi/Kesehatan serta iklan untuk Perumahan, Lowongan Kerja, atau Jasa Keuangan/Kredit (HEC), Isu Sosial, Pemilu, atau Politik (SIEP) mungkin tidak langsung memiliki akses ke semua fitur AI generatif.

Bagaimana cara kerjanya?

Saat ini, kami meluncurkan dukungan untuk fitur ini sebagai bagian dari Marketing API, khususnya API Materi Iklan. Pengiklan akan memiliki kemampuan untuk memilih fitur ini dari API serta melihat pratinjau materi iklan AI Generatif dari API.

Contoh berikut ini menampilkan cara menggunakan materi iklan Anda ke fitur AI Generatif di Marketing API.

          curl -X POST \
          -F 'name=Generative AI Creative' \
          -F 'object_story_spec={
          ...
          }' \
          -F 'degrees_of_freedom_spec={
          "creative_features_spec": {
          "image_background_gen": {
          "enroll_status": "OPT_IN"
          }
          }
          }' \
          -F 'access_token=<ACCESS_TOKEN>'\
          https://graph.facebook.com/<GRAPH_API_VERSION>/act_<AD_ACCOUNT_ID>/adcreatives
        

Catatan: Contoh di atas menunjukkan Persetujuan untuk fitur Penciptaan Latar Belakang. Serupa dengan Perluasan Gambar yang menggunakan kode image_uncrop dan untuk Pembuatan Teks menggunakan kode text_generation di creative_features_spec.

Pengiklan juga akan bisa mempratinjau materi iklan yang diubah dengan AI Generatif melalui API. Buka tautan dokumentasi developer ini untuk mempelajari selengkapnya tentang cara membuat, memberikan materi iklan, dan meninjau konten yang dibuat untuk setiap fitur GenAI kami.

Instagram Video API: Pengunggahan yang Bisa Dilanjutkan untuk Instagram Video API

Mulai 15 Mei 2024, "Protokol Pengunggahan yang Bisa Dilanjutkan” baru akan mendukung penerbitan video Instagram (yaitu Reels, Cerita Video, dan Video Carousel) baik dari video lokal maupun video url yang dihosting secara publik. Protokol baru ini memungkinkan pengunggahan file lokal dan unggahan video yang berdurasi lebih lama khusus untuk Reels (yaitu, hingga 15 menit), dan melanjutkan operasi pengunggahan setelah gangguan jaringan atau kegagalan transmisi lainnya.

Sebelumnya untuk membuat video Instagram, file video harus diunggah ke layanan hosting yang bisa diakses oleh publik, di mana URL yang bisa dibagikan akan didapatkan dan diberikan kepada Meta agar bisa menerbitkan video.

Detail alur penerbitan konten yang telah ditingkatkan bisa ditemukan di dokumentasi developer penerbitan konten dengan detail tambahan seputar media Instagram yang bisa ditemukan di sini.

Instagram Graph API: Memperkenalkan Metrik Baru

Hari ini, enam metrik tambahan untuk Media Penampung Carousel akan tersedia untuk Graph API. Metriknya adalah Suka, Komentar, Bagikan, Ikuti, Aktivitas Profil (yaitu, jumlah tindakan yang diambil saat pengguna mengunjungi profil Anda), Kunjungan Profil (yaitu, berapa kali profil Anda dikunjungi). Metrik ini telah tersedia di Halaman Insight Instagram, tetapi pembaruan ini akan memastikan bahwa metrik juga tersedia melalui Graph API.

Dengan menambahkan Suka, Komentar, Bagikan, Ikuti, Aktivitas Profil, Kunjungan Profil ke endpoint Graph API untuk Postingan Carousel, Anda akan bisa melihat metrik ini secara langsung dari Panggilan API.

Harap baca referensi daftar lengkap metrik ini di sini agar bisa menambahkan metrik yang relevan ke Panggilan GET API untuk postingan penampung carousel hari ini.

Pembaruan Jadwal Penghentian: Offline Conversion API (OCAPI) Meta

Tahun lalu, kami mengumumkan bahwa Offline Conversions API versi 17 tidak akan lagi mendukung peristiwa offline dan kami mengantisipasi penghentian Offline Conversions API di kuartal ketiga tahun 2024. Jadwal penghentian yang telah diantisipasi ini telah diperbarui dan kami mengonfirmasi bahwa Offline Conversions API (OCAPI) akan dihapus pada bulan Mei 2025. Meski penghentian OCAPI telah diperpanjang dari Q3 2024 menjadi Mei 2025, kami masih mendorong pengiklan yang saat ini mengirimkan peristiwa offline melalui Offline Conversions API (OCAPI), untuk tetap merencanakan migrasi penyiapan mereka yang ada agar bisa mulai mengirim peristiwa offline melalui Conversions API (CAPI for Offline).

Penghentian & Perubahan Disruptif

Penghentian Tombol Pesan di Messenger API

Berlaku langsung, tombol Pesan tidak akan lagi didukung di panggilan Messenger API. Perubahan ini tidak memengaruhi tempat dan tombol lainnya dan bisnis tetap bisa mengelola pesanan menggunakan Meta Business Suite.

Penghentian pembuatan Jenis Iklan Pesan Bersponsor di Marketing API

Mulai hari ini, pembuatan jenis iklan Pesan Bersponsor tidak akan lagi tersedia di Marketing API v20.0 dan dukungan pembuatan iklan untuk jenis iklan ini dari versi API sebelumnya akan berakhir setelah 90 hari. Perubahan ini tidak akan memengaruhi jenis iklan pengiriman pesan lainnya.

Kami menyarankan untuk meninjau integrasi saat ini dan menyesuaikan aplikasi sesuai keperluan untuk memastikan transisi yang mulus untuk pengguna.

Penghapusan Jangka Waktu Non-Kritis untuk Metrik Demografi Insight (melalui Instagram Graph API Eksternal)

Pada 21 Mei 2024, kami meluncurkan versi 20 dari Instagram Graph API.

Setelah 90 hari sejak peluncuran ini (yaitu, 19 Agustus 2024), Graph API tidak akan lagi membagikan metrik demografi tentang anggota pemirsa yang berinteraksi dan dijangkau dalam jangka waktu yang tidak kritis untuk Instagram Graph API (misalnya, informasi distribusi negara, kota, usia, dan jenis kelamin selama 14 dan 90 hari terakhir).

Instagram Graph API masih akan mengembalikan informasi demografis untuk bulan lalu (yaitu, “this_month”) dan minggu lalu (yaitu, “this_week”), serupa dengan aplikasi Instagram untuk memastikan konsistensi di seluruh platform.

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

Baca dokumentasi developer untuk mempelajari selengkapnya.

Penghentian Versi API:

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

Graph API

• 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.

• 20 November 2024: Graph API v15.0 akan dihentikan dan dihapus dari platform.

Marketing API

• 13 Agustus 2024: Marketing API v18.0 akan dihentikan dan dihapus dari platform.

• 4 Februari 2025: Marketing API v19.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 v20

Rilis Meta Business SDK v20 akan diterbitkan segera setelah perilisan Graph API v20. Perilisan ini mencakup perbaikan bug, peningkatan dependensi, fitur baru, dan yang paling penting, pembaruan antarmuka API agar sesuai dengan Graph API v20.

Dalam rilis ini, kami juga memperkenalkan dukungan tambahan untuk Instagram API. Tambahan tersebut adalah IGMediaForIGOnlyAPI, IGUserForIGOnlyAPI, IGRefreshAccessTokenForIGOnlyAPI, dan IGAccessTokenForIGOnlyAPI. Tambahan ini memungkinkan lebih banyak metode selain Instagram API yang ada agar Anda bisa mengambil media secara langsung. Kami bertujuan untuk menambahkan lebih banyak API yang mencakup produk Meta untuk mendukung ekosistem Business SDK.

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

• Mei 2024: Facebook Platform SDK v13.0 atau di bawahnya akan dihentikan.