ملاحظات الإصدار

الإصدار 18 (16/10/2024)

تمّت إضافة الميزات والتحديثات الجديدة التالية في الإصدار 18.

إدارة الحساب

  • (للحسابات المدرَجة في القائمة المسموح بها فقط) تمت إضافة DataLinkService.CreateDataLink، ما يسمح بربط حساب على "إعلانات Google" بفيديوهات صنّاع المحتوى المستضافة على قنواتهم على YouTube. يتيح ربط الفيديوهات لحساب "إعلانات Google" عرض الإعلانات على المنصات الشريكة باستخدام فيديوهات صنّاع المحتوى.

المجموعات الإعلانية

الإعلانات

  • تمت إضافة AdGroupAd.ad_group_ad_asset_automation_settings، ما يتيح تفعيل إنشاء مواد العرض التلقائي للإعلانات أو إيقافه.
  • تمت إضافة القيم التالية إلى AssetAutomationType:
    • GENERATE_VERTICAL_YOUTUBE_VIDEOS
    • GENERATE_SHORTER_YOUTUBE_VIDEOS
  • تمّت إضافة السمة AdNetworkType.GOOGLE_OWNED_CHANNELS، وتُستخدَم في الإعلانات المعروضة على القنوات التي تملكها Google، مثل YouTube وGmail وخلاصة "اقتراحات".

مواد العرض

الحملات

المعيار

  • تمت إضافة content_criterion_view الذي يعرض مقاييس أداء المحتوى المستهدَف، مثل الكلمات الرئيسية والمواضع والمواضيع، في "الحملات على الشبكة الإعلانية" و"الحملات لزيادة الطلب" و"حملات الفيديو".

الفنادق السفر

الخدمات المحلية

حملة الأداء الأفضل

التخطيط

  • (بالنسبة إلى الحسابات المُدرَجة في القائمة المسموح بها فقط) تمت إضافة خدمة جديدة باستخدام الطريقة ContentCreatorInsightsService.GenerateCreatorInsights، ما يتيح للمستخدمين استكشاف إحصاءات حول أبرز صنّاع المحتوى في YouTube. يتيح ذلك للعملاء البحث عن صنّاع محتوى استنادًا إلى مجموعة من استهدافات الجمهور واستهدافات المحتوى أو استنادًا إلى قائمة بأرقام تعريف قنوات YouTube للحصول على إحصاءات عن صنّاع المحتوى.
  • تعديلات على AudienceInsightsService.GenerateSuggestedTargetingInsights:
    • تم نقل audience وbaseline_audience وdata_month إلى audience_definition.
    • تمت إضافة audience_description لإنشاء اقتراحات استهداف من وصف نصي بتنسيق حر باستخدام الذكاء الاصطناعي التوليدي.
  • تمت إضافة AudienceInsightsService.GenerateTargetingSuggestionMetrics الذي يعرض مقاييس مدى الوصول المحتمل لمجموعات محدّدة من مجموعات استهداف الجمهور.

اقتراحات

إعداد التقارير

  • تم استبدال حقلَي summary_row_setting وreturn_total_results_count في SearchGoogleAdsRequest بحقل search_settings، الذي يكون نوعه SearchSettings، مع الحقول التالية:
    • omit_results
    • return_summary_row
    • return_total_results_count
  • تمت إضافة المقاييس الجديدة التالية حول النقرات غير الصالحة الناشئة عن تقنيات معروفة، مثل النقرات التي يتم إنشاؤها بواسطة برامج التتبُّع أو برامج الزحف، ذات الأنماط غير المنتظمة. ويمكن إجراء استعلام عنها باستخدام تقرير campaign.
  • تمت إضافة القيم التالية إلى QuotaError:
    • EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION
    • EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION

الإصدار 17.1.0 (07‏ آب/أغسطس 2024)

تمت إضافة الميزات والتحديثات الجديدة التالية في الإصدار 17_1.

مواد العرض

