الإصدار 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.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
للسماح بتقسيم بيانات الأداء استنادًا إلى وجهات معيّنة (مدن وبلدان ومناطق) لـ "حملات الفنادق" و"الحملات على شبكة البحث":
الخدمات المحلية
- سيكون الحقل
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
. - تمت إضافة القيم التالية إلى
QuotaError
:EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION
EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION
الإصدار 17.1.0 (07 آب/أغسطس 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
الذي يعرض بيانات تشخيص تحميل الإحالات الناجحة على مستوى إجراء الإحالة الناجحة.- تتمّ إضافة المقاييس التالية إلى تقارير بيانات التشخيص بلا إنترنت لتوضيح عدد الإحالات الناجحة المحمَّلة التي لا تزال قيد المعالجة:
التخطيط
-
AudienceInsights.GenerateAudienceOverlapInsights()
التي تقبل سمة أساسية ومجموعة من سمات الجمهور، وتُعرِض تقديرات التداخل في مدى الوصول المحتمل إلى الجمهور على YouTube بين السمة الأساسية وسمات الجمهور
إعداد التقارير
- إتاحة تقسيم
per_store_view
استنادًا إلىsegments.date
الفيديوهات
- إتاحة استرداد المعلومات ذات الصلة باستراتيجيات عروض الأسعار العادية التالية لحملات الفيديو باستخدام التقارير، مثل
ad_group
وcampaign
:Campaign.fixed_cpm
(التكلفة الثابتة لكل ألف ظهور)Campaign.target_cpv
(تكلفة المشاهدة المستهدَفة)
Campaign.video_campaign_settings
الذي يتيح لك تحديد المستودعات الإعلانية التي يمكن عرض إعلانات الفيديو عليها باستخدام حقول التقارير التالية:segments.ad_format_type
الذي يتيح لك تقسيم التقارير التالية استنادًا إلى نوع شكل إعلان الفيديو:
الإصدار 17 (05-06-2024)
تمت إضافة الميزات والتغييرات التالية في الإصدار 17.
الإعلانات
- تمت إزالة
AdService.getAd
. ويؤدي ذلك إلى توافق واجهة برمجة التطبيقاتAdService
مع الخدمات الأخرى في واجهة برمجة التطبيقات Google Ads API. اطّلِع على استرداد العناصر للاطّلاع على الطريقة المُقترَحة لجلب الإعلانات وأنواع الموارد الأخرى. - تمت إضافة المزيد من عمليات التحقّق من صحة
ImageAdInfo.image_asset
في ما يتعلّق بالسمات والتنسيق. قد تظهر الأخطاء التالية إذا كانت الصورة غير صالح:
مواد العرض
- تمت إضافة تعداد جديد:
ClickType.AD_IMAGE
- تمت إضافة التقارير الجديدة التالية بمقاييس جديدة لكلٍّ من "حملات الأداء الأفضل" و"الحملات على شبكة البحث":
الجمهور
الوظائف المجمّعة
- تمت إضافة
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
.
- تمت إعادة التسمية
- يتم الآن عرض المقاييس التالية مع الاستجابة حتى إذا كانت قيمتها صفرًا. هذا يجعلها متسقة مع المقاييس الأخرى.
المعايير
- تمت إضافتها إلى الحقول التالية في
AdGroupCriterion
لعرض ما إذا كان معيار المجموعة الإعلانية معروضًا أو أسباب عدم عرضه:primary_status
primary_status_reasons
- تمت إضافة
metrics.search_impression_share
لنظام التشغيلgender_view
- تمت إضافة دعم لـ
metrics.phone_calls
لـkeyword_view
الخدمات المحلية
- تمت إضافة
LocalServicesLeadService.AppendLeadConversation()
. لإلحاق حرف جديدLocalServicesLeadConversation
إلىLocalServicesLead
، الذي يرسل الرسائل إلى المستخدمين من خلال القنوات المناسبة مثل الرسائل القصيرة SMS اعتمادًا على تم إنشاء العميل المحتمل.- حجم
AppendLeadConversationRequest.conversations
محدود إلى 1000. 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
قابل للتغيير.
الإصدار 16.1.0 (24/04/2024)
تمت إضافة الميزات والتغييرات التالية في الإصدار 16.1.
إدارة الحساب
CustomerNegativeCriterion.ip_block
الذي يدعم إضافة عنوان IP كمعيار سلبي على مستوى العميل- قيمة التعداد الجديدة:
ProductLinkError.LINK_EXISTS
. - قيمة التعداد الجديدة:
ProductLinkInvitationError.CUSTOMER_NOT_PERMITTED_TO_CREATE_INVITATION
.
مواد العرض
- إتاحة مواد العرض ذات الصلة بالحملات لزيادة الطلب
ad_group_ad_asset_view
وasset_field_type_view
- قيمة التعداد الجديدة:
AssetFieldType.DISCOVERY_CAROUSEL_CARD
.
الجمهور
- قيمة جديدة لقائمة القيم المحدّدة مسبقًا:
ResourceLimitType.LOOKALIKE_USER_LISTS_PER_CUSTOMER
تفرض هذه القيمة حدًا أقصى يبلغ 1,000 على عدد قوائم المستخدمين المشابهين التي يمكن أن يمتلكها العميل.
الحملات
- إتاحة عرض الهدف
عمليات محاكاة عروض أسعار الحملات المستندة إلى عائد الإنفاق الإعلاني (ROAS)
تستخدِم حملات التطبيقات
تقرير
campaign_simulation
. - قيمة التعداد الجديدة:
CampaignError.DYNAMIC_TEXT_ASSET_CANNOT_OPT_OUT_WITH_FINAL_URL_EXPANSION_OPT_IN
- قيمة التعداد الجديدة:
AdGroupPrimaryStatusReason.AD_GROUP_PAUSED_DUE_TO_LOW_ACTIVITY
. - قيمة التعداد الجديدة:
CampaignCriterionError.CANNOT_REMOVE_ALL_LOCATIONS_DUE_TO_TOO_MANY_COUNTRY_EXCLUSIONS
الإحالات الناجحة
SkAdNetworkConversionValueSchema.postback_mappings
تتوفّر ميزات SKAdNetwork 4.0 .- تمت إضافة دعم للتحذيرات بشأن
CustomerSkAdNetworkConversionValueSchemaService
كـMutateCustomerSkAdNetworkConversionValueSchemaRequest.enable_warnings
عند ضبطه علىtrue
، سيتم عرض أي أخطاء غير مانعة تتعلّق بتعطُّل العمليات بصفتهاMutateCustomerSkAdNetworkConversionValueSchemaResponse.warning
. - قيم التعداد الجديدة في
CustomerSkAdNetworkConversionValueSchemaError
:INVALID_EVENT_COUNTER
INVALID_EVENT_NAME
المعايير
- حقول جديدة في
BrandInfo
:display_name
primary_url
rejection_reason
status
- تعداد جديد:
BrandRequestRejectionReason
- قيمة التعداد الجديدة:
CriterionType.LIFE_EVENT
التجارب
- قيمة التعداد الجديدة:
ExperimentError.INVALID_DURATION_FOR_AN_EXPERIMENT
.
الخدمات المحلية
local_services_lead.credit_details.credit_state
وlocal_services_lead.credit_details.credit_state_last_update_date_time
التي تعرض حالة الرصيد والطابع الزمني لتعديل حالة الرصيد، على التوالي.local_services_lead_conversation.message_details.attachment_urls
التي تعرض عناوين URL التي يمكن استخدامها لتنزيل محتويات المرفق
الفيديوهات
customer.video_brand_safety_suitability
أوBrandSafetySuitability
التي تدعم جلب مدى ملاءمة أمان العلامة التجارية للفيديو لدى العميل المستوى.- قيمة التعداد الجديدة:
VideoCampaignError.MUTATE_REQUIRES_RESERVATION
.
الإصدار 16 (21/02/2024)
تمت إضافة الميزات والتغييرات التالية في الإصدار 16.
إدارة الحساب
- تم نقل
advertising_partner
منAccountLink
إلىProductLink
وProductLinkInvitation
. - تمت إزالة
data_partner
وgoogle_ads
منAccountLink
. - تمت الإضافة
IdentityVerificationService
إلى إدارة عملية التحقق من هوية المعلن.StartIdentityVerification()
تُستخدم لبدء جلسة تحقق باستخدامverification_program
ينشئ هذا الإجراء جلسة إثبات ملكية جديدة ويعرض استجابة فارغة لمحاولة إثبات ملكية تم إجراؤها بنجاح.- يمكن استخدام
GetIdentityVerification()
لاسترداد معلومات إثبات الهوية، ما يؤدي إلى عرض عدة عناصر منIdentityVerification
. يتضمّن كلIdentityVerification
ما يلي:verification_program
وهو نوع برنامج التحقق من الهويةidentity_verification_requirement
تحتوي على تفاصيل تتعلق بالموعد النهائي الذي سيتم على المعلِن إكمال عملية التحقّقverification_progress
يتضمّن تفاصيل ذات صلة بجلسة التحقّق من المعلِنين، بما في ذلك:- تمثّل
program_status
الحالة الحالية لهذا العنصر جلسة التحقّق من المعلنين - توجّه الدالة "
action_url
" العميل إلى عنوان URL لإكمال التحقق. - يمثّل
invitation_link_expiration_time
تاريخ انتهاء الصلاحية. لجهازaction_url
- تمثّل
- التعداد:
- الأخطاء:
- تمت الإضافة
AuthorizationError.ACTION_NOT_PERMITTED_FOR_SUSPENDED_ACCOUNT
مواد العرض
- التغييرات على
asset_group
:- إضافة إمكانية استخدام الشرائح المرتبطة بالوقت، مثل
segments.year
وsegments.month
- تم جعل
campaign
موردًا مرجعيًا بدلاً من إلى تقسيم الموارد.
- إضافة إمكانية استخدام الشرائح المرتبطة بالوقت، مثل
الحملات
- التغييرات على "الحملات لزيادة الطلب":
- إضافة دعم لإعداد
Campaign.shopping_setting
إلى إحدى "الحملات لزيادة الطلب" الحالية - تمت الإضافة
ShoppingSetting.disable_product_feed
لإيقاف خلاصة المنتجات الاختيارية في "الحملات لزيادة الطلب" - تمت إضافة
Ad.demand_gen_product_ad
وDemandGenProductAdInfo
المقابل، المتوفّر في "الحملات لزيادة الطلب" التي تحتوي علىCampaign.shopping_setting
غير فارغ.
- إضافة دعم لإعداد
- تمت إضافة البيانات إلى الحقول التالية إلى
AdGroup
لتوضيح ما إذا كانت عرض إعلانات المجموعة الإعلانية أو أسباب عدم عرضها:primary_status
primary_status_reasons
- تمت إضافتها إلى الحقول التالية في
AdGroupAd
لعرض ما إذا كان يتم عرض إعلان المجموعة الإعلانية أو أسباب عدم عرضه:primary_status
primary_status_reasons
- تمت إضافة القيم التالية إلى
AdGroupError
:CANNOT_ADD_AD_GROUP_FOR_CAMPAIGN_TYPE
INVALID_STATUS
تجربة
- تمت إضافة
Experiment.sync_enabled
لتحديد ما إذا كان يجب تفعيل المزامنة في التجربة. عند تفعيل المزامنة ، يتم تلقائيًا نسخ التغييرات التي يتم إجراؤها على الحملة الأصلية أثناء تنفيذ تجربتك إلى حملة التجربة. - تمت الإضافة
ExperimentError.CANNOT_ENABLE_SYNC_FOR_UNSUPPORTED_EXPERIMENT_TYPE
- تمت إضافة
CampaignError.CANNOT_MODIFY_TEXT_ASSET_AUTOMATION_WITH_ENABLED_TRIAL
.
الفنادق السفر
- تمت إضافة الحقول التالية إلى
ListingDimensionInfo
للاطّلاع على النشاطات المقترَحة لتفعيل إنشاء مجموعات بيانات استنادًا إلى الولاية والمدينة التي توفر نشاط السفر: - تمت إضافة معلومات عن الشرائح التالية إلى
travel_activity_performance_view
:
الخدمات المحلية
- تمت إضافة رمزَي
LocalServicesVerificationArtifact.business_registration_check_verification_artifact
وBusinessRegistrationCheckArtifact
للسماح للمعلِنين بمراقبة مستوى التقدّم في عملية التحقّق من تسجيل النشاط التجاري. - تمت إضافة مرجع جديد.
local_services_employee
للسماح المعلنين لاسترداد معلومات الموظفين التي أضافوها.
التخطيط
- تمت إزالة "
score
" منAudienceInsightsAttributeMetadata
اقتراحات
- تمت إضافة
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
- تمت إضافة رمزَي الخطأ
CampaignError.CANNOT_LINK_TO_COMPARISON_SHOPPING_SERVICE_ACCOUNT
وCampaignError.CANNOT_TARGET_NETWORK_FOR_COMPARISON_SHOPPING_SERVICE_LINKED_ACCOUNTS
لتوفير أخطاء أكثر تفصيلاً لحملات Shopping المرتبطة بحساب على Comparison Shopping Service Center . - تمت إضافة القيم التالية إلى
AssetGroupListingGroupFilterError
:DIMENSION_TYPE_NOT_ALLOWED
DUPLICATE_WEBPAGE_FILTER_UNDER_ASSET_GROUP
FILTER_EXCLUSION_NOT_ALLOWED
LISTING_SOURCE_NOT_ALLOWED
MULTIPLE_LISTING_SOURCES
MULTIPLE_WEBPAGE_CONDITION_TYPES_NOT_ALLOWED
MULTIPLE_WEBPAGE_TYPES_PER_ASSET_GROUP
PAGE_FEED_FILTER_HAS_PARENT
أهداف مراحل النشاط
- تمت إضافة "
update
" إلىCustomerLifecycleGoalOperation
أوCampaignLifecycleGoalOperation
لجعل أنواع العمليات هذه متسقة مع أنواع العمليات الأخرى في واجهة برمجة التطبيقات. ## ملاحظات الإصدار المؤرشفة
راجِع الإصدارات التي تم إيقاف العمل بها للاطّلاع على ملاحظات الإصدار المؤرشفة.