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

الإصدار 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 على 1,000.
  • لا يمكن تحديد سوى السمة LocalServicesLead عند ضبط lead_type على LeadType.MESSAGE في Conversation.local_services_lead.
• تمت إضافة قيم تعداد جديدة إلى ConversationType:
  • WHATSAPP لتمثيل محادثة تم تقديمها من خلال WhatsApp.
  • ADS_API لتمثيل محادثة تم تقديمها باستخدام طريقة LocalServicesLeadService.AppendLeadConversation() الجديدة.
• تمت إضافة الحقول الجديدة التالية إلى local_services_verification_artifact:
  • local_services_verification_artifact.insurance_verification_artifact.expiration_date_time
  • local_services_verification_artifact.license_verification_artifact.expiration_date_time

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

• يمكنك الآن اختيار الحقول ذات الصلة بمنتج مرتبط فقط عند طلب البحث عن product_link. سيؤدي اختيار حقول متعدّدة من العديد من المنتجات المرتبطة إلى عرض QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE. على سبيل المثال، لا يمكن اختيار product_link.advertising_partner.customer وproduct_link.data_partner.data_partner_id في طلب البحث نفسه.
• سيؤدي تمرير page_size إلى GoogleAdsService.Search إلى خطأ RequestError.PAGE_SIZE_NOT_SUPPORTED.

Shopping

• تمت إضافة تقرير جديد shopping_product يتوافق مع صفحة المنتجات في واجهة مستخدم "إعلانات Google". يتيح لك هذا الخيار عرض البيانات المتعلّقة بالحالة الحالية للمنتجات من حسابات Google Merchant Center المرتبطة بحساب "إعلانات Google".
  • يمكنك فلترة المقاييس من تقرير shopping_product باستخدام segments.date عند استخدام GoogleAdsService.Search أو GoogleAdsService.SearchStream. لا يُسمح بالتقسيم حسب التاريخ وسيؤدي إلى عرض خطأ ShoppingProductError.UNSUPPORTED_DATE_SEGMENTATION.

الأهداف الموحّدة

• تمت إضافة UserListCustomerTypeService.MutateUserListCustomerTypes() لضبط أنواع العملاء من الجمهور.
• تمت إزالة CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings. لضبط إعدادات الجمهور لأهداف مراحل نشاط العملاء، استخدِم UserListCustomerTypeService.MutateUserListCustomerTypes() بدلاً من ذلك.
  • يمكنك إرفاق قائمة مستخدمين أو إلغاء إرفاقها عن طريق ضبط السمة UserListCustomerType.customer_type_category على UserListCustomerTypeCategory.PURCHASERS لتضمينها في تعريف حالي للعميل أو استبعادها منه وفقًا لأهداف مراحل نشاط العملاء، على التوالي. انتقِل إلى تقسيم شرائح جمهورك للحصول على مزيد من التفاصيل.

الفيديوهات

• تمت إضافة القيم التالية إلى ContentLabelType. يمكنك استبعاد ContentLabelTypes هذه على مستوى العميل:
  • BRAND_SUITABILITY_CONTENT_FOR_FAMILIES
  • BRAND_SUITABILITY_GAMES_FIGHTING
  • BRAND_SUITABILITY_GAMES_MATURE
  • BRAND_SUITABILITY_HEALTH_SENSITIVE
  • BRAND_SUITABILITY_HEALTH_SOURCE_UNDETERMINED
  • BRAND_SUITABILITY_NEWS_RECENT
  • BRAND_SUITABILITY_NEWS_SENSITIVE
  • BRAND_SUITABILITY_NEWS_SOURCE_NOT_FEATURED
  • BRAND_SUITABILITY_POLITICS
  • BRAND_SUITABILITY_RELIGION
• تمت إضافة AdVideoAsset.ad_video_asset_info لتوفير الإعدادات المفضّلة في المستودع لمواد عرض الفيديو عند إنشاء DemandGenVideoResponsiveAdInfo.
• (الحسابات المُدرَجة في القائمة المسموح بها فقط) تم جعل Campaign.video_brand_safety_suitability قابلاً للتغيير.

