تحليلات Reels في Instagram عبر واجهة برمجة التطبيقات (API)
تُرجع نقطة النهاية (endpoint) الخاصة بتحليلات الوسائط في Instagram، وهي GET /<IG_MEDIA_ID>/insights، المقاييس التالية لـ Reel: views وreach وlikes وcomments وshares وsaved وreposts وtotal_interactions وig_reels_avg_watch_time وig_reels_video_view_total_time وreels_skip_rate، إضافة إلى crossposted_views وfacebook_views لـ Reel المنشور مشتركًا. أُوقف دعم plays وclips_replays_count وig_reels_aggregated_all_plays_count في أبريل 2025، وحلّ محلها مقياس المشاهدات (views).
يقرأ easyCoexistence مقاييس Reel عبر get_social_insights، فيستطيع Claude أو ChatGPT أو كودك الخاص أن يسأل عن أداء Reel، ويحصل على المشاهدات والوصول ووقت المشاهدة ومعدل التخطي مباشرة من Meta للحساب المتصل، مع خطأ Meta نفسه عندما يكون اسم مقياس مهملًا.
النافذة الزمنية التي يقيسها reels_skip_rate: نسبة المشاهدات التي تخطّى فيها المستخدم الـ Reel خلال أول 3 ثوانٍ.
متى أُوقف دعم plays وclips_replays_count وig_reels_aggregated_all_plays_count في كل إصدارات API.
متى أُضيفت reels_skip_rate وreposts وcrossposted_views وfacebook_views إلى تحليلات الوسائط.
المدة التي قد تتأخر فيها البيانات الكامنة وراء مقاييس الوسائط.
المدة التي تحتفظ فيها Meta بمقاييس الوسائط.
أي مقاييس الـ Reel تُرجعها الواجهة؟
هي المقاييس التي تذكرها مرجعية Meta لتحليلات الوسائط لنوع الوسائط media_product_type REELS، وتُقرأ عبر GET /<IG_MEDIA_ID>/insights مع معامل metric بقيم مفصولة بفواصل. تصف Meta عدة منها بأنها تقديرية أو قيد التطوير، كما هو مذكور بجوار كل منها، وتحتسب الإعجابات والتعليقات كنشاط عضوي فقط:
ما الذي يُرجعه طلب التحليلات لـ Reel بعينه؟
كائنًا واحدًا لكل مقياس في data، يحتوي على name وperiod وvalues وtitle وdescription وid. قيمة period دائمًا lifetime لأن Meta تحددها لمقاييس الوسائط ولا يمكن تغييرها، لذلك لا يحتاج الطلب إليها. تصف مرجعية Meta مقياسي وقت المشاهدة بأنهما مدة زمنية دون تحديد وحدتها، لذا تحقق منهما على Reel تعرفه قبل رسمهما بيانيًا.
GET https://graph.instagram.com/<IG_MEDIA_ID>/insights
?metric=views,reach,ig_reels_avg_watch_time,reels_skip_rate
&access_token=<INSTAGRAM_USER_ACCESS_TOKEN>
{
"data": [
{
"name": "views",
"period": "lifetime",
"values": [{ "value": <VALUE> }],
"title": "<TITLE>",
"description": "<DESCRIPTION>",
"id": "<IG_MEDIA_ID>/insights/views/lifetime"
}
]
}ما المقاييس المهملة في Reels، وبماذا استُبدلت؟
أوقفت Meta الدعم عن المقاييس الثلاثة الأولى بدءًا من الإصدار v22.0 من Graph API في 21 يناير 2025، وهو اليوم الذي قدّمت فيه views، وفي كل الإصدارات في 21 أبريل 2025؛ أما video_views فقد أُوقف دعمها من الإصدار v21.0 وفي كل الإصدارات في 8 يناير 2025. يفشل الطلب الذي يذكر مقياسًا مهملًا، لذا تحتاج قائمة المقاييس المكتوبة قبل 2025 إلى تحديث:
| Retired | Request instead | |
|---|---|---|
| plays | Deprecated in every version on 21 Apr 2025 | views |
| clips_replays_count | Deprecated in every version on 21 Apr 2025 | views |
| ig_reels_aggregated_all_plays_count | Deprecated in every version on 21 Apr 2025 | views |
| video_views | Deprecated in every version on 8 Jan 2025 | views |
| impressions | Not in Meta's Reels list; returns an error for media created on or after 2 Jul 2024 | views |
ما الذي تحسبه المشاهدات (views) والوصول (reach)؟
views هو عدد مرات تشغيل الـ Reel على Instagram، وهو مقياس تصفه Meta بأنه قيد التطوير؛ أما reach فهو عدد الحسابات الفريدة التي شاهدته مرة واحدة على الأقل، وتصفه Meta بأنه تقديري. تحسب likes وcomments وviews وtotal_interactions النشاط العضوي فقط، فلا تشمل التفاعل مع الإعلانات المصنوعة من الـ Reel. أما total_likes وtotal_comments وtotal_views، التي تشمل الوسائط المروّجة، فتتوفر مع Facebook Login فقط.
ما الحدود والتأخيرات المطبّقة؟
تضع مرجعية Meta لتحليلات الوسائط هذه القواعد لأرقام الـ Reel:
- قد تتأخر البيانات الكامنة وراء المقاييس بما يصل إلى 48 ساعة.
- تُخزَّن مقاييس الوسائط لمدة تصل إلى سنتين.
- البيانات المفقودة أو غير المتاحة تُرجع مجموعة بيانات فارغة، وليس 0.
crossposted_viewsوfacebook_viewsتُنتجان خطأ للـ Reel الذي لم يُنشر مشتركًا، لذا اطلبهما في استدعاء مستقل.- أي تفصيل لا يدعمه مقياس مطلوب يُفشل الطلب كله، ويُرجع الخطأ «An unknown error has occurred» بدلًا من النتيجة.
- مع Instagram Login، يحتاج رمز الوصول (token) إلى الصلاحيتين
instagram_business_basicوinstagram_business_manage_insights، على النطاق graph.instagram.com.
كيف تقرأ أداة get_social_insights بيانات المحتوى المنشور؟
بمعرّف الحساب account_id الخاص بالاتصال، ومعرّف وسائط الـ Reel object_id، وقائمة بالمقاييس. يستدعي easyCoexistence الـ endpoint GET /<IG_MEDIA_ID>/insights على graph.instagram.com باستخدام token الحساب، ويمرّر أسماء المقاييس إلى Meta كما وردت، ويُرجع بيانات Meta، أو خطأ Meta نفسه عندما يكون اسم المقياس مهملًا. ويُرجع list_social_posts معرّفات وسائط المنشورات الأخيرة للحساب، ومنها Reels.
{
"account_id": "<ACCOUNT_ID>",
"object_id": "<REEL_MEDIA_ID>",
"metrics": [
"views", "reach", "likes", "comments", "shares", "saved",
"total_interactions", "ig_reels_avg_watch_time",
"ig_reels_video_view_total_time", "reels_skip_rate"
]
}الأخطاء الشائعة
- طلب plays أو clips_replays_count. أُوقف دعم الاثنين في كل إصدارات API في 21 أبريل 2025، فاطلب views بدلًا منهما.
- إدراج crossposted_views أو facebook_views في طلب عام. تُنتج هذه المقاييس خطأ للـ Reel غير المنشور مشتركًا، وهذا الخطأ يُفشل الاستدعاء كله.
- افتراض وحدة لوقت المشاهدة. لا تذكر مرجعية Meta وحدة لكل من ig_reels_avg_watch_time وig_reels_video_view_total_time، لذا تحقق منهما على Reel تعرفه.
- قراءة النتيجة الفارغة على أنها صفر. تُرجع Meta مجموعة بيانات فارغة عندما لا تكون البيانات موجودة أو غير متاحة حاليًا.
من US$ 9 لكل اتصال شهريًا، ويتناقص السعر إلى US$ 0.75 كلما أضفت اتصالات، مع فترة تجريبية مجانية مدتها 3 أيام تبدأ من أول اتصال.
الأسئلة الشائعة
لماذا يُرجع طلب تحليلات Reels نتيجة فارغة؟
تُرجع Meta مجموعة بيانات فارغة، وليس 0، عندما لا تكون البيانات موجودة أو غير متاحة حاليًا، وقد تتأخر البيانات الكامنة وراء المقاييس بما يصل إلى 48 ساعة.
كيف أحصل على وقت مشاهدة Reels عبر واجهة البرمجة؟
اطلب ig_reels_avg_watch_time للمتوسط وig_reels_video_view_total_time للإجمالي، بما فيها إعادات التشغيل، من GET /<IG_MEDIA_ID>/insights.
ما معنى معدل التخطي؟
هو المقياس reels_skip_rate، وهو النسبة المئوية للمشاهدات الأولية التي تخطّى فيها المستخدم الـ Reel خلال أول 3 ثوانٍ. أضافته Meta في 3 ديسمبر 2025 وتصفه بأنه تقديري وقيد التطوير.
هل تشمل تحليلات Reels مشاهدات الإعلانات؟
لا. تحسب likes وcomments وviews وtotal_interactions النشاط العضوي فقط، أما total_views، الذي يشمل الوسائط المروّجة، فيتوفر مع Facebook Login فقط.
تابع القراءة
اربط قناتك الأولى في دقيقتين.
لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.
- 3 أيام مجانًا
- إلغاء في أي وقت
- واجهات API الرسمية فقط
- مراقبة على مدار الساعة 24/7
تم التحقق في