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

رؤى قصص Instagram عبر الواجهة البرمجية

تعيد نقطة النهاية (endpoint) لرؤى وسائط Instagram هذه المقاييس للقصة طوال مدة بقائها: reach، views، replies، shares، navigation، follows، profile_visits، profile_activity، reposts وtotal_interactions. ينقسم navigation حسب story_navigation_action_type إلى TAP_FORWARD وTAP_BACK وTAP_EXIT وSWIPE_FORWARD. مقاييس القصة متاحة لمدة 24 ساعة، والقيم الأقل من 5 تُرجع الخطأ 10، ولا يتوفر خطاف الويب (webhook) باسم story_insights مع Instagram Login.

يقرأ easyCoexistence رؤى القصة عبر get_social_insights طالما القصة نشطة، فيستطيع Claude أو ChatGPT أو شيفرتك الخاصة أن تسأل عن أداء قصص اليوم، وتحصل على الوصول والمشاهدات والردود والمشاركات والتنقل مباشرة من Meta للحساب المتصل.

24 hours

المدة التي تتاح فيها مقاييس وسائط القصص عبر الواجهة البرمجية.

Error 10

تُرجع بدلاً من القيمة عندما تكون قيمة المقياس أقل من 5، إذ لا يوجد عدد مشاهدين كافٍ لتظهر الرؤى للوسائط.

Facebook Login

الإعداد الوحيد الذي يذكره دليل رؤى Meta لـ webhook القصص story_insights، وهو غير مدعوم مع Instagram Login.

0

قيمة الردود لقصة أنشأها حساب في أوروبا أو اليابان.

22 Jun 2026

عندما أضافت Meta link_clicks للقصص، لاحتساب النقرات على الروابط مثل ملصقات الروابط، وذلك لـ Facebook Login فقط.

ما المقاييس التي تعيدها القصة؟

هي المقاييس التي يذكرها مرجع Meta للوسائط media_product_type STORY، وتُقرأ عبر GET /<STORY_MEDIA_ID>/insights طالما القصة نشطة. مع Instagram Login يُوجَّه الطلب إلى graph.instagram.com برمز يحمل الصلاحيتين instagram_business_basic وinstagram_business_manage_insights، وتكون period دائماً lifetime:

reachUnique accounts that saw the Story. Estimated.
viewsTimes the Story was played on Instagram. In development.
repliesReplies to the Story, with regional exceptions.
sharesTimes the Story was shared.
navigationActions taken from the Story: forward, back, exit and next Story.
followsFollows of the account, counted for the Story.
profile_visitsTimes the profile was visited.
profile_activityActions on the profile after engaging, by action_type.
repostsReposts, minus reposts later deleted.
total_interactionsInteractions on the Story, net of removals. In development.
facebook_viewsPlays where the Story was crossposted. Throws if it was not.

كيف تقرأ التنقل حسب الإجراء؟

اطلب navigation وحده مع breakdown=story_navigation_action_type. يأتي الإجمالي في total_value.value وكل إجراء في total_value.breakdowns[].results، وتُجمع هذه القيم لتساوي الإجمالي: TAP_FORWARD (للأمام)، وTAP_BACK (للخلف)، وTAP_EXIT (خروج)، وSWIPE_FORWARD (القصة التالية). تكتب عينة استجابة Meta القيم بحروف صغيرة:

Navigation broken down by action, after Meta's sample
GET https://graph.instagram.com/<STORY_MEDIA_ID>/insights
  ?metric=navigation
  &breakdown=story_navigation_action_type
  &access_token=<INSTAGRAM_USER_ACCESS_TOKEN>

{
  "data": [
    {
      "name": "navigation",
      "period": "lifetime",
      "values": [{ "value": 25 }],
      "total_value": {
        "value": 25,
        "breakdowns": [
          {
            "dimension_keys": ["story_navigation_action_type"],
            "results": [
              { "dimension_values": ["tap_forward"], "value": 19 },
              { "dimension_values": ["tap_back"], "value": 4 },
              { "dimension_values": ["tap_exit"], "value": 1 },
              { "dimension_values": ["swipe_forward"], "value": 1 }
            ]
          }
        ]
      },
      "id": "<STORY_MEDIA_ID>/insights/navigation/lifetime"
    }
  ]
}

