یادداشت های انتشار

نسخه 18 (16-10-2024)

ویژگی ها و به روز رسانی های جدید زیر در نسخه 18 اضافه شده است.

مدیریت حساب

• (فقط برای حساب های مجاز) DataLinkService.CreateDataLink اضافه شد، که اجازه می دهد یک حساب Google Ads را به ویدیوهای سازنده میزبانی شده در کانال YouTube سازنده پیوند دهید. پیوند ویدیو به حساب Google Ads امکان می‌دهد تبلیغات مشارکتی را با استفاده از ویدیوهای سازنده اجرا کند.

گروه های تبلیغاتی

• AdGroup.exclude_demographic_expansion اضافه شد که به شما امکان می‌دهد تا زمانی که optimized_targeting_enabled true است، اطلاعات جمعیتی را از گسترش حذف کنید، ویژگی که قبلاً فقط برای Demand Gen پشتیبانی می‌شد.

تبلیغات

• AdGroupAd.ad_group_ad_asset_automation_settings اضافه شد، که اجازه می‌دهد تبلیغات را در تولید دارایی خودکار یا خارج از آن انتخاب کنید.
• مقادیر زیر را به AssetAutomationType اضافه کرد:
  • GENERATE_VERTICAL_YOUTUBE_VIDEOS
  • GENERATE_SHORTER_YOUTUBE_VIDEOS
• AdNetworkType.GOOGLE_OWNED_CHANNELS اضافه شد، که توسط تبلیغاتی که در کانال‌های متعلق به Google مانند YouTube، Gmail و فید Discover ارائه می‌شوند، استفاده می‌شود.

دارایی ها

• 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 اضافه شد که معیارهای عملکرد محتوای هدف‌گذاری شده مانند کلیدواژه‌ها، مکان‌ها و موضوعات را برای کمپین‌های Display، Demand Gen و ویدیو برمی‌گرداند.

هتل و سفر

• پشتیبانی از فیدهای سفر در تبلیغات جستجو
  • ClickType.TRAVEL_ASSETS اضافه شد تا امکان تقسیم بندی معیارهای فیدهای سفر در تبلیغات جستجو را فراهم کند.
  • AssetSetType.TRAVEL_FEED اضافه شد که می‌تواند برای انتخاب و انصراف از استفاده از 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 اضافه شد که امکان تنظیم CPA هدف را برای یک دسته از طریق Campaign.local_services_campaign_settings فراهم می کند.

حداکثر عملکرد

• پشتیبانی از دستورالعمل های برند
  • Campaign.brand_guidelines_enabled اضافه شد که نشان می‌دهد آیا دستورالعمل‌های برند برای یک کمپین حداکثر عملکرد فعال هستند یا خیر. در صورت فعال بودن، دارایی‌هایی که field_type روی BUSINESS_NAME ، LOGO ، LANDSCAPE_LOGO تنظیم شده است، باید به‌جای منابع AssetGroupAsset به‌عنوان منابع CampaignAsset مرتبط شوند.
  • خطاهای CampaignError.REQUIRED_BUSINESS_NAME_ASSET_NOT_LINKED و CampaignError.REQUIRED_LOGO_ASSET_NOT_LINKED اضافه شد، که نشان می‌دهد کمپین‌های Performance Max با دستورالعمل‌های برند فعال، منابع مورد نیاز CampaignAsset مرتبط با کمپین را ندارند.
  • وقتی دستورالعمل‌های نام تجاری فعال هستند، حداقل یک دارایی با field_type روی BUSINESS_NAME و حداقل یکی با LOGO باید به عنوان منابع CampaignAsset به کمپین مرتبط شود. کمپین‌های حداکثر عملکرد برای فروش آنلاین با فید محصول فقط زمانی باید این شرط را برآورده کنند که دارایی‌هایی وجود داشته باشند که به گروه‌های دارایی کمپین مرتبط هستند.
  • مقادیر زیر را به AssetLinkError اضافه کرد:
    • BRAND_ASSETS_NOT_LINKED_AT_ASSET_GROUP_LEVEL ، که هنگام تلاش برای پیوند دادن دارایی‌های برند به کمپین‌ها به‌عنوان منابع CampaignAsset به جای منابع AssetGroupAsset در کمپین‌های Performance Max با دستورالعمل‌های نام تجاری فعال نشده، پرتاب می‌شود .
    • خطای BRAND_ASSETS_NOT_LINKED_AT_CAMPAIGN_LEVEL ، که هنگام تلاش برای مرتبط کردن دارایی های مارک به کمپین ها به عنوان منابع AssetGroupAsset به جای منابع CampaignAsset در کمپین های Performance Max با فعال کردن دستورالعمل های مارک، ایجاد می شود.
