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

مقاييس واجهة برمجة التطبيقات (API) المهملة في Instagram: تحل views محل impressions و plays

استبدلت Meta مقياس impressions بمقياس views في API الإحصاءات الخاصة بـ Instagram. قدّمت views في 21 يناير 2025، وأهملت impressions و plays و clips_replays_count و ig_reels_aggregated_all_plays_count في كل إصدار من API في 21 أبريل 2025، بعد أن أوقفت video_views وستة مقاييس للحساب في 8 يناير. أضافت تغييرات لاحقة مقاييس أخرى، مثل reposts و reels_skip_rate في ديسمبر 2025.

تقرأ easyCoexistence إحصاءات Instagram عبر get_social_insights، الذي يمرّر أسماء المقاييس التي تعطيها إلى Meta كما هي، بما فيها views، ويعيد بيانات Meta، أو رسالة الخطأ الخاصة بـ Meta عندما يكون اسم المقياس قد أُوقف، فيستطيع Claude أو ChatGPT أو شيفرتك تتبّع التغيير في اليوم الذي تجريه Meta.

21 Apr 2025

متى أُهملت impressions و plays و clips_replays_count و ig_reels_aggregated_all_plays_count في كل الإصدارات.

21 Jan 2025

متى قدّمت Meta مقاييس views لحسابات الإحصاءات والوسائط، وفتحت الإحصاءات لتطبيقات Instagram Login.

8 Jan 2025

متى فقدت video_views وست سلاسل زمنية للحساب، ومنها profile_views و website_clicks، الدعم في كل إصدار.

2 Jul 2024

الوسائط المُنشأة في هذا التاريخ أو بعده تعيد خطأً لا بيانات عند طلب impressions بعد 21 أبريل 2025.

total_value

القيمة الوحيدة لـ metric_type التي يقبلها مقياس views على مستوى الحساب، بينما كان impressions يتيح أيضاً سلسلة time_series يومية.

أي مقاييس Instagram أهملتها Meta في عام 2025؟

على جولتين، أعلنت Meta كلاً منهما قبل شهور في سجل التغييرات الخاص بها، وطُبّقت أولاً من إصدار جديد من Graph API، ثم على كل الإصدارات:

  • 8 يناير 2025: video_views على الوسائط، والسلاسل الزمنية للحساب email_contacts و get_direction_clicks و phone_call_clicks و profile_views و text_message_clicks و website_clicks، أُسقطت أولاً في v21.0.
  • 21 يناير 2025: impressions على مقاييس الحساب والوسائط، و plays و clips_replays_count و ig_reels_aggregated_all_plays_count على الوسائط، أُهملت ابتداءً من v22.0 وما بعده، في اليوم الذي وصلت فيه views.
  • 21 أبريل 2025: أُهملت هذه المقاييس الأربعة في كل إصدارات API.

ما الذي يجب أن يصبح كل مقياس أُوقف؟

قرنت Meta views بإهمال أبريل 2025 في الإدخال نفسه من سجل التغييرات. أما إهمالات يناير فلم تسمِّ بديلاً لها، لذلك نعرض أقرب مقياس وثّقته مراجع الحساب والوسائط لديها اعتبارًا من 31 أكتوبر 2026.

RetiredRequest instead
impressionsAccount and media, 21 Apr 2025views
playsMedia, 21 Apr 2025views
clips_replays_countMedia, 21 Apr 2025views
ig_reels_aggregated_all_plays_countMedia, 21 Apr 2025views
video_viewsMedia, 8 Jan 2025views
phone_call_clicks, email_contacts, text_message_clicks, get_direction_clicksAccount, 8 Jan 2025profile_links_taps, by contact_button_type
profile_viewsAccount, 8 Jan 2025profile_visits, per post or Story
website_clicksAccount, 8 Jan 2025profile_activity per post, whose action_type includes BIO_LINK_CLICKED

هل ما زال impressions يعيد أي شيء؟

فقط للوسائط القديمة. يقول سجل تغييرات Meta إن الطلبات المقدمة بعد 21 أبريل 2025 للوسائط المُنشأة في 2 يوليو 2024 أو بعده تعيد خطأً، ومرجع الوسائط يُبقي impressions فقط للوسائط المُنشأة قبل ذلك التاريخ. أما على مستوى الحساب فقد أُهمل impressions في كل إصدار، لذلك لا فائدة منه في شيفرة تُكتب اليوم.

