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

الإصدار 19.1 (‎16/04/2025)

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

مواد العرض

• تمت إضافة حقل asset_coverage لسمة AssetGroup التي تعرض معلومات عن الفجوات في مجموعة مواد العرض.
  • يحتوي على حقل فرعي ad_strength_action_items يعرض قائمة بالإجراءات التي يمكن للمعلِن اتّخاذها لتحسين قوة الإعلان لمجموعة مواد عرض معيّنة.

الحملات

• يمكنك الآن تقييم العملاء المحتملين أو تقديم ملاحظات عنهم في حملات الخدمات المحلّية. كجزء من هذا التغيير، تم تعديل الإصدار 19.1
  • تمت إضافة خدمة جديدة باسم LocalServicesLeadService. يمكنك استخدام ProvideLeadFeedback الطريقة لتحميل التقييم والملاحظات حول العملاء المحتملين.
  • تمت إضافة حقل جديد باسم lead_feedback_submitted إلى LocalServicesLead للمساعدة في تحديد ما إذا كان العميل المحتمل قد تلقّى ملاحظاتك.
• تمت إضافة عمود مقياس جديد biddable_cohort_app_post_install_conversions لحملات التطبيقات.

الحملات لزيادة الطلب

• تمّت إضافة طُرق إضافية في خدمات التخطيط لدعم "الحملات لزيادة الطلب".

• تمت إتاحة عناصر التحكّم بالقنوات في "حملات زيادة الطلب" على مستوى المجموعة الإعلانية. يمكنك اختيار مجموعة عامة محدّدة مسبقًا من القنوات أو مجموعة فرعية من القنوات باستخدام الحقل demand_gen_ad_group_settings. القنوات المتاحة في الإصدار الحالي:

  • أثناء عرض الفيديو على YouTube
  • الإعلانات ضمن الخلاصة على YouTube
  • YouTube Shorts
  • اكتشاف
  • Gmail
  • الشبكة الإعلانية

• تمّ عرض نوع مادة عرض جديد لمواد عرض TALL_PORTRAIT_MARKETING_IMAGE. يرتبط نوع مادة العرض هذا بحقل tall_portrait_marketing_images شكل الإعلان المتعدّد مواد العرض لزيادة الطلب.

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

• تمت إضافة دعم لثلاثة أنواع أخرى من الموارد في ChangeStatusResourceType:
  • CAMPAIGN_BUDGET
  • ASSET_SET
  • CAMPAIGN_ASSET_SET
• يمكنك استرداد هذه الأنواع الثلاثة الأكثر دقة من تقرير change_status.

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

• يمكنك الآن ضبط الحقل google_ads_conversion_customer أثناء إنشاء عميل جديد باستخدام Google Ads API. كان هذا الحقل في السابق للقراءة فقط.
• يمكنك الآن تحديد نوع العميل المرتبط بالإحالة الناجحة عند تحميل الإحالات الناجحة بلا إنترنت.
• تمّ إدخال حقل session_attributes جديد لـ ClickConversion.

إعلانات الخدمات المحلية

• تمت إضافة RPC جديد ProvideLeadFeedback إلى LocalServicesLeadService لمحاولة تقديم ملاحظات حول جودة LocalServicesLead.
• تمت إضافة حقل جديد lead_feedback_submitted إلى LocalServicesLead المورد يؤكّد ما إذا تم تقديم ملاحظات لمورد معيّن.

خدمات التخطيط

• تمت إضافة إمكانية استخدام التوقعات الشهرية لعدد مرّات الظهور المستهدَف في ReachPlanService.GenerateReachForecast.
  • يمكن للمطوّرين ضبط TargetFrequencyTimeUnit.MONTHLY في TargetFrequencySettings عند استخدام رمز المنتج TARGET_FREQUENCY القابل للتخطيط لإنشاء توقّعات شهرية للوصول إلى الجمهور بالاستناد إلى عدد مرّات الظهور المستهدَف.
