Versi 11.0

Graph API

Dirilis 8 Juni 2021 | Tersedia sampai 14 September 2023 | Postingan Blog

Aplikasi Konsumen

Level Akses

Berlaku untuk semua versi.

Dalam beberapa minggu ke depan, level akses akan diterapkan untuk semua aplikasi Konsumen yang sudah ada. Untuk aplikasi-aplikasi ini, izin dan fitur yang telah disetujui melalui proses Tinjauan Aplikasi akan secara otomatis disetujui untuk Advanced Access. Semua izin dan fitur lain secara otomatis akan disetujui untuk Akses Standar.

Level akses juga akan berlaku untuk semua aplikasi baru yang dibuat dalam beberapa minggu ke depan. Aplikasi yang baru dibuat akan secara otomatis disetujui untuk Advanced Access pada izin email dan public_profile. Namun, kedua izin tersebut akan diatur ke Akses Standar secara default dan harus diatur secara manual ke Advanced Access sebelum dapat diminta dari pengguna aplikasi yang tidak memiliki peran di aplikasi.

Dukungan Developer

Kami telah merilis alat Status Facebook untuk Bisnis guna memantau kesehatan platform dan produk bisnis seperti Pengelola Iklan, WhatsApp Business, dan Platform Developer Facebook.

Facebook Analytics

Penghentian

Berlaku untuk semua versi.

Facebook Analytics tidak akan tersedia lagi setelah 30 Juni 2021. Selain itu, kami juga menghentikan Plugin Dasbor Aplikasi untuk Marketing API. Untuk informasi selengkapnya, kunjungi Pusat Bantuan Bisnis.

Kolom Node Aplikasi berikut tidak lagi tersedia:

analytics_config
analytics_platform_metrics_config
permissible_ad_accounts

Endpoint berikut tidak lagi tersedia:

GET Application/analytics_cohort_query
GET Application/analytics_entity_user_config
GET Application/analytics_event_types
GET Application/analytics_funnel_query
GET Application/analytics_query
GET Application/analytics_segments

Instagram Basic Display API

Debugger Token Akses

Berlaku untuk semua versi.

Alat debugger token akses sekarang hanya menampilkan ID lingkup aplikasi saat debugging token.

Versi API

Berlaku untuk semua versi.

API sekarang mendukung panggilan versi. Untuk membuat kueri versi API tertentu, sertakan nomor versi di jalur kueri setelah URL dasar. Contoh:

https://graph.instagram.com/v11.0/{node-id}/{edge-name}

Permintaan tanpa versi (nomor versi tidak ada) diarahkan ke versi yang ditentukan dalam pengaturan Dasbor Aplikasi > Pengaturan > Advanced > Upgrade Versi API dari aplikasi pemanggil.

ID Pengguna Lingkup Aplikasi

Berlaku untuk versi 11.0+.

ID Pengguna Lingkup Aplikasi (ASID) telah diperkenalkan. ASID akan menggantikan ID pengguna mentah dalam waktu sekitar dua tahun, ketika versi 10.0 tidak berlaku lagi, sehingga kami merekomendasikan Anda untuk mulai memetakan ID mentah pengguna aplikasi Anda ke ASID yang setara.

Semua versi mendukung kueri berbasis ID pengguna mentah.
Hanya panggilan versi 11.0+ yang mendukung kueri berbasis ASID.
Panggilan versi 11.0+ akan menerima ASID dalam tanggapan, bahkan saat menanyakan ID pengguna mentah.

Paginasi Berbasis Waktu

Berlaku untuk v11.0+.

Menambahkan parameter since dan until ke endpoint GET /{user-id}/media untuk mendukung paginasi berbasis waktu.

Instagram Graph API

Jumlah Suka

Berlaku untuk v11.0+. Akan berlaku untuk semua versi mulai 7 September 2021.

Jika secara tidak langsung mengirim kueri Media Instagram melalui endpoint lain atau perluasan kolom, kolom like_count akan dihilangkan dari tanggapan API jika pemilik media menyembunyikan jumlah suka. Mengkueri langsung ke Media Instagram (yang hanya dapat dilakukan oleh pemilik Media Instagram) akan menampilkan jumlah suka yang sebenarnya, meskipun jumlah suka telah disembunyikan.