الإصدار 16.1.0 (24/04/2024)

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

إدارة الحساب

• CustomerNegativeCriterion.ip_block التي تتوافق مع إضافة عنوان IP كمعيار سلبي على مستوى العميل
• قيمة التعداد الجديدة: ProductLinkError.LINK_EXISTS.
• قيمة التعداد الجديدة: ProductLinkInvitationError.CUSTOMER_NOT_PERMITTED_TO_CREATE_INVITATION.

مواد العرض

• إتاحة مواد العرض ذات الصلة بالحملات لزيادة الطلب في ad_group_ad_asset_view وasset_field_type_view
• قيمة التعداد الجديدة: AssetFieldType.DISCOVERY_CAROUSEL_CARD.

شرائح الجمهور

• قيمة تعداد جديدة: ResourceLimitType.LOOKALIKE_USER_LISTS_PER_CUSTOMER تحدّ من عدد قوائم المستخدمين المشابهة التي يمكن أن يمتلكها العميل إلى 1,000

الحملات

• إتاحة عمليات محاكاة عروض أسعار حملات عائد الإنفاق الإعلاني المستهدف لحملات التطبيقات باستخدام تقرير campaign_simulation
• قيمة التعداد الجديدة: CampaignError.DYNAMIC_TEXT_ASSET_CANNOT_OPT_OUT_WITH_FINAL_URL_EXPANSION_OPT_IN.
• قيمة التعداد الجديدة: AdGroupPrimaryStatusReason.AD_GROUP_PAUSED_DUE_TO_LOW_ACTIVITY.
• قيمة التعداد الجديدة: CampaignCriterionError.CANNOT_REMOVE_ALL_LOCATIONS_DUE_TO_TOO_MANY_COUNTRY_EXCLUSIONS.

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

• SkAdNetworkConversionValueSchema.postback_mappings التي تتوافق مع ميزات SKAdNetwork 4.0
• تمت إضافة إمكانية استخدام التحذيرات على CustomerSkAdNetworkConversionValueSchemaService بصيغة MutateCustomerSkAdNetworkConversionValueSchemaRequest.enable_warnings. عند الضبط على true، سيتم عرض أي أخطاء لا تؤدي إلى الحظر تتعلّق بحالات تعذُّر التشغيل على النحو MutateCustomerSkAdNetworkConversionValueSchemaResponse.warning.
• قيم enum جديدة في CustomerSkAdNetworkConversionValueSchemaError:
  • INVALID_EVENT_COUNTER
  • INVALID_EVENT_NAME

المعايير

• الحقول الجديدة في BrandInfo:
  • display_name
  • primary_url
  • rejection_reason
  • status
• تعداد جديد: BrandRequestRejectionReason.
• قيمة التعداد الجديدة: CriterionType.LIFE_EVENT.

التجارب

• قيمة التعداد الجديدة: ExperimentError.INVALID_DURATION_FOR_AN_EXPERIMENT.

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

• local_services_lead.credit_details.credit_state وlocal_services_lead.credit_details.credit_state_last_update_date_time التي تعرض حالة الرصيد والطابع الزمني عند تعديل حالة الرصيد على التوالي.
• local_services_lead_conversation.message_details.attachment_urls التي تعرض عناوين URL التي يمكن استخدامها لتنزيل محتوى المرفق.

الفيديوهات

• customer.video_brand_safety_suitability وBrandSafetySuitability تتيحان معرفة مدى ملاءمة الفيديو لأمان العلامة التجارية على مستوى العميل.
• قيمة التعداد الجديدة: VideoCampaignError.MUTATE_REQUIRES_RESERVATION.

الإصدار 16 (21/02/2024)

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

إدارة الحساب

