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

الإصدار 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 بصفتها موردَين من 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

مواد العرض

• تمت إضافة عنصر enum جديد: 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، ما يؤدي إلى إرسال الرسائل إلى المستخدِمين من خلال القنوات المناسبة، مثل الرسائل القصيرة، استنادًا إلى كيفية إنشاء العميل المحتمل.
  • يقتصر حجم 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.
• قيم التعداد الجديدة في 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.
• تم ضبط القيمة UNSPECIFIED بدلاً من UNKNOWN على الكلمات الرئيسية المقترَحة التي لم يتم ضبط نوع مطابقتها. recommended_match_type
• تمت إضافة أنواع الاقتراحات التالية:
  • 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 لجعل أنواع العمليات هذه متسقة مع أنواع العمليات الأخرى في واجهة برمجة التطبيقات.

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

اطّلِع على الإصدارات التي تم إيقافها نهائيًا للاطّلاع على ملاحظات الإصدارات المؤرشَفة.