ماذا يعني views؟

على مستوى الحساب، عدد المرات التي شُغِّل فيها المحتوى أو عُرض، عبر Reels والمنشورات والقصص؛ وعلى منشور أو Reel أو قصة واحدة، عدد المرات التي شُغِّلت فيها على Instagram. كان impressions يحسب المرات التي ظهر فيها المحتوى على الشاشة، بما فيها الإعلانات، لذلك يتغير ما يقيسه المخطط الذي ينتقل من أحدهما إلى الآخر عند التبديل. يقبل views على مستوى الحساب metric_type=total_value فقط ويُفصَّل حسب media_product_type، وما زالت Meta تصفه بأنه قيد التطوير.

أي مقاييس أضافتها Meta منذ ذلك الحين؟

يسرد سجل تغييرات Meta هذه الإضافات بعد إهمالات 2025:

  • 3 ديسمبر 2025: reels_skip_rate و reposts على الوسائط، و reposts على الحساب، و crossposted_views و facebook_views لمقاطع Reels المنشورة بالنشر المتقاطع.
  • 22 أبريل 2026: total_likes و total_comments و total_views، مجمّعة عبر الأسطح وتشمل الوسائط المروّجة، وتتيحها مراجع Meta مع Facebook Login فقط؛ وتوسّع facebook_views أيضاً ليشمل المنشورات والقصص.
  • 22 يونيو 2026: link_clicks على القصص، تحسب النقرات على الروابط مثل ملصقات الروابط، وتقصرها ملاحظات السجل على Facebook Login.

ما الذي يجب تغييره في الشيفرة؟

تحتاج قائمة مقاييس كُتبت قبل 2025 إلى هذه التغييرات حتى تستمر في العمل:

  • استبدل impressions و plays و clips_replays_count و ig_reels_aggregated_all_plays_count و video_views بـ views، في طلبات الحساب والوسائط على حد سواء.
  • اطلب views على مستوى الحساب بـ metric_type=total_value. لا يوجد له time_series، لذا اقرأ إجمالياً واحداً لكل نطاق حيث كان impressions يعطي خطاً يومياً.
  • اطلب crossposted_views و facebook_views للوسائط المنشورة بالنشر المتقاطع فقط، في طلب مستقل بهما؛ يقول مرجع Meta إن كليهما يرمي خطأً إذا لم تكن الوسائط منشورة بالنشر المتقاطع.
  • لا تُدرج total_likes و total_comments و total_views في تطبيقات Instagram Login، لأن Meta تتيحها مع Facebook Login فقط.
  • استبدل phone_call_clicks و email_contacts و text_message_clicks و get_direction_clicks بـ profile_links_taps مفصّلاً حسب contact_button_type.
  • عامل الخطأ في اسم مقياس كإشارة لتحديث القائمة، لا كسبب لإعادة المحاولة.

كيف تصل الإهمالات إلى إصدارات API الأقدم؟

على خطوتين. يُطبَّق التغيير أولاً من إصدار جديد من Graph API، أي v21.0 لـ video_views و v22.0 لـ impressions، ثم يصل إلى كل الإصدارات في تاريخ يحدده الإدخال نفسه من سجل التغييرات، بعد نحو ثلاثة أشهر في الحالتين. تثبيت إصدار أقدم لا يشتري أكثر من بضعة أشهر، ويسرد سجل تغييرات Instagram Platform التاريخين لكل تغيير.

أي إهمالات سابقة لعام 2025 ما زالت تصيب الشيفرة القديمة؟

