الإصدار 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
على 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
قابلاً للتغيير.
الإصدار 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
الحملات
- إتاحة عمليات محاكاة عروض أسعار حملات عائد الإنفاق الإعلاني المستهدف لحملات التطبيقات باستخدام تقرير
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
. - قيم enum جديدة في
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
لجعل أنواع العمليات هذه متوافقة مع أنواع العمليات الأخرى في واجهة برمجة التطبيقات.
الإصدار 15 (18/10/2023)
تم تقديم الميزات والتحديثات الجديدة التالية في الإصدار 15.
إدارة الحساب
- إذا تم تعليق حسابك بسبب نشاط غير مصرَّح به في
الحساب، سيتم الآن عرض
customer.status
وcustomer_client.status
على النحو التاليSUSPENDED
. في السابق، تم إرجاعها على أنّهاENABLED
. - تمت إتاحة إضافة رابط بين حساب على "إعلانات Google" وحساب على Merchant Center وإزالته:
- تمت إضافة
ProductLink.merchant_center
وMerchantCenterIdentifier
. - تمت إضافة
LinkedProductType.MERCHANT_CENTER
.
- تمت إضافة
- تمت إضافة السمة
ProductLinkInvitationService
وProductLinkInvitation
لإتاحة تعديل دعوة الربط المُرسلة من منتجات أخرى، وهي متوفّرة لحسابات Hotel Center وMerchant Center. - تمت إزالة
MerchantCenterLinkService
.- لربط حسابات "إعلانات Google" بحسابات على Merchant Center، استخدِم السمة
ProductLinkInvitationService
وProductLinkService
.
- لربط حسابات "إعلانات Google" بحسابات على Merchant Center، استخدِم السمة
- تمت إزالة
AccountLink.hotel_center
وإمكانية تعديل دعوات الربط من حسابات "مركز إدارة معلومات الفنادق" باستخدامAccountLinkService
.- لتعديل دعوة لربط الحساب من حساب على Hotel Center، استخدِم
ProductLinkInvitationService
.
- لتعديل دعوة لربط الحساب من حساب على Hotel Center، استخدِم
مواد العرض
- تم استبدال
ImageAdInfo.media_file
بـImageAdInfo.image_asset
لإتاحة إضافة الصور وإزالتها باستخدام مواد العرض. ونتيجةً لذلك، أزلنا أيضًا العنوانMediaFileService
الذي لم يعُد ضروريًا. - تمت إضافة السمة
ListingGroupFilterDimension.webpage
للمساعدة في إنشاء فلتر لمجموعة بيانات استنادًا إلى التصنيفات المخصّصة والسلاسل الفرعية لعناوين URL.- تم أيضًا استبدال
AssetGroupListingGroupFilter.vertical
بـAssetGroupListingGroupFilter.listing_source
وListingGroupFilterListingSource
- تم أيضًا استبدال
- تمت إضافة
asset_group_asset.source
لإظهار مصدر مادة العرض في مجموعة مواد العرض. - تمت إضافة
ad_group_ad_asset_view.source
لعرض مصدر مادة عرض الإعلان في المجموعة الإعلانية.
شرائح الجمهور
- بالنسبة إلى ميزة "مطابقة العملاء"، تمت إضافة
CustomerMatchUserListMetadata.consent
لإتاحة تقديم الموافقة. اعتبارًا من 6 آذار (مارس) 2024، إذا كانت الموافقة غير متوفّرة للمستخدمين في المنطقة الاقتصادية الأوروبية، يتم تحديد قيمة الموافقة على أنّها لم يتم منح الموافقة. لن تتم معالجة بيانات المستخدمين الذين لم يمنحوا موافقتهم في المنطقة الاقتصادية الأوروبية، ولن يكون بالإمكان استخدامها لتخصيص الإعلانات من خلال ميزة "مطابقة العملاء". يمكنك الاطّلاع على دليل "مطابقة العملاء" لمزيد من التفاصيل. - بالنسبة إلى المبيعات في المتاجر، تمت إضافة
UserData.consent
للسماح بتقديم الموافقة. راجِع دليل المبيعات في المتاجر للحصول على مزيد من التفاصيل. إذا كنت تستخدم "مطابقة العملاء" مع مبيعات المتجر، راجِع الأسئلة الشائعة للحصول على معلومات إضافية. - تمت إضافة
UserList.lookalike_user_list
للمساعدة في إنشاء شريحة جمهور مشابهة، وهي شريحة جمهور تم إنشاؤها استنادًا إلى الجمهور الأساسي الحالي المقدَّم. يمكن استخدام شرائح الجمهور المشابهة في "حملة لزيادة الطلب" فقط.
الحملات
تعديلات على "حملات الأداء الأفضل":
- تتوافق
AssetGroupSignal
الآن مع نوعَين من الإشارات يمكن إرفاقهما بمجموعة مواد عرض للاستهداف المحسّن:AssetGroupSignal.audience
- تمت إضافة
Audience.scope
وAudience.asset_group
لحصر استخدام الجمهور على مجموعة مواد عرض معيّنة. يجب ضبط السمةAudience.asset_group
فقط إذا كانت قيمةAudience.scope
ASSET_GROUP
.
- تمت إضافة
AssetGroupSignal.search_theme
- تمت إضافة
CriterionType.SEARCH_THEME
لإتاحة نوع المعيار الجديد هذا. لا يمكن استخدام هذا النوع الجديد من المعايير إلا في "حملات الأداء الأفضل" لإنشاءAssetGroupSignal
من خلال تعبئةAssetGroupSignal.search_theme
بمعيارSearchThemeInfo
.
- تمت إضافة
- تمت إضافة
AssetGroupSignalOperation.exempt_policy_violation_keys
للمساعدة في طلب الإعفاء عند إضافة إشارات مجموعات مواد العرض. - تمت إضافة
asset_group_top_combination_view
جديد لتسجيل مواد العرض الأفضل أداءً على مستوى مجموعة مواد العرض. - يمكن الآن الاستعلام عن
asset_group
باستخدام حقول المقاييس لإتاحة استرداد أداء "حملة الأداء الأفضل". - في
PerformanceMaxUpgradeStatus
، تمت إعادة تسميةUPGRADE_ELIGIBLE
إلىUPGRADE_ELIGIBLE
.
- تتوافق
بالنسبة إلى "الحملات لزيادة الطلب" و"الحملات أثناء التصفّح" تعرض عمليات محاكاة عروض الأسعار المستهدفة للإجراء على مستوى الحملة (
campaign_simulation.target_cpa_point_list.points
)TargetCpaSimulationPoint.interactions
بدلاً منTargetCpaSimulationPoint.clicks
.تمت إضافة
BrandSuggestionService
الذي يمكنه اقتراح علامات تجارية استنادًا إلى بادئة العلامة التجارية المقدَّمة وقائمة العلامات التجارية المستبعَدة. يمكن استخدام هذه العلامات التجارية لإنشاء معيارBRAND
، وإضافتها إلى مجموعة مشترَكةBRANDS
، ثم إرفاقها بحملة من خلال إنشاءCampaignCriterion
مع ضبطbrand_list
على المجموعة المشتركة. يمكن استهداف معايير الحملة في "الحملات على شبكة البحث" واستبعادها في "حملات الأداء الأفضل" على التوالي.تمت إضافة
Campaign.asset_automation_settings[]
لعرض حالة التشغيل الآلي لكل نوع من أنواع مواد العرض.تمت إضافة القيم التالية إلى تعداد
CampaignPrimaryStatusReason
:NO_ASSET_GROUPS
ASSET_GROUPS_PAUSED
الإحالات الناجحة
- تمت إضافة
CallConversion.consent
وClickConversion.consent
لإتاحة تقديم الموافقة. اطّلِع على دليل الإحالات الناجحة للمكالمات ودليل الإحالات الناجحة الناتجة عن النقرات للحصول على المزيد من التفاصيل. - تمت إضافة الحقول التالية المتعلّقة بالإحالات الناجحة
SKAdNetwork
المتاحة عند طلب البحث باستخدام
customer
أوcampaign
: - تم استبدال
metrics.sk_ad_network_conversions
بـmetrics.sk_ad_network_installs
. - تمت إضافة الدعم لتشخيص تحميل الإحالات الناجحة بلا إنترنت
- تم نقل
offline_conversion_upload_client_summary
من حقل في موردcustomer
إلى تقرير مستوى أعلى. استخدِم هذا التقرير للحصول على تفاصيل مفيدة عن حالة تحميل الإحالات الناجحة مثل عدد الأحداث الناجحة ومعدّل النجاح ونسبة الخطأ.- تنبيه: الإحالة الناجحة التي تمّ تحميلها ولكنها أدّت إلى حدوث خطأ
ConversionUploadError.CLICK_NOT_FOUND
لا تزال تُحتسَب على أنّها ناجحة، ولكن يتم أيضًا وضع علامة عليها على أنّهاOfflineConversionAlert
.
- تنبيه: الإحالة الناجحة التي تمّ تحميلها ولكنها أدّت إلى حدوث خطأ
- تمت إضافة
job_id
كمَعلمة اختيارية لأنواع الطلبات التالية حتى تتمكّن من تجميع عدة طلبات تحميل بشكل منطقي في وظيفة مفهومية واحدة: - تمت إضافة
INVALID_JOB_ID
إلى الأخطاء التالية: - تم استبدال
INVALID_CONVERSION_ACTION
بـNO_CONVERSION_ACTION_FOUND
وINVALID_CONVERSION_ACTION_TYPE
في الأخطاء التالية:
- تم نقل
- تمت إضافة ثلاثة تقارير لإتاحة تحديد المصدر على جميع الشبكات في "مبادرة حماية الخصوصية" لنظام التشغيل Android بدون
عمليات إعادة التوجيه:
android_privacy_shared_key_google_campaign
الذي يحتوي علىshared_campaign_key
وبعض الحقول التي تساعد في ترميز المفتاحandroid_privacy_shared_key_google_ad_group
الذي يحتوي علىshared_ad_group_key
وبعض الحقول التي تساعد في ترميز المفتاحandroid_privacy_shared_key_google_network_type
الذي يحتوي علىshared_network_type_key
وبعض الحقول التي تساعد في ترميز المفتاح
- تمت إضافة
ConversionActionError.CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELS
. حدث هذا الخطأ عندما تحاول استخدام أحد نماذج تحديد المصدر المستندة إلى القواعد المتوقّفة نهائيًاConversionActionOperation
. في السابق، تعذّر إتمام العملية مع ظهور خطأUNKNOWN
.
الفنادق والسفر
- تمت إتاحة الحقول التالية في
travel_activity_group_view
وtravel_activity_performance_view
:- الشرائح:
- المقاييس:
metrics.search_absolute_top_impression_share
metrics.search_budget_lost_absolute_top_impression_share
metrics.search_budget_lost_impression_share
metrics.search_budget_lost_top_impression_share
metrics.search_impression_share
metrics.search_rank_lost_absolute_top_impression_share
metrics.search_rank_lost_impression_share
metrics.search_rank_lost_top_impression_share
metrics.search_top_impression_share
إعلانات الخدمات المحلية
- تمت إضافة
LocalServicesSettings
وحقوله إلى تقريرcustomer
لعرض معلومات الترخيص الدقيقة لمعلِن "الخدمات المحلّية" والحالات التأمينية. - تمت إضافة التقارير الجديدة التالية للخدمات
المحلية:
- يحتوي
local_services_lead
على كل التفاصيل المتعلقة بالعملاء المحتملين في إعلانات الخدمات المحلّية، مثلlead_charged
وlead_type
وlead_status
.- التعداد:
local_services_lead_conversation
تتضمّن تفاصيل الرسائل والمحادثات الهاتفية، مثلconversation_channel
وcall_duration_millis
وcall_recording_url
.- تتم المصادقة على عنوان URL لتسجيل المكالمات الهاتفية مقارنةً بحساب العميل المستهدَف وحساباته الإدارية.
- يعرض
local_services_verification_artifact
عناصر معلن "الخدمات المحلّية"، مثل الفحص الأمني وتراخيص النشاط التجاري وبيانات التأمين في الأنشطة التجارية. يمكن الوصول إلى أي مستندات مرتبطة بالترخيص والتأمين من خلال عنوان URL.
- يحتوي
التخطيط
- تمت إضافة إمكانية إرجاع
Forecast.views
وPlannedProductForecast.views
لمنتجاتReachPlanService.ListPlannableProducts
لأنواع المنتجات التي تنطبق عليها. - تمت إضافة معلومات عن إمكانية إرجاع السمة
PlannableTargeting.surface_targeting
إلىReachPlanService.ListPlannableProducts
، والتي تصف مساحات العرض المتوفّرة للمنتج. - تمت إضافة تعداد
ReachPlanSurface
جديد. - تمت إتاحة استهداف عدد مرّات الظهور
المستهدَف باستخدام السمة
AdvancedProductTargeting.target_frequency_settings
، ويؤدي ذلك إلى عرضPlannedProductForecast.average_frequency
. - تمت إضافة
AudienceInsightsService.GenerateSuggestedTargetingInsights
لعرض الجماهير المقترحة القابلة للاستهداف. - تمت إضافة القيم التالية إلى
ReachPlanError
:NOT_FORECASTABLE_NOT_ENOUGH_INVENTORY
NOT_FORECASTABLE_ACCOUNT_NOT_ENABLED
اقتراحات
- تمت إضافة
RecommendationSubscriptionService
الذي يدير الاشتراكات في الاقتراحات: - تمت إضافة أنواع الاقتراحات التالية:
FORECASTING_SET_TARGET_CPA
التي تقترح ضبط تكلفة مستهدَفة للإجراء للحملات التي لم يتم تحديد قيمة محدّدة لها، قبل الحدث الموسمي الذي يُتوقّع أن يؤدي إلى زيادة عدد الزياراتSET_TARGET_CPA
التي تقترح ضبط تكلفة مستهدفة للإجراء للحملات التي لم يتم تحديد قيمة محدّدة لهاSET_TARGET_ROAS
التي تقترح ضبط عائد إنفاق إعلاني مستهدف للحملات التي لم يتم تحديدها.
إعداد التقارير
- تمت إضافة المقاييس الجديدة التالية التي يمكن الاستعلام عنها باستخدام
campaign
(متوفّرة لـ "الحملات على الشبكة الإعلانية" و"حملات الفيديو" و"الحملات أثناء التصفّح" و"حملات التطبيقات") وsegments.device
:
Shopping
- تمت إزالة الدالة
ShoppingSetting.sales_country
، التي يتم عرض قيمها الآن على النحو التالي:ShoppingSetting.feed_label
.- يمكنك مواصلة استخدام خلاصة معيّنة في Merchant Center لإحدى الحملات باستخدام الحقل
ShoppingSetting.feed_label
. ويجب ضبطه على قيمة تصنيف الخلاصة أو على رمز البلد المكوَّن من حرفَين والذي سبق استخدامه للسمةShoppingSetting.sales_country
. لمزيد من التفاصيل، يُرجى الاطّلاع على مقالة الدعم حول تصنيفات الخلاصة.
- يمكنك مواصلة استخدام خلاصة معيّنة في Merchant Center لإحدى الحملات باستخدام الحقل
- تمت إزالة اعتماد فئات المنتجات على رمز بلد في إعداد التقارير.
لم يطرأ أي تغيير على مجموعة أرقام تعريف الفئات المتوافقة.
- تم استبدال الحقول التالية المُستخدَمة في
shopping_performance_view
:segments.product_bidding_category_level1
معsegments.product_category_level1
segments.product_bidding_category_level2
معsegments.product_category_level2
segments.product_bidding_category_level3
معsegments.product_category_level3
segments.product_bidding_category_level4
معsegments.product_category_level4
segments.product_bidding_category_level5
معsegments.product_category_level5
- تم استبدال
product_bidding_category_constant
بـproduct_category_constant
، ما يؤدّي إلى عرض جميع الترجمات المتاحة لفئة معيّنة في حقل متكرّر. - تم استبدال
ListingDimensionInfo.product_bidding_category
بـListingDimensionInfo.product_category
. - تم استبدال
ListingGroupFilterDimension.product_bidding_category
بـListingGroupFilterDimension.product_category
.
- تم استبدال الحقول التالية المُستخدَمة في
- تمت إزالة إمكانية إضافة
Campaign.shopping_setting
إلى "الحملات على شبكة البحث". عند محاولة إنشاء "حملة على شبكة البحث" باستخدامCampaign.shopping_setting
أو إضافةCampaign.shopping_setting
إلى حملة حالية على شبكة البحث تؤدي الآن إلى ظهورOPERATION_NOT_PERMITTED_FOR_CONTEXT
. - تمت إزالة إمكانية إضافة
CampaignCriterion.listing_scope
إلى "الحملات على شبكة البحث". تؤدي محاولة إضافةCampaignCriterion.listing_scope
إلى حملة حالية على شبكة البحث الآن إلى إنشاءOPERATION_NOT_PERMITTED_FOR_CONTEXT
. - تمت إضافة مقاييس الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق التالية:
metrics.orders
metrics.average_order_value_micros
metrics.average_cart_size
metrics.cost_of_goods_sold_micros
metrics.gross_profit_micros
metrics.gross_profit_margin
metrics.revenue_micros
metrics.units_sold
metrics.cross_sell_cost_of_goods_sold_micros
metrics.cross_sell_gross_profit_micros
metrics.cross_sell_revenue_micros
metrics.cross_sell_units_sold
metrics.lead_cost_of_goods_sold_micros
metrics.lead_gross_profit_micros
metrics.lead_revenue_micros
metrics.lead_units_sold
- يمكن اختيار جميع هذه المقاييس في التقارير التالية:
الأهداف الموحّدة
- تمت إضافة
CustomerLifecycleGoalService.ConfigureCustomerLifecycleGoals
لضبط أهداف اكتساب العملاء على مستوى العميل.- الإبلاغ:
customer_lifecycle_goal
- الإبلاغ:
- تمت إضافة
CampaignLifecycleGoalService.ConfigureCampaignLifecycleGoals
لضبط أهداف اكتساب العملاء على مستوى الحملة.- الإبلاغ:
campaign_lifecycle_goal
- الإبلاغ:
- تمت إضافة
CampaignConversionGoalError.CANNOT_USE_STORE_SALE_GOAL_FOR_PERFORMANCE_MAX_CAMPAIGN
. - تمت إضافة القيم التالية إلى
ConversionGoalCampaignConfigError
:EMPTY_CONVERSION_GOALS
STORE_SALE_STORE_VISIT_CANNOT_BE_BOTH_INCLUDED
PERFORMANCE_MAX_CAMPAIGN_CANNOT_USE_CUSTOM_GOAL_WITH_STORE_SALES
الفيديوهات
- تمت إضافة إمكانية استهداف Google TV على مستوى الحملة:
- تمت الإضافة
NetworkSettings.target_google_tv_network
- تمت إضافة
AdNetworkType.GOOGLE_TV
.
- تمت الإضافة
- تمت إضافة دعم لاستهداف YouTube على مستوى الحملة:
- تمت الإضافة
NetworkSettings.target_youtube
- في
AdNetworkType
، تم دمجYOUTUBE_WATCH
وYOUTUBE_SEARCH
فيYOUTUBE
. - تمت إضافة
CampaignError.CANNOT_TARGET_DISPLAY_NETWORK_WITHOUT_YOUTUBE
.
- تمت الإضافة
ملاحظات الإصدار المؤرشفة
راجِع الإصدارات التي تم إيقاف العمل بها للاطّلاع على ملاحظات الإصدار المؤرشفة.