• تمت إضافة طريقة جديدة ReachPlanService.GenerateConversionRates، تسمح للمعلِنين بطلب معدّلات إحالات ناجحة مقترَحة للمنتجات القابلة للتخطيط المتوافقة.
• توقّعات "الحملات لزيادة الطلب" في ReachPlanService.GenerateReachForecast:
  • يمكن للمطوّرين الآن طلب توقّعات مدى الوصول إلى الجمهور في "الحملات لزيادة الطلب". يمكن للمطوّرين استخدام رمز المنتج القابل للتخطيط DEMAND_GEN_MAX_CONVERSIONS الجديد لإنشاء توقّعات مدى الوصول إلى الجمهور في "الحملات لزيادة الطلب".
  • تمت إضافة حقل conversion_rate جديد يتيح للمطوّرين الذين يطلبون توقّعات مدى الوصول في "حملات زيادة الطلب" تقديم معدل إحالات ناجحة. يمكن استرداد معدّلات الإحالات الناجحة المقترَحة باستخدام الطريقة الجديدة ReachPlanService.GenerateConversionRates. هذا الحقل مطلوب لطلبات التوقّعات في "حملات زيادة الطلب". ولا يمكن استخدامها مع المنتجات الأخرى القابلة للتخطيط.
  • تمت إضافة حقل conversions جديد إلى التوقّعات التي يتم عرضها. يحتوي هذا الحقل على عدد الإحالات الناجحة في نقطة معيّنة على منحنى مدى الوصول. لا تتوفّر الإحالات الناجحة إلا لمنتجات DEMAND_GEN_MAX_CONVERSIONS القابلة للتخطيط.

اقتراحات

• يتوفّر الحقل الجديد ad_strength لأجل ImprovePerformanceMaxAdStrengthRecommendation، الذي يعرض نتيجة قوة الإعلان الحالية لمجموعة مواد العرض المرتبطة بالاقتراح.

Shopping

• يمكنك الآن إلغاء استبعادات العلامات التجارية لإعلانات Shopping في "حملات الأداء الأفضل". يتم عرض ذلك من خلال حقل pmax_campaign_settings جديد على مستوى الحملة، ولا يعمل إلا مع حملات الأداء الأفضل للبيع بالتجزئة. ستظهر رسالة خطأ جديدة CampaignError.BRAND_TARGETING_OVERRIDES_NOT_SUPPORTED إذا حاولت ضبط هذا الحقل لنوع حملة غير متوافق.

الفيديوهات

• تمت إضافة إمكانية القراءة فقط للإعلانات الصوتية. يُرجى الاطّلاع على مركز مساعدة "إعلانات Google" لاطلاعك على مزيد من المعلومات عن هذه الميزة. ويؤدي هذا التغيير إلى عرض ما يلي:
  • AdvertisingChannelSubType جديد باسم YOUTUBE_AUDIO
  • AdGroupType جديد باسم YOUTUBE_AUDIO
  • قائمة جديدة لأشكال الإعلانات باسم YOUTUBE_AUDIO_AD، وحقولها المقابلة YouTubeAudioAdInfo
• تمّت إضافة مقاييس وشرائح جديدة إلى مقاييس مدى الوصول إلى طلبات البحث مع تعديل الإصدار التجريبي. في إطار هذه التغييرات،
  • تمّت إتاحت عمودَي مقاييس جديدَين باسمَي coviewed_impressions و primary_impressions.
  • تمّ طرح شريحةَين جديدتَين باسمَين adjusted_age_range و adjusted_gender.
  • في حال اختيار أيّ من الشركتين الجديدتَين إلى جانب حقل مقياس مدى الوصول (coviewed_impressions أو primary_impressions أو unique_users أو average_impression_frequency_per_user)، يجب اختيار الشريحة الأخرى أيضًا لاسترداد إحصاءات صالحة لهذه الأعمدة.
  • لا تتوفّر هذه الميزة حاليًا إلا للعملاء المدرَجين في القائمة المسموح بها.

الإصدار 19 (‎26-02-2025)

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

إدارة الحساب

• تمت إضافة القيم التالية إلى CustomerError للتماشي مع التغييرات القادمة:
  • CREATION_DENIED_FOR_POLICY_VIOLATION
  • CREATION_DENIED_INELIGIBLE_MCC

الإعلانات

• تمت إضافة DemandGenMultiAssetAdInfo.tall_portrait_marketing_images لإتاحة استخدام مواد عرض الصور العمودية بنسبة عرض إلى ارتفاع 9:16 في إعلانات "الحملات لزيادة الطلب".

مواد العرض