كم مدة إتاحة مقاييس القصص؟

24 ساعة. تتيح Meta مقاييس وسائط القصص لمدة 24 ساعة فقط، أي طوال عمر القصة نفسها، بينما قد تتأخر البيانات خلفها حتى 48 ساعة. اقرأها وفق جدول زمني طالما القصة نشطة، واحتفظ بآخر القيم التي حصلت عليها. تنبه Meta إلى أن البيانات قد تصل بعد انتهاء القصة إذا أُضيفت إلى highlight، وقد تعرض استدعاءات الواجهة البرمجية والـ webhooks والتطبيق نتائج مختلفة في تلك الحالة.

لماذا يُرجع مقياس القصة الخطأ 10؟

لأن قيمته أقل من 5. تُرجع Meta رمز الخطأ 10 مع الرسالة (#10) Not enough viewers for the media to show insights بدلاً من رقم صغير، لذا قد تفشل قصة شاهدها عدد قليل من الناس بينما تنجح قصة أكثر زيارة. تعامل معه كعدد منخفض لا كعطل، ولا تكرر المحاولة في حلقة متكررة.

لماذا تكون ردود القصة 0؟

بسبب قواعد إقليمية. تُستبعد الردود من أوروبا منذ 1 ديسمبر 2020، ومن اليابان منذ 14 أبريل 2021، من مقياس الردود، فتُرجع القصة التي أنشأها حساب في أحد هذين الإقليمين القيمة 0. يعرّف مرجع Meta الردود بأنها تعليقات IG Comments على كائن وسائط القصة.

هل يوجد webhook باسم story_insights؟

ليس مع Instagram Login. يضع جدول الحقول في Meta الحقل story_insights كغير متاح هناك، ويذكر مرجع الوسائط أن webhook الرؤى غير مدعوم مع Instagram Login، ويدرج دليل الرؤى story_insights لـ Facebook Login فقط. مع Facebook Login يُطلق الحقل عند انتهاء القصة، ولا يحمل إلا مقاييس أول 24 ساعة، ويُرجع القيم الأقل من 5 كـ -1.

أي مقاييس القصص أُلغيت أو أصبحت محدودة؟

تظهر بعض الأسماء القديمة في الشيفرات القديمة أو في سجل تغييرات Meta:

  • impressions: مُهمَل للوسائط المنشأة بعد 2 يوليو 2024، لذا تُبلغ القصة الحالية عن views بدلاً منه.
  • taps_forward وtaps_back وexits: أُلغيت في 11 ديسمبر 2023؛ ويعرض navigation، مقسماً حسب story_navigation_action_type، الإجراءات نفسها.
  • link_clicks: النقرات على الروابط مثل ملصقات الروابط، أُضيف في 22 يونيو 2026 لـ Facebook Login فقط.
  • total_views: المشاهدات عبر كل الأسطح، بما فيها الوسائط المروّجة، ومتاح مع Facebook Login فقط.

كيف يقرأ get_social_insights القصة؟

بمعرف الوسائط للقصة كقيمة object_id، وهو المعرف الذي تُرجعه publish_instagram_post باسم media_id عند نشر القصة، والمقاييس كقائمة. اطلب navigation في استدعاء منفصل مع params مضبوطة على breakdown story_navigation_action_type، لأن تقسيماً لا يدعمه مقياس واحد مطلوب يُفشل الاستدعاء كله. تُعاد أخطاء Meta، بما فيها الخطأ 10، كما كتبتها Meta.

get_social_insights arguments for one Story
{
  "account_id": "<ACCOUNT_ID>",
  "object_id": "<STORY_MEDIA_ID>",
  "metrics": ["reach", "views", "replies", "shares", "follows", "profile_visits"]
}

الأخطاء الشائعة

  • قراءة مقاييس القصة في اليوم التالي. تتيحها Meta لمدة 24 ساعة فقط، لذا اجمعها وهي نشطة.
  • إعادة المحاولة مع الخطأ 10 في حلقة. يعني قيمة أقل من 5، أي عدد غير كافٍ من المشاهدين، ولن يتغير حتى يشاهد القصة عدد أكبر من الناس.
  • طلب navigation مع تقسيم إلى جانب مقاييس أخرى. يعمل story_navigation_action_type مع navigation وحده، والتقسيم غير المدعوم يُفشل الاستدعاء كله.
  • انتظار story_insights مع Instagram Login. لا تتيح Meta هذا الـ webhook هناك، لذا استعلم عن نقطة نهاية الرؤى قبل انتهاء القصة.
إنجاز ذلك باستخدام EasyCoexistence

تُنشر القصص عبر publish_instagram_post. من US$ 9 إلى US$ 0.75 لكل اتصال شهرياً، ينخفض كلما أضفت اتصالات، مع فترة تجريبية مجانية مدتها 3 أيام.

الأسئلة الشائعة

هل تتغير مقاييس القصة بعد إضافتها إلى highlight؟

قد تتغير. تقول Meta إن القصة المضافة إلى highlight قد تستمر في استقبال البيانات بعد انتهائها، فقد تختلف الواجهة البرمجية والـ webhooks والتطبيق لفترة.

هل يعمل total_views مع قصص Instagram Login؟

لا. total_views، الذي يحسب المشاهدات عبر الأسطح مع احتساب الوسائط المروّجة، متاح مع Facebook Login فقط. ومع Instagram Login اطلب views.

هل تقرأ الواجهة البرمجية النقرات على ملصقات الروابط في قصة Instagram؟

مع Facebook Login فقط. أضافت Meta link_clicks للقصص في 22 يونيو 2026، وهو يحسب النقرات على الروابط مثل ملصقات الروابط، ولا تتيحه مع Instagram Login.

ما الذي حلّ محل taps_forward وtaps_back وexits؟

navigation، مقسماً عبر story_navigation_action_type إلى TAP_FORWARD وTAP_BACK وTAP_EXIT وSWIPE_FORWARD. أُلغيت المقاييس القديمة في 11 ديسمبر 2023.

تابع القراءة

تحليلات Instagram عبر واجهة برمجة التطبيقات (API): مقاييس الحساب والمنشوراتالمقاييس التي تعيدها واجهة Instagram للحساب ولكل منشور وReels وقصة، مع حدود Meta وفترات التأخير والمقاييس المعاد تسميتها.نشر قصص Instagram عبر واجهة برمجة التطبيقات (API)كيف تنشر API القصص في Instagram: متطلبات الصورة والفيديو، ومدة 24 ساعة، والردود كرسائل مباشرة، والمقاييس المتاحة.تحليلات Reels في Instagram عبر واجهة برمجة التطبيقات (API)مقاييس Reels التي تعيدها API من Instagram: المشاهدات والوصول والإعجابات والمشاركات والحفظ ووقت المشاهدة ومعدل التخطي، والمقاييس المهملة وبدائلها.البيانات الديموغرافية لمتابعي Instagram عبر واجهة برمجة التطبيقات (API)تفصيل متابعي حساب Instagram وجمهوره المتفاعل حسب العمر والجنس والمدينة والدولة، مع الأطر الزمنية والحدود عبر API.ذكر القصص والردود عليها في webhook إنستغرامكيف تصل إشارات القصص وردودها عبر حقل messages: المرفق story_mention و reply_to.story ورابط CDN ونافذة الرد.حقول خطاف الويب (webhook) في Instagram: القائمة الكاملةحقول webhook التي تُدرجها Meta لـ Instagram Login: ما يُطلق كل حقل، والإذن الذي يلزمه، والحقول المتروكة لـ Facebook Login.

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

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

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

تم التحقق في