Giriş yapınÜcretsiz denemeyi başlatın
easyCoexistence Resmi API'ler

API ile Facebook Reels ve video içgörüleri

Facebook video ve Reels içgörüleri GET /{video-id}/video_insights üzerinden gelir: total_video_views en az 3 saniyelik oynatmaları sayar, total_video_avg_time_watched ve total_video_view_total_time izleme süresini milisaniye cinsinden verir, Reels ise blue_reels_play_count, fb_reels_total_plays ve fb_reels_replay_count metriklerini ekler. Meta, total_video_impressions gibi video gösterim ve tekil izleyici metriklerini Haziran 2026'da tüm API sürümleri için kullanımdan kaldırdı.

easyCoexistence, Facebook Sayfa ve gönderi içgörülerini get_social_insights ile okur; Claude, ChatGPT veya kendi kodunuzdan, böylece yapay zekânız Sayfanın ve gönderilerinin nasıl gittiğini anlatabilir; bir videonun veya Reel'in kendi video_insights verileri Meta Business Suite'te okunur.

3 seconds

total_video_views ile sayılan en kısa oynatma; bu süreden kısa videolarda neredeyse videonun tamamı.

June 2026

Meta'nın total_video_impressions, total_video_views_unique ve post_video_views_unique metriklerini tüm API sürümleri için kullanımdan kaldırdığı tarih.

2 years

Video içgörü verisinin ne kadar geriye gittiği.

40 intervals

total_video_retention_graph videoyu nasıl böldüğü ve her noktadaki oynatmaları toplam görüntülemenin yüzdesi olarak nasıl raporladığı.

1 ms

blue_reels_play_count içinde Reels oynatması sayılan izleme; tekrar izlemeler hariç tutulur.

Reels left out

Reels etkileşimlerinin Sayfa metriklerinde yer almaması; Meta'nın içgörü referansındaki sınırlamalardan biri.

video_insights bir video için hangi metrikleri döndürür?

Bu video metrikleri Meta'nın referansında yer alır ve Kasım 2026 itibarıyla kullanımdan kaldırma listelerinin dışındadır; hepsi videonun ID'si üzerinden okunan ömür boyu toplamlardır. Görüntülemeler, tek bir oynatma içinde tekrar izlenen süreyi hariç tutar. Birçoğunun organik ve ücretli sürümleri vardır, örneğin total_video_views_organic ve total_video_views_paid:

total_video_viewsPlays of at least 3 seconds, or nearly the full length if shorter
total_video_complete_viewsPlays of 97% or more of the length
total_video_15s_viewsPlays of 15 seconds or more
total_video_60s_excludes_shorter_viewsPlays of 60 seconds or more
total_video_avg_time_watchedAverage viewing time, in milliseconds
total_video_view_total_timeTotal viewing time, in milliseconds
total_video_retention_graphPlays at each of 40 intervals, as a percentage of views
total_video_reactions_by_type_totalReactions to the video, by type

Hangi metrikler Reels'i kapsar?

Meta'nın referansında bir Reels bölümü vardır; bu bölüm Reel'in video ID'si üzerinden, ömür boyu değerlerle okunur:

  • blue_reels_play_count: gösterim sonrasında 1 milisaniye veya daha uzun süren oynatmalar sayılır, tekrarlar hariç.
  • fb_reels_total_plays: tekrarlar dahil aynı oynatmalar; fb_reels_replay_count: yalnızca aynı oturumdaki tekrarlar.
  • post_video_avg_time_watched ve post_video_view_time: tekrarlar dahil, ortalama ve toplam oynatılan milisaniye.
  • post_video_followers: Reel üzerinden gelen takipler.
  • post_video_likes_by_reaction_type: Reel'deki beğeniler.
  • post_video_social_actions: Reel'in yorumları ve paylaşımları.
  • post_video_retention_graph: Reel boyunca belirli noktalardaki oynatmalar, toplam oynatmanın yüzdesi olarak.

Meta 2026'da hangi video metriklerini kullanımdan kaldırdı?

Meta'nın Graph API v25 duyurusu, Haziran 2026'da tüm API sürümleri için iki grubu kullanımdan kaldırdı ve bunun yerine Media Views ile Media Viewers metriklerine yönlendiriyor: tekil izleyiciler için post_total_media_view_unique ve page_total_media_view_unique, ücretli ve organik ayrımı için post_media_view ve page_media_view.

  • Video gösterimleri: total_video_impressions ve tekil, ücretli, organik, viral ve hayran varyantları ile video üzerindeki post_impressions_unique.
  • 3 saniyelik izleyiciler: total_video_views_unique ve organik ve ücretli sürümleri, post_video_views_unique ve organik ve ücretli sürümleri ile page_video_views_unique.

post_video_views ve page_video_views hâlâ geçerli mi?