• (للحسابات المُدرَجة في القائمة المسموح بها فقط) تمت إضافة ميزة استخدام مواد عرض الرسائل من خلال Asset.business_message_asset و BusinessMessageAsset والأنواع التالية من القوائم والأخطاء.
  • القيم المحدَّدة مسبقًا:
    • AssetFieldType.BUSINESS_MESSAGE
    • AssetType.BUSINESS_MESSAGE
    • BusinessMessageCallToActionType
    • BusinessMessageProvider
  • الأخطاء:
    • AssetError.CUSTOMER_NOT_ON_ALLOWLIST_FOR_WHATSAPP_MESSAGE_ASSETS
    • ResourceLimitType
      • BUSINESS_MESSAGE_ASSET_LINKS_PER_CUSTOMER
      • WHATSAPP_BUSINESS_MESSAGE_ASSET_LINKS_PER_CAMPAIGN
      • WHATSAPP_BUSINESS_MESSAGE_ASSET_LINKS_PER_AD_GROUP
• تمت إضافة AssetAutomationType.GENERATE_LANDING_PAGE_PREVIEW للسماح بإنشاء معاينة للصفحة المقصودة تلقائيًا.
• تم تفعيل AssetAutomationType.GENERATE_SHORTER_YOUTUBE_VIDEOS إعلانات الفيديو المتجاوبة لزيادة الطلب تلقائيًا.
• (للحسابات المُدرَجة في القائمة المسموح بها فقط، علماً بأنّ القائمة المسموح بها مغلقة حاليًا) تمت إضافة Asset.app_deep_link_asset و AppDeepLinkAsset.

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

• أهداف الإحالات الناجحة
  • أصبح LifecycleGoalValueSettings.high_lifetime_value متاحًا خارج نطاق الإصدار التجريبي ويمكن تغييره الآن.
  • تمت إضافة CustomerLifecycleGoal.owner_customer لعرض اسم المورد الخاص بالعميل الذي يملك هدف رحلة العميل.
• تم إيقاف ConversionActionType.SALESFORCE نهائيًا.

الخلاصات

• تمت إزالة جميع الكيانات ذات الصلة بالخلاصة، مثل Feed وFeedMapping FeedService وAdGroupFeed وfeed_placeholder_view وما إلى ذلك. على المستخدمين الآن استخدام assets لتحقيق الغرض نفسه. يُرجى الانتقال إلى ملاحظات نقل البيانات للاطّلاع على قائمة بجميع العناصر التي تمت إزالتها.

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

• جعلت الحقلَين min_days وmax_days من ValueRuleItineraryAdvanceBookingWindow حقل optional للسماح بتحديد القيمة 0. يتيح ذلك استهداف عمليات البحث المتعلّقة بالسفر التي تتم اليوم.

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

• (للحسابات المُدرَجة في القائمة المسموح بها فقط) إرشادات بناء هوية العلامة التجارية
  • أصبح Campaign.brand_guidelines_enabled قابلاً للتغيير فقط عند إنشاء "حملة أداء أفضل".
  • وهذا الإجراء غير متوافق مع حملات الأداء الأفضل المستندة إلى أهداف السفر.
  • لتفعيل إرشادات العلامة التجارية في "حملات الأداء الأفضل" الحالية، استخدِم CampaignService.EnablePMaxBrandGuidelines تمت إضافته حديثًا. لا يمكن إيقاف إرشادات العلامة التجارية.
  • تمت إضافة Campaign.brand_guidelines وBrandGuidelines للسماح بضبط ألوان العلامة التجارية ومجموعة الخطوط.
  • قيم الأخطاء الجديدة:
    • BatchJobError.CAMPAIGN_AND_CAMPAIGN_ASSET_TRANSACTION_FAILURE
    • BrandGuidelinesMigrationError
    • BRAND_GUIDELINES_ALREADY_ENABLED
    • CANNOT_ENABLE_BRAND_GUIDELINES_FOR_REMOVED_CAMPAIGN
    • BRAND_GUIDELINES_LOGO_LIMIT_EXCEEDED
    • CANNOT_AUTO_POPULATE_BRAND_ASSETS_WHEN_BRAND_ASSETS_PROVIDED
    • AUTO_POPULATE_BRAND_ASSETS_REQUIRED_WHEN_BRAND_ASSETS_OMITTED
    • TOO_MANY_ENABLE_OPERATIONS
  • CampaignError
    • BRAND_GUIDELINES_NOT_ENABLED_FOR_CAMPAIGN
    • BRAND_GUIDELINES_MAIN_AND_ACCENT_COLORS_REQUIRED
    • BRAND_GUIDELINES_COLOR_INVALID_FORMAT
    • BRAND_GUIDELINES_UNSUPPORTED_FONT_FAMILY
    • BRAND_GUIDELINES_UNSUPPORTED_CHANNEL
    • CANNOT_ENABLE_BRAND_GUIDELINES_FOR_TRAVEL_GOALS
    • CUSTOMER_NOT_ALLOWLISTED_FOR_BRAND_GUIDELINES