• performance_max_placement_view اضافه شد که نمایش‌هایی را از مکان‌هایی که تبلیغات حداکثر عملکرد در آن‌ها ارائه شده است را برمی‌گرداند.
• AssetGroupListingGroupFilterError.TREE_WAS_INVALID_BEFORE_MUTATION اضافه شد.TREE_WAS_INVALID_BEFORE_MUTATION

برنامه ریزی

• (فقط برای حساب‌های مجاز) سرویس جدیدی با روش ContentCreatorInsightsService.GenerateCreatorInsights اضافه کرد که به کاربران امکان می‌دهد اطلاعات آماری درباره سازندگان برتر YouTube را بررسی کنند. این به مشتریان اجازه می‌دهد تا سازندگانی را با توجه به ترکیب هدف‌گیری مخاطب و هدف‌گیری محتوا یا اطلاعات بینش سازنده با فهرستی از شناسه‌های کانال YouTube جستجو کنند.
• به‌روزرسانی‌های AudienceInsightsService.GenerateSuggestedTargetingInsights :
  • audience ، baseline_audience و data_month به audience_definition منتقل شدند.
  • audience_description برای ایجاد پیشنهادات هدف‌یابی از یک توضیح متنی فرم رایگان با استفاده از Gen AI اضافه شد.
• AudienceInsightsService.GenerateTargetingSuggestionMetrics اضافه شد که معیارهای دسترسی بالقوه را برای ترکیب‌های هدف‌گیری مخاطب خاص برمی‌گرداند.

توصیه ها

• RecommendationService.GenerateRecommendations اکنون می تواند برای ایجاد توصیه هایی در مورد پیشنهادهای بودجه بهینه شده در طول ساخت کمپین، با گنجاندن نوع توصیه CAMPAIGN_BUDGET در GenerateRecommendationsRequest.recommendation_types[] استفاده شود. این برای کمپین‌های Performance Max و Search کار می‌کند.

گزارش دهی

• فیلدهای 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

v17.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 های موجود در پاسخ را نشان می دهد.
  • اگر خطایی رخ دهد، روش به جای URL ها partial_failure_error برمی گرداند.

تاریخچه را تغییر دهید

