أي تغيير هيكلي في حقول القيمة قد يكسر تقريرًا أو قرار مزايدة بدون أن ينتبه الفريق.
إصدار Google Ads API v25 في 22 يوليو 2026 يحتوي تغييرات مهمة في CustomerLifecycleOptimizationValueSettings. بعض الحقول لم تعد standalone كما كانت، بل أصبحت داخل oneofs بجانب حقول multiplier جديدة. هذا النوع من التغيير لا يظهر للمعلن كعنوان كبير، لكنه قد يؤثر على تكامل التقارير، اختبارات migration، أو أي سكربت يقرأ إعدادات القيمة لشرائح العملاء.
أين الخطر؟
الحقول التي تنتقل داخل oneof تغير طريقة القراءة والكتابة والتحقق. إذا كان dashboard يتوقع حقلًا مباشرًا، قد يتوقف أو يعرض قيمة ناقصة. وإذا كان سكربت مزامنة يستخدم نفس الحقل لبناء توصية، فقد ينتج توصية غير دقيقة. لذلك يجب التعامل مع الترقية كاختبار معنى، لا مجرد تغيير مكتبة.
الخطر الأكبر يظهر في الوكالات التي تملك أكثر من حساب وتستخدم نفس قالب التقرير. خطأ واحد في الحقل قد ينتشر في أكثر من لوحة دون أن يظهر كفشل واضح.
كيف تختبر الترقية؟
ابدأ بحساب عينة يحتوي إعدادات lifecycle فعلية، ثم قارِن القيم قبل وبعد الترقية. لا تكتفِ باستجابة API؛ افحص شكل الأعمدة في التقرير، أي alerts تعتمد على هذه القيم، وأي naming داخل dashboard. إذا ظهر حقل جديد مثل multiplier، لا تعرضه للعميل قبل أن يفهم فريق الأداء معناه العملي.
ضع تاريخ الإصدار وتاريخ اختبار الترقية داخل changelog داخلي. هذا يساعد عند ظهور اختلاف في الأرقام بعد أسبوعين، لأن الفريق يستطيع ربطه بتغيير API لا بتغير أداء الحملة فقط.
Checklist migration
- اقرأ v25 release notes وحدد الحقول التي يلمسها التكامل.
- اختبر حسابات فيها customer lifecycle goals فعلية.
- قارن القيم قبل وبعد الترقية على نفس الفترة.
- راجع أي oneof أو multiplier قبل عرضه في dashboard.
- أضف تنبيهًا عند فقدان قيمة كانت تظهر سابقًا.
- وثق الإصدار المستخدم في كل تقرير أسبوعي.
ما علاقة ذلك بقرارات الأداء؟
إعدادات lifecycle ليست مجرد تقنية. هي تؤثر على طريقة تقييم العملاء الجدد والحاليين وقيمة التحويلات. إذا تغيرت القراءة، قد يظن الفريق أن الحملة تغيرت بينما التغيير في طبقة البيانات. لذلك يجب أن يكون صاحب القرار الإعلاني حاضرًا في QA، لا المطور فقط.
الترقية الناجحة تعطي الفريق ثقة أن المقارنة بين الأسابيع ما زالت عادلة.
أسئلة شائعة
هل يجب الترقية إلى v25 فورًا؟ ليس بدون جدول اختبار؛ ابدأ باللوحات والسكربتات الأكثر حساسية.
هل oneof مشكلة تقنية فقط؟ لا، لأنها قد تغير طريقة ظهور القيمة في التقرير.
هل أحتاج اختبار كل الحسابات؟ اختبر عينة تمثل أنواع الإعدادات المستخدمة ثم وسع التحقق.
المصادر
- Google Ads API: Release notes.
- Google Ads API: Upgrade to the latest version.
- Google Ads API: Client libraries.
هل ترقية Google Ads API عندك مؤمنة بتقرير QA؟
نراجع الحقول المتغيرة والتقارير ولوحات العملاء قبل أن تتحول ترقية API إلى أرقام مضللة.
اطلب مراجعة الموقع