Evet. İkisi de Meta'nın içgörü referansında kullanımdan kaldırma işareti olmadan yer alır: post_video_views bir video gönderisinin en az 3 saniyelik oynatmalarını ömür boyu veya günlük olarak sayar, page_video_views ise Sayfanın oynatmalarını günlük, haftalık veya days_28 olarak sayar. Tekil sürümleri, post_video_views_unique ve page_video_views_unique, Haziran 2026'da tüm API sürümleri için kullanımdan kaldırıldı; 10 saniyelik metrikler, örneğin post_video_views_10s, v18 üzerinde işaretlidir.

Video içgörüleri nasıl istenir?

Video içgörüleri üç nesne üzerinden istenir ve her birinin kendi metrikleri vardır. metric değeri virgülle ayrılmış liste olarak ayarlanmış GET /{video-id}/video_insights, bir video veya Reel'i okur; metric olmadan ise videonun toplamlarını döndürür. post_video_views gibi gönderi düzeyindeki video metrikleri GET /{page-post-id}/insights ile, page_video_views gibi Sayfa düzeyindekiler ise GET /{page-id}/insights ve bir period ile okunur.

Reading a video's views and watch time
GET /{video-id}/video_insights?metric=total_video_views,total_video_avg_time_watched,total_video_retention_graph

Hangi izinler ve görev gerekir?

Sayfada ANALYZE görevini yerine getirebilen birinden alınmış bir Sayfa token'ı. Meta'nın video_insights referansı read_insights ve pages_manage_engagement izinlerini belirtirken, video içgörüleri kılavuzu pages_read_engagement izninden söz eder. Veriler son 2 yılı kapsar; kullanıcılara veya gruplara ait videoların içgörüleri kullanılamaz ve çapraz paylaşılan bir video, paylaşıldığı her Sayfada ayrı bir video ID'sine sahiptir.

Sayfa düzeyindeki metrikler Reels'i içerir mi?

Hayır. Meta'nın içgörü referansı, Sayfa metriklerini okumanın sınırlamaları arasında, Reels etkileşimlerinin dahil edilmediğini belirtir. Bir Reel'in oynatmaları, takipleri, yorumları ve paylaşımları Reel'in kendisi üzerinden okunur: video ID'siyle video_insights aracılığıyla.

easyCoexistence bunları nasıl okur?

get_social_insights, Sayfanın veya tek bir gönderinin insights edge'ini okur: metrikler, bir period ve bir gönderi için object_id; since ve until gibi ek parametreler iletilir. video_insights ayrı bir edge'dir ve hiçbir araç onu okumaz, bu yüzden bir videonun veya Reel'in kendi metrikleri Meta Business Suite'te okunur. Kullanımdan kalkmış bir metrik Meta'nın hatası olarak döner; böylece yapay zekânız metrik adını değiştirebilir.

Yaygın hatalar

  • total_video_impressions isteyerek. Meta video gösterim metriklerini Haziran 2026'da kullanımdan kaldırdı; bunun yerine post_media_view gibi Media Views metriklerini isteyin.
  • post_video_retention_graph değerlerini toplamak. Bunlar her aralıktaki görüntülemelerin yüzdeleridir, oynatma sayıları değil.
  • Reels'i Sayfa toplamlarında aramak. Meta'nın Sayfa içgörüleri Reels etkileşimlerini dışarıda bırakır; bu yüzden her Reel'in kendi video_insights çıktısını okuyun.
  • İzleme süresini saniye olarak okumak. total_video_avg_time_watched, total_video_view_total_time ve post_video_view_time milisaniye cinsindendir.
Bunu EasyCoexistence'la yapmak

Bağlantı başına aylık US$ 9'dan US$ 0,75'e kadar, bağlantı eklendikçe düşer; ilk 3 gün ücretsiz deneme.

Sık sorulan sorular

total_video_views_unique yerine ne geçti?

Meta, Media Viewers metriklerini gösterir: gönderide post_total_media_view_unique ve Sayfa için page_total_media_view_unique.

Bir Reel'in oynatmalarını API üzerinden nasıl alırım?

Tekrarları hariç tutmak için blue_reels_play_count, dahil etmek için fb_reels_total_plays metriğini isteyin; ikisini de Reel'in başlatma çağrısının döndürdüğü video ID ile GET /{video-id}/video_insights üzerinden alın.

post_impressions_unique hâlâ Reels için çalışıyor mu?

Hayır. Meta'nın Reels tablosunda hâlâ listelenir, ancak v25 duyurusu onu Haziran 2026'da video_insights üzerinde kullanımdan kaldırdı; gönderideki tekil izleyicileri post_total_media_view_unique sayar.

Hangi videolarda içgörü yoktur?

Kullanıcılara veya gruplara ait videolar. Meta'nın video içgörüleri Sayfalardaki videoları kapsar ve son 2 yılın verisini sunar.

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