النسخة minor قد لا تكسر الكود، لكنها قد تفتح حقولًا تغير طريقة قراءة الأداء.

نُشر في 18 يوليو 2026 · Semantic Versioning / v24.2 / Reporting QA

توثيق Google Ads API يشرح أن الإصدارات الرئيسية تحمل breaking changes ونقاط نهاية منفصلة، بينما الإصدارات minor مثل v24.2 تضيف مزايا على نفس المسار بدون كسر متوقع. لكن بالنسبة لفريق الأداء، عدم كسر الطلب لا يعني أن التقرير جاهز. الحقول الجديدة في PMax وDemand Gen وLocal Services قد تحتاج تفسيرًا وتشغيلًا داخل dashboard.

الفرق العملي بين major وminor

major version يحتاج خطة هجرة ومراجعة compatibility. أما minor version فيبدو أسهل، لكنه يضيف حقولًا أو enum values قد تغري الفريق بإدخالها في التقرير سريعًا.

المشكلة أن الحقل الجديد قد يكون صحيحًا تقنيًا لكنه غير مفهوم تجاريًا. لذلك يجب أن يدخل في QA checklist قبل عرضه للعميل أو استخدامه في قرار ميزانية.

مثال من v24.2

في v24.2 أضافت Google حقولًا مرتبطة بـ Local Services داخل Performance Max، ودعم ظهور Google Maps ضمن قنوات Demand Gen، وقيمًا مرتبطة بمحتوى مولد أو مدعوم بالذكاء الاصطناعي. هذه إضافات مهمة لكنها تحتاج naming واضح ومراجعة أثرها على التقارير.

لو ظهر حقل جديد داخل dashboard بدون شرح، قد يقرأه الفريق كأنه KPI ثابت بينما هو في الحقيقة بعد جديد يحتاج سياقًا.

Checklist تحديث التقارير

• افصل اختبار كسر الكود عن اختبار معنى البيانات.
• سجل كل field جديد قبل إضافته للوحة.
• اكتب تعريفًا داخليًا لكل metric أو segment مهم.
• اختبر عينة حسابات وحملات قبل النشر.
• قارن أرقام التقرير قبل وبعد التحديث.
• حدد owner للتحديث ومراجعة لاحقة بعد أسبوع.

كيف تستخدم الخبر تجاريًا؟

هذا النوع من المقالات يشرح للعميل أن التقرير الجيد ليس Sheet جميلًا فقط. التقرير يحتاج متابعة تغييرات Google الرسمية وترجمة الحقول الجديدة إلى قرارات قابلة للفهم.

في صفحة خدمة Google Ads reporting، اجعل نقطة API readiness جزءًا من العرض: تحديث، اختبار، تفسير، وتوثيق.

أسئلة شائعة

هل minor version آمن دائمًا؟ هو لا يحتوي breaking changes حسب تعريف Google، لكنه يحتاج اختبار معنى البيانات.

هل يجب استخدام كل حقل جديد؟ لا. استخدم ما يخدم قرارًا واضحًا فقط.

من يراجع التحديث؟ المطور يراجع التكامل، وفريق الأداء يراجع معنى الأرقام.

المصادر

• Google Ads API: Versioning.
• Google Ads API release notes.
• Google Ads API: Upgrade your API version.
• Google Ads API: Demand Gen overview.