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

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

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

إدارة الحساب

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

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

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

الإعلانات

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

مواد العرض

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

الحملات

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

المعيار

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

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

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

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

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

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

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

التخطيط

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

اقتراحات

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

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

• تم استبدال حقلَي summary_row_setting وreturn_total_results_count في SearchGoogleAdsRequest بحقل search_settings، الذي يكون نوعه SearchSettings، مع الحقول التالية:
  • omit_results
  • return_summary_row
  • return_total_results_count
• تمت إضافة المقاييس الجديدة التالية حول النقرات غير الصالحة الناشئة عن تقنيات معروفة، مثل النقرات التي يتم إنشاؤها بواسطة برامج التتبُّع أو برامج الزحف، ذات الأنماط غير المنتظمة. ويمكن إجراء استعلام عنها باستخدام تقرير campaign.
  • metrics.general_invalid_clicks
  • metrics.general_invalid_click_rate
• تمت إضافة القيم التالية إلى QuotaError:
  • EXCESSIVE_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 الذي يعرض بيانات تشخيص تحميل الإحالات الناجحة على مستوى إجراء الإحالة الناجحة.
• تتمّ إضافة المقاييس التالية إلى تقارير بيانات التشخيص بلا إنترنت لتوضيح عدد الإحالات الناجحة المحمَّلة التي لا تزال قيد المعالجة:
  • offline_conversion_upload_client_summary
    • pending_event_count
    • pending_rate
  • offline_conversion_upload_conversion_action_summary:
    • pending_count

التخطيط

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

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

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

الفيديوهات

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

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

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

الإعلانات

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

مواد العرض

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

الجمهور

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

الوظائف المجمّعة

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

الحملات

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

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

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

المعايير

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

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

• تمت إضافة LocalServicesLeadService.AppendLeadConversation(). لإلحاق حرف جديد LocalServicesLeadConversation إلى LocalServicesLead، الذي يرسل الرسائل إلى المستخدمين من خلال القنوات المناسبة مثل الرسائل القصيرة SMS اعتمادًا على تم إنشاء العميل المحتمل.
  • حجم AppendLeadConversationRequest.conversations محدود إلى 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 ينشئ هذا الإجراء جلسة إثبات ملكية جديدة ويعرض استجابة فارغة لمحاولة إثبات ملكية تم إجراؤها بنجاح.
    • تمت إضافة 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:
  • segments.activity_city
  • segments.activity_country
  • segments.activity_state

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

• تمت إضافة رمزَي 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 لجعل أنواع العمليات هذه متسقة مع أنواع العمليات الأخرى في واجهة برمجة التطبيقات. ## ملاحظات الإصدار المؤرشفة

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