• تمت الإضافة AssetAutomationType.GENERATE_ENHANCED_YOUTUBE_VIDEOS لإتاحة إنشاء مواد عرض محسّنة للفيديوهات تلقائيًا في "حملات الأداء الأفضل" .

التخطيط

• (للحسابات المدرَجة في القائمة المسموح بها فقط) تمت إضافة ميزة ContentCreatorInsightsService.GenerateTrendingInsights التي تتيح للمستخدمين الاطّلاع على مواضيع المحتوى الرائجة على YouTube لتعريفات محددة للجمهور.
• تمت إضافة رمز GenerateCreatorInsightsRequest.country_locations[] لتحديد البلدان التي تريد البحث فيها عن المعايير المحدّدة.
• تمت إضافة رمز GenerateCreatorInsightsRequest.search_brand لتحديد علامة تجارية للبحث عن صنّاع محتوى
• تمت إضافة حقول جديدة إلى YouTubeChannelInsights لتوفير معلومات إضافية عن القناة لطلبات search_channels :
  • channel_url
  • channel_description
  • top_videos
• تمت إضافة حقول بيانات وصفية جديدة إلى AudienceInsightsAttributeMetadata:
  • youtube_video_metadata
  • user_interest_attribute_metadata
  • knowledge_graph_attribute_metadata

الفيديوهات

• بعد إصدار DataLinkService.CreateDataLink، أضفنا الطرق التالية للسماح بتعديل روابط data التي تم إنشاؤها سابقًا:
  • RemoveDataLink لإزالة روابط البيانات في حساب "إعلانات Google"
  • UpdateDataLink لقبول روابط البيانات ورفضها وإبطالها في حساب على "إعلانات Google"
• تمت إزالة التوافق مع VIDEO_OUTSTREAM من القوائم المحددة التالية:
  • AdType
  • AdvertisingChannelSubType
  • AdGroupType

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

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

إدارة الحساب

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

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

• تمت إضافة AdGroup.exclude_demographic_expansion الذي يتيح لك استبعاد الخصائص الديمغرافية من التوسّع عندما يكون optimized_targeting_enabled هو true، وهي ميزة كانت متاحة سابقًا فقط في "حملات زيادة الطلب".

الإعلانات

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

مواد العرض

• تمت إعادة تسمية AssetType.DISCOVERY_CAROUSEL_CARD إلى AssetType.DEMAND_GEN_CAROUSEL_CARD.

الحملات

• تمت إضافة metrics.store_visits_last_click_model_attributed_conversions، الذي يعرض عدد زيارات المتجر التي تمّ تحديد مصدرها باستخدام نموذج النقرة الأخيرة لإحدى الحملات.
• تمت إضافة المقاييس التالية المتعلّقة بمشاهدة الفيديو لحملة معيّنة:
  • metrics.video_view_rate_in_feed
  • metrics.video_view_rate_in_stream
  • metrics.video_view_rate_shorts
• تمت إضافة metrics.results_conversions_purchase، الذي يعرض عمليات شراء الإحالات الناجحة لنتائج الأهداف الموحّدة لحملة معيّنة.
• تم تغيير القيمة التلقائية لسمة DemandGenCampaignSettings.upgraded_targeting من false إلى true.

المعيار

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

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

• إتاحة خلاصات السفر في "الإعلانات على شبكة البحث"
  • تمت إضافة ClickType.TRAVEL_ASSETS للسماح بتقسيم مقاييس خلاصات السفر في "الإعلانات على شبكة البحث".
  • تمت إضافة AssetSetType.TRAVEL_FEED التي يمكن استخدامها للموافقة على استخدام خلاصة السفر في الإعلانات على شبكة البحث أو إيقافه.
