مقاييس واجهة برمجة التطبيقات (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.
متى أُهملت impressions و plays و clips_replays_count و ig_reels_aggregated_all_plays_count في كل الإصدارات.
متى قدّمت Meta مقاييس views لحسابات الإحصاءات والوسائط، وفتحت الإحصاءات لتطبيقات Instagram Login.
متى فقدت video_views وست سلاسل زمنية للحساب، ومنها profile_views و website_clicks، الدعم في كل إصدار.
الوسائط المُنشأة في هذا التاريخ أو بعده تعيد خطأً لا بيانات عند طلب impressions بعد 21 أبريل 2025.
القيمة الوحيدة لـ 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.
| Retired | Request instead | |
|---|---|---|
| impressions | Account and media, 21 Apr 2025 | views |
| plays | Media, 21 Apr 2025 | views |
| clips_replays_count | Media, 21 Apr 2025 | views |
| ig_reels_aggregated_all_plays_count | Media, 21 Apr 2025 | views |
| video_views | Media, 8 Jan 2025 | views |
| phone_call_clicks, email_contacts, text_message_clicks, get_direction_clicks | Account, 8 Jan 2025 | profile_links_taps, by contact_button_type |
| profile_views | Account, 8 Jan 2025 | profile_visits, per post or Story |
| website_clicks | Account, 8 Jan 2025 | profile_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 فتبقى متاحة.
من 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 على القصص.
تابع القراءة
اربط قناتك الأولى في دقيقتين.
لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.
- 3 أيام مجانًا
- إلغاء في أي وقت
- واجهات API الرسمية فقط
- مراقبة على مدار الساعة 24/7
تم التحقق في