API üzerinden Instagram Reels içgörüleri
Instagram'ın medya içgörüleri uç noktası, GET /<IG_MEDIA_ID>/insights, bir Reel için şu metrikleri döndürür: views, reach, likes, comments, shares, saved, reposts, total_interactions, ig_reels_avg_watch_time, ig_reels_video_view_total_time ve reels_skip_rate. Çapraz paylaşılmış bir Reel için ayrıca crossposted_views ve facebook_views döner. plays, clips_replays_count ve ig_reels_aggregated_all_plays_count ise Nisan 2025'te kaldırıldı; yerlerine views geldi.
easyCoexistence, bir Reel'in içgörülerini get_social_insights ile okur; böylece Claude, ChatGPT ya da kendi kodunuz bir Reel'in nasıl performans gösterdiğini sorabilir ve bağlı hesap için görüntüleme, erişim, izlenme süresi ve atlama oranını doğrudan Meta'dan alabilir.
reels_skip_rate, Reel'in ilk 3 saniyesinde atlanan görüntülemelerin payını ölçer.
plays, clips_replays_count ve ig_reels_aggregated_all_plays_count alanlarının her API sürümünde kullanımdan kaldırıldığı tarih.
reels_skip_rate, reposts, crossposted_views ve facebook_views alanlarının medya içgörülerine eklendiği tarih.
Medya metriklerinin arkasındaki verinin ne kadar gecikebileceği.
Meta'nın medya metriklerini ne kadar süre sakladığı.
Bir Reel hangi metrikleri döndürür?
Meta'nın media_product_type REELS için listelediği medya içgörüleri referansındaki metrikler; bunlar GET /<IG_MEDIA_ID>/insights ile ve virgülle ayrılmış bir metric parametresiyle okunur. Meta bazılarını tahmini veya geliştirme aşamasında olarak etiketler; bu not her metriğin yanında yer alır. Beğeniler ve yorumlar yalnızca organik etkinlik olarak sayılır:
Reels içgörü isteği ne döndürür?
data içinde her metrik için name, period, values, title, description ve id alanlarını taşıyan bir nesne. period her zaman lifetime olarak okunur; Meta bunu medya metrikleri için belirler ve değiştirilemez, bu nedenle istekte belirtmeye gerek yoktur. Meta'nın referansı iki izlenme süresi metriğini birim belirtmeden süre olarak tanımlar; bu nedenle bunları grafiğe dökmeden önce bildiğiniz bir Reel ile kontrol edin.
GET https://graph.instagram.com/<IG_MEDIA_ID>/insights
?metric=views,reach,ig_reels_avg_watch_time,reels_skip_rate
&access_token=<INSTAGRAM_USER_ACCESS_TOKEN>
{
"data": [
{
"name": "views",
"period": "lifetime",
"values": [{ "value": <VALUE> }],
"title": "<TITLE>",
"description": "<DESCRIPTION>",
"id": "<IG_MEDIA_ID>/insights/views/lifetime"
}
]
}Hangi Reel metrikleri kaldırıldı ve yerlerine ne geldi?
Meta ilk üç metriği Graph API v22.0'dan itibaren kullanımdan kaldırdı; bu, views'ı tanıttığı 21 Ocak 2025 günüydü. Tüm sürümlerde ise 21 Nisan 2025'te kaldırıldılar. video_views ise v21.0'dan itibaren ve tüm sürümlerde 8 Ocak 2025'te kaldırıldı. Kaldırılmış bir metriği adlandıran istek başarısız olur; bu nedenle 2025'ten önce yazılmış bir metrik listesinin güncellenmesi gerekir:
| Retired | Request instead | |
|---|---|---|
| plays | Deprecated in every version on 21 Apr 2025 | views |
| clips_replays_count | Deprecated in every version on 21 Apr 2025 | views |
| ig_reels_aggregated_all_plays_count | Deprecated in every version on 21 Apr 2025 | views |
| video_views | Deprecated in every version on 8 Jan 2025 | views |
| impressions | Not in Meta's Reels list; returns an error for media created on or after 2 Jul 2024 | views |
Bir Reel'de views ve reach neyi sayar?
views, Reel'in Instagram'da oynatılma sayısını, yani görüntüleme sayısını gösterir; Meta bunu geliştirme aşamasında olarak etiketler. reach, Reel'i en az bir kez gören benzersiz hesap sayısıdır; Meta bunu tahmini olarak etiketler. likes, comments, views ve total_interactions yalnızca organik etkinliği sayar; Reel'den yapılan reklamlardaki etkileşimleri dışarıda bırakır. Tanıtılan medyayı da içeren total_likes, total_comments ve total_views yalnızca Facebook Login ile sunulur.
Hangi sınırlar ve gecikmeler geçerli?
Meta'nın medya içgörüleri referansı, bir Reel'in sayıları için şu kuralları koyar:
- Metriklerin arkasındaki veri 48 saate kadar gecikebilir.
- Medya metrikleri en fazla 2 yıl saklanır.
- Eksik veya kullanılamayan veri 0 değil, boş bir veri kümesi olarak döner.
crossposted_viewsvefacebook_views, çapraz paylaşılmamış bir Reel için hata verir; bu nedenle bunları kendi çağrılarında isteyin.- İstenen metriğin desteklemediği bir kırılım, tüm isteği "An unknown error has occurred." hatasıyla başarısız kılar.
- Instagram Login ile token, graph.instagram.com üzerinde
instagram_business_basicveinstagram_business_manage_insightsizinlerine ihtiyaç duyar.
get_social_insights bir Reel'i nasıl okur?
Bağlantının account_id değeri, Reel'in medya kimliği ise object_id olarak ve metrik listesiyle birlikte kullanılır. easyCoexistence, hesabın token'ıyla graph.instagram.com üzerinde GET /<IG_MEDIA_ID>/insights çağrısı yapar, metrik adlarını verildiği gibi Meta'ya iletir ve Meta'nın verisini döndürür; bir ad kaldırılmışsa Meta'nın kendi hatasını döndürür. list_social_posts ise hesabın son gönderilerinin ve Reel'lerinin medya kimliklerini verir.
{
"account_id": "<ACCOUNT_ID>",
"object_id": "<REEL_MEDIA_ID>",
"metrics": [
"views", "reach", "likes", "comments", "shares", "saved",
"total_interactions", "ig_reels_avg_watch_time",
"ig_reels_video_view_total_time", "reels_skip_rate"
]
}Yaygın hatalar
- plays veya clips_replays_count istemek. İkisi de 21 Nisan 2025'te tüm API sürümlerinde kullanımdan kaldırıldı; bunun yerine views isteyin.
- crossposted_views ya da facebook_views alanlarını genel bir isteğe karıştırmak. Çapraz paylaşılmamış bir Reel için hata verirler ve bu hata çağrıyı başarısız kılar.
- İzlenme süresinin birimini varsaymak. Meta, ig_reels_avg_watch_time ve ig_reels_video_view_total_time için bir birim belirtmez; bu nedenle bilinen bir Reel ile kontrol edin.
- Boş bir sonucu sıfır saymak. Veri mevcut değilse ya da şu anda kullanılamıyorsa Meta boş bir veri kümesi döndürür.
Bir metrik adı kaldırıldığında Meta'nın kendi hatası gösterilir. Bağlantı başına aylık US$ 9 ile US$ 0.75 arasında, bağlantı ekledikçe düşer; ilk 3 gün ücretsizdir.
Sık sorulan sorular
Reels içgörü isteği neden boş bir sonuç döndürür?
Veri mevcut değilse ya da şu anda kullanılamıyorsa Meta 0 değil boş bir veri kümesi döndürür; metriklerin arkasındaki veri de 48 saate kadar gecikebilir.
API'den Reel izlenme süresini nasıl alırım?
Ortalama için ig_reels_avg_watch_time, toplam için ig_reels_video_view_total_time isteyin; toplam, tekrar izlemeleri de içerir. Bunları GET /<IG_MEDIA_ID>/insights üzerinden alın.
reels_skip_rate nedir?
İlk görüntülemelerin ilk 3 saniyesinde Reel'i atlayan yüzdedir. Meta bunu 3 Aralık 2025'te ekledi ve tahmini, geliştirme aşamasında olarak etiketliyor.
Reels içgörüleri reklam görüntülemelerini içerir mi?
Hayır. likes, comments, views ve total_interactions yalnızca organik etkinliği sayar; tanıtılan medyayı da içeren total_views yalnızca Facebook Login ile sunulur.
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