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

تحليلات 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 نفسه عندما يكون اسم مقياس مهملًا.

3 seconds

النافذة الزمنية التي يقيسها reels_skip_rate: نسبة المشاهدات التي تخطّى فيها المستخدم الـ Reel خلال أول 3 ثوانٍ.

21 Apr 2025

متى أُوقف دعم plays وclips_replays_count وig_reels_aggregated_all_plays_count في كل إصدارات API.

3 Dec 2025

متى أُضيفت reels_skip_rate وreposts وcrossposted_views وfacebook_views إلى تحليلات الوسائط.

48 hours

المدة التي قد تتأخر فيها البيانات الكامنة وراء مقاييس الوسائط.

2 years

المدة التي تحتفظ فيها Meta بمقاييس الوسائط.

أي مقاييس الـ Reel تُرجعها الواجهة؟

هي المقاييس التي تذكرها مرجعية Meta لتحليلات الوسائط لنوع الوسائط media_product_type REELS، وتُقرأ عبر GET /<IG_MEDIA_ID>/insights مع معامل metric بقيم مفصولة بفواصل. تصف Meta عدة منها بأنها تقديرية أو قيد التطوير، كما هو مذكور بجوار كل منها، وتحتسب الإعجابات والتعليقات كنشاط عضوي فقط:

viewsTimes the Reel was played on Instagram. In development.
reachUnique accounts that saw the Reel at least once. Estimated.
likesLikes on the Reel, organic only.
commentsComments on the Reel, organic only.
sharesTimes the Reel was shared.
savedTimes the Reel was saved.
repostsReposts, minus reposts later deleted.
total_interactionsLikes, saves, comments and shares, minus unlikes, unsaves and deleted comments. In development.
ig_reels_avg_watch_timeAverage time spent playing the Reel.
ig_reels_video_view_total_timeTotal time the Reel was played, replays included. In development.
reels_skip_rateShare of initial views that skipped within the first 3 seconds. Estimated, in development.
crossposted_viewsPlays across Instagram and where the Reel was crossposted, combined. Throws if it was not crossposted.
facebook_viewsPlays of the crossposted Reel outside Instagram. Throws if it was not crossposted.

ما الذي يُرجعه طلب التحليلات لـ Reel بعينه؟

كائنًا واحدًا لكل مقياس في data، يحتوي على name وperiod وvalues وtitle وdescription وid. قيمة period دائمًا lifetime لأن Meta تحددها لمقاييس الوسائط ولا يمكن تغييرها، لذلك لا يحتاج الطلب إليها. تصف مرجعية Meta مقياسي وقت المشاهدة بأنهما مدة زمنية دون تحديد وحدتها، لذا تحقق منهما على Reel تعرفه قبل رسمهما بيانيًا.

A Reels insights request and the shape of its answer
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 إلى تحديث:

RetiredRequest instead
playsDeprecated in every version on 21 Apr 2025views
clips_replays_countDeprecated in every version on 21 Apr 2025views
ig_reels_aggregated_all_plays_countDeprecated in every version on 21 Apr 2025views
video_viewsDeprecated in every version on 8 Jan 2025views
impressionsNot in Meta's Reels list; returns an error for media created on or after 2 Jul 2024views

ما الذي تحسبه المشاهدات (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.

get_social_insights arguments for one Reel
{
  "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 مجموعة بيانات فارغة عندما لا تكون البيانات موجودة أو غير متاحة حاليًا.
إنجاز ذلك باستخدام EasyCoexistence

من 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 فقط.

تابع القراءة

تحليلات Instagram عبر واجهة برمجة التطبيقات (API): مقاييس الحساب والمنشوراتالمقاييس التي تعيدها واجهة Instagram للحساب ولكل منشور وReels وقصة، مع حدود Meta وفترات التأخير والمقاييس المعاد تسميتها.مقاييس واجهة برمجة التطبيقات (API) المهملة في Instagram: تحل views محل impressions و playsالمقاييس التي أوقفتها Meta في 2025، ومنها impressions و plays و video_views، مع تواريخ الإيقاف وما يحل محل كل منها وما يجب تغييره في الشيفرة.نشر Reels على Instagram عبر واجهة برمجة التطبيقات (API)كيف ينشر API من Instagram مقاطع Reels: متطلبات Meta للفيديو، والحاويات ومدة المعالجة، والمشاركة في Feed، والأغلفة، والمقاييس.رؤى قصص Instagram عبر الواجهة البرمجيةمقاييس القصص التي تعيدها واجهة Instagram البرمجية، من الوصول والمشاهدات والردود إلى التنقل بالنقر والخروج، ومدة بقائها وسبب إرجاع بعضها الخطأ 10.البيانات الديموغرافية لمتابعي Instagram عبر واجهة برمجة التطبيقات (API)تفصيل متابعي حساب Instagram وجمهوره المتفاعل حسب العمر والجنس والمدينة والدولة، مع الأطر الزمنية والحدود عبر API.

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

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

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

تم التحقق في