إحصاءات منشورات Facebook عبر API: المشاهدات والوصول والتفاعل
تأتي إحصاءات منشورات Facebook من GET /{page-post-id}/insights مع مقاييس مثل post_media_view، وهي عدد مرات تشغيل المنشور أو عرضه، و post_total_media_view_unique وهو عدد مشاهديه الفريدين، و post_clicks و post_reactions_by_type_total. أوقفت Meta مقياس post_impressions في نوفمبر 2025 ومقياس post_impressions_unique في يونيو 2026، لذا تحل المشاهدات والمشاهدون الفريدون محل الانطباعات والوصول.
يقرأ easyCoexistence إحصاءات منشورات Facebook عبر get_social_insights، فيستطيع Claude أو ChatGPT أو كودك الخاص أن يسأل عن أداء منشور ويحصل على المشاهدات الحالية من Meta والمشاهدين الفريدين والنقرات والتفاعلات، مع list_social_posts لإيجاد المنشور.
المقياس الذي توصي به Meta بدلاً من post_impressions_unique، وقد حددت إيقافه في جميع إصدارات API في يونيو 2026.
متى توقف post_impressions عن إرجاع البيانات في جميع الإصدارات، وتسمي Meta مقياس post_media_view بديلاً له.
الفترة التي تذكرها Meta لمقاييس المنشورات مثل post_media_view و post_clicks وإجماليات التفاعلات.
ما تشمله أعداد الإعجاب في Meta: الإعجاب والاهتمام معاً.
ما تعيده Meta بدلاً من خطأ عندما يفتقر التطبيق إلى إذن read_insights.
أي مقاييس المنشورات تعمل في 2026؟
هذه المقاييس موجودة في مرجع الإحصاءات لدى Meta وخارج قوائم الإيقاف اعتباراً من 1 نوفمبر 2026. تُقرأ كل منها عبر معرّف المنشور، وفترتها مدى الحياة ما لم يُذكر خلاف ذلك:
post_media_view: عدد مرات تشغيل المنشور أو عرضه، مع تفصيلis_from_adsوis_from_followers.post_total_media_view_unique: عدد المشاهدين الفريدين للمنشور، وهو بديل Meta للوصول.post_clicks: النقرات في أي موضع من المنشور لم تولّد قصة، ويقسّمهاpost_clicks_by_typeحسب نوع الاستهلاك.post_reactions_by_type_total: التفاعلات حسب النوع، مع إجمالي لكل نوع مثلpost_reactions_love_totalأوpost_reactions_anger_total.post_video_views: مرات تشغيل الفيديو لمدة 3 ثوانٍ على الأقل، بفترة مدى الحياة أو اليوم.
ما الذي حل محل الانطباعات والوصول في المنشورات؟
نقلت Meta قياس المنشورات من الانطباعات إلى مشاهدات الوسائط على مرحلتين، كل منهما لجميع إصدارات API دفعة واحدة، وصار الاسم الملغى يعيد خطأ المقياس غير الصالح. وتعطي سجلّ التغييرات وصفحة المقاييس المهملة وملاحظات Graph API v25 البدائل التالية:
| 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 |
ما الفرق بين المشاهدات والمشاهدين الفريدين؟
تحصي المشاهدات مرات العرض، أما المشاهدون الفريدون فيحصون الأشخاص. يجمع post_media_view كل مرة شُغّل فيها المنشور أو عُرض، فمن رآه مرتين يُحسب مرتين، بينما يحسب post_total_media_view_unique المشاهدين الفريدين للمنشور مرة واحدة لكل منهم. وتصف Meta المقاييس التي تنتهي بلاحقة _unique بأنها تقريبية وتحسب القيم الفريدة بشكل مستقل، لذا قد لا يساوي الإجمالي مجموع أجزائه.
كيف تطلب إحصاءات منشور؟
عبر GET /{page-post-id}/insights مع تحديد metric بقائمة مفصولة بفواصل، أو GET /{page-post-id}/insights/{metric} لمقياس واحد. يجب أن يصدر الرمز عن شخص يستطيع تنفيذ مهمة ANALYZE على الصفحة، مع منح read_insights و pages_read_engagement، وتحمل كل نتيجة الحقول name و period و values و title و description. ويطلب مثال Meta نفسه إجماليات التفاعلات:
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"
}
]
}كيف تحسب التفاعلات والتعليقات والمشاركات؟
من الحقول الخاصة بالمنشور نفسه، بجانب إحصاءاته. يعيد fields=reactions.summary(total_count) إجمالي التفاعلات، ويعيد reactions.type(LOVE).limit(0).summary(total_count) عدد نوع واحد، من LIKE و LOVE و WOW و HAHA و SORRY و ANGRY. ويحمل الحقل shares عدد المشاركات، وتقول Meta إنه قد يشمل المنشورات المحذوفة والمنشورات التي لا يستطيع الرمز رؤيتها، ويضيف الحافة comments مع summary=true حقل total_count.
كيف ترتبط مقاييس المنشورات بمقاييس الصفحة؟
تجمع مقاييس الصفحة محتوى الصفحة خلال فترة، بينما تعطي مقاييس المنشور إجماليات مدى الحياة لمنشور واحد. تحسب page_post_engagements التفاعل مع منشورات الصفحة عبر التفاعلات والتعليقات والمشاركات وغيرها، بحسب day أو week أو days_28، وتفعل page_media_view و page_total_media_view_unique الأمر نفسه للمشاهدات والمشاهدين. وأزالت Meta المقياس post_engaged_users في 2024، لذا يُبنى التفاعل لكل منشور من النقرات والتفاعلات والتعليقات والمشاركات.
ما مدى حداثة البيانات، وإلى أي مدى تمتد؟
تُحدَّث معظم المقاييس مرة يومياً، أما المقاييس التي تضع Meta بجانبها نجمة، مثل post_clicks، فتُحدَّث عدة مرات في اليوم. تحتفظ Meta بسنتين من الإحصاءات للصفحات العامة، لكن 5 أيام فقط للصفحات غير المنشورة. وتعني lifetime الفترة التي تتوفر فيها البيانات، وهي سنتان أو أقل افتراضياً. وتحتاج بيانات إحصاءات الصفحة إلى صفحة لها 100 إعجاب أو أكثر، وتعيد عدة مقاييس فيديو القيمة 0 في فيديو أُعيدت مشاركته من صفحة أخرى.
كيف يقرأ easyCoexistence إحصاءات المنشورات؟
تأخذ get_social_insights المقاييس، وفي حالة منشور واحد معرّفه object_id، وهو معرّف المنشور الذي تعيده list_social_posts. وبدون object_id تقرأ الصفحة. تُمرَّر المعاملات period وسائر المعاملات الإضافية مثل since و until إلى Meta دون تغيير، ويعود المقياس الملغى كخطأ المقياس غير الصالح من Meta، فيستطيع الذكاء الاصطناعي التحول إلى اسم حالي.
الأخطاء الشائعة
- طلب post_impressions_unique. أوقفته Meta لجميع إصدارات API في يونيو 2026، فاطلب post_total_media_view_unique لحساب المشاهدين الفريدين.
- جمع المشاهدين الفريدين عبر المنشورات. يحسب كل منشور مشاهديه تقريباً، فالشخص الذي رأى منشورين يُحسب مرتين.
- قراءة إحصاءات فيديو أُعيدت مشاركته من صفحة أخرى. تعيد عدة مقاييس فيديو القيمة 0 للمشاركات، والقيم الدقيقة تأتي فقط من الصفحة التي أنشأت الفيديو.
- الوثوق بالصفر من استجابة فارغة. بدون read_insights تعيد Meta مجموعة بيانات فارغة بدلاً من خطأ، لذا تحقق من الإذن أولاً.
من US$ 9 إلى US$ 0.75 لكل اتصال شهرياً، يقل مع إضافة اتصالات، مع فترة تجريبية مجانية لمدة 3 أيام.
الأسئلة الشائعة
ما الذي حل محل وصول المنشورات على Facebook؟
post_total_media_view_unique، أي عدد المشاهدين الفريدين للمنشور، بعد أن أوقفت Meta post_impressions_unique في يونيو 2026.
هل يمكنني معرفة من تفاعل مع منشور صفحة؟
لا. تعيد Meta أعداد التفاعلات حسب النوع، لكن الصفحة أو الشخص لا يستطيع الاستعلام إلا عن تفاعله هو، أما البقية فتبقى خاصة.
هل تشمل أعداد الإعجاب تفاعلات الاهتمام؟
نعم. تحسب إجماليات الإعجاب لدى Meta الإعجاب والاهتمام معاً، في الإحصاءات وفي الحافة الخاصة بالتفاعلات على حد سواء.
هل يمكنني قراءة إحصاءات منشور في صفحة أخرى؟
ليس عبر إحصاءات الصفحة، فهي تحتاج رمزاً من شخص يستطيع تنفيذ مهمة ANALYZE على الصفحة التي أنشأت المنشور.
تابع القراءة
اربط قناتك الأولى في دقيقتين.
لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.
- 3 أيام مجانًا
- إلغاء في أي وقت
- واجهات API الرسمية فقط
- مراقبة على مدار الساعة 24/7
تم التحقق في