تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

الإصدار 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 الذي يعرض بيانات التشخيص لتحميل الإحالات الناجحة على مستوى إجراء الإحالة الناجحة.
تتمّ إضافة المقاييس التالية إلى تقارير بيانات التشخيص بلا إنترنت لتوضيح عدد الإحالات الناجحة المحمَّلة التي لا تزال قيد المعالجة:
- 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 الذي يتيح لك تحديد المستودعات الإعلانية التي يمكن عرض إعلانات الفيديو عليها باستخدام حقول التقارير التالية:
segments.ad_format_type الذي يتيح لك تقسيم التقارير التالية استنادًا إلى نوع شكل إعلان الفيديو:

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

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

الإعلانات

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

مواد العرض

تمت إضافة تعداد جديد: 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.
يتم الآن عرض المقاييس التالية مع الاستجابة حتى عندما فهي صفر. هذا يجعلها متسقة مع المقاييس الأخرى.

المعايير

تمت الإضافة إلى الحقول التالية في 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 ينشئ جلسة تحقق جديدة ويعرض ردًا فارغًا تم إنشاء عملية إثبات الهوية بنجاح.
  - تمت الإضافة IdentityVerificationProgram.ADVERTISER_IDENTITY_VERIFICATION
- GetIdentityVerification() لاسترداد معلومات التحقق، والتي تؤدي إلى كائنات عديدة لـ IdentityVerification. يشمل كل IdentityVerification ما يلي:
  - verification_program وهو نوع برنامج التحقق من الهوية
  - identity_verification_requirement تحتوي على تفاصيل تتعلق بالموعد النهائي الذي سيتم على المعلِن إكمال عملية التحقّق
  - verification_progress يتضمّن تفاصيل ذات صلة بجلسة التحقّق من المعلِنين، بما في ذلك:
    - تمثّل program_status الحالة الحالية لهذا العنصر جلسة التحقّق من المعلنين
    - توجّه الدالة "action_url" العميل إلى عنوان URL لإكمال التحقق.
    - يمثّل invitation_link_expiration_time تاريخ انتهاء الصلاحية. لجهاز action_url
- التعداد:
  - IdentityVerificationProgram
  - IdentityVerificationProgramStatus
- الأخطاء:
  - IdentityVerificationError
تمت الإضافة 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 للاطّلاع على النشاطات المقترَحة لتفعيل إنشاء مجموعات بيانات استنادًا إلى الولاية والمدينة التي توفر نشاط السفر:
- activity_state
- activity_city
تمت إضافة معلومات عن الشرائح التالية إلى 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
تمت إزالة 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 على المجموعة المشتركة. يمكن استهداف معايير الحملة في "الحملات على شبكة البحث" واستبعادها في حملات الأداء الأفضل على التوالي
- الحقول:
  - SharedCriterion.brand
  - CampaignCriterion.brand_list
- التعداد:
  - SharedSetType.BRANDS
  - CriterionType.BRAND_LIST
تمت الإضافة Campaign.asset_automation_settings[] لعرض حالة التشغيل الآلي لكل نوع من أنواع مواد العرض
تمت إضافة القيم التالية إلى CampaignPrimaryStatusReason التعداد:
- NO_ASSET_GROUPS
- ASSET_GROUPS_PAUSED

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

تمت إضافة CallConversion.consent و ClickConversion.consent للدعم تقديم الموافقة. اطّلِع على دليل الإحالات الناجحة للمكالمات ودليل الإحالات الناجحة الناتجة عن النقر لمزيد من المعلومات التفاصيل.
تمت إضافة الحقول التالية ذات الصلة بـ SKAdNetwork التحويلات، وهي متاحة عند الاستعلام عنها باستخدام customer أو campaign:
- الشرائح:
- المقاييس:
  - metrics.sk_ad_network_total_conversions
  - metrics.sk_ad_network_installs
