الإعلان عن الإصدار 24 من Google Ads API

الأربعاء 22 أبريل 2026

نعلن اليوم عن طرح الإصدار 24 من Google Ads API. لاستخدام ميزات الإصدار 24 الجديدة، عليك ترقية مكتبات برامج العميل ورمز العميل. تم نشر جميع مكتبات العملاء المحدَّثة ونماذج الرموز البرمجية.

ندعوك للانضمام إلينا في جولة مباشرة حول هذا الإصدار في فعالية "أبرز ميزات إصدار Google Ads API" على Discord أو بث Ads Developers YouTube Live أو فعالية LinkedIn Live غدًا (23 أبريل في الساعة 10 صباحًا بالتوقيت الشرقي). سيتم أيضًا تسجيل هذا الحدث ونشره على YouTube لمن لا يمكنهم حضور الحدث المباشر. إذا كانت لديك أي أسئلة أو أردت مناقشة هذا المنشور، يُرجى التواصل معنا في قناة ‎#ads-api على Discord.

الميزات الجديدة

إتاحة ميزة "الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق": ميزة الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق هي إضافة لتتبُّع الإحالات الناجحة على موقعك الإلكتروني أو تطبيقك. وباستخدام هذه الميزة، يمكنك تقديم تفاصيل المنتجات المُباعة في كل معاملة، ما يساعدك في الاستفادة من تقارير وإحصاءات متقدّمة عن المبيعات والأرباح لحسابك وحملاتك على "إعلانات Google"، مثل عدد الطلبات، ومتوسّط حجم سلة التسوّق، والإيرادات، والأرباح الإجمالية.

يضيف الإصدار 24 من Google Ads API إمكانية استخدام هذه الميزة على النحو التالي:

  • تمت إضافة مورد جديد CartDataSalesView يسمح بتقسيم مقاييس الإحالات الناجحة ليس فقط حسب نقرة على المنتج، ولكن أيضًا حسب المنتج المُباع، باستخدام شرائح مثل product_sold_brand. تتيح هذه الأعمدة للمعلنين الاطّلاع على إحصاءات عن المنتجات التي اشتراها العملاء فعليًا بعد النقر على الإعلانات، حتى إذا كان الإعلان لمنتج مختلف.
  • تمّت إضافة عدّة مقاييس "كلّ" غير قابلة للمزايدة، وهي مقاييس تتضمّن أيضًا الإحالات الناجحة التي لا تعمل حملاتك على تحسينها بشكل نشط، مثل all_cost_of_goods_sold_micros. تتم إضافة المقاييس الجديدة إلى جميع الموارد التي تتيح استخدام المقاييس المقابلة القابلة لتقديم عروض أسعار.
  • تمت إضافة شريحة conversion_attribution_event_type إلى مورد ShoppingPerformanceView، ما يجعلها قابلة للاختيار مع بيانات سلة التسوّق ومقاييس الإحالات الناجحة الأخرى. تشير هذه الشريحة إلى ما إذا كانت الإحالة الناجحة منسوبة إلى نقرة أو إلى مشاهدة، ومن الضروري التعرّف على إحصاءات بيانات سلة التسوّق التي تنتجها الإحالات الناجحة بعد رؤية الإعلان فقط.

الميزات المعدَّلة

يقدّم الإصدار 24 تعديلات على الميزات الحالية التي تتطلّب تغييرات في الرمز عند الترقية. نستعرض هنا أهم هذه التغييرات، ويمكنك الاطّلاع على ملاحظات الإصدار للحصول على القائمة الكاملة بالتغييرات.

إعدادات استبعاد محتوى الفيديو في الحملات: لقد بسّطنا إمكانية ضبط إعدادات استبعاد محتوى الفيديو في الحملات الفردية. يتوفّر هذا الإعداد على مستوى العميل، وينطبق على جميع الحملات بدلاً من ذلك. وتهدف إعدادات استبعاد المحتوى هذه إلى منحك المزيد من التحكم ومساعدتك في استبعاد أنواع من المحتوى قد لا تتناسب مع علامتك التجارية أو مؤسستك على الرغم من توافقها مع سياساتنا. يمكنك الاطّلاع على https://support.google.com/google-ads/answer/7515513 لمزيد من المعلومات عن إعدادات استبعاد محتوى الفيديو.