• نوع منبع تغییر وضعیت جدید: 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 (CPM ثابت (هزینه در هزار نمایش))
  • Campaign.target_cpv (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

v17 (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 اضافه شد.OPERATION_LEVEL_CONSENT_PROVIDED

مشاغل دسته ای

• BatchJobError.REQUEST_TOO_LARGE اضافه شد، که زمانی که AddBatchJobOperationsRequest ارسال شده بزرگتر از 10484504 بایت باشد پرتاب می شود.
• پشتیبانی برای تنظیم MutateOperation.asset_group_operation هنگام استفاده از BatchJobService اضافه شد. این به شما امکان می دهد از پردازش دسته ای برای ایجاد و مدیریت کل کمپین های Performance Max استفاده کنید. راهنمای اختصاصی جدید ما را ببینید.

کمپین ها

• در همه زمینه‌ها، فهرست‌بندی‌ها، خطاهای همه منابع در سراسر Google Ads API، مانند کمپین‌ها، تبلیغات و دارایی‌ها، Discovery به Gen Demand تغییر نام داد. برای مثال، 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 مشخص کرد.
• مقادیر enum جدید به 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 می شود.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_product اضافه کرد که مربوط به صفحه محصولات رابط کاربری Google Ads است. از بازگرداندن داده‌های مربوط به وضعیت فعلی محصولات از حساب‌های Google Merchant Center مرتبط با حساب Google Ads پشتیبانی می‌کند.
  • هنگام استفاده از GoogleAdsService.Search یا GoogleAdsService.SearchStream می‌توانید معیارهای گزارش shopping_product را با استفاده از segments.date فیلتر کنید. تقسیم بندی بر اساس تاریخ مجاز نیست و یک خطای 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
• هنگام ایجاد DemandGenVideoResponsiveAdInfo AdVideoAsset.ad_video_asset_info برای پشتیبانی از اولویت‌های موجودی برای دارایی‌های ویدیو اضافه کرد.
• (فقط حساب های مجاز) Made Campaign.video_brand_safety_suitability قابل تغییر است.

نسخه 16.1.0 (24-04-2024)

ویژگی ها و تغییرات زیر در نسخه 16.1 اضافه شده است.

مدیریت حساب

• CustomerNegativeCriterion.ip_block که از افزودن IP به عنوان یک معیار منفی در سطح مشتری پشتیبانی می کند.
• مقدار enum جدید: ProductLinkError.LINK_EXISTS .
• مقدار enum جدید: ProductLinkInvitationError.CUSTOMER_NOT_PERMITTED_TO_CREATE_INVITATION .

دارایی ها

• پشتیبانی از دارایی‌های مربوط به Demand Gen به ad_group_ad_asset_view و asset_field_type_view .
• مقدار enum جدید: AssetFieldType.DISCOVERY_CAROUSEL_CARD .

مخاطبان

• مقدار enum جدید: ResourceLimitType.LOOKALIKE_USER_LISTS_PER_CUSTOMER که تعداد لیست های مشابه کاربر را که مشتری می تواند داشته باشد به 1000 محدود می کند.

کمپین ها

• پشتیبانی از شبیه‌سازی‌های پیشنهادی کمپین هدف ROAS برای کمپین‌های برنامه با استفاده از گزارش campaign_simulation .
• مقدار enum جدید: CampaignError.DYNAMIC_TEXT_ASSET_CANNOT_OPT_OUT_WITH_FINAL_URL_EXPANSION_OPT_IN .
• مقدار enum جدید: 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 .
• مقدار enum جدید: CriterionType.LIFE_EVENT .

آزمایش ها

• مقدار enum جدید: 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 که نشانی‌های اینترنتی را برمی‌گرداند که می‌توان از آنها برای دانلود محتویات پیوست استفاده کرد.

ویدیوها

• customer.video_brand_safety_suitability و BrandSafetySuitability که از بازیابی مناسب بودن ایمنی برند ویدیویی در سطح مشتری پشتیبانی می کنند.
• مقدار enum جدید: 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 اضافه شد.ACTION_NOT_PERMITTED_FOR_SUSPENDED_ACCOUNT.

دارایی ها

• تغییرات asset_group :
  • پشتیبانی از بخش‌های مرتبط با زمان، مانند segments.year و segments.month اضافه شده است.
  • به جای تقسیم‌بندی منبع، campaign به یک منبع منتسب تبدیل کرد.

کمپین ها

• تغییرات در کمپین های تقاضای نسل:
  • پشتیبانی برای تنظیم Campaign.shopping_setting به کمپین نسل تقاضای موجود اضافه شد.
  • ShoppingSetting.disable_product_feed برای غیرفعال کردن فید محصول اختیاری کمپین‌های Demand Gen اضافه شد.
  • Ad.demand_gen_product_ad و DemandGenProductAdInfo مربوطه اضافه شد که برای کمپین های Demand Gen با یک 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 اضافه شد.CANNOT_ENABLE_SYNC_FOR_UNSUPPORTED_EXPERIMENT_TYPE.
• CampaignError.CANNOT_MODIFY_TEXT_ASSET_AUTOMATION_WITH_ENABLED_TRIAL اضافه شد.CANNOT_MODIFY_TEXT_ASSET_AUTOMATION_WITH_ENABLED_TRIAL.

هتل و سفر

• فیلدهای زیر را به آگهی ListingDimensionInfo for a Things to do اضافه کرد تا امکان ایجاد گروه‌های فهرست‌بندی بر اساس ایالت و شهری که فعالیت سفر در آن در دسترس است را فراهم کند:
  • 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 به جای UNKNOWN روی UNSPECIFIED تنظیم کرده‌اند.
• انواع توصیه های زیر را اضافه کرد:
  • MAXIMIZE_CONVERSION_VALUE_OPT_IN که شرکت در استراتژی پیشنهاد قیمت حداکثر تبدیل را توصیه می کند
  • IMPROVE_GOOGLE_TAG_COVERAGE که استفاده از Google Tag را در صفحات بیشتری توصیه می کند
  • PERFORMANCE_MAX_FINAL_URL_OPT_IN که توصیه می‌کند بسط URL نهایی را برای کمپین‌های Performance Max خود روشن کنید
  • REFRESH_CUSTOMER_MATCH_LIST که توصیه می کند فهرست مشتریانی را که در 90 روز گذشته به روز نشده است به روز کنید.
  • CUSTOM_AUDIENCE_OPT_IN که ایجاد یک مخاطب سفارشی را توصیه می کند
  • LEAD_FORM_ASSET که اضافه کردن دارایی‌های فرم سرنخ را در سطح کمپین یا مشتری توصیه می‌کند
  • IMPROVE_DEMAND_GEN_AD_STRENGTH که بهبود قدرت تبلیغات در کمپین های نسل تقاضا را توصیه می کند

خرید

• CampaignError.CANNOT_LINK_TO_COMPARISON_SHOPPING_SERVICE_ACCOUNT و CampaignError.CANNOT_TARGET_NETWORK_FOR_COMPARISON_SHOPPING_SERVICE_LINKED_ACCOUNTS اضافه شد.CANNOT_TARGET_NETWORK_FOR_COMPARISON_SHOPPING_SERVICE_LINKED_ACCOUNTS به منظور ارائه خطاهای دقیق‌تر برای کمپین‌های حساب خرید مرکز خرید مرتبط با یک Comparison .
• مقادیر زیر را به 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 اضافه شد تا این نوع عملیات با سایر انواع عملیات در API سازگار باشد.

یادداشت های انتشار بایگانی شده

برای یادداشت‌های انتشار آرشیو شده ، نسخه‌های Sunsetted را ببینید.