Metrik API Instagram yang dihentikan: impresi dan plays diganti views
Meta menggantikan impressions dengan views di API insights Instagram. Views diperkenalkan pada 21 Januari 2025, dan impressions, plays, clips_replays_count serta ig_reels_aggregated_all_plays_count dihentikan di setiap versi API pada 21 April 2025, setelah video_views dan enam metrik akun berakhir pada 8 Januari. Perubahan berikutnya menambahkan metrik, seperti reposts dan reels_skip_rate pada Desember 2025.
easyCoexistence membaca insights Instagram dengan get_social_insights, yang meneruskan nama metrik yang Anda berikan langsung ke Meta, termasuk views, dan mengembalikan data Meta, atau pesan kesalahan Meta sendiri saat nama dihentikan, sehingga Claude, ChatGPT atau kode Anda sendiri dapat mengikuti perubahan nama pada hari Meta membuatnya.
Kapan impressions, plays, clips_replays_count dan ig_reels_aggregated_all_plays_count dihentikan di setiap versi API.
Kapan Meta memperkenalkan views untuk insights akun dan media, serta membuka insights untuk aplikasi Instagram Login.
Kapan video_views dan enam metrik time series akun, termasuk profile_views dan website_clicks, tidak lagi didukung di setiap versi.
Media yang dibuat pada atau setelah tanggal ini mengembalikan kesalahan, bukan data, jika impressions diminta setelah 21 April 2025.
Satu-satunya metric_type yang diterima metrik views tingkat akun; impressions juga menyediakan time_series harian.
Metrik Instagram apa saja yang dihentikan Meta pada 2025?
Dua gelombang, masing-masing diumumkan berbulan-bulan sebelumnya di changelog Meta, dan diterapkan lebih dulu dari versi Graph API baru, lalu ke setiap versi:
- 8 Januari 2025:
video_viewspada media, dan deret waktu akunemail_contacts,get_direction_clicks,phone_call_clicks,profile_views,text_message_clicksdanwebsite_clicks, pertama kali dihapus di v21.0. - 21 Januari 2025: impressions pada insights akun dan media, serta plays,
clips_replays_countdanig_reels_aggregated_all_plays_countpada media, dihentikan untuk v22.0 dan yang lebih baru, pada hari views hadir. - 21 April 2025: keempat metrik itu dihentikan di setiap versi API.
Apa yang seharusnya menggantikan setiap metrik yang dihentikan?
Meta memasangkan views dengan penghentian April 2025 dalam entri changelog yang sama. Untuk metrik Januari, Meta tidak menyebut penggantinya, sehingga kolom kanan memuat metrik terdekat yang didokumentasikan di referensi akun dan media per 31 Oktober 2026.
| Retired | Request instead | |
|---|---|---|
| impressions | Account and media, 21 Apr 2025 | views |
| plays | Media, 21 Apr 2025 | views |
| clips_replays_count | Media, 21 Apr 2025 | views |
| ig_reels_aggregated_all_plays_count | Media, 21 Apr 2025 | views |
| video_views | Media, 8 Jan 2025 | views |
| phone_call_clicks, email_contacts, text_message_clicks, get_direction_clicks | Account, 8 Jan 2025 | profile_links_taps, by contact_button_type |
| profile_views | Account, 8 Jan 2025 | profile_visits, per post or Story |
| website_clicks | Account, 8 Jan 2025 | profile_activity per post, whose action_type includes BIO_LINK_CLICKED |
Apakah impressions masih mengembalikan data?
Hanya untuk media lama. Changelog Meta menyatakan bahwa permintaan setelah 21 April 2025 untuk media yang dibuat pada atau setelah 2 Juli 2024 mengembalikan kesalahan, dan referensi insights media hanya menyimpan impressions untuk media yang dibuat sebelum tanggal itu. Pada tingkat akun, impressions dihentikan di setiap versi, sehingga kode yang ditulis sekarang tidak membutuhkannya.
Apa yang dihitung views?
Pada tingkat akun, jumlah kali konten diputar atau ditampilkan, di seluruh Reels, postingan dan Stories; pada satu postingan, Reel atau Story, jumlah kali konten diputar di Instagram. impressions menghitung berapa kali konten tampil di layar, termasuk iklan, sehingga grafik yang berpindah dari satu ke yang lain mengubah apa yang diukur saat peralihan. views tingkat akun hanya menerima metric_type=total_value dan dipecah menurut media_product_type, dan Meta masih memberinya label dalam pengembangan.
Metrik apa saja yang sudah ditambahkan Meta sejak itu?
Changelog Meta mencantumkan penambahan berikut setelah penghentian 2025:
- 3 Desember 2025:
reels_skip_ratedan reposts pada media, reposts pada akun, sertacrossposted_viewsdanfacebook_viewsuntuk Reels yang di-crosspost. - 22 April 2026:
total_likes,total_commentsdantotal_views, dijumlahkan lintas permukaan dan termasuk media yang dipromosikan, yang oleh referensi Meta hanya ditawarkan dengan Facebook Login;facebook_viewsjuga diperluas ke postingan dan Stories. - 22 Juni 2026:
link_clickspada Stories, yang menghitung ketukan pada tautan seperti stiker tautan, dan yang oleh changelog dibatasi untuk Facebook Login.
Apa yang harus berubah di kode?
Daftar metrik yang ditulis sebelum 2025 memerlukan perubahan berikut agar tetap berfungsi:
- Ganti impressions, plays,
clips_replays_count,ig_reels_aggregated_all_plays_countdanvideo_viewsdengan views, baik pada permintaan akun maupun media. - Minta views tingkat akun dengan
metric_type=total_value. Metrik ini tidak punyatime_series, jadi baca satu total per rentang tempat impressions dulu memberi garis harian. - Minta
crossposted_viewsdanfacebook_viewshanya pada media yang di-crosspost, dalam permintaan tersendiri: referensi Meta menyatakan keduanya menghasilkan kesalahan jika media tidak di-crosspost. - Jangan sertakan
total_likes,total_commentsdantotal_viewsdi aplikasi Instagram Login, karena Meta hanya menawarkannya dengan Facebook Login. - Ganti
phone_call_clicks,email_contacts,text_message_clicksdanget_direction_clicksdenganprofile_links_tapsyang dipecah menurutcontact_button_type. - Perlakukan kesalahan pada nama metrik sebagai tanda untuk memperbarui daftar, bukan untuk mencoba kembali.
Bagaimana penghentian sampai ke versi API yang lebih lama?
Dalam dua tahap. Perubahan diterapkan lebih dulu dari versi Graph API baru, v21.0 untuk video_views dan v22.0 untuk impressions, lalu mencapai setiap versi pada tanggal yang tercantum di entri changelog yang sama, sekitar tiga bulan kemudian di kedua kasus. Mengunci versi lama hanya memberi beberapa bulan, paling lama, dan changelog Instagram Platform milik Meta mencantumkan kedua tanggal untuk setiap perubahan.
Penghentian lama mana yang masih memengaruhi kode lama?
Dua dari sebelum 2025 masih muncul di kode yang tidak pernah disentuh sejak itu:
- 11 Desember 2023: metrik
carousel_album,taps_forward,taps_back, exits dan engagement pada media, sertaaudience_gender_age,audience_locale,audience_countrydanaudience_citypada akun, saatfollower_demographicskini mencakup usia, kota, negara dan gender. - 19 Agustus 2024: rentang waktu
last_14_days,last_30_days,last_90_daysdanprev_monthuntukengaged_audience_demographicsdanreached_audience_demographics;this_weekdanthis_monthtetap ada.
Kesalahan umum
- Meminta impressions untuk postingan yang dipublikasikan sejak Juli 2024. Meta mengembalikan kesalahan untuk media itu; minta views.
- Meminta views akun sebagai time_series. Meta mendokumentasikannya hanya dengan total_value, jadi baca satu total untuk setiap rentang yang dibutuhkan.
- Meminta crossposted_views atau facebook_views untuk media yang tidak pernah di-crosspost. Referensi Meta menyatakan keduanya menghasilkan kesalahan dalam kasus itu.
- Mengharapkan total_likes, total_comments atau total_views dengan Instagram Login. Meta menyediakannya hanya dengan Facebook Login; likes, comments dan views tetap tersedia.
US$ 9 hingga US$ 0.75 per koneksi per bulan, turun seiring bertambahnya koneksi, dengan 3 hari pertama gratis.
Pertanyaan yang sering diajukan
Apa yang menggantikan phone_call_clicks dan email_contacts di API Instagram?
Meta tidak menyebut penggantinya langsung saat keduanya berakhir di setiap versi pada 8 Januari 2025. Metrik terdekat yang didokumentasikan referensi akun Meta saat ini adalah profile_links_taps, yang dipecah menurut contact_button_type.
Apa yang menggantikan plays pada Reels Instagram?
views. Meta menghentikan plays, clips_replays_count dan ig_reels_aggregated_all_plays_count di setiap versi API pada 21 April 2025, tiga bulan setelah memperkenalkan views.
Mengapa panggilan insights Instagram saya mulai gagal?
Periksa daftar metrik terlebih dahulu: impressions, plays, video_views dan metrik profil lama sudah dihentikan, dan views tingkat akun hanya menerima total_value. Mencoba kembali permintaan yang sama akan menghasilkan kesalahan yang sama.
Apakah Meta menghentikan metrik Instagram pada 2026?
Tidak ada yang muncul di changelog Instagram Meta hingga 28 Oktober 2026. Entri 2026 justru menambahkan metrik, di antaranya total_views, facebook_views yang diperluas, dan link_clicks pada Stories.
Lanjut membaca
Hubungkan saluran pertama Anda dalam dua menit.
Tanpa menunggu peninjauan platform. Hubungkan WhatsApp, Instagram, TikTok, atau saluran lainnya, lalu minta AI Anda untuk memposting, membalas, atau membuat laporan, dan lihat hasilnya langsung.
- Gratis 3 hari
- Batalkan kapan saja
- Hanya API resmi
- Dipantau 24/7
Diverifikasi pada