Paginasi Berbasis Waktu

Berlaku untuk v11.0+.

Menambahkan parameter since dan until ke endpoint GET /{ig-user-id}/media untuk mendukung paginasi berbasis waktu.

Instant Experience

Template

Berlaku untuk v11.0+.

Template Instant Experience telah keluar dari versi beta dan sekarang tersedia untuk semua developer.

Platform Messenger

Webhooks Postback Berkirim Pesan

Berlaku untuk v11.0+.

Kolom mid telah ditambahkan ke Webhooks messaging_postbacks untuk mengizinkan aplikasi mendapatkan ID Pesan.

Penghentian Template Maskapai

Berlaku untuk v11.0+. Akan berlaku untuk semua versi mulai 6 Desember 2021.

Panggilan ke POST /{page-id}/messages yang menyertakan template maskapai (template_type dari jenis airline_boardingpass, airline_checkin, airline_itinerary, airline_update) akan gagal.

oEmbed

Fitur Baca oEmbed Baru

Berlaku untuk semua versi.

Produk oEmbed telah digantikan dengan fitur Baca oEmbed baru. Jika Anda menerapkan produk oEmbed sebelum 8 Juni 2021, Anda memiliki waktu sampai 7 September 2021 untuk menyelesaikan Tinjauan Aplikasi untuk fitur Baca oEmbed. Jika Anda belum disetujui untuk fitur Baca oEmbed sampai 7 September 2021, penerapan oEmbed Anda akan gagal dimuat.

Pages API

ID Komentar

Berlaku untuk v11.0+. Akan berlaku untuk semua versi mulai 7 September 2021.

Kolom id untuk komentar tidak akan ditampilkan untuk aplikasi apa pun yang hanya menggunakan fitur Akses Konten Publik Halaman guna mengkueri endpoint Halaman. Ini termasuk kolom id, /PAGEPOST-ID/comments, atau /COMMENT-ID/comments. Guna mendapatkan kolom id pada komentar untuk komentar pada postingan Halaman, pengguna aplikasi harus dapat melakukan tugas MODERASI di Halaman yang dikueri.

Pengalaman Halaman Baru

Dalam beberapa bulan ke depan, semua Halaman klasik akan dimigrasikan ke Pengalaman Halaman Baru. Gunakan has_transitioned_to_new_page_experience kolom Halaman untuk menentukan apakah Halaman telah dimigrasikan. Setelah semua Halaman dimigrasikan, pengalaman Halaman klasik tidak akan tersedia lagi.

Sebagian besar endpoint Pages API mendukung Halaman klasik dan NPE. Endpoint yang mendukung Halaman NPE menampilkan bagian "Pengalaman Halaman Baru" di referensinya.

Endpoint berikut tidak mendukung halaman NPE:

/PAGE-ID/likes
/PAGE-ID/global_brand_children
/PAGE-ID/locations
/PAGE-ID/tabs
/PAGE-ID/visitor_posts

Beberapa kolom Halaman tidak tersedia untuk NPE dan akan menampilkan null, set data yang berbeda, atau kesalahan saat dipanggil. Kunjungi Ringkasan Pengalaman Halaman Baru kami untuk daftar kolom Halaman ini.

Izin

user_likes

Berlaku untuk semua versi.

Penggunaan diizinkan untuk izin user_likes telah diperbarui. Mulai 7 September 2021, aplikasi yang telah disetujui untuk izin ini tetapi melanggar deskripsi penggunaan barunya akan dicabut persetujuannya.

Penggunaan diizinkan versi lama: Meningkatkan kualitas pengalaman pengguna di aplikasi Anda secara signifikan (harus jelas bagi pengguna bagaimana datanya digunakan untuk menyediakan pengalaman tersebut).
Penggunaan diizinkan versi baru: Menyediakan pengalaman yang dipersonalisasi dengan menghubungkan atau memunculkan konten yang terkait dengan kesukaan orang tersebut. Ini termasuk melakukan kurasi konten dalam skala besar untuk menyesuaikan aplikasi dengan jumlah konten yang besar, dan memudahkan orang untuk membagikan apa yang mereka sukai kepada orang lain, misalnya di aplikasi kencan dan musik.

