تسجيل الدخولابدأ الفترة التجريبية المجانية
easyCoexistence واجهات API الرسمية

ريلز فيسبوك ومؤشرات الفيديو عبر واجهة برمجة التطبيقات (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.

3 seconds

أقصر تشغيل يحسبه total_video_views، أو قرابة الطول الكامل للفيديوهات الأقصر من ذلك.

June 2026

متى أوقفت Meta دعم total_video_impressions و total_video_views_unique و post_video_views_unique لجميع إصدارات API.

2 years

المدى الزمني الذي تتوفر فيه بيانات مؤشرات الفيديو.

40 intervals

كيف يقسم total_video_retention_graph الفيديو، ويعرض التشغيلات عند كل نقطة كنسبة مئوية من إجمالي المشاهدات.

1 ms

التشغيل الذي يُحسب كتشغيل ريل في blue_reels_play_count، مع استبعاد إعادة التشغيل.

Reels left out

التفاعلات على الريلز غير مشمولة في مقاييس الصفحة، وذلك ضمن القيود الواردة في مرجع مؤشرات Meta.

ما المقاييس التي يعيدها video_insights لفيديو ما؟

هذه مقاييس الفيديو الواردة في مرجع Meta وخارج قوائم الإيقاف الخاصة بها اعتبارًا من نوفمبر 2026، وكلها إجماليات مدى الحياة تُقرأ عبر معرّف الفيديو. لا تشمل المشاهدات الوقت الذي يُقضى في إعادة التشغيل ضمن تشغيل واحد، ولكثير منها نسخ عضوية ومدفوعة، مثل total_video_views_organic و 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

أي مقاييس تغطي الريلز؟

يحتوي مرجع 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.

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

ما الأذونات والمهمة المطلوبة؟

رمز الوصول (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 بالميلي ثانية.
إنجاز ذلك باستخدام EasyCoexistence

من 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 الفيديوهات المنشورة على الصفحات، مع بيانات للسنتين الماضيتين.

تابع القراءة

واجهة برمجة التطبيقات (API) لـ Facebook Reels: نشر Reels إلى صفحةكيفية نشر Reels إلى صفحة عبر Facebook Reels API: استدعاءات البدء والرفع والإنهاء على video_reels، ومواصفات الفيديو، والحد 30 يومياً، وفحص الحالة.نشر الفيديوهات على صفحة فيسبوك عبر واجهة برمجة التطبيقات (API)طريقة نشر فيديو على صفحة فيسبوك عبر Graph API: بإرسال file_url أو رفع ملف إلى /videos، مع العنوان والوصف وحالة المعالجة.عرض منشورات صفحة فيسبوك عبر واجهة برمجة التطبيقات (API): feed وposts وpublished_postsكيفية عرض منشورات صفحة فيسبوك عبر Graph API: مقارنة feed وposts وpublished_posts، والحقول المفيدة، والترقيم بالمؤشر، وحدود Meta.مقاييس Facebook Page Insights في 2026: ما يعمل وما أوقفته Metaمقاييس Facebook Page Insights العاملة حتى أواخر 2026 والمُوقفة من Meta مع تواريخ الإيقاف، مثل page_impressions وpage_fans ومقاييس الوصول وغيرها.أذونات واجهة برمجة التطبيقات (API) لصفحات Facebook ومتطلبات مراجعة التطبيقالأذونات التسعة لصفحات Facebook، وما يتيحه كل منها، وما تطلبه مراجعة التطبيق من Meta: Advanced Access، والتحقق من النشاط التجاري، وتسجيل الشاشة.هل واجهة برمجة التطبيقات (API) الخاصة بـ Facebook مجانية؟ أسعار صفحات Facebook وMessenger في 2026استدعاء Facebook Pages API ومنصة Messenger مجانا في 2026. تفرض Meta رسوما على الإعلانات والرسائل التسويقية، والوصول يتم عبر App Review.

اربط قناتك الأولى في دقيقتين.

لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.

  • 3 أيام مجانًا
  • إلغاء في أي وقت
  • واجهات API الرسمية فقط
  • مراقبة على مدار الساعة 24/7

تم التحقق في