اثنان من قبل 2025 يظهران في شيفرة لم تُمس منذ مدة:

  • 11 ديسمبر 2023: مقاييس carousel_album، و taps_forward و taps_back و exits و engagement على الوسائط، و audience_gender_age و audience_locale و audience_country و audience_city على الحساب، حيث يغطي follower_demographics الآن العمر والمدينة والبلد والجنس.
  • 19 أغسطس 2024: الفترات الزمنية last_14_days و last_30_days و last_90_days و prev_month لـ engaged_audience_demographics و reached_audience_demographics، ويبقى this_week و this_month قائمين.

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

  • طلب impressions لمنشور نُشر منذ يوليو 2024. تعيد Meta خطأً لهذه الوسائط؛ اطلب views بدلاً منه.
  • طلب views على مستوى الحساب كـ time_series. توثّق Meta المقياس بـ total_value فقط، لذا اقرأ إجمالياً لكل نطاق تحتاجه.
  • طلب crossposted_views أو facebook_views لوسائط لم تُنشر بالنشر المتقاطع أبداً. يقول مرجع Meta إن كليهما يرمي خطأً في هذه الحالة.
  • توقّع total_likes أو total_comments أو total_views مع Instagram Login. تتيحها Meta مع Facebook Login فقط؛ أما likes و comments و views فتبقى متاحة.
إنجاز ذلك باستخدام EasyCoexistence

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

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

ما الذي حل محل phone_call_clicks و email_contacts في واجهة Instagram البرمجية بعد إهمالهما؟

لم تسمِّ Meta بديلاً مباشراً عندما انتهيا في كل إصدار في 8 يناير 2025. أقرب مقياس توثقه مراجع الحساب اليوم هو profile_links_taps، مفصّلاً حسب contact_button_type.

ما الذي حل محل plays في Reels بعد إهماله؟

views. أهملت Meta كلاً من plays و clips_replays_count و ig_reels_aggregated_all_plays_count في كل إصدار من API في 21 أبريل 2025، بعد ثلاثة أشهر من تقديم views.

لماذا بدأ طلب إحصاءات Instagram عندي بالفشل؟

تحقّق أولاً من قائمة المقاييس: impressions و plays و video_views ومقاييس الملف الشخصي القديمة أُهملت، ومقياس views على مستوى الحساب لا يقبل إلا total_value. إعادة الطلب نفسه تعيد الخطأ نفسه.

هل أهملت Meta أي مقاييس Instagram في 2026؟

لا يظهر أي منها في سجل تغييرات Instagram لدى Meta حتى 28 أكتوبر 2026. تضيف إدخالات 2026 مقاييس بدلاً من ذلك، منها total_views و facebook_views أوسع و link_clicks على القصص.

تابع القراءة

تحليلات Instagram عبر واجهة برمجة التطبيقات (API): مقاييس الحساب والمنشوراتالمقاييس التي تعيدها واجهة Instagram للحساب ولكل منشور وReels وقصة، مع حدود Meta وفترات التأخير والمقاييس المعاد تسميتها.حدود معدل Instagram API: الاستدعاءات خلال 24 ساعة وإنتاجية الرسائل المباشرة (DM)حدود معدل Instagram API: 4,800 استدعاء لكل ظهور كل 24 ساعة، و100 رسالة مباشرة في الثانية، و750 ردًا خاصًا في الساعة، والخطأ 80002.إيقاف واجهة Instagram Basic Display API: ما الذي انتهى وكيف تنتقلتوقفت واجهة Instagram Basic Display API في 4 ديسمبر 2024. ما كانت تفعله، وما حل محلها لحسابات الأعمال والمبدعين، وكيفية نقل التطبيق.ريلز Instagram التجريبية عبر واجهة برمجة التطبيقات (API): trial_params والتخرجطريقة نشر ريلز Instagram التجريبية عبر API: trial_params على حاوية REELS، والتخرج اليدوي أو SS_PERFORMANCE، ودعم Instagram Login.أخطاء واجهة برمجة التطبيقات (API) في Instagram: معنى الرموز الشائعةأخطاء Instagram API الشائعة ومعانيها: رموز الوصول المنتهية، وحدود المعدل، والوسائط التي لا يستطيع Meta جلبها، وحد النشر، ونوافذ الرسائل المغلقة.نشر Reels على Instagram عبر واجهة برمجة التطبيقات (API)كيف ينشر API من Instagram مقاطع Reels: متطلبات Meta للفيديو، والحاويات ومدة المعالجة، والمشاركة في Feed، والأغلفة، والمقاييس.

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

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

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

تم التحقق في