user_posts

Berlaku untuk semua versi.

Penggunaan diizinkan untuk izin user_posts telah diperbarui. Mulai 7 September 2021, aplikasi yang telah disetujui untuk izin ini tetapi melanggar deskripsi penggunaan barunya akan dicabut persetujuannya.

Penggunaan diizinkan versi lama: Meningkatkan kualitas pengalaman pengguna di aplikasi Anda secara signifikan (harus jelas bagi pengguna bagaimana datanya digunakan untuk menyediakan pengalaman tersebut).
Penggunaan diizinkan versi baru: Memungkinkan orang membuat buku atau album fisik atau digital dari linimasa mereka, dan berbagi kenangan dari linimasa mereka di Facebook atau di aplikasi sosial lainnya.

SDK

Kunjungi Catatan Perubahan iOS SDK, Catatan Perubahan Android SDK, dan Catatan Perubahan Unity SDK untuk mempelajari tentang perubahan penting yang akan datang pada SDK ini.

Marketing API

Dirilis 8 Juni 2021 | Tersedia sampai 23 Februari 2022 | Postingan Blog

Audiens

Penghapusan Pemirsa Khusus, Pemirsa Serupa, dan Pemirsa Tersimpan

Berlaku untuk semua versi.

Mulai 8 Juni 2021 dan ke depannya, Pemirsa Khusus, Pemirsa Serupa, atau Pemirsa Tersimpan yang belum digunakan dalam set iklan aktif apa pun selama lebih dari dua tahun akan ditandai sebagai "Pemirsa Kedaluwarsa". Kemudian, pemirsa tersebut dijadwalkan akan dihapus dalam 90 hari setelah ditandai sebagai "Pemirsa Kedaluwarsa".

Developers akan dapat memfilter status "Pemirsa Kedaluwarsa" menggunakan kolom operation_status dan melihat estimasi penghapusan waktu pemirsa dalam sistem menggunakan kolom delete_time. Developer dapat memilih untuk menghapus pemirsa secara proaktif atau menggunakan pemirsa dalam set iklan aktif untuk mencegah penghapusan. Setelah pemirsa dihapus, pengiklan tidak akan dapat mengaktifkan kembali pemirsa tersebut.

Untuk Pemirsa Khusus (kecuali Pemirsa Khusus Daftar Pelanggan), Pemirsa Serupa, atau Pemirsa Tersimpan:

Jika pengiklan ingin pemirsa yang ditandai dihapus secara otomatis mulai 6 September 2021, tidak ada tindakan yang perlu dilakukan. Namun, jika diinginkan, pengiklan juga dapat secara proaktif menghapus pemirsa sebelum tanggal penghapusan otomatis.
Untuk pemirsa yang ditandai pengiklan agar dipertahankan, pengiklan harus merencanakan untuk menggunakan pemirsa ini dalam set iklan aktif sebelum 6 September 2021 agar pemirsa ini tidak dihapus.

Untuk Pemirsa Khusus Daftar Pelanggan:

Kami menyimpan ini atas nama pengiklan sesuai dengan instruksi mereka. Jika pengiklan tidak mengambil tindakan apa pun untuk menggunakan pemirsa yang ditandai di set iklan aktif sebelum 6 September 2021, kami akan menganggap ini sebagai petunjuk untuk menghapus pemirsa yang ditandai.

Endpoint dan kolom berikut akan terpengaruh:

GET /{custom-audience-id}
GET /act_{ad-account-id}/customaudiences?filtering
GET /act_{ad-account-id}/saved_audiences?filtering
GET /{saved-audience-id}

Lihat Ringkasan Pemirsa: Perubahan Penghapusan Pemirsa Khusus untuk informasi selengkapnya tentang pembaruan ini.

API Bisnis

Berlaku untuk semua versi.

Kami sementara membatasi akses ke endpoint berikut. Hanya aplikasi yang telah berhasil memanggil endpoint ini dalam 30 hari terakhir yang akan terus memiliki akses.

Semua aplikasi lain akan mendapatkan pesan kesalahan saat melakukan panggilan ke endpoint ini.

Catalog API

Kolom Inventaris Produk Tidak Berlaku Lagi

Berlaku untuk 11.0+.

