ريلز فيسبوك ومؤشرات الفيديو عبر واجهة برمجة التطبيقات (API)
تأتي مؤشرات فيديو فيسبوك وريلز من نقطة النهاية (endpoint) GET /{video-id}/video_insights: يحسب total_video_views عمليات التشغيل التي لا تقل عن 3 ثوانٍ، ويعرض total_video_avg_time_watched و total_video_view_total_time وقت المشاهدة بالميلي ثانية، وتضيف الريلز blue_reels_play_count و fb_reels_total_plays و fb_reels_replay_count. أوقفت Meta في يونيو 2026 دعم مؤشرات مرات الظهور وعدد المشاهدين الفريدين للفيديو، مثل total_video_impressions، في جميع إصدارات API.
يقرأ easyCoexistence مؤشرات صفحات فيسبوك والمنشورات عبر get_social_insights من Claude أو ChatGPT أو من الكود الخاص بك، فيستطيع الذكاء الاصطناعي لديك أن يخبرك بأداء الصفحة ومنشوراتها؛ أما video_insights الخاصة بالفيديو أو الريل فتُقرأ في Meta Business Suite.
أقصر تشغيل يحسبه total_video_views، أو قرابة الطول الكامل للفيديوهات الأقصر من ذلك.
متى أوقفت Meta دعم total_video_impressions و total_video_views_unique و post_video_views_unique لجميع إصدارات API.
المدى الزمني الذي تتوفر فيه بيانات مؤشرات الفيديو.
كيف يقسم total_video_retention_graph الفيديو، ويعرض التشغيلات عند كل نقطة كنسبة مئوية من إجمالي المشاهدات.
التشغيل الذي يُحسب كتشغيل ريل في blue_reels_play_count، مع استبعاد إعادة التشغيل.
التفاعلات على الريلز غير مشمولة في مقاييس الصفحة، وذلك ضمن القيود الواردة في مرجع مؤشرات Meta.
ما المقاييس التي يعيدها video_insights لفيديو ما؟
هذه مقاييس الفيديو الواردة في مرجع Meta وخارج قوائم الإيقاف الخاصة بها اعتبارًا من نوفمبر 2026، وكلها إجماليات مدى الحياة تُقرأ عبر معرّف الفيديو. لا تشمل المشاهدات الوقت الذي يُقضى في إعادة التشغيل ضمن تشغيل واحد، ولكثير منها نسخ عضوية ومدفوعة، مثل total_video_views_organic و total_video_views_paid:
أي مقاييس تغطي الريلز؟
يحتوي مرجع Meta على قسم للريلز، يُقرأ عبر معرّف فيديو الريل، بقيم مدى الحياة:
blue_reels_play_count: التشغيلات التي تبلغ مللي ثانية واحدة أو أكثر بعد احتساب مرة ظهور، مع استبعاد إعادة التشغيل.fb_reels_total_plays: التشغيلات نفسها مع احتساب إعادة التشغيل؛fb_reels_replay_count: إعادة التشغيل ضمن الجلسة نفسها وحدها.post_video_avg_time_watchedوpost_video_view_time: متوسط الوقت المُشغَّل والإجمالي بالميلي ثانية، مع احتساب إعادة التشغيل.post_video_followers: المتابعات الناتجة عن الريل.post_video_likes_by_reaction_type: الإعجابات على الريل.post_video_social_actions: التعليقات والمشاركات عليه.post_video_retention_graph: التشغيلات عند نقاط داخل الريل، كنسبة مئوية من إجمالي التشغيلات.
أي مقاييس الفيديو أوقفتها Meta في 2026؟
أعلنت Meta في إعلان Graph API v25 إيقاف مجموعتين في يونيو 2026 لجميع إصدارات API، وتشير إلى مقاييس Media Views و Media Viewers بدلًا منهما: post_total_media_view_unique و page_total_media_view_unique للمشاهدين الفريدين، و post_media_view و page_media_view للتقسيم بين المدفوع والعضوي.
- مرات ظهور الفيديو:
total_video_impressionsمع متغيراته الفريدة والمدفوعة والعضوية والمنتشرة والخاصة بالمعجبين، وpost_impressions_uniqueعلى الفيديو. - المشاهدون لثلاث ثوانٍ:
total_video_views_uniqueونسختاها العضوية والمدفوعة، وpost_video_views_uniqueونسختاها العضوية والمدفوعة، وpage_video_views_unique.
هل ما زالت post_video_views و page_video_views صالحة؟
نعم. يبقى الاثنان في مرجع مؤشرات Meta دون علامة إيقاف: تحسب post_video_views تشغيلات منشور الفيديو التي لا تقل عن 3 ثوانٍ، مدى الحياة أو يوميًا، وتحسب page_video_views تشغيلات الصفحة يوميًا أو أسبوعيًا أو days_28. أما نسختاهما الفريدتان، post_video_views_unique وpage_video_views_unique، فقد أُوقفتا في يونيو 2026 لجميع إصدارات API، ومقاييس 10 ثوانٍ، مثل post_video_views_10s، فوق الإصدار v18.
كيف تُطلب مؤشرات الفيديو؟
عبر ثلاثة عناصر، ولكل منها مقاييسه. يقرأ GET /{video-id}/video_insights، مع metric كقائمة مفصولة بفواصل، فيديو أو ريلًا، وبدون metric يعيد إجماليات الفيديو. تُقرأ مقاييس فيديو المنشور، مثل post_video_views، عبر GET /{page-post-id}/insights، ومقاييس الصفحة، مثل page_video_views، عبر GET /{page-id}/insights مع period.
GET /{video-id}/video_insights?metric=total_video_views,total_video_avg_time_watched,total_video_retention_graphما الأذونات والمهمة المطلوبة؟
رمز الوصول (token) للصفحة من شخص يستطيع تنفيذ مهمة ANALYZE على الصفحة. يذكر مرجع video_insights في Meta الإذنين read_insights و pages_manage_engagement، بينما يذكر دليل مؤشرات الفيديو الإذن pages_read_engagement. تغطي البيانات السنتين الماضيتين، ولا تتوفر مؤشرات الفيديوهات المنشورة على حسابات المستخدمين أو المجموعات، ولفيديو منشور بالمشاركة (crosspost) معرّف فيديو منفصل على كل صفحة نُشر عليها.
هل تشمل مقاييس الصفحة الريلز؟
لا. يذكر مرجع مؤشرات Meta، ضمن قيوده لقراءة مقاييس الصفحة، أن التفاعلات على الريلز غير مشمولة. تُقرأ تشغيلات الريل ومتابعاته وتعليقاته ومشاركاته على الريل نفسه، عبر video_insights بمعرّف الفيديو الخاص به.
كيف يقرؤها easyCoexistence؟
تقرأ get_social_insights حافة المؤشرات للصفحة أو لمنشور واحد: المقاييس والفترة، و object_id للمنشور، مع تمرير معاملات إضافية مثل since و until. ولأن video_insights حافة مستقلة لا تقرأها أي أداة، تُقرأ مقاييس الفيديو أو الريل نفسه في Meta Business Suite. يعيد المقياس المتوقف خطأ Meta، فيستطيع الذكاء الاصطناعي لديك تبديل الاسم.
الأخطاء الشائعة
- طلب total_video_impressions. أوقفت Meta مقاييس ظهور الفيديو في يونيو 2026؛ اطلب بدلها مقاييس Media Views، مثل post_media_view.
- جمع قيم مخطط الاحتفاظ. هي نِسَب مئوية من المشاهدات عند كل فاصل، لا أعداد تشغيلات.
- البحث عن الريلز ضمن إجماليات الصفحة. تستبعد مؤشرات الصفحة التفاعلات على الريلز، لذا اقرأ video_insights الخاص بكل ريل.
- قراءة وقت المشاهدة بالثواني. total_video_avg_time_watched و total_video_view_total_time و post_video_view_time بالميلي ثانية.
من US$ 9 إلى US$ 0.75 لكل اتصال شهريًا، ويقل السعر كلما أضفت اتصالات، مع فترة تجريبية مجانية مدتها 3 أيام.
الأسئلة الشائعة
ما الذي حلّ محل total_video_views_unique؟
تشير Meta إلى مقاييس Media Viewers: post_total_media_view_unique على المنشور، و page_total_media_view_unique للصفحة.
كيف أحصل على تشغيلات الريل عبر API؟
اقرأ blue_reels_play_count، أو fb_reels_total_plays لاحتساب إعادة التشغيل، من GET /{video-id}/video_insights باستخدام معرّف الفيديو الذي أعاده طلب بدء الريل.
هل ما زال post_impressions_unique يعمل مع الريلز؟
لا. ما زال جدول الريلز في Meta يذكره، لكن إعلان v25 أوقفه على video_insights في يونيو 2026، ويحسب post_total_media_view_unique المشاهدين الفريدين على المنشور.
أي فيديوهات لا تتوفر لها مؤشرات؟
الفيديوهات المنشورة على حسابات المستخدمين أو المجموعات. تغطي مؤشرات الفيديو في Meta الفيديوهات المنشورة على الصفحات، مع بيانات للسنتين الماضيتين.
تابع القراءة
اربط قناتك الأولى في دقيقتين.
لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.
- 3 أيام مجانًا
- إلغاء في أي وقت
- واجهات API الرسمية فقط
- مراقبة على مدار الساعة 24/7
تم التحقق في