حدود البيانات التاريخية في Ads Insights API: 37 و13 و6 شهور

فيه تغيير في Ads Insights API بقى سارى من 12 يناير 2026، ولحد دلوقتي بقاله عشر شهور، ولسه ناس كتير بتكتشفه لما بتحاول تسحب مقارنة سنة بسنة في تقارير اخر السنة وترجع بداتا فاضية.

والمشكلة مش ان الداتا اتقفلت. المشكلة ان مفيش حد سقف واحد. فيه تلات سقوف مختلفة على نفس الحساب، كل واحد بيطبق على نوع تاني من التقسيمات، والفرق بينهم 37 شهر و13 شهر و6 شهور. فلو انت بتخطط لسنة 2027 من داتا 2025، لازم تعرف انهي جزء لسه موجود وانهي جزء ضاع خلاص.

والمقال ده عن الارقام زي ما ميتا كاتبتها بالحرف في مدونة المطورين بتاعتها، وايه اللي ده بيعمله في تقرير بتكتبه الشهر ده بالتحديد.

التلات سقوف، من المصدر

الاعلان الرسمي موجود في بوست مدونة مطوري ميتا عن تحديثات اتاحة مقاييس Ads Insights API المنشور في 16 اكتوبر 2025، والنص بيقول ان التغييرات بتبدأ من 12 يناير 2026، وانها بتحدّد اتاحة نوافذ اسناد وتقسيمات معينة في الـAPI.

والتقسيم كالتالي، وده كلام الصفحة نفسها مش تفسيري:

نوع البياناتالسقفبيرجعك لحد امتى من اليوم
الاجماليات (total values) لحقول الـAPI37 شهر، ومتوافقة مع مدير الاعلاناتحوالي اكتوبر 2023
اي تقسيم لحقول العد الفريد زي unique_actions وcost_per_unique_action_type13 شهرحوالي اكتوبر 2025
التقسيمات بالساعة، سواء hourly_stats_aggregated_by_advertiser_time_zone او user_time_zone13 شهرحوالي اكتوبر 2025
تقسيم التكرار frequency_value6 شهورحوالي مايو 2026

وفيه بند خامس مختلف في شكله: تقسيمات mmm بقت محصورة على الـasynchronous jobs، يعني مش سقف زمني، ده تغيير في طريقة الطلب نفسها. لو عندك سكريبت بيطلبها بشكل متزامن، هو واقع دلوقتي لسبب تاني خالص.

What this covers
What this covers

نوافذ الاسناد اللي اتشالت

نفس الاعلان بيقول ان الباراميتر 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 شهر من تاريخ اليوم.

At a glance
At a glance

ايه اللي ده بيعمله في تقرير الشهر ده

خد الحسبة على تاريخ اليوم، نوفمبر 2026، لان دي اللحظة اللي بيتكتب فيها تقارير اخر السنة وخطط 2027.

والخلاصة اللي مش حابب حد يوصلها متأخر: الاجماليات محفوظة، والتفاصيل اللي بتفسر الاجماليات هي اللي بتضيع. وده بالظبط عكس اللي محتاجه لما حد يسألك ليه التكلفة زادت.

اعمل ايه عمليا، بترتيب

ده مش تحسين، ده صيانة. ولو عندك اكتر من حساب، ابدأ بالاكبر.

والنقطة الاخيرة دي هي اللي بتعمل اكبر ضرر في الواقع. الموضوع ده قريب من مشكلة تانية كتبت عنها قبل كده، تكرار الاحداث في البكسل ونافذة الـ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 عشان يبقى ارشيف.