Kolom inventory tidak akan berlaku lagi dan digantikan dengan kolom baru quantity_to_sell_on_facebook. Meski kami akan terus mendukung kolom inventory untuk waktu dekat, kami rekomendasikan Anda untuk menggunakan kolom quantity_to_sell_on_facebook yang baru.

Endpoint berikut terpengaruh:

Lihat Jumlah untuk Dijual dan Kolom yang Didukung untuk Produk - Iklan Dinamis & Perdagangan untuk informasi selengkapnya tentang pembaruan ini.

Penghapusan Grup Produk yang Tidak Kosong

Berlaku untuk 11.0+. Akan berlaku untuk semua versi mulai 7 September 2021.

Kami tidak akan lagi mengizinkan penghapusan grup produk yang tidak kosong secara default. Grup produk yang tidak kosong dapat dihapus dengan menerapkan deletion_method=delete_items ke permintaan penghapusan. Ini akan menghapus grup produk dan itemnya.

Endpoint berikut terpengaruh:

DELETE /<product_group_id>

Penghapusan Set Produk Aktif

Berlaku untuk 11.0+. Akan berlaku untuk semua versi mulai 7 September 2021.

Kami tidak akan lagi mengizinkan penghapusan katalog dengan set produk aktif secara default. Untuk mengaktifkan penghapusan katalog yang berisi set produk aktif, atur parameter allow_delete_catalog_with_live_product_set katalog ke true.

Perubahan ini berdampak pada endpoint berikut:

DELETE /<product_catalog_id>

Endpoint Diagnostik Baru

Berlaku untuk 11.0+.

Kami telah menambahkan endpoint baru GET /{product_catalog_id}/diagnostics. Endpoint ini dapat digunakan untuk mengambil data diagnostik untuk katalog tertentu, seperti isu yang mencegah produk ditampilkan di saluran dan peluang yang dapat meningkatkan kemampuan produk untuk ditemukan.

Commerce API

Estimasi Detail Pembayaran Total Pesanan

Berlaku untuk 11.0+. Akan berlaku untuk semua versi mulai 7 September 2021.

Kami mengubah cara estimasi detail pembayaran dilaporkan dalam total pesanan untuk panggilan ke endpoint {commerce-order-id}/?fields=estimated_payment_details. Sebelumnya, jika pesanan tidak dipenuhi, estimasi pajak digunakan, dan untuk pesanan yang dipenuhi, pajak yang dipenuhi digunakan. Mulai versi 11.0, endpoint ini akan selalu menggunakan estimasi pajak. Perhatikan bahwa detail tentang pajak yang dipenuhi dapat diakses menggunakan {commerce-order-id}/items?fields=tax_details.

Peningkatan Konversi

Perubahan Metrik

Berlaku untuk v11.0+. Akan berlaku untuk semua versi mulai 7 September 2021.

Metrik yang ditampilkan dari kolom GET /{objective-id}/?fields=result telah berubah.

Metrik berikut telah ditambahkan:

conversions_incremental_share
conversions_CPiC
conversions_multicell_confidence
conversions_multicell_rank
sales_incremental_share
sales_multicell_confidence
sales_multicell_rank
buyers_incremental_share
buyers_CPiB
buyers_multicell_confidence
buyers_multicell_rank

Metrik berikut telah dihapus:

advancedBuyers.control
ancedBuyers.informativeMultiCellBayesianConfidence
advancedBuyers.lift
advancedBuyers.test
advancedConversions.control
advancedConversions.informativeMultiCellBayesianConfidence
advancedConversions.lift
advancedConversions.test
advancedSales.control
advancedSales.informativeMultiCellBayesianConfidence
advancedSales.lift
advancedSales.test
buyers.baseline
buyers.bayesianCILower
buyers.bayesianCIUpper
buyers.control
buyers.delta
buyers.incremental
buyers.isStatSig
buyers.lift
buyers.multiCellBayesianConfidence
buyers.reachedPercent
buyers.singleCellBayesianConfidence
conversions.baseline
conversions.bayesianCILower
conversions.bayesianCIUpper
conversions.control
conversions.delta
conversions.incremental
conversions.isStatSig
conversions.lift
conversions.multiCellBayesianConfidence
conversions.reachedPercent
conversions.singleCellBayesianConfidence
frequency
incrementalROAS
sales.baseline
sales.bayesianCILower
sales.bayesianCIUpper
sales.control
sales.delta
sales.incremental
sales.isStatSig
sales.lift
sales.multiCellBayesianConfidence
sales.singleCellBayesianConfidence

