Instagram API kullanımdan kaldırılan metrikleri: impressions ve plays yerini views'a bıraktı
Meta, Instagram insights API'sinde impressions yerine views metriğini getirdi. views 21 Ocak 2025'te tanıtıldı; impressions, plays, clips_replays_count ve ig_reels_aggregated_all_plays_count ise 21 Nisan 2025'te her API sürümünde kullanımdan kaldırıldı. Bu, video_views ve altı hesap metriğinin 8 Ocak'ta sona ermesinden sonra oldu. Sonraki değişiklikler yeni metrikler ekledi; örneğin Aralık 2025'te reposts ve reels_skip_rate geldi.
easyCoexistence, Instagram insights verilerini get_social_insights ile okur; verdiğiniz metrik adlarını olduğu gibi Meta'ya iletir, views dahil, ve Meta'nın verisini ya da bir ad kaldırıldığında Meta'nın kendi hata mesajını döndürür.
impressions, plays, clips_replays_count ve ig_reels_aggregated_all_plays_count metriklerinin her API sürümünde kullanımdan kaldırıldığı tarih.
Meta'nın hesap ve medya insights için views metriğini tanıttığı ve insights'ı Instagram Login uygulamalarına açtığı tarih.
video_views ve profile_views ile website_clicks dahil altı hesap zaman serisinin her sürümde desteğini kaybettiği tarih.
21 Nisan 2025'ten sonra impressions istendiğinde, 2 Temmuz 2024 ve sonrasında oluşturulan medya veri yerine hata döndürür.
Hesap düzeyindeki views metriğinin tek kabul ettiği metric_type; impressions ise günlük bir time_series da sunuyordu.
Meta 2025'te hangi Instagram metriklerini kaldırdı?
İki dalga halinde; her biri Meta'nın değişiklik kaydında aylar önceden duyuruldu. Önce yeni bir Graph API sürümünde uygulandı, sonra her sürüme yayıldı:
- 8 Ocak 2025: medyada
video_viewsve hesap zaman serileriemail_contacts,get_direction_clicks,phone_call_clicks,profile_views,text_message_clicksvewebsite_clicks; önce v21.0 sürümünde kaldırıldı. - 21 Ocak 2025: hesap ve medya insights'ta impressions, medyada plays,
clips_replays_countveig_reels_aggregated_all_plays_count; v22.0 ve sonrası için kullanımdan kaldırıldı. views metriğinin geldiği gün. - 21 Nisan 2025: bu dört metrik her API sürümünde kullanımdan kaldırıldı.
Kaldırılan her metrik neye dönüşmeli?
Meta, Nisan 2025 kaldırmalarını aynı değişiklik kaydı girdisinde views ile eşleştirdi. Ocak kaldırmalarında ise yerine geçen metrik adı vermedi; bu yüzden en yakın metrik, Meta'nın hesap ve medya referanslarında 31 Ekim 2026 itibarıyla belgelenen metriktir.
| 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 |
impressions hâlâ bir şey döndürüyor mu?
Yalnızca eski medya için. Meta'nın değişiklik kaydına göre, 21 Nisan 2025'ten sonra 2 Temmuz 2024 ve sonrasında oluşturulmuş medya için yapılan istekler hata döndürür; medya insights referansı ise yalnızca bu tarihten önce oluşturulmuş medya için impressions metriğini hâlâ tanımlar. Hesap düzeyinde impressions her sürümde kullanımdan kaldırıldığı için bugün yazılan kodun ona ihtiyacı yoktur.
views neyi sayar?
Hesapta views, Reels, gönderiler ve Story'ler genelinde içeriğin oynatılma veya gösterilme sayısıdır; tek bir gönderi, Reel veya Story için ise Instagram'da oynatılma sayısıdır. impressions, reklamlar dahil içeriğin ekranda gösterilme sayısını sayıyordu; bu nedenle iki metriği birleştiren bir grafik geçişte ölçtüğü şeyi değiştirir. Hesap düzeyindeki views yalnızca metric_type=total_value kabul eder ve media_product_type'a göre ayrılır; Meta bu metriği hâlâ geliştirme aşamasında olarak etiketler.
2025 kaldırmalarından beri hangi metrikler eklendi?
Meta'nın değişiklik kaydı, 2025 kaldırmalarından sonra şu eklemeleri listeler:
- 3 Aralık 2025: medyada
reels_skip_rateve reposts, hesapta reposts, ve çapraz paylaşılan Reel'ler içincrossposted_viewsilefacebook_views. - 22 Nisan 2026:
total_likes,total_commentsvetotal_views; yüzeyler genelinde toplanır ve tanıtılan medyayı içerir, Meta bunu yalnızca Facebook Login ile sunar.facebook_viewsayrıca gönderilere ve Story'lere genişletildi. - 22 Haziran 2026: Story'lerde
link_clicks, link çıkartmaları gibi bağlantılara dokunmaları sayar; değişiklik kaydı bunu Facebook Login ile sınırlar.
Kodda ne değişmeli?
2025 öncesinde yazılmış bir metrik listesinin çalışmaya devam etmesi için şu değişiklikler gerekir:
- Hesap ve medya isteklerinde impressions, plays,
clips_replays_count,ig_reels_aggregated_all_plays_countvevideo_viewsyerine views kullanın. - Hesap düzeyindeki views metriğini
metric_type=total_valueile isteyin. Zaman serisi yoktur; impressions metriğinin günlük çizgi verdiği yerde, her aralık için tek bir toplam okuyun. crossposted_viewsvefacebook_viewsmetriklerini yalnızca çapraz paylaşılmış medyada, ayrı bir istekte isteyin; Meta'nın referansı, medya çapraz paylaşılmamışsa ikisinin de hata verdiğini belirtir.total_likes,total_commentsvetotal_viewsmetriklerini Instagram Login uygulamalarının dışında tutun; Meta bunları yalnızca Facebook Login ile sunar.phone_call_clicks,email_contacts,text_message_clicksveget_direction_clicksyerinecontact_button_typealanına göre ayrılmışprofile_links_tapskullanın.- Bir metrik adında hata alırsanız bunu yeniden denemek yerine listeyi güncelleme işareti olarak ele alın.
Kullanımdan kaldırmalar eski API sürümlerine nasıl ulaşır?
İki aşamada. Bir değişiklik önce yeni bir Graph API sürümünde uygulanır (video_views için v21.0, impressions için v22.0), sonra aynı değişiklik kaydı girdisinde verilen bir tarihte her sürüme ulaşır; iki durumda da yaklaşık üç ay sonra. Eski bir sürümde sabit kalmak en fazla birkaç ay kazandırır; Meta'nın Instagram Platform değişiklik kaydı her değişiklik için iki tarihi de listeler.
2025 öncesinden kalan hangi kaldırmalar eski kodu hâlâ yakalıyor?
2025'ten önceki iki kaldırma, yıllardır dokunulmamış kodda ortaya çıkar:
- 11 Aralık 2023: medyada
carousel_albummetrikleri,taps_forward,taps_back, exits ve engagement; hesaptaaudience_gender_age,audience_locale,audience_countryveaudience_city. Artıkfollower_demographicsyaş, şehir, ülke ve cinsiyeti kapsar. - 19 Ağustos 2024:
engaged_audience_demographicsvereached_audience_demographicsiçinlast_14_days,last_30_days,last_90_daysveprev_monthzaman aralıkları kaldırıldı;this_weekvethis_monthkalır.
Yaygın hatalar
- Temmuz 2024'ten beri yayımlanmış bir gönderi için impressions istemek. Meta bu medya için hata döndürür; views isteyin.
- Hesap düzeyindeki views metriğini time_series olarak istemek. Meta bunu yalnızca total_value ile belgeler; bu yüzden ihtiyaç duyduğunuz her aralık için bir toplam okuyun.
- Hiç çapraz paylaşılmamış medya için crossposted_views veya facebook_views istemek. Meta'nın referansı bu durumda ikisinin de hata verdiğini belirtir.
- Instagram Login ile total_likes, total_comments veya total_views beklemek. Meta bunları yalnızca Facebook Login ile sunar; beğeniler, yorumlar ve views kalır.
Böylece Claude, ChatGPT veya kendi kodunuz, Meta değişikliği yaptığı gün yeniden adlandırmayı takip edebilir. Bağlantı başına aylık US$ 9'dan US$ 0.75'e kadar, bağlantı ekledikçe düşer; ilk 3 gün ücretsiz deneme.
Sık sorulan sorular
phone_call_clicks ve email_contacts metriklerinin yerini ne aldı?
Bu metrikler 8 Ocak 2025'te her sürümde sona erdiğinde Meta doğrudan bir halef adı vermedi. Hesap referansının bugün belgelediği en yakın metrik, contact_button_type alanına göre ayrılmış profile_links_taps metriğidir.
Instagram Reels'deki plays metriğinin yerini ne aldı?
views. Meta, plays, clips_replays_count ve ig_reels_aggregated_all_plays_count metriklerini 21 Nisan 2025'te her API sürümünde kullanımdan kaldırdı; bu, views metriğini tanıtmasından üç ay sonraydı.
Instagram insights çağrım neden hata vermeye başladı?
Önce metrik listesini kontrol edin: impressions, plays, video_views ve eski profil metrikleri kaldırıldı; hesapta views yalnızca total_value kabul eder. Aynı isteği yeniden denemek aynı hatayı döndürür.
Meta 2026'da hiç Instagram metriği kaldırdı mı?
28 Ekim 2026'ya kadar Meta'nın Instagram değişiklik kaydında hiçbiri görünmüyor. 2026 girdileri bunun yerine metrik ekler; bunların arasında total_views, genişletilmiş facebook_views ve Story'lerde link_clicks var.
Okumaya devam edin
İlk kanalınızı iki dakikada bağlayın.
Beklemeniz gereken platform incelemesi yok. WhatsApp, Instagram, TikTok veya başka bir kanalı bağlayın, ardından yapay zekânızdan paylaşım yapmasını, yanıtlamasını ya da rapor vermesini isteyin ve işini izleyin.
- 3 gün ücretsiz
- İstediğiniz zaman iptal
- Yalnızca resmi API'ler
- 7/24 izleniyor
Doğrulama tarihi