الجمهور

  • قِيم تعداد جديدة في UserListCustomerTypeCategory:
    • LOYALTY_TIER_1_MEMBERS
    • LOYALTY_TIER_2_MEMBERS
    • LOYALTY_TIER_3_MEMBERS
    • LOYALTY_TIER_4_MEMBERS
    • LOYALTY_TIER_5_MEMBERS
    • LOYALTY_TIER_6_MEMBERS
    • LOYALTY_TIER_7_MEMBERS

الحملات

سجل التغييرات

  • نوع مورد تغيير الحالة الجديد: ASSET_GROUP.

الإحالات الناجحة

التخطيط

  • AudienceInsights.GenerateAudienceOverlapInsights() التي تقبل سمة أساسية ومجموعة من سمات الجمهور، وتُعرِض تقديرات التداخل في مدى الوصول المحتمل إلى الجمهور على YouTube بين السمة الأساسية وسمات الجمهور

إعداد التقارير

الفيديوهات

الإصدار 17 (‎05-06-2024)

تمت إضافة الميزات والتغييرات التالية في الإصدار 17.

الإعلانات

  • تمت إزالة AdService.getAd. ويؤدي ذلك إلى توافق واجهة برمجة التطبيقات AdService مع الخدمات الأخرى في واجهة برمجة التطبيقات Google Ads API. اطّلِع على استرداد العناصر للاطّلاع على الطريقة المُقترَحة لجلب الإعلانات وأنواع الموارد الأخرى.
  • تمت إضافة المزيد من عمليات التحقّق من صحة ImageAdInfo.image_asset في ما يتعلّق بالسمات والتنسيق. قد تظهر الأخطاء التالية إذا كانت الصورة غير صالح:

مواد العرض

الجمهور

الوظائف المجمّعة

الحملات

  • تمت إعادة تسمية "الحملات أثناء التصفّح" إلى "الحملات لزيادة الطلب" في جميع الحقول والقوائم والخطأ في كل موارد Google Ads API، مثل الحملات والإعلانات ومواد العرض. بالنسبة على سبيل المثال، أصبحت AdvertisingChannelType.DISCOVERY الآن AdvertisingChannelType.DEMAND_GEN
  • تمت إضافة Campaign.keyword_match_type للسماح لك بضبط نوع مطابقة الكلمات الرئيسية لجميع الكلمات الرئيسية في إحدى الحملات.

الإحالات الناجحة

المعايير

الخدمات المحلية

إعداد التقارير

Shopping

الأهداف الموحّدة

الفيديوهات

  • تمت إضافة القيم التالية إلى ContentLabelType يمكنك استبعاد ContentLabelTypes هذه على مستوى العميل:
    • BRAND_SUITABILITY_CONTENT_FOR_FAMILIES
    • BRAND_SUITABILITY_GAMES_FIGHTING
    • BRAND_SUITABILITY_GAMES_MATURE
    • BRAND_SUITABILITY_HEALTH_SENSITIVE
    • BRAND_SUITABILITY_HEALTH_SOURCE_UNDETERMINED
    • BRAND_SUITABILITY_NEWS_RECENT
    • BRAND_SUITABILITY_NEWS_SENSITIVE
    • BRAND_SUITABILITY_NEWS_SOURCE_NOT_FEATURED
    • BRAND_SUITABILITY_POLITICS
    • BRAND_SUITABILITY_RELIGION
  • تمت إضافة AdVideoAsset.ad_video_asset_info للسماح بالإعدادات المفضّلة للمستودع لمواد عرض الفيديو عند إنشاء DemandGenVideoResponsiveAdInfo.
  • (الحسابات المُدرَجة في القائمة المسموح بها فقط) تم إنشاؤها Campaign.video_brand_safety_suitability قابل للتغيير.

الإصدار 16.1.0 (24/04/2024)

تمت إضافة الميزات والتغييرات التالية في الإصدار 16.1.

إدارة الحساب

مواد العرض

