فيه تغيير في Ads Insights API بقى سارى من 12 يناير 2026، ولحد دلوقتي بقاله عشر شهور، ولسه ناس كتير بتكتشفه لما بتحاول تسحب مقارنة سنة بسنة في تقارير اخر السنة وترجع بداتا فاضية.
والمشكلة مش ان الداتا اتقفلت. المشكلة ان مفيش حد سقف واحد. فيه تلات سقوف مختلفة على نفس الحساب، كل واحد بيطبق على نوع تاني من التقسيمات، والفرق بينهم 37 شهر و13 شهر و6 شهور. فلو انت بتخطط لسنة 2027 من داتا 2025، لازم تعرف انهي جزء لسه موجود وانهي جزء ضاع خلاص.
والمقال ده عن الارقام زي ما ميتا كاتبتها بالحرف في مدونة المطورين بتاعتها، وايه اللي ده بيعمله في تقرير بتكتبه الشهر ده بالتحديد.
التلات سقوف، من المصدر
الاعلان الرسمي موجود في بوست مدونة مطوري ميتا عن تحديثات اتاحة مقاييس Ads Insights API المنشور في 16 اكتوبر 2025، والنص بيقول ان التغييرات بتبدأ من 12 يناير 2026، وانها بتحدّد اتاحة نوافذ اسناد وتقسيمات معينة في الـAPI.
والتقسيم كالتالي، وده كلام الصفحة نفسها مش تفسيري:
| نوع البيانات | السقف | بيرجعك لحد امتى من اليوم |
|---|---|---|
| الاجماليات (total values) لحقول الـAPI | 37 شهر، ومتوافقة مع مدير الاعلانات | حوالي اكتوبر 2023 |
| اي تقسيم لحقول العد الفريد زي unique_actions وcost_per_unique_action_type | 13 شهر | حوالي اكتوبر 2025 |
| التقسيمات بالساعة، سواء hourly_stats_aggregated_by_advertiser_time_zone او user_time_zone | 13 شهر | حوالي اكتوبر 2025 |
| تقسيم التكرار frequency_value | 6 شهور | حوالي مايو 2026 |
وفيه بند خامس مختلف في شكله: تقسيمات mmm بقت محصورة على الـasynchronous jobs، يعني مش سقف زمني، ده تغيير في طريقة الطلب نفسها. لو عندك سكريبت بيطلبها بشكل متزامن، هو واقع دلوقتي لسبب تاني خالص.
نوافذ الاسناد اللي اتشالت
نفس الاعلان بيقول ان الباراميتر action_attribution_windows مش هيرجع تاني نافذتين: 7d_view و28d_view. يعني لو عندك تقرير متبني على مشاهدة 7 ايام او 28 يوم، الارقام دي مش هتيجي.
واللي باقي متاح، بالنص: 1-day click و7-day click و28-day click و1-day engaged view و1-day view، لحقول زي actions وconversions وresults، بالاضافة للقيم الافتراضية المبنية على اعدادات الاسناد عند المعلن.
النقطة العملية هنا: لو انت كنت بتقارن اداء حملات براندنج بنافذة 28d_view، التغيير ده مش بيقلل الداتا، هو بيلغي المنهجية. ومفيش بديل مباشر، لان 1d_view مش نسخة اصغر من 28d_view، هي سؤال تاني.
التوثيق نفسه مش متفق، وده مش خطأ مني
لو رحت على صفحة مرجع Ad Account Insights في Graph API، هتلاقي حاجتين لازم تعرفهم قبل ما تبني عليها.
الاولى انها لسه بتسرد 7d_view و28d_view جوه قيم الـenum المقبولة، في حين ان بوست المدونة بيقول ان الباراميتر مش هيرجعهم. فالقيمة مقبولة في التوثيق المرجعي ومش بترجع داتا. ده النوع اللي بيضيع ناس يوم كامل وهي بتدور على غلط في الكود مش موجود.
والتانية في تعريف default نفسه. نفس الصفحة في قسم الـReading بتقول ان default معناها ["7d_click","1d_view"]، وفي قسم الـCreating بتقول ان default معناها ["7d_view","1d_click"]. الاتنين على نفس الصفحة، والصفحة مش بتفسر الفرق. فلو انت سايب الاسناد على default وبتقارن ارقام من مصدرين، ممكن تكون بتقارن نافذتين مختلفين وانت فاكر انهم واحد.
انا مش بقول انهي واحدة الصح. انا بقول حدد النوافذ بنفسك صريح في الطلب بدل ما تعتمد على default، وده قرار بيحل المشكلة من غير ما تحتاج تعرف الاجابة.
وصفحة المرجع كمان بتثبت سقف الـ37 شهر من ناحية تانية: date_preset = lifetime اتقفل من Graph API v10.0 واتغير لـ date_preset = maximum اللي بيرجع 37 شهر كحد اقصى، وفيه كود خطأ 3018 بيقول ان تاريخ البداية لا يمكن يكون ابعد من 37 شهر من تاريخ اليوم.
ايه اللي ده بيعمله في تقرير الشهر ده
خد الحسبة على تاريخ اليوم، نوفمبر 2026، لان دي اللحظة اللي بيتكتب فيها تقارير اخر السنة وخطط 2027.
- مقارنة التكرار سنة بسنة للربع الاخير: مش ممكنة. سقف الـ6 شهور بيوصلك لحوالي مايو 2026، فداتا تكرار الربع الاخير من 2025 مش موجودة وملهاش طريق رجوع.
- مقارنة الوصول الفريد والـunique actions للربع الاخير من 2025: دي بتنتهي صلاحيتها دلوقتي بالظبط. سقف الـ13 شهر بيوصل لحوالي اكتوبر 2025، يعني شهور الربع الاخير من 2025 بتسقط واحد ورا التاني كل شهر يعدي.
- التقسيم بالساعة لحملات الجمعة البيضاء بتاعة 2025: نفس الحكاية، 13 شهر، وده اللي بيحدد امتى بتنشر الاعلان في الموسم. لو مصدّرتهاش، هي على وشك تسقط.
- الاجماليات: مرتاحة. 37 شهر بتوصلك لحوالي اكتوبر 2023، فالمقارنات على مستوى اجمالي التحويلات والتكلفة لسه شغالة لسنتين ورا.
والخلاصة اللي مش حابب حد يوصلها متأخر: الاجماليات محفوظة، والتفاصيل اللي بتفسر الاجماليات هي اللي بتضيع. وده بالظبط عكس اللي محتاجه لما حد يسألك ليه التكلفة زادت.
اعمل ايه عمليا، بترتيب
ده مش تحسين، ده صيانة. ولو عندك اكتر من حساب، ابدأ بالاكبر.
- صدّر دلوقتي الـ13 شهر الاخيرة من اي تقسيم فيه عد فريد او ساعات، ولو حتى مرة واحدة على هيئة ملف. الشهر الجاي رقم منها بيروح.
- خلي التصدير ده شهري ومجدول، مش طلب بتعمله لما تحتاجه. اي حاجة بتحت سقف بتحتاج ارشيف بره الـAPI.
- احتفظ بالتكرار بشكل منفصل وبوتيرة اعلى، لان 6 شهور نافذة قصيرة جدا لحاجة بتتغير بالاسبوع.
- حدد نوافذ الاسناد صريح في كل طلب، وسجّل في التقرير نفسه النافذة اللي اتحسب بيها. اي تقرير قديم مكتوب بـ7d_view محتاج علامة انه مش قابل للتكرار.
- راجع الداشبوردات اللي بتسحب تلقائي. اللي هيحصل مش ايرور واضح، هو خلية فاضية، والخلية الفاضية في داشبورد بتتقرأ كصفر مش كناقص.
والنقطة الاخيرة دي هي اللي بتعمل اكبر ضرر في الواقع. الموضوع ده قريب من مشكلة تانية كتبت عنها قبل كده، تكرار الاحداث في البكسل ونافذة الـ48 ساعة، وفي الحالتين العطل مش بيعلن عن نفسه. ولو شغال على قياس بيوصل لبيانات بره المنصة، الترتيب الصح للمراجعة موجود في ازاي تقيس الاعلانات الاوفلاين، والجانب المقابل عند تيك توك في شرح TikTok Events API.
ولو الموضوع عندك اوسع من سقوف الـAPI، وهو ان خطة القياس نفسها مبنية على داتا بتتقلص سنة ورا سنة، فيه معالجة عملية للجانب ده عند KF Agency في كيف تقيس الحملات بدون كوكيز الطرف الثالث، وهي بالعربي كمان.
الحدود بصراحة
تلاتة، وكلهم يستاهلوا يتقالوا.
الاول: الارقام اللي فوق كلها عن اتاحة البيانات في الـAPI، مش عن دقتها. سقف 13 شهر مش بيقول ان الـ13 شهر اللي قبله كانوا مظبوطين، وفيه تغييرات في الاسناد والموديلات حصلت في نفس الفترة بتخلي المقارنة الطويلة اضعف مما تبان. اطول مقارنة متاحة مش بالضرورة اصلح مقارنة.
التاني: انا حسبت تواريخ الرجوع بالتقريب من تاريخ اليوم، وقلت «حوالي» عن قصد. ميتا بتقول 37 و13 و6 شهور، ومحددتش بالنص هي بتحسبها من اول الشهر ولا من اليوم نفسه. فلو قرارك متوقف على اسبوع، جرّب الطلب بنفسك على الحساب بدل ما تعتمد على حسبتي.
التالت: التغيير ده بقاله عشر شهور وانا مش بقدمه كخبر. بقدمه لان اكتوبر ونوفمبر هما الشهور اللي بيتكتب فيها التقرير السنوي، وده التوقيت اللي الناس بتكتشف فيه السقوف دي لاول مرة، لما يكون فات وقت التصدير. اللي ينفع يتعمل دلوقتي هو انك متخسرش الـ13 شهر اللي لسه في ايدك.
أسئلة شائعة
التغيير ده جديد ولا قديم؟
الاعلان نشر في 16 اكتوبر 2025، والتغييرات بتبدأ من 12 يناير 2026 زي ما بوست المدونة بيقول. فهو بقاله عشر شهور وهو سارى. السبب اللي يخليك تهتم دلوقتي مش انه جديد، السبب ان نوفمبر هو شهر التقارير السنوية، وده التوقيت اللي الناس بتكتشف فيه ان داتا الربع الاخير من السنة اللي فاتت مش بترجع.
يعني الداتا القديمة اتمسحت من مدير الاعلانات كمان؟
الاعلان بيتكلم عن اتاحة المقاييس في الـAPI، وبيقول ان الاجماليات لحقول الـAPI هتفضل متاحة لـ37 شهر بما يتوافق مع مدير الاعلانات. فالكلام عن تقسيمات معينة في الـAPI، مش بيان عام بمسح الحساب. لو محتاج تتأكد لحالة معينة، اطلبها في الواجهة وفي الـAPI وقارن.
ليه صفحة المرجع لسه بتقول 7d_view و28d_view؟
دي ملاحظة حقيقية وانا مش هغطي عليها. صفحة مرجع Ad Account Insights لسه بتسرد القيمتين جوه الـenum المقبولة، وبوست المدونة بيقول ان الباراميتر مش هيرجعهم. يعني القيمة مقبولة شكلا ومش بترجع داتا، والمصدرين من ميتا نفسها. املك الاتنين وانت بتشخص، وافترض السلوك اللي بتشوفه في الحساب.
ايه اقصى حاجة اقدر اسحبها دلوقتي؟
لو بتسحب اجماليات، 37 شهر عن طريق date_preset = maximum، وده نفسه بديل lifetime اللي اتقفل من Graph API v10.0. وفيه كود خطأ 3018 بيرفض اي تاريخ بداية ابعد من 37 شهر. لو بتسحب تقسيمات عد فريد او ساعات، 13 شهر. لو بتسحب تكرار، 6 شهور.
اعمل ايه لو عندي داشبورد بيسحب تلقائي؟
راجعه بنفسك ومتستناش ايرور. اللي بيحصل في الحالة دي مش رسالة خطأ، هو خلية فاضية، والداشبورد عادة بيعرضها صفر. يعني هتقرا ان التكرار بقى صفر مش ان الداتا مش متاحة، وتبني قرار على الفرق. حدد في الداشبورد نفسه حد اقصى للفترة يطابق السقف بدل ما تسيبه يطلب اي مدى.
هل فيه طريقة ارجع بيها الداتا اللي ضاعت؟
لا، مفيش. ودي الحاجة الوحيدة في الموضوع اللي ملهاش حل بعدين. اللي ينفع هو انك تصدّر اللي لسه موجود دلوقتي، وتخلي التصدير مجدول شهري بدل طلب وقت الحاجة. الارشيف لازم يبقى بره الـAPI عشان يبقى ارشيف.
المصادر
- Meta for Developers Blog: Ads Insights API Metric Availability Updates (منشور 16 اكتوبر 2025، ان التغييرات بتبدأ من 12 يناير 2026، وان الاجماليات لحقول الـAPI تفضل متاحة لحد 37 شهر بما يتوافق مع مدير الاعلانات، وان كل تقسيمات حقول العد الفريد زي unique_actions وcost_per_unique_action_type محدودة بـ13 شهر، وان التقسيمات بالساعة hourly_stats_aggregated_by_advertiser_time_zone وuser_time_zone محدودة بـ13 شهر، وان تقسيم frequency_value محدود بـ6 شهور، وان تقسيمات mmm بقت محصورة على asynchronous jobs، وان action_attribution_windows مش هيرجع 7d_view و28d_view، وان 1-day click و7-day click و28-day click و1-day engaged view و1-day view باقيين متاحين لحقول زي actions وconversions وresults)
- Graph API Reference: Ad Account Insights (ان date_preset = lifetime اتقفل في Graph API v10.0 واستبدل بـ date_preset = maximum اللي بيرجع 37 شهر كحد اقصى، وان كود الخطأ 3018 بيقول ان تاريخ البداية لا يمكن يكون ابعد من 37 شهر من تاريخ اليوم، وان الـenum لسه بيسرد 7d_view و28d_view، وان الصفحة بتعرّف default بشكل مختلف في قسم Reading وقسم Creating)