تم استبدال metrics.sk_ad_network_conversions بـ metrics.sk_ad_network_installs
تمت إضافة دعم لتشخيص تحميل الإحالات الناجحة بلا إنترنت.
- تم نقل offline_conversion_upload_client_summary من حقل على مورد customer إلى تقرير المستوى الأعلى. استخدام هذه المسودة للحصول على تفاصيل مفيدة عن حالة تحميل الإحالات الناجحة مثل عدد الأحداث الناجحة ومعدل النجاح ونسبة الأخطاء.
  - إشعار: إحالة ناجحة تم تحميلها ولكنها تؤدي إلى ConversionUploadError.CLICK_NOT_FOUND لا يزال يُعتبر ناجحًا، ولكن يتم تصنيفه أيضًا على أنه OfflineConversionAlert
- تمت إضافة job_id كمَعلمة اختيارية لأنواع الطلبات التالية، وبالتالي يمكنك تجميع طلبات تحميل متعددة بشكل منطقي في قائمة واحدة الوظيفة:
  - UploadConversionAdjustmentsRequest
  - UploadClickConversionsRequest
- تمت إضافة INVALID_JOB_ID إلى الأخطاء التالية:
  - ConversionAdjustmentUploadError
  - ConversionUploadError
- تم استبدال INVALID_CONVERSION_ACTION بـ NO_CONVERSION_ACTION_FOUND INVALID_CONVERSION_ACTION_TYPE في الأخطاء التالية:
  - ConversionAdjustmentUploadError
  - ConversionUploadError
إضافة ثلاثة تقارير لدعم جميع الشبكات في "مبادرة حماية الخصوصية" على 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:
- الشرائح:
- المقاييس:

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

تمت إضافة LocalServicesSettings و حقول إلى تقرير customer لعرض محلي حالة الترخيص الدقيقة لمعلن الخدمات والحالات التأمينية
تمت إضافة التقارير الجديدة التالية للنطاق المحلي الخدمات:
- يحتوي local_services_lead على جميع التفاصيل المتعلّقة بالخدمات المحلّية العملاء المحتملون في الإعلانات مثل lead_charged lead_type، lead_status
  - التعداد:
    - LeadStatus
    - LeadType
- 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 الذي يدير الاشتراكات في الاقتراحات:
- المرجع: RecommendationSubscription
- الحقل: MutateOperation.recommendation_subscription_operation
- التعداد: ChangeClientType.GOOGLE_ADS_RECOMMENDATIONS_SUBSCRIPTION
- الأخطاء:
  - RecommendationSubscriptionError
  - RecommendationSubscriptionStatus
تمت إضافة أنواع الاقتراحات التالية:
- FORECASTING_SET_TARGET_CPA التي تقترح إعداد تكلفة مستهدفة للإجراء للحملات التي لا تتضمّن المحدد، قبل حدث موسمي من المتوقع أن يزداد حركة المرور.
- SET_TARGET_CPA التي تقترح إعداد تكلفة مستهدفة للإجراء للحملات التي لا تتضمّن المحددة.
- SET_TARGET_ROAS التي تقترح إعداد عائد إنفاق إعلاني مستهدف للحملات التي لا تتضمّن المحددة.

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

تمت إضافة المقاييس الجديدة التالية، والتي يمكن الاستعلام عنها باستخدام campaign (متاحة للإعلانات على الشبكة الإعلانية وإعلانات الفيديو والإعلانات أثناء التصفّح حملات التطبيقات) وsegments.device:
- metrics.unique_users
- metrics.average_impression_frequency_per_user

Shopping

تمت إزالة الدالة ShoppingSetting.sales_country، التي يتم عرض قيمها الآن على النحو التالي: ShoppingSetting.feed_label
- يمكنك مواصلة استخدام حساب محدّد على Merchant Center. حملة باستخدام الـ ShoppingSetting.feed_label . يجب ضبطها على قيمة تصنيف الخلاصة أو على البلد المكوّن من حرفَين. الرمز الذي سبق أن تم استخدامه لـ ShoppingSetting.sales_country. لمزيد من التفاصيل، يُرجى الاطّلاع على مقالة الدعم حول الخلاصة. الفعلية.
تمت إزالة اعتماد فئات المنتجات على رمز بلد في إعداد التقارير. لم يطرأ أي تغيير على مجموعة أرقام تعريف الفئات المتوافقة.
- تم استبدال الحقول التالية المستخدمة في 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

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

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