الإصدار 17.1.0 (07/08/2024)
تمت إضافة الميزات والتحديثات الجديدة التالية في الإصدار 17_1.
مواد العرض
- تتيح لك أداة
AdGroupAdService.RemoveAutomaticallyCreatedAssets()
إزالة مواد عرض منشأة تلقائيًا محدّدة مرتبطة بالإعلانات المتجاوبة على شبكة البحث.
الجمهور
- قيم enum جديدة في
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
- قيم 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
بهدف تقديم أخطاء أكثر تفصيلاً لحملات التسوّق المرتبطة مركز خدمة مقارنة الأسعار الحساب. - تمت إضافة القيم التالية إلى
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
للدعم جارٍ تعديل دعوة لربط الحساب مُرسَلة من منتجات أخرى، وهي متاحة لـ فندق Center وMerchant وسط حسابات. - تمت إزالة
MerchantCenterLinkService
.- لربط حسابات "إعلانات Google" بحسابات على Merchant Center، استخدِم
ProductLinkInvitationService
وProductLinkService
- لربط حسابات "إعلانات Google" بحسابات على Merchant Center، استخدِم
- تمت إزالة
AccountLink.hotel_center
وإمكانية تعديل الدعوات التي تتضمّن روابط. من حسابات Hotel Center باستخدامAccountLinkService
- لتعديل دعوة ربط من حساب على "مركز إدارة معلومات الفنادق"، استخدِم
ProductLinkInvitationService
- لتعديل دعوة ربط من حساب على "مركز إدارة معلومات الفنادق"، استخدِم
مواد العرض
- تم استبدال
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
إلى "بحث Google" الحملات. محاولة إنشاء "حملة على شبكة البحث" تتضمّن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
- تمت الإضافة
ملاحظات الإصدار المؤرشفة
راجِع الإصدارات التي تم إيقاف العمل بها للاطّلاع على ملاحظات الإصدار المؤرشفة.