الجمهور

  • قيمة جديدة لقائمة القيم المحدّدة مسبقًا: ResourceLimitType.LOOKALIKE_USER_LISTS_PER_CUSTOMER تفرض هذه القيمة حدًا أقصى يبلغ 1,000 على عدد قوائم المستخدمين المشابهين التي يمكن أن يمتلكها العميل.

الحملات

الإحالات الناجحة

المعايير

التجارب

الخدمات المحلية

الفيديوهات

الإصدار 16 (21/02/2024)

تمت إضافة الميزات والتغييرات التالية في الإصدار 16.

إدارة الحساب

مواد العرض

  • التغييرات على asset_group:
    • إضافة إمكانية استخدام الشرائح المرتبطة بالوقت، مثل segments.year و segments.month
    • تم جعل campaign موردًا مرجعيًا بدلاً من إلى تقسيم الموارد.

الحملات

  • التغييرات على "الحملات لزيادة الطلب":
  • تمت إضافة البيانات إلى الحقول التالية إلى AdGroup لتوضيح ما إذا كانت عرض إعلانات المجموعة الإعلانية أو أسباب عدم عرضها:
    • primary_status
    • primary_status_reasons
  • تمت إضافتها إلى الحقول التالية في AdGroupAd لعرض ما إذا كان يتم عرض إعلان المجموعة الإعلانية أو أسباب عدم عرضه:
    • primary_status
    • primary_status_reasons
  • تمت إضافة القيم التالية إلى AdGroupError:
    • CANNOT_ADD_AD_GROUP_FOR_CAMPAIGN_TYPE
    • INVALID_STATUS

تجربة

الفنادق السفر

الخدمات المحلية

التخطيط

اقتراحات

  • تمت إضافة RecommendationService.GenerateRecommendations() التي تعرِض اقتراحات استنادًا إلى الإعدادات المحدّدة، مثل أنواع الاقتراحات وأنواع القنوات الإعلانية. هذا مفيد بشكل خاص أثناء إنشاء الحملة
  • تمت الإضافة RecommendationMetrics.conversions_value
  • تتضمّن الآن الكلمات الرئيسية المقترَحة التي لم يتم ضبط نوع المطابقة لها recommended_match_type تم ضبطها على UNSPECIFIED بدلاً من UNKNOWN.
  • تمت إضافة أنواع الاقتراحات التالية:
    • MAXIMIZE_CONVERSION_VALUE_OPT_IN التي تقترح تفعيل استراتيجية "عروض أسعار تحقيق الحدّ الأقصى من قيمة الإحالات الناجحة" الألعاب الاستراتيجية
    • IMPROVE_GOOGLE_TAG_COVERAGE التي تقترح نشر "علامة Google" على المزيد من الصفحات
    • PERFORMANCE_MAX_FINAL_URL_OPT_IN التي تنصح بتفعيل ميزة توسيع عنوان URL النهائي في "حملات الأداء الأفضل" الحملات
    • REFRESH_CUSTOMER_MATCH_LIST التي تقترح تعديل قائمة عملاء لم يتم تعديلها في آخر 90 يومًا
    • CUSTOM_AUDIENCE_OPT_IN التي تقترح إنشاء شريحة جمهور مخصّصة
    • LEAD_FORM_ASSET التي تقترح إضافة مواد عرض نماذج العملاء المحتملين على مستوى الحملة أو العميل
    • IMPROVE_DEMAND_GEN_AD_STRENGTH الذي يقترح تحسين قوة الإعلان في "الحملات لزيادة الطلب"

Shopping

أهداف مراحل النشاط

  • تمت إضافة "update" إلى CustomerLifecycleGoalOperation أو CampaignLifecycleGoalOperation لجعل أنواع العمليات هذه متسقة مع أنواع العمليات الأخرى في واجهة برمجة التطبيقات. ## ملاحظات الإصدار المؤرشفة

راجِع الإصدارات التي تم إيقاف العمل بها للاطّلاع على ملاحظات الإصدار المؤرشفة.