• (للحسابات المُدرَجة في القائمة المسموح بها فقط) تمت إضافة برنامج الرحلة كأحد قواعد قيم الإحالات الناجحة الجديدة باستخدام الحقول والقيم الجديدة التالية:
  • ConversionValueRule.itinerary_condition مع ValueRuleItineraryCondition، يتيح ذلك تحديد فترة الحجز المُسبَق ومدة برنامج الرحلة وأيام الأسبوع لبدء الرحلة
  • ConversionValueRulePrimaryDimensionEnum.ITINERARY
  • ValueRuleSetDimension.ITINERARY
• تمت إضافة الشرائح التالية لتقارير campaign و ad_group للسماح بتقسيم بيانات الأداء استنادًا إلى وجهات معيّنة (المدن والبُلدان والمناطق) لكلّ من "حملات الفنادق" و"الحملات على شبكة البحث":
  • segments.travel_destination_city
  • segments.travel_destination_country
  • segments.travel_destination_region

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

• ستكون سمة PhoneCallDetails.call_recording_url فارغة، بدلاً من تقديم عنوان URL غير صالح إذا لم يكن تسجيل المكالمة متوفّرًا لمحادثة العميل المحتمل في الخدمات المحلية المحدّدة.
• تمت إضافة CategoryBid.target_cpa_bid_micro التي تتيح ضبط التكلفة المستهدَفة للإجراء لفئة معيّنة من خلال Campaign.local_services_campaign_settings.

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

• دعم إرشادات العلامة التجارية
  • تمت إضافة Campaign.brand_guidelines_enabled، الذي يشير إلى ما إذا كانت إرشادات الهوية البصرية للعلامة التجارية مفعّلة في "حملة أداء أفضل" معيّنة. في حال تفعيل هذه الميزة، يجب ربط مواد العرض التي تم ضبط field_type فيها على BUSINESS_NAME، LOGO، LANDSCAPE_LOGO كموارد CampaignAsset بدلاً من موارد AssetGroupAsset.
  • تمّت إضافة خطأَي CampaignError.REQUIRED_BUSINESS_NAME_ASSET_NOT_LINKED و CampaignError.REQUIRED_LOGO_ASSET_NOT_LINKED ، اللذَين يشيرَان إلى أنّ "حملات الأداء الأفضل" التي تم تفعيل إرشادات العلامة التجارية فيها لا تتضمّن CampaignAsset الموارد المطلوبة المرتبطة بالحملة.
  • عند تفعيل إرشادات العلامة التجارية، يجب ربط مادة عرض واحدة على الأقل تم ضبط field_type فيها على BUSINESS_NAME ومادة عرض واحدة على الأقل تم ضبط LOGO فيها على CampaignAsset بصفتها موردَين للحملة. يجب أن تستوفي "حملات الأداء الأفضل" للمبيعات على الإنترنت باستخدام خلاصة منتجات هذا الشرط فقط عندما تكون هناك مواد عرض مرتبطة بمجموعات مواد عرض الحملة.
  • تمت إضافة القيم التالية إلى AssetLinkError:
    • BRAND_ASSETS_NOT_LINKED_AT_ASSET_GROUP_LEVEL، الذي يتمّ طرحه عند محاولة ربط مواد عرض العلامة التجارية بالحملات كموارد CampaignAsset بدلاً من موارد AssetGroupAsset في "حملات الأداء الأفضل" التي لم يتم تفعيل إرشادات العلامة التجارية فيها
    • خطأ BRAND_ASSETS_NOT_LINKED_AT_CAMPAIGN_LEVEL الذي يتمّ طرحه عند محاولة ربط مواد عرض العلامات التجارية بالحملات بصفتها موارد AssetGroupAsset بدلاً من موارد CampaignAsset في "حملات الأداء الأفضل" التي تمّ تفعيل إرشادات العلامة التجارية فيها
• تمت إضافة performance_max_placement_view، الذي يعرض مرّات ظهور مواضع الإعلانات التي تمّ عرض إعلانات "حملات الأداء الأفضل" فيها.
• تمت الإضافة AssetGroupListingGroupFilterError.TREE_WAS_INVALID_BEFORE_MUTATION

التخطيط

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

اقتراحات

• يمكن الآن استخدام RecommendationService.GenerateRecommendations لإنشاء اقتراحات بشأن اقتراحات الميزانية المحسّنة أثناء إنشاء الحملة، وذلك من خلال تضمين نوع الاقتراح CAMPAIGN_BUDGET في GenerateRecommendationsRequest.recommendation_types[]. وينطبق ذلك على "حملات الأداء الأفضل" و"الحملات على شبكة البحث".

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

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