Metrik berikut telah berganti nama:

Nama Lama	Nama Baru
`advancedBuyers.baseline`	`buyers_not_exposed`
`advancedBuyers.bayesianCILower`	`buyers_incremental_lower`
`advancedBuyers.bayesianCIUpper`	`buyers_incremental_upper`
`advancedBuyers.incremental`	`buyers_incremental`
`advancedBuyers.informativeMultiCellPairwiseBayesianConfidence`	`buyers_multicell_confidence`
`advancedBuyers.informativeSingleCellBayesianConfidence`	`buyers_confidence`
`advancedBuyers.scaled`	`buyers_control_scaled`
`advancedConversions.baseline`	`conversions_not_exposed`
`advancedConversions.bayesianCILower`	`conversions_incremental_lower`
`advancedConversions.bayesianCIUpper`	`conversions_incremental_upper`
`advancedConversions.incremental`	`conversions_incremental`
`advancedConversions.informativeMultiCellPairwiseBayesianConfidence`	`conversions_multicell_confidence`
`advancedConversions.informativeSingleCellBayesianConfidence`	`conversions_confidence`
`advancedConversions.scaled`	`conversions_control_scaled`
`advancedSales.baseline`	`sales_not_exposed`
`advancedSales.bayesianCILower`	`sales_incremental_lower`
`advancedSales.bayesianCIUpper`	`sales_incremental_upper`
`advancedSales.incremental`	`sales_incremental`
`advancedSales.informativeMultiCellPairwiseBayesianConfidence`	`sales_multicell_confidence`
`advancedSales.informativeSingleCellBayesianConfidence`	`sales_confidence`
`advancedSales.scaled`	`sales_control_scaled`
`buyers.pValue`	`buyers_raw_pValue`
`buyers.reached`	`buyers_exposed`
`buyers.scaled`	`buyers_control_raw_scaled`
`buyers.test`	`buyers_test`
`conversions.pValue`	`conversions_raw_pValue`
`conversions.reached`	`conversions_exposed`
`conversions.scaled`	`conversions_control_raw_scaled`
`conversions.test`	`conversions_test`
`IncrementalROAS`	`sales_ROAS`
`sales.pValue`	`sales_raw_pValue`
`sales.reached`	`sales_exposed`
`sales.scaled`	`sales_control_raw_scaled`
`sales.test`	`sales_test`

Daftar lengkap metrik yang tersedia dapat dilihat di Glosarium Metrik Peningkatan Facebook.

Insights API

Metrik Kunjungan Toko Tidak Berlaku Lagi

Berlaku untuk 11.0+. Akan berlaku untuk semua versi mulai 6 September 2021.

Metrik store_visits_actions dan cost_per_store_visit_actions tidak berlaku lagi.

Endpoint berikut terpengaruh:

API Iklan Promo

Endpoint API Iklan Promo Tidak Berlaku Lagi

Berlaku untuk v11.0+. Akan berlaku untuk semua versi mulai 7 September 2021.

Sebagai bagian dari upaya berkelanjutan kami untuk meningkatkan stabilitas produk, Facebook akan mengakhiri dukungannya untuk produk Iklan Promo mulai 8 Juni 2021. Iklan Facebook standar adalah pengganti yang direkomendasikan untuk mendistribusikan diskon di dalam toko dan/atau diskon online Anda. Informasi diskon, lokasi penukaran, tanggal kedaluwarsa, dan kode promosi disarankan untuk ditempatkan langsung di materi iklan Level Iklan.

Endpoint berikut tidak berlaku lagi:

GET /{page-id}/nativeoffers
POST /[page-id}/nativeoffers
GET /pagename/nativeoffers
GET /{native-offer-id}
GET /{native-offer-id}/views
POST /{native-offer-id}/codes
POST /{native-offer-id}/nativeofferviews
GET /{offer-id}/comments
GET /{offer-id}/sharedposts
GET /{offer-id}/likes