• تم نقل بيانات "advertising_partner" من AccountLink إلى ProductLink و ProductLinkInvitation.
• تمت إزالة "data_partner" و"google_ads" من AccountLink.
• تمت إضافة IdentityVerificationService لإدارة عملية إثبات هوية المعلِن.
  • تُستخدَم السمة StartIdentityVerification() لبدء جلسة تحقّق من خلال استخدام verification_program المقدَّم. يؤدي ذلك إلى إنشاء جلسة تحقّق جديدة وعرض ردّ فارغ لعملية إثبات ملكية يتم إنشاؤها بنجاح.
    • تمت إضافة 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 لجعل أنواع العمليات هذه متوافقة مع أنواع العمليات الأخرى في واجهة برمجة التطبيقات.

الإصدار 15 (18/10/2023)

تم تقديم الميزات والتحديثات الجديدة التالية في الإصدار 15.

إدارة الحساب

• إذا تم تعليق حسابك بسبب نشاط غير مصرَّح به في الحساب، سيتم الآن عرض customer.status وcustomer_client.status على النحو التالي SUSPENDED. في السابق، تم إرجاعها على أنّها ENABLED.
• تمت إتاحة إضافة رابط بين حساب على "إعلانات Google" وحساب على Merchant Center وإزالته:
  • تمت إضافة ProductLink.merchant_center وMerchantCenterIdentifier.
  • تمت إضافة LinkedProductType.MERCHANT_CENTER.
• تمت إضافة السمة ProductLinkInvitationService وProductLinkInvitation لإتاحة تعديل دعوة الربط المُرسلة من منتجات أخرى، وهي متوفّرة لحسابات Hotel Center وMerchant Center.
• تمت إزالة MerchantCenterLinkService.
  • لربط حسابات "إعلانات Google" بحسابات على Merchant Center، استخدِم السمة ProductLinkInvitationService وProductLinkService.
• تمت إزالة AccountLink.hotel_center وإمكانية تعديل دعوات الربط من حسابات "مركز إدارة معلومات الفنادق" باستخدام AccountLinkService.
  • لتعديل دعوة لربط الحساب من حساب على Hotel Center، استخدِم 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:
  • الشرائح:
    • segments.sk_ad_network_coarse_conversion_value
    • segments.sk_ad_network_source_domain
    • segments.sk_ad_network_source_type
    • segments.sk_ad_network_postback_sequence_index
  • المقاييس:
    • 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:
  • الشرائح:
    • segments.activity_account_id
    • segments.activity_rating
    • segments.external_activity_id
  • المقاييس:
    • 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.
    • التعداد:
      • LeadStatus
      • LeadType
  • local_services_lead_conversation تتضمّن تفاصيل الرسائل والمحادثات الهاتفية، مثل conversation_channel وcall_duration_millis وcall_recording_url.
    • تتم المصادقة على عنوان URL لتسجيل المكالمات الهاتفية مقارنةً بحساب العميل المستهدَف وحساباته الإدارية.
  • يعرض local_services_verification_artifact عناصر معلن "الخدمات المحلّية"، مثل الفحص الأمني وتراخيص النشاط التجاري وبيانات التأمين في الأنشطة التجارية. يمكن الوصول إلى أي مستندات مرتبطة بالترخيص والتأمين من خلال عنوان URL.
    • التعداد:
      • LocalServicesVerificationArtifactStatus
      • LocalServicesVerificationArtifactType
      • LocalServicesInsuranceRejectionReason
      • LocalServicesLicenseRejectionReason

التخطيط

• تمت إضافة إمكانية إرجاع 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 إلى "الحملات على شبكة البحث". عند محاولة إنشاء "حملة على شبكة البحث" باستخدام 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
  • يمكن اختيار جميع هذه المقاييس في التقارير التالية:
    • ad_group
    • ad_group_ad
    • asset_group_product_group_view
    • campaign
    • customer
    • keyword_view
    • product_group_view
    • shopping_performance_view

الأهداف الموحّدة

• تمت إضافة 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.

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

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