الإصدار 17.1.0 (‎07-08-2024)

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

مواد العرض

• AdGroupAdService.RemoveAutomaticallyCreatedAssets() يتيح لك إزالة مواد عرض منشأة تلقائيًا محددة مرتبطة بالإعلانات المتجاوبة على شبكة البحث.

الجمهور

• قيم التعداد الجديدة في 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

الحملات

• يُنشئ ShareablePreviewService.GenerateShareablePreviews() عناوين URL shareable_preview_url في الاستجابة لمعاينات الإعلانات القابلة للمشاركة لمواد العرض المجموعات الإعلانية المفعَّلة والمتوقفة مؤقتًا.
  • يشير الحقل expiration_date_time إلى تاريخ انتهاء صلاحية عناوين URL في الاستجابة.
  • في حال حدوث خطأ، ستعرِض الطريقة partial_failure_error بدلاً من عناوين URL.

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

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

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

• حقل قسم جديد لإصدار SKAdNetwork: segments.sk_ad_network_version
• offline_conversion_upload_conversion_action_summary، الذي يعرض بيانات تشخيص تحميل الإحالات الناجحة على مستوى إجراء الإحالة الناجحة.
• تتم إضافة المقاييس التالية إلى تقارير بيانات التشخيص بلا إنترنت للتعبير عن عدد الإحالات الناجحة المحمَّلة التي لا تزال قيد المعالجة:
  • offline_conversion_upload_client_summary
    • pending_event_count
    • pending_rate
  • offline_conversion_upload_conversion_action_summary:
    • pending_count

التخطيط

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

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

• إتاحة تقسيم per_store_view استنادًا إلى segments.date

الفيديوهات

• إتاحة استرداد المعلومات المتعلّقة بالملفّات التالية استراتيجيات عروض الأسعار العادية لحملات الفيديو باستخدام التقارير، مثل، ad_group وcampaign:
  • Campaign.fixed_cpm (التكلفة الثابتة لكل ألف ظهور)
  • Campaign.target_cpv (تكلفة المشاهدة المستهدَفة)
• Campaign.video_campaign_settings يتيح لك هذا التقرير تحديد المستودعات التي يمكن عرض إعلانات الفيديو عليها، وذلك باستخدام حقول التقارير التالية:
  • campaign.video_campaign_settings.video_ad_inventory_control.allow_in_feed
  • campaign.video_campaign_settings.video_ad_inventory_control.allow_in_stream
  • campaign.video_campaign_settings.video_ad_inventory_control.allow_shorts
• segments.ad_format_type التي تسمح لك بتقسيم التقارير التالية استنادًا إلى نوع شكل إعلان الفيديو:
  • ad_group
  • ad_group_ad
  • ad_group_ad_asset_view
  • campaign
  • customer

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

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

الإعلانات

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

مواد العرض

• تمت إضافة عنصر enum جديد: ClickType.AD_IMAGE
• تمت إضافة التقارير الجديدة التالية التي تتضمّن مقاييس جديدة لكلّ من "حملات الأداء الأفضل" و "الحملات على شبكة البحث":
  • campaign_aggregate_asset_view
  • channel_aggregate_asset_view

الجمهور

• تمت إضافة OfflineUserDataJobError.OPERATION_LEVEL_CONSENT_PROVIDED

المهام المجمّعة

• تمت إضافة BatchJobError.REQUEST_TOO_LARGE، الذي سيتم طرحه عندما يكون حجم AddBatchJobOperationsRequest الذي تم إرساله أكبر من 10484504 بايت.
• تمت إضافة إمكانية ضبط MutateOperation.asset_group_operation عند استخدام BatchJobService. يتيح لك ذلك استخدام المعالجة المجمّعة لإنشاء "حملات الأداء الأفضل" بالكامل و إدارتها. اطّلِع على الدليل المخصّص الجديد.

الحملات

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

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

• بالنسبة إلى الإحالات الناجحة على SKAdNetwork،
  • تمت إعادة تسمية segments.sk_ad_network_conversion_value إلى segments.sk_ad_network_fine_conversion_value.
  • تمت إضافة segments.sk_ad_network_redistributed_fine_conversion_value.
