Entri catatan perubahan digolongkan berdasarkan kategori berikut:
Fitur Baru, Perubahan, dan Penghentian hanya berdampak pada versi ini. Breaking Changes 90-Hari mempengaruhi semua versi.
Breaking Changes tidak diikutsertakan di sini karena tidak terikat ke rilisan tertentu.
Dirilis 1 Mei 2018 | Tersedia hingga 28 Juli 2020 | Postingan Blog
subscribed_domains_phishing
API Transparansi Sertifikat untuk berlangganan domain untuk peringatan pengelabuan (phishing).groups_access_member_info
dan publish_to_groups
.Kedaluwarsa Token Akses: Token akses tidak valid jika pengguna belum berinteraksi dengan aplikasi dalam 90 hari terakhir.
id
first_name
last_name
middle_name
name
name_format
picture
short_name
age_range
context
cover
currency
devices
gender
link
locale
timezone
updated_time
verified
Izin rsvp_event
dan user_managed_groups
telah dihentikan. Izin user_managed_groups
masih dapat digunakan untuk tujuan pengujian, tetapi tidak dapat diajukan untuk Tinjauan Login.
groups_access_member_info
— untuk menerima data terkait anggota di konten grup.
publish_to_groups
— untuk memosting konten ke dalam grup atas nama pengguna.
user_age_range
– untuk mengakses rentang usia seseorang.
user_gender
– untuk mengakses jenis kelamin seseorang.
user_link
– untuk mengakses URL profil Facebook bagi pengguna aplikasi lainnya.
Tidak ada penghentian untuk versi ini.
Nilai non-zero akan dikembalikan untuk Metrik perincian Insight Halaman.
Metrik keterlibatan Halaman dan Cerita Postingan, termasuk metric
yang digunakan dengan kolom metrik tersebut, diubah namanya dari stories
menjadi activity
.
Metrik interaksi Konsumsi Postingan Halaman, termasuk metric
yang digunakan dengan kolom metrik tersebut, diubah namanya dari post_consumption*
menjadi post_clicks*
.
GET /{page-id}/insights/{metric}
- Metrik berikut akan dihapus dalam 90 hari:
page_story_adds
page_story_adds_by_age_gender_unique
page_story_adds_by_city_unique
page_story_adds_by_country_unique
page_views
page_views_unique
page_views_login
page_views_login_unique
GET /{post-id}/insights/{metric}
- Metrik berikut akan dihapus dalam 90 hari:
post_story_adds_by_action_type
post_story_adds_by_action_type_unique
post_story_adds_unique
post_story_adds
post_fan_reach
post_interests_impressions
post_interests_impressions_unique
post_interests_consumptions
post_interests_consumptions_unique
post_interests_consumptions_by_type
post_interests_consumptions_by_type_unique
post_interests_action_by_type
post_interests_action_by_type_unique
/photos
— Parameter type
untuk edge /photos
(yang tersedia dalam banyak node), tidak mendukung uploaded
lagi sebagai nilai untuk operasi GET
(GET /object/photos?type=uploaded
).GET /user
— Kolom third_party_id
dihentikan. Aplikasi yang menggunakan API versi lama bisa mendapatkan kolom ini hingga 30 Juli 2018. Aplikasi yang diinstal oleh Pengguna pada atau setelah 1 Mei 2018 tidak bisa mendapatkan kolom ini, berapa pun versi API yang digunakannya.Dirilis 1 Mei 2018 | Tersedia Hingga 1 Februari 2019 | Postingan Blog
bid_strategy
Kami memperkenalkan kolom baru bid_strategy
untuk {account-id}/adsets
yang memungkinkan Anda memilih strategi penawaran iklan berdasarkan tujuan bisnis Anda. Tiap strategi memiliki keunggulan dan kelemahan. Opsinya mencakup:
LOWEST_COST
- Dapatkan hasil terbanyak berdasarkan anggaran yang ditetapkan dan penayangan iklan optimization_goal
. Facebook akan secara otomatis menawar lebih sesuai kebutuhan untuk menghabiskan anggaran Anda. Anda dapat memberikan maksimum penawaran atau tidak memberikan batas dengan opsi ini.
TARGET_COST
- Memberikan biaya rata-rata yang stabil untuk iklan seiring dengan peningkatan anggaran iklan yang Anda tetapkan.
Untuk informasi selengkapnya, lihat Pembelian dan Pengoptimalan Iklan, Strategi Penawaran.
API baru untuk Membuat Iklan Koleksi - Dahulu, Facebook membuat canvas di latar belakang tiap kali Anda membuat iklan koleksi. Hal ini membatasi akses Anda ke canvas yang berada di latar belakang. Anda tidak dapat menggunakannya untuk menargetkan ulang pemirsa dengan pemirsa interaksi canvas. Kini saat membuat iklan koleksi dari set produk, Anda juga harus secara eksplisit membuat canvas dengan elemen yang tepat. Saat Anda menggunakan canvas ini dalam iklan koleksi, Facebook secara otomatis membuat iklan koleksi. Untuk detail selengkapnya, lihat Iklan Koleksi dari Set Produk.
Invalidasi Kolom Kanan - Kami membuat tidak valid iklan yang hanya menargetkan posisi Facebook, right_hand_column
dengan objek yang tidak valid untuk right_hand_column
di {ad_account_id}/adsets
. Kami sekarang hanya mendukung penempatan kanan untuk format iklan yang didukung dengan tujuan ini: Traffic, Konversi, dan Penjualan Katalog Produk.
is_autobid
and is_average_price_pacing
dihentikan dalam GET
dan POST
pada v3.0 dan lebih baru.
Perubahan Sintaks Aturan untuk Pemirsa Khusus - Kami memperbarui struktur aturan yang digunakan untuk membuat pemirsa khusus situs web, pemirsa khusus aplikasi seluler, pemirsa khusus interaksi halaman, pemirsa interaksi iklan prospek, pemirsa interaksi canvas, dan pemirsa khusus offline. Ini memungkinkan Anda untuk membuat aturan berdasarkan perilaku agregat, aturan dari sumber peristiwa yang berbeda-beda, dan untuk mengecualikan aturan. Lihat:
Akses Katalog Produk - Untuk mengakses item katalog, Anda harus menentukan vertikal katalog yang tepat. Jika permintaan tidak cocok dengan vertikal yang tepat untuk katalog, Anda akan mendapatkan kesalahan. Misalnya, jika Anda memiliki katalog ecommerce, sebaiknya akses dengan endpoint /products
yang sesuai, seperti GET {catalog_id}/products
, GET {product_feed_id}/products
, atau GET {product_set_id}/products
. Anda tidak dapat mengakses katalog dengan endpoint untuk vertikal lain seperti GET {catalog_id}/autos
, GET {product_feed_id}/hotels
, atau GET {product_set_id}/flights
.
String Kosong dalam Tanda Template - Kami tidak mengizinkan string kosong lagi sebagai paramater untuk Iklan Dinamis, opsi tanda template. Misalnya, jika Anda meneruskan string kosong ke {{trip.checkin_date date_format:}}
Anda mendapatkan kesalahan. Untuk mengetahui info latar belakang, lihat Iklan Dinamis, Pengelolaan Iklan.
Waktu Habis Wawasan - Jika kami mengharapkan permintaan Insights API mengakibatkan waktu habis sebelum selesai, kami mengembalikan kesalahan dengan kode kesalahan 100
dan subkode 1504033
. Kami memperkirakan ini berdasarkan ukuran permintaan dan kemajuan pemrosesan yang dibuat sesuai dengan batas waktu habis. Jika Anda mendapatkan kesalahan ini, sebaiknya lakukan permintaan Insights API asinkron untuk data ini. Lihat Pekerjaan Asinkron Insights API.
Nilai Negatif dalam Data Peristiwa - Jika Anda memposting data peristiwa ke {data_set_id}/events
dengan nilai negatif, ini akan gagal. Ini berdampak pada kolom data
untuk POST /{data_set_id-id}/events
.
Wawasan tentang Pengoptimalan Anggaran Kampanye - adset_budget_value
sekarang mengembalikan using campaign budget
saat kampanye iklan menggunakan pengoptimalan anggaran kampanye. Ini berdampak pada:
GET {adaccount-id}/insights
,
GET {campaign-id}/insights
,
GET {adset-id}/insights
,
GET {ad-id}/insights
,
POST {adaccount-id}/insights
,
POST {campaign-id}/insights
,
POST {adset-id}/insights
,
POST {ad-id}/insights
.
Pengurutan Default untuk Piksel - Jika Anda memanggil edge GET {account_id}/adspixel
di akun bisnis atau akun iklan, kami mengembalikan hasil yang diurutkan secara default, menurut nama piksel, bukan waktu pengaktifan piksel terakhir.
Ganti nama kolom statistik piksel - Kami mengganti nama kolom timestamp
di edge statistik piksel menjadi start_time
. Ini mewakili waktu mulai saat kami mulai menggabungkan data per jam pada pengaktifan piksel. Kami sekarang mengembalikannya dalam format ISO 8601 dan menyertakan offset zona waktu. Ini memperbaiki masalah saat kami mengembalikan cap waktu Unix yang tidak valid. Ini memengaruhi endpoint berikut: GET {ads-pixel-id}/stats
Menghentikan endpoint POST {pixel-id}/shared_agencies
. Harap gunakan UI Pengelola Bisnis untuk membagikan piksel iklan ke agensi.
kpi_custom_conversion_id
, kpi_type
, dan kpi_results
dari /{ad_campaign_id}
dan /ad_account_ID/campaigns
.POST {ad-id}/
,
POST {adset-id}/
,
POST act_{ad-account-id}
,
POST act_{ad-account-id}/ads
,
POST act_{ad-account-id}/adsets
Menghentikan kolom zipbytes
dari POST act_{ad-account-id}/adimages
dan menghapus kemampuan untuk mengunggah file ZIP di edge tersebut. Harap gunakan gambar dengan ekstensi: jpg
, jpeg
, gif
, bmp
, png
, tiff
, atau tif
.
Menghentikan metode saat ini untuk membuat iklan koleksi yang menggunakan satu panggilan API dengan semua aset yang diperlukan sebagai parameter. Anda sekarang perlu membuat canvas terlebih dahulu, lalu menggunakan tautan canvas untuk membuat iklan koleksi. Ini memungkinkan Anda mengakses objek canvas yang ada di latar belakang agar Anda dapat, misalnya, menargetkan ulang pemirsa. Lihat Iklan Koleksi.
Menghentikan format iklan Carousel untuk iklan dengan tujuan Interaksi Postingan Halaman. Kombinasi ini tidak valid lagi. Lihat Validasi, Tujuan, dan Materi Iklan
is_autobid
dan is_average_price_pacing
dari endpoint: POST {ad-account-id}/adsets
dan POST {adset-id}
. Gunakan kolom bid_strategy
baru untuk menentukan strategi penawaran tertentu untuk set iklan. Untuk informasi selengkapnya, lihat Penawaran dan Pengoptimalan.Menghentikan kolom di bawah delivery_estimate
untuk iklan dan akun iklan. Hasilnya tidak memenuhi kebutuhan pengiklan. Selain itu, banyak pengiklan memilii tujuan bisnis yang mungkin tidak terpenuhi dengan baik oleh jumlah tawaran yang disarankan Facebook. Kolom dan parameter yang dihentikan mencakup:
Kolom bid_estimate
,
parameter currency
,
parameter daily_budget
,
parameter optimize_for
Kami merekomendasikan Anda menggunakan nilai bisnis intrinsik yang tepat yang Anda dapatkan dari iklan dan tawaran Facebook berdasarkan ini. Jika Anda belum mengetahui nilai ini, kami menyarankan Anda menggunakan tawaran otomatis. Untuk latar belakang, lihat Pusat Bantuan Iklan, Lelang Iklan dan Pembelian dan Pengoptimalan Iklan.
Hasil yang dihentikan, yang dikembalikan dari kolom curve_budget_reach
di GET /{rf-prediction-id}
. Kami sekarang mengembalikan peta, dan menghentikan nilai pengembalian string seri JSON. Ini berdampak pada:: GET /{rf-prediction-id}
.
Menghentikan edge GET /{ad-account-id}/ratecard
.
Menghentikan beberapa kolom yang terkait dengan penagihan pada /ad_accounts
. Ini mencakup:
next_bill_date
active_billing_date_preference
pending_billing_date_preference
active_asl_schedule
salesforce_invoice_group_id
transactions
adspaymentcycle
show_checkout_experience
pixel_id
dan external_event_source
GET /customaudience
.Menghentikan matched_unique_users
di OFFLINE_EVENT_SET_ID
dikembalikan oleh GET /{data-set-id}
dan GET /{data-set-upload-id}
. Lihat API Konversi Offline.
Menghentikan edge attributed_events
dan kolom attribute_stats
di GET /{data_set_id} API
. Gunakan API GET /{data_set_id}/stats
untuk mendapatkan statistik peristiwa teratribusi.
Menghentikan kolom matched_unique_users
di OFFLINE_EVENT_SET_ID
yang dikembalikan oleh GET /{data-set-id}
dan DAPATKAN /{data-set-upload-id}
.
Menghentikan nilai pengembalian default pada GET {data_set_upload_id}
. Ini tidak mengembalikan kolom-kolom ini lagi secara default: first_upload_time
, last_upload_time
, api_calls
, valid_entries
, matched_entries
, duplicate_entries
, event_time_min
, event_time_max
, event_stats
, dan matched_unique_users
.
Menghentikan nilai pengembalian default pada GET {data_set_id}/stats
. Ini sekarang hanya mengembalikan statistik jumlah secara default. Untuk menentukan statistik mana yang harus dikembalikan, gunakan parameter fields
atau parameter summary
untuk statistik kumulatif seperti average_upload_delay
.
Menghentikan nilai pengembalian default untuk GET {data_set_id}
. Ini tidak mengembalikan kolom-kolom ini lagi secara default: attribute_stats
, duplicate_entries
, event_stats
, event_time_max
, event_time_min
, matched_entries
, matched_unique_users
, usage
, valid_entries
.
Menghentikan edge GET {data-set-upload-id}/stats
. Harap gunakan kolom valid_entries
atau matched_entries
dari GET {data-set-upload-id}
.
Menghentikan canvas_component_avg_pct_view
dari Insights API.