التغييرات على AudienceInsightsService: كجزء من إعادة تصميم الرمز، نقلنا حقل طلب InsightsAudience.topic_audience_combinations إلى مساحة الاسم common. قد تحتاج إلى تعديل توجيهات الاستيراد في بعض لغات البرمجة.

تغييرات على ReachPlanService: كجزء من إعادة تصميم الرمز، نقلنا الحقل youtube_select_lineups من الخدمة ReachPlanService.ListPlannableProducts. تتوفّر القوائم الآن ضمن حقل youtube_select_lineup_targeting. قوائم YouTube Select هي منتجات قائمة على الحجوزات تتيح للعملاء المؤهَّلين استهداف أفضل %1 من القنوات الرائجة على YouTube والتي تضم شرائح الجمهور الأكثر حماسًا في سوق معيّنة. مزيد من المعلومات

التغييرات في ContentCreatorInsightsService: في إطار إعادة تصميم الرمز البرمجي، أزلنا الحقل is_brand_connect_creator من خدمتَي ContentCreatorInsightsService.GenerateCreatorInsights وContentCreatorInsightsService.GenerateTrendingInsights.
على المستخدمين بدلاً من ذلك البحث عن صانع محتوى يتوفّر له الخيار CREATOR_PARTNERSHIPS في partnership_opportunities. منتج "الشراكات مع صنّاع محتوى YouTube" في "إعلانات Google" هو المساحة التي يمكنك من خلالها العثور على صنّاع محتوى في YouTube للتعاون معهم في إنشاء محتوى دعائي، كما تساعدك على إدارة شراكاتك مع صنّاع المحتوى بكفاءة. مزيد من المعلومات

التغييرات في KeywordPlanIdeaService: لقد وحّدنا البنية الأساسية للتوقّعات من أجل توفير تجربة أكثر سلاسة وموثوقية. يقدّم الإصدار 24 من Google Ads API طريقة GenerateKeywordForecastMetrics معدَّلة تبسّط عملية التخطيط من خلال التركيز على المقاييس التي تؤثّر بشكل مباشر في أدائك. سنشارك منشور مدوّنة أكثر تفصيلاً حول هذا التغيير في الأيام المقبلة.

تغييرات على مورد campaign_budget: أزلنا شريحة ad_sub_network_type لمورد campaign_budget لأنّها غير متوافقة مع طريقة العرض هذه.

تغييرات على طرق عرض مواد العرض: أزلنا شريحة click_type من طرق العرض ad_group_asset وcampaign_asset وcustomer_asset. يتوافق هذا التغيير مع تغيير حديث في المنتج أدّى إلى إزالة هذه الشريحة من "إعلانات Google" لتجنُّب الوصف المضلِّل للبيانات. يمكنك استخدام التقسيم click_type من المورد ad_group_ad للحصول على تفاصيل عن أداء الإعلان ومادة العرض التي تم عرضه معها.

التغييرات على الإعلان المتجاوب للفيديو: VideoResponsiveAdInfo أصبح قابلاً للتغيير. في إطار هذا التغيير، وضعنا علامة على videos وbusiness_name وlogo_images كحقول مطلوبة في كلّ من كائنَي DemandGenVideoResponsiveAdInfo وVideoResponsiveAdInfo.

التغييرات على ShareablePreviewService: تم تعديل ShareablePreviewService.GenerateShareablePreviews لعدم استخدام ميزة "تعذّر تنفيذ بعض العمليات" بعد الآن. ستظهر رسالة خطأ في الطلبات إذا تعذّر تنفيذها لأي معرّف. مزيد من المعلومات

يمكن أن تساعدك المراجع التالية في البدء:

إذا واجهتك مشاكل في الدعم الفني، يُرجى التواصل معنا على الرابط https://support.google.com/google-ads/contact/google_ads_api

صورة للمؤلف - ، فريق Google Ads API

التصنيفات: google-ads-api، release