• يتم الآن عرض المقاييس التالية مع الاستجابة حتى إذا كانت قيمتها صفرًا. ما يجعلها متّسقة مع المقاييس الأخرى.
  • metrics.all_conversions_value_by_conversion_date
  • metrics.all_conversions_by_conversion_date
  • metrics.conversions_value_by_conversion_date
  • metrics.conversions_by_conversion_date

المعايير

• تمت إضافتها إلى الحقول التالية في جدول AdGroupCriterion لعرض ما إذا كان معيار المجموعة الإعلانية معروضًا أو أسباب عدم عرضه:
  • primary_status
  • primary_status_reasons
• تمت إضافة دعم لسمة metrics.search_impression_share في gender_view
• تمت إضافة دعم لسمة metrics.phone_calls في keyword_view

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

• تمت إضافة LocalServicesLeadService.AppendLeadConversation() يُستخدَم لإلحاق LocalServicesLeadConversation جديد بـ LocalServicesLead، ما يؤدي إلى إرسال الرسائل إلى المستخدِمين من خلال القنوات المناسبة، مثل الرسائل القصيرة SMS، استنادًا إلى كيفية إنشاء العميل المحتمل.
  • يقتصر حجم AppendLeadConversationRequest.conversations على 1,000.
  • لا يمكن تحديد سوى LocalServicesLead التي تم ضبط lead_type فيها على LeadType.MESSAGE في Conversation.local_services_lead.
• تمت إضافة قيم جديدة لسمة "القائمة المحدودة" إلى: ConversationType:
  • WHATSAPP لتمثيل محادثة تم إجراؤها من خلال WhatsApp
  • ADS_API لتمثيل محادثة تم تقديمها باستخدام الطريقة الجديدة LocalServicesLeadService.AppendLeadConversation()
• تمت إضافة الحقول الجديدة التالية إلى local_services_verification_artifact:
  • local_services_verification_artifact.insurance_verification_artifact.expiration_date_time
  • local_services_verification_artifact.license_verification_artifact.expiration_date_time

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

• يمكنك الآن اختيار الحقول المرتبطة بمنتج واحد مرتبط فقط عند إجراء طلب بحث في product_link. سيؤدي اختيار عدة حقول من عدة منتجات مرتبطة إلى طرح QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE. على سبيل المثال، product_link.advertising_partner.customer و product_link.data_partner.data_partner_id لا يمكن اختيارهما في طلب البحث نفسه.
• سيؤدي تمرير page_size إلى GoogleAdsService.Search إلى حدوث خطأ RequestError.PAGE_SIZE_NOT_SUPPORTED.

Shopping

• تمت إضافة تقرير جديد shopping_product، وهو يتوافق مع صفحة المنتجات في واجهة مستخدم "إعلانات Google". ويتيح عرض البيانات المتعلّقة بالحالة الحالية للمنتجات من حسابات Google Merchant Center المرتبطة بحساب على "إعلانات Google".
  • يمكنك فلترة المقاييس من تقرير shopping_product باستخدام segments.date عند استخدام GoogleAdsService.Search أو GoogleAdsService.SearchStream. لا يُسمح بالتقسيم حسب التاريخ، وسيؤدي ذلك إلى عرض خطأ ShoppingProductError.UNSUPPORTED_DATE_SEGMENTATION.

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

• تمت إضافة UserListCustomerTypeService.MutateUserListCustomerTypes() لضبط أنواع العملاء من الجمهور.
• تمت إزالة CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings. لضبط إعدادات الجمهور لأهداف مراحل نشاط العميل، استخدِم UserListCustomerTypeService.MutateUserListCustomerTypes() بدلاً من ذلك.
  • يمكنك إرفاق قائمة مستخدمين أو إلغاء إرفاقها عن طريق ضبط القيمة UserListCustomerType.customer_type_category على UserListCustomerTypeCategory.PURCHASERS لتضمينها في تعريف عميل حالي أو استبعادها منه لأهداف مراحل نشاط العملاء، على التوالي. يُرجى الانتقال إلى مقالة تقسيم شرائح الجمهور للاطّلاع على مزيد من التفاصيل.

الفيديوهات

• تمت إضافة القيم التالية إلى 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 قابلاً للتغيير.

ملاحظات الإصدار المؤرشفة

اطّلِع على الإصدارات التي تم إيقافها نهائيًا للاطّلاع على ملاحظات الإصدارات المؤرشَفة.