API üzerinden Facebook gönderi içgörüleri: görüntülemeler, erişim ve etkileşim
Facebook gönderi içgörüleri, GET /{page-post-id}/insights isteğinde metric listesiyle gelir: post_media_view, gönderinin oynatıldığı ya da gösterildiği kez sayısı; post_total_media_view_unique, benzersiz izleyicileri; post_clicks ve post_reactions_by_type_total. Meta, post_impressions metriğini Kasım 2025'te, post_impressions_unique metriğini Haziran 2026'da kullanımdan kaldırdı; bu nedenle görüntülemeler ve benzersiz izleyiciler artık gösterim ve erişimin yerini alıyor.
easyCoexistence, Facebook gönderi içgörülerini get_social_insights ile okur; böylece Claude, ChatGPT ya da kendi kodunuz bir gönderinin nasıl performans gösterdiğini sorabilir ve Meta'nın güncel görüntüleme, benzersiz izleyici, tıklama ve tepki verilerini geri alabilir.
Meta'nın, tüm API sürümleri için Haziran 2026'da kullanımdan kaldırdığı post_impressions_unique yerine önerdiği alternatif.
post_impressions'ın tüm sürümlerde veri döndürmeyi bıraktığı tarih; Meta alternatif olarak post_media_view'i gösterir.
Meta'nın post_media_view, post_clicks ve tepki toplamları gibi gönderi metrikleri için listelediği dönem.
Meta'nın beğeni sayılarına hem beğeni hem de care tepkileri dahildir.
Uygulamada read_insights izni eksik olduğunda Meta'nın hata yerine döndürdükleri.
2026'da hangi gönderi metrikleri çalışıyor?
Bunlar Meta'nın içgörü referansında yer alır ve 1 Kasım 2026 itibarıyla kullanımdan kaldırma listelerinin dışındadır. Her biri gönderinin ID'si üzerinden okunur; aksi belirtilmedikçe dönem lifetime olur:
post_media_view: gönderinin oynatıldığı ya da gösterildiği kez sayısı,is_from_adsveis_from_followerskırılımlarıyla.post_total_media_view_unique: gönderinin benzersiz izleyicileri; Meta'nın erişim metriğinin yerine geçen metrik.post_clicks: hikâye üretmeyen gönderi içindeki tıklamalar;post_clicks_by_typebunları tüketim türüne göre ayırır.post_reactions_by_type_total: tepkiler türe göre, her tür içinpost_reactions_love_totalya dapost_reactions_anger_totalgibi bir toplamla birlikte.post_video_views: en az 3 saniye oynatılan videonun oynatmaları, dönem lifetime ya da day ile.
Gösterim ve erişimin yerine ne geldi?
Meta, gönderi ölçümünü iki turda gösterimlerden medya görüntülemelerine taşıdı; her tur tüm API sürümlerinde aynı anda yürürlüğe girdi ve kullanımdan kalkan bir ad artık geçersiz metrik hatası döndürür. Değişiklik günlüğü, kullanımdan kaldırılan metrikler sayfası ve Graph API v25 notları şu alternatifleri veriyor:
| Deprecated | Use instead | |
|---|---|---|
| Nov 15, 2025 | post_impressions | post_media_view |
| Nov 15, 2025 | post_impressions_paid | post_media_view with is_from_ads |
| Nov 15, 2025 | post_impressions_fan | post_media_view with is_from_followers |
| June 2026 | post_impressions_unique | post_total_media_view_unique |
| June 2026 | post_impressions_paid_unique, post_impressions_organic_unique | post_media_view breakdowns, which count views rather than people |
Görüntüleme ile benzersiz izleyici arasındaki fark nedir?
Görüntüleme sayısı gösterimleri, benzersiz izleyici sayısı ise kişileri sayar. post_media_view, gönderinin her oynatılma ya da gösterilme anını toplar; bir kişi onu iki kez görürse iki kez sayılır. post_total_media_view_unique ise gönderinin benzersiz izleyicilerini her biri bir kez sayarak hesaplar. Meta, _unique ile biten metrikleri yaklaşık olarak işaretler ve benzersiz değerleri bağımsız hesapladığı için bir toplam, parçalarının toplamına eşit olmayabilir.
Bir gönderinin içgörülerini nasıl istersiniz?
GET /{page-post-id}/insights isteğiyle, metric parametresi virgülle ayrılmış bir liste olarak; ya da tek bir metrik için GET /{page-post-id}/insights/{metric} ile. Erişim token'ı, Sayfa üzerinde ANALYZE görevini yerine getirebilen biri tarafından alınmalı; read_insights ve pages_read_engagement izinleri verilmiş olmalı. Her sonuç name, period, values, title ve description alanlarını taşır. Meta'nın kendi örneği tepki toplamlarını ister:
GET /{page-post-id}/insights?metric=post_reactions_like_total,post_reactions_love_total
{
"data": [
{
"name": "post_reactions_like_total",
"period": "lifetime",
"values": [{ "value": 226 }],
"title": "Lifetime Total Like Reactions of a post.",
"id": "{page-post-id}/insights/post_reactions_like_total/lifetime"
},
{
"name": "post_reactions_love_total",
"period": "lifetime",
"values": [{ "value": 17 }],
"title": "Lifetime Total Love Reactions of a post.",
"id": "{page-post-id}/insights/post_reactions_love_total/lifetime"
}
]
}Tepkiler, yorumlar ve paylaşımlar nasıl sayılır?
Gönderinin kendi alanlarından, içgörülerinin yanında. fields=reactions.summary(total_count) toplam tepki sayısını, reactions.type(LOVE).limit(0).summary(total_count) ise LIKE, LOVE, WOW, HAHA, SORRY ve ANGRY arasından tek bir türün sayısını döndürür. shares alanı paylaşım sayısını tutar; Meta bunun silinmiş gönderileri ve token'ın göremediği gönderileri içerebileceğini söyler. summary=true ile comments kenarı bir total_count ekler.
Gönderi metrikleri Sayfa metrikleriyle nasıl ilişkili?
Sayfa metrikleri, Sayfanın içeriğini bir dönem boyunca toplar; gönderi metrikleri ise tek bir gönderinin ömür boyu toplamlarını verir. page_post_engagements, Sayfanın gönderileriyle etkileşimi tepkiler, yorumlar, paylaşımlar ve daha fazlasıyla sayar; day, week ya da days_28 bazında. page_media_view ve page_total_media_view_unique aynısını görüntülemeler ve izleyiciler için yapar. Meta post_engaged_users'ı 2024'te kaldırdı; bu yüzden gönderi başına etkileşim tıklamalar, tepkiler, yorumlar ve paylaşımlardan oluşturulur.
Veri ne kadar taze ve ne kadar geriye gider?
Çoğu metrik günde bir kez güncellenir; Meta'nın yıldız (*) ile işaretlediği metrikler, örneğin post_clicks, günde birkaç kez güncellenir. Meta, herkese açık Sayfalar için iki yıllık içgörü tutar; yayımlanmamış olanlar için yalnızca 5 gün. lifetime, veri mevcut olan dönemi ifade eder; varsayılan olarak iki yıl ya da daha kısa. Sayfa içgörü verileri 100 ve üzeri beğenisi olan bir Sayfa gerektirir; birkaç video metriği ise başka bir Sayfadan yeniden paylaşılan videoda 0 okunur.
easyCoexistence gönderi içgörülerini nasıl okur?
get_social_insights aracı metrikleri ve tek bir gönderi için object_id alanını alır; object_id, list_social_posts aracının döndürdüğü gönderi ID'sidir. object_id verilmezse Sayfayı okur. period ile since ve until gibi ek parametreler Meta'ya değişmeden iletilir; kullanımdan kalkmış bir metrik, Meta'nın geçersiz metrik hatasıyla döner ve yapay zekâ güncel bir adı deneyebilir.
Yaygın hatalar
- post_impressions_unique isteğinde bulunmak. Meta bunu Haziran 2026'da tüm API sürümleri için kullanımdan kaldırdı; benzersiz izleyicileri saymak için post_total_media_view_unique isteyin.
- Gönderiler arasında benzersiz izleyicileri toplamak. Her gönderi kendi izleyicilerini yaklaşık olarak sayar; dolayısıyla iki gönderiyi de gören bir kişi iki kez sayılır.
- Başka bir Sayfadan yeniden paylaşılan bir videonun içgörülerini okumak. Birkaç video metriği yeniden paylaşımlarda 0 döner; yalnızca videoyu oluşturan Sayfa doğru değerleri alır.
- Boş bir yanıttaki sıfıra güvenmek. read_insights izni olmadan Meta hata yerine boş bir veri kümesi döner; bu yüzden önce izni kontrol edin.
Gönderiyi bulmak için list_social_posts kullanılır. Bağlantı başına, ayda US$ 9 ile US$ 0,75 arasında; bağlantı eklendikçe fiyat düşer ve ilk 3 gün ücretsiz deneme.
Sık sorulan sorular
Facebook'ta gönderi erişimi yerine ne kullanılıyor?
post_total_media_view_unique; Meta, Haziran 2026'da post_impressions_unique metriğini kullanımdan kaldırdıktan sonra bir gönderinin benzersiz izleyici sayısını bu metrikle verir.
Bir Sayfa gönderisine kimin tepki verdiğini görebilir miyim?
Hayır. Meta tepki sayılarını türe göre döndürür; ancak bir Sayfa ya da kişi yalnızca kendi tepkisini sorgulayabilir, diğerleri gizli kalır.
Beğeni sayıları care tepkilerini de içerir mi?
Evet. Meta'nın beğeni toplamları hem beğeniyi hem care'i sayar; içgörülerde ve reactions kenarında aynı şekilde.
Başka bir Sayfadaki bir gönderinin içgörülerini okuyabilir miyim?
Sayfa içgörüleriyle hayır: gönderiyi oluşturan Sayfa üzerinde ANALYZE görevini yerine getirebilen birinden token gerekir.
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