v23 (2026-01-28)
В версии 23 были добавлены следующие новые функции и обновления.
См. раздел «Обновление до последней версии» для получения инструкций.
Реклама
- В список
AdGroupAdErrorEnumдобавленаAD_SHARING_NOT_ALLOWED. Эта ошибка возвращается при попытке поделиться объявлением с несколькими группами объявлений, что больше не разрешено. - В
AdFormatTypeдобавлены новые типы форматирования:TEXT,VERTICAL_ADS_BOOKING_LINK,VERTICAL_ADS_PROMOTION. - В версии 23 удалена поддержка
CallAdиCallAdInfo. Подробнее см. https://support.google.com/google-ads/answer/6341403.
Ресурсы
В отчет asset_group добавлены дополнительные метрики:
В отчет asset_group_asset добавлены дополнительные показатели:
Добавлена
orientationполя только для чтения для изображений и видеофайлов вAsset.Добавлена поддержка получения
CampaignAssetсfield_typeHEADLINEиDESCRIPTION.Добавлены
HEADLINE_AS_SITELINK_POSITION_ONE,HEADLINE_AS_SITELINK_POSITION_TWO,DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_ONEиDESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_TWOвServedAssetFieldTypeдля ресурсов, предоставляемых в качестве ссылок на сайт.Обновлены материалы для деловых сообщений:
- Добавлена поддержка Facebook Messenger и Zalo в качестве поставщиков в
BusinessMessageAsset, добавлены поляFACEBOOK_MESSENGERиZALOвBusinessMessageProviderEnum.BusinessMessageProvider, а также новые поляfacebook_messenger_infoиzalo_infoвBusinessMessageAsset. - Добавлено свойство
CUSTOMER_NOT_ON_ALLOWLIST_FOR_MESSAGE_ASSETSвAssetErrorEnum.
- Добавлена поддержка Facebook Messenger и Zalo в качестве поставщиков в
Выставление счетов
- Теперь
InvoiceService.ListInvoicesможет возвращать более подробную информацию о счетеInvoiceвключая разбивку затрат на уровне кампании, детализированные нормативные расходы и информацию о корректировках, установивinclude_granular_level_invoice_detailsвListInvoicesRequest. - Добавлены
RegulatoryFeeTypeEnumиUnitOfMeasureEnum.
Кампании
- Добавлены коды ошибок
CampaignError.DURATION_TOO_LONG_FOR_TOTAL_BUDGETиCampaignError.END_DATE_TIME_REQUIRED_FOR_TOTAL_BUDGET. - Добавлены
Campaign.start_date_timeиCampaign.end_date_timeвместоCampaign.start_dateиCampaign.end_date, что позволяет указывать временные компоненты для определенных типов кампаний.
Конверсии
- Добавлена опция
YOUTUBE_FOLLOW_ON_VIEWSвConversionActionCategoryдля отслеживания пользователей, которые сначала смотрят рекламу, а затем видео с того же канала.
Генерация спроса
- Добавлено поле
DemandGenVideoResponsiveAdInfo.companion_banner. - Удалено поле
lead_form_onlyизDemandGenMultiAssetAdInfo.
Стимулы
Добавлена поддержка системы «Выбери сам» (Choose Your Own, CYO) , позволяющая партнерам программно получать и применять бонусы Google Ads для своих клиентов:
- Добавлена
IncentiveService:- Метод
FetchIncentiveпозволяет получить список доступных бонусов для пользователя на основе страны, языка и, при необходимости, адреса электронной почты пользователя. Это может вернуть персонализированные варианты бонусов в формате «Выбери сам» (CYO). - Метод
ApplyIncentiveпозволяет применять выбранное пользователем вознаграждение к конкретному аккаунту клиента Google Ads.
- Метод
- Добавлен ресурс только для чтения
AppliedIncentive, доступный для поиска черезGoogleAdsService.SearchиGoogleAdsService.SearchStream. Он предоставляет подробную информацию об использованных бонусах, включая их статус, ход выполнения, суммы вознаграждений и соответствующие даты. - В
IncentiveErrorEnumдобавлены новые коды ошибок для обработки проблем, связанных с получением или применением вознаграждений. - Добавлено значение
INVALID_EMAIL_ADDRESSвAuthenticationErrorEnum.
- Добавлена
Для более детальной программной обработки сбоев в будущих релизах мы добавим дополнительные коды ошибок в
IncentivesService. Рекомендуем следить за предстоящими объявлениями и примечаниями к релизам, чтобы узнать о новых кодах ошибок и убедиться, что ваши приложения могут обрабатывать эти новые режимы сбоев.
Планирование
Добавлен
LIFE_EVENT_USER_INTERESTвAudienceInsightsDimensionEnum. Это новое измерение позволяет пользователям создавать аудитории, используя жизненные события, по следующим методам:-
AudienceInsightsService.GenerateAudienceCompositionInsights -
AudienceInsightsService.GenerateSuggestedTargetingInsights -
AudienceInsightsService.GenerateInsightsFinderReport -
ContentCreatorInsightsService.GenerateCreatorInsights
События жизненного цикла не поддерживаются для других методов
AudienceInsightsService, таких какAudienceInsightsService.GenerateAudienceOverlapиAudienceInsightsService.GenerateTargetingSuggestionMetrics.-
В ответе
ReachPlanService.GenerateConversionRatesтеперь отображаются различные поверхности, что позволяет предлагать разные коэффициенты конверсии в зависимости от настроек поверхности (например, Gmail, Shorts). Эта функция поддерживается только для кампаний по генерации спроса.В
YouTubeChannelInsightsдобавленаLanguageDistribution, позволяющая отображать языковой контент на YouTube-каналах.Добавлен
BenchmarksServiceдля сравнения данных о рекламе на YouTube с отраслевыми показателями.Добавлена
AudienceInsightsService.GenerateAudienceDefinitionдля преобразования текстового описания целевой аудитории в соответствующие атрибуты аудитории с помощью генеративного ИИ.Добавлена функция
YouTubeChannelInsights.relevance_score, которая оценивает релевантность контента для определенной темы с учетом количества просмотров.Добавлена
TrendInsightMetrics.trend_change_percent, которая отображает процентное изменение значения тренда за сравниваемый период.
Рекомендации
- Добавлено поле
is_new_customerвGenerateRecommendationsRequest. Если для рекомендаций типаCAMPAIGN_BUDGETустановлено значениеtrue, то генерируются рекомендации с использованием модели для новых клиентов. Это рекомендуется только для клиентов, у которых нет кампаний.
Отчеты
Метрики и сегментация
- Теперь
AdGroupAdAssetViewиAdGroupAdAssetCombinationViewподдерживают метрики показов, эффективности и конверсии дляRESPONSIVE_DISPLAY_AD. - Добавлен сегмент
ad_sub_network_typeдля более детального анализа эффективности внутри рекламной сети. Первоначально он доступен для кампаний DemandGen на YouTube (в потоке, в ленте, короткие ролики). Этот сегмент необходимо выбрать вместе сad_network_type. - Включена детализация по типам рекламных сетей для кампаний Performance Max.
- Теперь представления UserLocationView и GeographicView поддерживают метрики, сегментированные по дате конверсии:
-
conversions_by_conversion_date, -
all_conversions_by_conversion_date, -
conversions_value_by_conversion_date, -
all_conversions_value_by_conversion_date, -
value_per_conversions_by_conversion_date, -
value_per_all_conversions_by_conversion_date, -
cross_device_conversions_by_conversion_date, -
cross_device_conversions_value_by_conversion_date.
-
- Теперь
Новые сегменты для вертикальной рекламы
Новые ракурсы:
- Добавлена возможность использования
PerStoreViewдля запроса информации о местоположении магазина. - Добавлена
MatchedLocationInterestViewдля кампаний AI Max, предоставляющая показатели эффективности с разбивкой по географическим местоположениям, в которых пользователи проявили интерес.
- Добавлена возможность использования
Максимальная производительность:
- Включена детализация по типам рекламных сетей для кампаний Performance Max.
Перевозки:
- Удалены агрегированные метрики производительности активов. Перечисление меток производительности больше не возвращается для поиска и отображения.
Покупки
- Теперь
ShoppingPerformanceViewподдерживает следующие метрики, сегментированные по дате конверсии:conversions_by_conversion_date,all_conversions_by_conversion_date,conversions_value_by_conversion_date,all_conversions_value_by_conversion_date,value_per_conversions_by_conversion_date,value_per_all_conversions_by_conversion_date. - Теперь
ShoppingPerformanceViewподдерживает следующие конкурентные метрики:search_budget_lost_impression_share,search_rank_lost_impression_share,search_budget_lost_absolute_top_impression_share,search_rank_lost_absolute_top_impression_share. - Добавлен
product_image_uriвShoppingProduct.
Вертикальная реклама
- Добавлен параметр
vertical_ads_format_settingвAdGroupдля поисковых кампаний, использующих туристические фиды, что позволяет контролировать, какие форматы объявлений могут отображаться. - Добавлен тип критерия
vertical_ads_item_group_rule_listвAdGroupCriterion. Добавленvertical_ads_item_group_ruleвSharedCriterion. Эти критерии позволяют таргетировать группы товаров в поисковых кампаниях с туристическими фидами. - Теперь вы можете подключить фид данных вертикальной рекламы к поисковой кампании, работающей под управлением AI Max, чтобы она показывала рекламные объявления о недвижимости и ссылки на бронирование туристических услуг наряду с вашими текстовыми объявлениями. На уровне группы объявлений вы можете управлять отображаемыми форматами с помощью параметра vertical_ads_format_setting и определять набор правил для групп элементов, чтобы ориентироваться на подмножество ваших объектов из фида данных вертикальной рекламы. Кроме того, отчеты теперь можно сегментировать как по типу формата объявления (AdFormatType) , так и по параметрам из фида данных вертикальной рекламы.
Видео
- Добавлено поле
AdVideoAssetInfo.ad_video_asset_feature_control. - Добавлен код ошибки
CampaignCriterionError.INVALID_VIDEO_LINEUP_ID. - Добавлены метрики слышимости для аудиорекламы на YouTube, позволяющие определить, была ли реклама слышимой и на каком количестве показов можно измерить слышимость.
v22 (15.10.2025)
В версии 22 были добавлены следующие новые функции и обновления.
Ресурсы
- Добавлен новый тип поля для графических ресурсов —
LANDING_PAGE_PREVIEW. - Представлен сервис
AssetGenerationService(бета-версия):- Этот сервис позволяет создавать текстовые и графические материалы с использованием генеративного искусственного интеллекта. Первоначально этот сервис доступен только ограниченному числу участников закрытого бета-тестирования.
-
GenerateText: Генерирует текст на основе таких входных данных, как конечный URL-адрес, произвольные подсказки, ключевые слова и существующий контекст кампании. -
GenerateImages: Генерирует изображения на основе таких входных данных, как конечный URL-адрес, произвольные подсказки, существующий контекст кампании или путем переосмысления существующих изображений товаров. - Ошибки, возникающие при генерации активов, возвращаются с кодами из
AssetGenerationErrorEnum.
Кампании
- Добавлены новые цели назначения ставок для кампаний приложений по установке (ACi) для оптимизации без указания целевого показателя, что полезно для быстрого масштабирования или когда определение правильного целевого показателя представляет собой сложную задачу. В
AppCampaignBiddingStrategyGoalType: *OPTIMIZE_IN_APP_CONVERSIONS_WITHOUT_TARGET_CPA: Использовать со стандартным параметром «Максимизация конверсий» .-
OPTIMIZE_TOTAL_VALUE_WITHOUT_TARGET_ROAS: Использовать со стандартным параметром «Максимизировать значение конверсии» .
-
- Добавлена поддержка стратегии назначения ставок с фиксированной долей.
- Добавлена
Campaign.feed_types, отображающая типы фидов, прикрепленных к кампании. Для кампаний Performance Max это может указывать на отраслевую принадлежность бизнеса, например,MERCHANT_CENTER_FEEDдля розничной торговли. - Разрешено прикреплять общие наборы
NEGATIVE_KEYWORDSк кампаниямMULTI_CHANNEL(для кампаний приложений) иLOCAL.
Генерация спроса
- Добавлена стратегия назначения ставок TargetCPC для кампаний по генерации спроса. Эта стратегия устанавливает ставки для максимизации кликов при заданной целевой стоимости клика (CPC).
- Установите целевую цену за клик (CPC) на уровне кампании, используя
Campaign.target_cpc. - Переопределите значение на уровне группы объявлений, используя
AdGroup.target_cpc_micros.
- Установите целевую цену за клик (CPC) на уровне кампании, используя
- Добавлен новый
AssetAutomationType: *GENERATE_DESIGN_VERSIONS_FOR_IMAGES: доступен дляDemandGenMultiAssetAds. Если включен, это добавляет элементы дизайна и встраивает текстовые ресурсы в графические ресурсы для создания новых графических ресурсов с различными соотношениями сторон. НовыеDemandGenMultiAssetAdsпо умолчанию включены. - Добавлен новый
AssetAutomationType: *GENERATE_VIDEOS_FROM_OTHER_ASSETS: доступен дляDemandGenMultiAssetAds. Если включен, генерируются видеоролики с использованием других ресурсов, таких как изображения и текст. Эти видеоролики затем можно использовать для создания новыхDemandGenVideoResponsiveAds. НовыеDemandGenMultiAssetAdsпо умолчанию включены. - Поле
BudgetPerDayMinimumErrorDetails.minimum_bugdet_amount_microsпереименовано вminimum_budget_amount_micros.
Общий
- Добавлено ограничение в 10 000 операций на один запрос
AddBatchJobOperations. - Обновлена обработка поля
page_sizeвListBatchJobResultsRequest:- Если
page_sizeне задан или равен 0, теперь по умолчанию устанавливается максимальное значение 1000 (ранее возвращалосьINVALID_PAGE_SIZE). - Если
page_sizeпревышает 1000, API теперь возвращает ошибкуINVALID_PAGE_SIZE(ранее ограничение в 1000 отображалось без уведомления).
- Если
- Добавлен новый код ошибки:
QuotaError.PAYMENTS_PROFILE_ACTIVATION_RATE_LIMIT_EXCEEDED, указывающий на превышение лимита активаций платежных профилей.
Максимальная производительность
- Добавлены новые значения
AssetAutomationTypeдля кампаний Performance Max:-
GENERATE_IMAGE_ENHANCEMENT: Включает автоматическое создание улучшенных изображений, таких как автоматическая обрезка. Включено по умолчанию. -
GENERATE_IMAGE_EXTRACTION: Включает автоматическое получение изображений из конечных URL-адресов. По умолчанию используется настройка динамического расширения изображений на уровне учетной записи.
-
- Удален
AssetPerformanceLabelдля кампаний Performance Max. - Функциональность удаленной функции
Campaign.url_expansion_opt_outтеперь управляется путем установки параметраAssetAutomationTypeFINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATIONвAssetAutomationSetting. - Добавлены новые сегменты для кампаний Performance Max. Каждый из этих сегментов доступен только для кампаний Performance Max и не будет возвращать данные при выборе любого другого типа кампании.
-
ad_using_product_data: Указывает, использует ли объявление данные о товаре из фида Google Merchant Center. -
ad_using_video: Указывает, использует ли реклама видеоматериал.
-
Планирование
- В поле
UserListCrmDataSourceTypeдобавлено значениеTHIRD_PARTY_PARTNER_DATA.- Добавлены новые коды ошибок, связанные с аудиторией партнеров:
-
PARTNER_AUDIENCE_SOURCE_NOT_SUPPORTED_FOR_USER_LIST_TYPE -
PARTNER_AUDIENCE_TYPE_NOT_SUPPORTED_FOR_USER_LIST_TYPE -
COMMERCE_PARTNER_NOT_ALLOWED -
PARTNER_AUDIENCE_INFO_NOT_SUPPORTED_FOR_USER_LIST_TYPE -
PARTNER_MANAGER_ACCOUNT_DISALLOWED -
PARTNER_NOT_ALLOWLISTED_FOR_THIRD_PARTY_PARTNER_DATA -
ADVERTISER_TOS_NOT_ACCEPTED -
ADVERTISER_PARTNER_LINK_MISSING -
ADVERTISER_NOT_ALLOWLISTED_FOR_THIRD_PARTY_PARTNER_DATA -
ACCOUNT_SETTING_TYPE_NOT_ALLOWED_FOR_USER_LIST_TYPE -
INVALID_CAMPAIGN_TYPE_FOR_THIRD_PARTY_PARTNER_DATA_LIST
- Добавлена
is_active_live_stream_creatorвYouTubeMetrics. Она возвращается функциейContentCreatorInsightsService.GenerateCreatorInsightsи указывает, публиковал ли автор прямую трансляцию за последние 90 дней. Добавлено новое сообщение
PlannableUserListMetadata, содержащееUserListCrmDataSourceTypeвPlannableUserList. Это сообщение возвращается функцией 'ReachPlanService.ListPlannableUserLists' , чтобы показать, является ли источник данных списка пользователей CRM либоFIRST_PARTY, либоTHIRD_PARTY_PARTNER_DATA.В
ReachPlanServiceдобавлено полеtrueview_views, которое заменяет полеviews.В
TrendInsightдобавлена поддержкаrelated_videosиrelated_creators. Также добавлены метаданные свойств видео и даты публикации в файлахYouTubeVideoAttributeMetadata.video_propertiesиYouTubeVideoAttributeMetadata.publish_date.-
AudienceInsightsService.GenerateInsightsFinderReportтеперь поддерживаетparental_statusиincome_ranges, а также более сложные комбинации AND/OR для тем и аудиторий.
-
Отчеты
- Добавлены два новых типа кликов:
CLICK_TO_MESSAGE_THIRD_PARTY_CLICKиCLICK_TO_MESSAGE_LANDING_PAGE_CLICK.- Теперь
AssetGroupAssetможно сегментировать поdevice,conversion_action,conversion_action_nameиconversion_action_category.- Теперь
AdGroupAdAssetViewиAdGroupAdAssetCombinationViewполностью поддерживают показатели эффективности и конверсии дляRESPONSIVE_SEARCH_AD. Ранее в этих представлениях для данного типа объявлений отображались только показы.
- Теперь
- Теперь
- Для упрощения анализа возможностей интеллектуального назначения ставок, следующие показатели теперь можно сегментировать по полям дат (
date,month,quarter,week,year): - Добавлен новый ресурс:
TargetingExpansionView, который отображает метрики для расширений по сравнению с ручным таргетингом, например, расширение без ключевых слов для AI Max в поисковых кампаниях. Добавлены новые сегменты для кампаний Performance Max. См. обновления Performance Max .
### Покупки
Исправлена ошибка в определении области действия метрик для кампаний и групп объявлений в ресурсе
ShoppingProduct.
Единые цели
- Добавлена поддержка целей по удержанию клиентов для оптимизации процесса повторного привлечения существующих клиентов.
- Настройте таргетинг с помощью
CampaignRetentionGoalSettings.target_option: *TARGET_SPECIFIC: Использует только пользователей из списков пользователей, связанных с кампанией. (В настоящее время только из разрешенных списков).-
TARGET_ALL(По умолчанию): Нацеливает повторное взаимодействие со всеми пользователями.
-
- Настройте таргетинг с помощью
Видео
- Переименованы несколько показателей, связанных с просмотрами видео:
-
average_cpvтеперь равноtrueview_average_cpv -
video_view_rateтеперьvideo_trueview_view_rate -
video_viewsтеперь называетсяvideo_trueview_views -
video_view_rate_in_feedтеперь равенvideo_trueview_view_rate_in_feed -
video_view_rate_in_streamтеперь равенvideo_trueview_view_rate_in_stream -
video_view_rate_shortsтеперь равенvideo_trueview_view_rate_shorts
-
- Добавлены метрики для оценки времени просмотра видеорекламы:
-
video_watch_time_duration_millis: Общее время просмотра. -
average_video_watch_time_duration_millis: Среднее время просмотра на один показ.
-
v21 (06.08.2025)
См. раздел «Обновление до последней версии» для получения инструкций.
AI Max для поисковых кампаний
Теперь вы можете использовать поле
ai_max_setting.enable_ai_maxв настройкахCampaign, чтобы включить AI Max для поисковых кампаний. AI Max для поисковых кампаний расширяет охват поисковой кампании за счет сопоставления поисковых запросов и позволяет контролировать, будут ли отображаться настройки таргетинга и креативов, если они заданы. Автоматизация текстовых материалов и настройки списков брендов, заданные в предыдущих версиях, будут по-прежнему учитываться до тех пор, пока AI Max для поисковых кампаний не будет явно включен и выключен.Campaign.ai_max_setting.bundling_requiredможно использовать для определения того, должны ли быть включены кампании AI Max для поисковых кампаний, чтобы учитывать или изменять автоматизацию текстовых материалов и настройки списков брендов.AdGroup.ai_max_ad_group_setting.disable_search_term_matchingможно использовать для отключения сопоставления поисковых запросов, если в родительской кампании включены кампании AI Max для поисковых кампаний. См. нашу статью в блоге «Раскройте потенциал нового уровня с помощью кампаний AI Max для поисковых кампаний» .Добавлена
CampaignError.AI_MAX_MUST_BE_ENABLED, которая возникает для поисковых кампаний, если вы активируете параметрFINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION, не включив при этом AI Max для поисковых кампаний в самой кампании.Добавлена поддержка применения настроек таргетинга на уровне групп объявлений в кампаниях AI Max for Search. Теперь вы можете добавлять следующие критерии к группам объявлений:
- Списки брендов
- Места расположения
- Веб-страницы (правила URL)
Добавлено представление
ai_max_search_term_ad_combination_viewдля отчета о производительности комбинаций поисковых запросов, заголовков и целевых страниц. Это представление показывает, какие поисковые запросы запускали ваши объявления и как показали себя эти конкретные комбинации. В будущих версиях будет добавлено дополнительное представление, которое также будет включать данные Performance Max. Если вы хотите избежать миграции вашей реализации для получения данных Performance Max, рассмотрите возможность ожидания этой версии.Добавлено значение
AI_MAXдля сегментаsearch_term_match_type.
Ресурсы
В
PromotionAssetдобавлены поляterms_and_conditions_text,terms_and_conditions_uri,promotion_barcode_infoиpromotion_qr_code_info. Поля штрихкода и QR-кода находятся внутри свойстваpromotion_trigger. См. статью в Справочном центре «Об активах для продвижения» .В
AssetAutomationTypeEnumдобавленFINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION. С помощью этого параметра можно управлять автоматической генерацией текстовых ресурсов и целевых страниц из конечного URL-адреса в поисковых кампаниях.Добавлена новая служба
AutomaticallyCreatedAssetRemovalService.RemoveCampaignAutomaticallyCreatedAssetдля удаления автоматически созданных ресурсов изCampaign. Эта служба поддерживает удаление только ресурса, содержащего конечный URL-адрес.Добавлен
DESCRIPTION_PREFIXв перечислениеServedAssetFieldType. Это исправляет проблему, из-за которой параметрserved_asset_field_typeвad_group_ad_asset_combination_viewбылUNKNOWNдля активов, используемых в качестве префикса описания.
Кампании
В поле
CampaignPrimaryStatusReasonдобавлено новое значение перечисленияMISSING_LOCATION_TARGETING. Эта новая причина статуса будет возвращаться только для кампаний с ограничениями по местоположению, в которых не указан таргетинг по местоположению. Для кампаний с ограничениями по местоположению любая попытка добавить таргетинг по местоположению за пределами разрешенной области приведет к ошибке критерияLOCATION_TARGETING_NOT_ELIGIBLE_FOR_RESTRICTED_CAMPAIGN.Добавлена поддержка интеграции со сторонними партнерами на уровнях
VideoCustomer.third_party_integration_partnersи Campaign.third_party_integration_partners . См. статью в Справочном центре «Отслеживание конверсий приложения с помощью аналитики сторонних приложений» .Теперь вы можете задать значение поля
advertising_partner_idsдля существующейCampaign. Ранее это поле можно было задать только для новой кампании при ее создании. После задания значение поля остается неизменяемым.Используя общий список типа
TYPE_PLACEMENT_LISTопределенный на уровне учетной записи менеджера, рекламодатели теперь могут применять критерииCustomerNegativeCriterionдля исключения списка размещений в отдельных учетных записях клиентов-рекламодателей.Добавлен
DESCRIPTION_PREFIXв перечислениеServedAssetFieldType. Это исправляет проблему, из-за которой параметрserved_asset_field_typeв представленииad_group_ad_asset_combination_viewбылUNKNOWNдля активов, используемых в качестве префикса описания.Добавлена поддержка поля
target_roas_tolerance_percent_millisв стратегиях назначения ставокMaximizeConversionValueиTargetRoas.TargetRoas.target_roas_tolerance_percent_millisдоступно только для портфельных стратегий, которые, в свою очередь, доступны только для поисковых кампаний.Изменен код ошибки
ProductGroup. Для запросов с включенной функцией частичного сбоя вместоINVALID_LISTING_GROUP_HIERARCHYбудет возвращатьсяLISTING_GROUP_ERROR_IN_ANOTHER_OPERATION.Добавлен новый ресурс
LocationInterestView, который суммирует показатели эффективности критериев интереса к местоположению в группах объявлений.
Конверсии
Добавлено значение
ENGAGED_VIEWв качестве нового параметра для сегментаconversion_attribution_event_type.Клиенты больше не будут иметь доступа к режиму
debug_enabledвConversionUploadService. Это поле, если оно установлено вTRUE, ранее использовалось для различения ошибкиCLICK_NOT_FOUNDотSUCCESSпри повышении конверсии импорта лидов.
Генерация спроса
- Добавлен код ошибки
CampaignBudgetError.BUDGET_BELOW_DAILY_MINIMUM. В будущем эта ошибка будет возвращаться при попытке установить очень низкий бюджет для кампании генерации спроса. Подробную информацию о требуемом минимальном бюджете можно найти в новом поле сведений об ошибкеbudgetDailyMinimumErrorDetails.
Изменения в политической рекламе в ЕС
Эти изменения в политике рекламы ЕС также были внесены в версии 19.2 и 20.1 .
Добавлено
Campaign.contains_eu_political_advertising. Это поле указывает, содержит ли ваша кампания политическую рекламу, ориентированную на Европейский Союз. Если для этого поля установлено значениеCONTAINS_EU_POLITICAL_ADVERTISING, кампания перестанет работать в ЕС начиная с 22 сентября 2025 года. Вызовы API для создания новой кампании завершатся ошибкойFieldError.REQUIRED, если это поле не задано.Для существующих кампаний необходимо установить поле
contains_eu_political_advertisingперед попыткой изменения таргетинга по близости, местоположению или группе местоположений на уровне кампании или группы объявлений. Вызовы API для создания или обновления этих критериев кампании или группы объявлений для существующих кампаний завершатся ошибкойCriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION, если кампания не завершила самодекларацию.В версиях v19.x и 20.x требование задавать значение этого поля пока не является обязательным, но будет введено в будущем. Об этом изменении будет объявлено заранее.
В случае, если в ходе эксперимента не будет указано, содержат ли кампании политическую рекламу, направленную против Европейского союза, система Trials and Experiments выдаст
ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION.
Максимальная производительность
Для новых кампаний PMax значение по умолчанию для
Campaign.brand_guidelines_enabledтеперьtrue.Добавлен отчет
campaign_search_term_view. Этот отчет предоставляет метрики поисковых запросов, агрегированные на уровне кампании. В этом отчете также добавлена поддержка кампаний Performance Max для поисковых запросов.Добавлено значение
PERFORMANCE_MAXдля сегментаsearch_term_match_type.
Планирование
Добавлен новый метод
ReachPlanService.ListPlannableUserInterests, который позволяет рекламодателям определять интересы пользователей (предпочтения и целевые рынки), поддерживаемые методомReachPlanService.GenerateReachForecast. Метод поддерживает поиск по конкретным типам интересов пользователей, а также запросы по именам и путям.Добавлено
AdditionalApplicationInfoвReachPlanService.ListPlannableUserListsв качестве необязательного поля ввода.Добавлена поддержка в
AudienceInsightsService.ListAudienceInsightsAttributesдля получения доступных списков пользователей 1P для идентификатора клиента, отправившего запрос.Добавлена поддержка списков пользователей 1P в
AudienceInsightsService.GenerateAudienceCompositionInsightsдля получения аналитических данных по аудиториям, нацеленным на список пользователей. Любой запрос, нацеленный на список пользователей, вернет только индекс аудитории и доступен только для следующих измеренийAudienceInsightsDimension:AGE_RANGE,GENDER,AFFINITY_USER_INTEREST,IN_MARKET_USER_INTEREST.В методе
AudienceInsightsService.GenerateTargetingSuggestionMetricsобновлен тип ввода аудитории доInsightsAudience. Новый тип ввода аудитории позволяет комбинировать интересы пользователей с помощью операторов И-ИЛИ, что поддерживает потенциальные показатели охвата для более персонализированного определения аудитории.В
TrendInsightMetricsдобавлена функция отображения доли аудитории для тренда.Добавлены новые связанные категории в
KnowledgeGraphAttributeMetadata, позволяющие пользователям фильтровать атрибуты графа знаний по категориям.
Отчеты
Для
AssetGroupAsset,ChannelAggregateAssetViewиCampaignAggregateAssetViewтеперь доступен ряд новых метрик. Кроме того, дляChannelAggregateAssetViewиCampaignAggregateAssetViewimpressions, которое ранее обнулялось для кампаний Performance Max, теперь будет отображать свое истинное значение.Теперь ресурс
AssetSetможно выбирать с помощьюChangeStatus, чтобы пользователи могли получить дополнительную информацию о ресурсе типаAssetSetилиCampaignAssetSetв одном запросе.Теперь ресурс
CampaignAssetSetможно выбрать с помощьюChangeStatus, чтобы пользователи могли получить дополнительную информацию о ресурсе типаAssetSetилиCampaignAssetSetв одном запросе.Добавлен новый сегмент
search_term_targeting_status, который можно выбрать в режиме просмотра поисковых запросов кампании.Добавлен новый объект
final_url_expansion_asset_view.Добавлена поддержка метрик
value_adjustmentиall_value_adjustmentв отчетеAssetGroup.Сделал
AssetGroupAssetсегментируемым поad_network_type.Добавлен новый сегмент
landing_page_source, который можно использовать с ресурсомlanding_page_view.Добавлен новый сегмент
search_term_match_source, который можно выбрать в представлениях поисковых запросов и поисковых запросов кампании.Добавлен новый
match_typeдля сегментов, который можно выбрать в представлении ключевых слов.Добавлена поддержка метрик для уникальных кластеров намерений запросов с использованием:
В сегментацию
click_viewдобавлен новый тип кликаVEHICLE_ASSETSдля отслеживания и составления отчетов о кликах, связанных с форматами объявлений, специфичными для транспортных средств.
Анализ эффективных стратегий назначения ставок для достижения целевого показателя ROAS в поисковой выдаче.
Теперь вы можете включить интеллектуальное исследование ставок в поисковых кампаниях, установив поле
target_roas_tolerance_percent_millisв стратегиях назначения ставокMaximizeConversionValueиTargetRoasна любое значение, делящееся на 1000, в диапазоне от 10000 (10%) до 30000 (30%) включительно. Для стратегий назначения ставокMaximizeConversionValueтакже необходимо установить полеtarget_roas. ПолеTargetRoas.target_roas_tolerance_percent_millisдоступно только для портфельных стратегий. См. нашу статью в блоге об интеллектуальном исследовании ставок и статью в справочном центре.Теперь поддерживается агрегированная отчетность по разнообразию для следующих показателей в рамках уникальных кластеров запросов. В пользовательском интерфейсе Google Ads доступен сегментированный по времени вид.
Видео
Добавлен
YouTubeVideoListAsset. Также добавленAsset#youtube_video_list_asset, который можно использовать для создания ссылки междуcampaignи объектом типаYouTubeVideoListAsset. См. статью в Справочном центре « Использование связанных видео» .Добавлены новые поля метаданных в
YouTubeChannelInsightsиYouTubeVideoAttributeMetadata.Добавлены новые типы кликов:
VIDEO_RELATED_VIDEOS_CLICK,VIDEO_CHANNEL_CLICKиPRODUCT_ASSETS.В
VideoAdInventoryControlдобавлено полеallow_non_skippable_in_stream, позволяющее отображать адаптивные видеообъявления как неотключаемые внутрипотоковые объявления. Эта опция доступна для кампаний, поддерживающих смешивание неотключаемого формата с другими форматами.Добавлены поля
Campaign.VideoCampaignSettings.video_ad_sequenceиAdGroup.VideoAdGroupSettings.VideoAdSequenceStepSetting(только для чтения). См. статью в Справочном центре «О последовательности видеорекламы» .Добавлены новые поля метаданных в
YouTubeChannelInsightsиYouTubeVideoAttributeMetadata.Добавлены тип критерия
VIDEO_LINEUPи полеvideo_lineupвCampaignCriterionиAdGroupCriterion. Эта функция доступна только для учетных записей, включенных в список разрешенных. Для получения подробной информации обратитесь к представителю Google по развитию бизнеса.Добавлен отчет о соответствии контента требованиям как на детальном уровне , так и на уровне групп . См. статью в Справочном центре «Об отчете о соответствии контента требованиям» .
v20.1 (06.08.2025)
Эти изменения в политике рекламы ЕС также были внесены в версии 19.2 и 21 .
Изменения в политической рекламе в ЕС
Добавлено
Campaign.contains_eu_political_advertising. Это поле указывает, содержит ли ваша кампания политическую рекламу, ориентированную на Европейский Союз. Если для этого поля установлено значениеCONTAINS_EU_POLITICAL_ADVERTISING, кампания перестанет работать в ЕС начиная с 22 сентября 2025 года.Для существующих кампаний необходимо установить поле
contains_eu_political_advertisingперед попыткой изменения таргетинга по близости, местоположению или группе местоположений на уровне кампании или группы объявлений. Вызовы API для создания или обновления этих критериев кампании или группы объявлений для существующих кампаний завершатся ошибкойCriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION, если кампания не завершила самодекларацию.В версиях v19.x и 20.x требование задавать значение этого поля пока не является обязательным, но будет введено в будущем. Об этом изменении будет объявлено заранее.
В случае, если в ходе эксперимента не будет указано, содержат ли кампании политическую рекламу, направленную против Европейского союза, система Trials and Experiments выдаст
ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION.
v20 (04.06.2025)
В версии 20 были добавлены следующие новые функции и обновления.
См. раздел «Обновление до последней версии» для получения инструкций.
Ресурсы
Добавлено несколько новых метрик и столбцов сегментов для отчета asset_group .
Столбцы метрик
-
new_customer_lifetime_value -
all_new_customer_lifetime_value -
conversions_by_conversion_date -
all_conversions_by_conversion_date -
conversions_value_by_conversion_date -
all_conversions_value_by_conversion_date -
value_per_conversions_by_conversion_date -
value_per_all_conversions_by_conversion_date
Сегментные столбцы
-
ad_network_type -
conversion_action -
conversion_action_name -
conversion_action_category -
external_conversion_source -
conversion_attribution_event_type -
conversion_adjustment -
conversion_lag_bucket -
conversion_or_adjustment_lag_bucket -
new_versus_returning_customers -
device -
slot
Кампании
- Добавлена поддержка добавления и обновления минус-слов на уровне кампании для кампаний Performance Max.
Конверсии
Теперь вы можете обновить поле
google_ads_conversion_customerдля существующего клиента, чтобы включить отслеживание конверсий между аккаунтами или изменить родительский аккаунт для отслеживания конверсий на другой аккаунт администратора.Добавлено поле
ClickConversion.user_ip_address. Google Ads не поддерживает сопоставление IP-адресов конечных пользователей из Европейской экономической зоны (ЕЭЗ), Великобритании (UK) или Швейцарии (CH). Пожалуйста, добавьте логику для условного исключения обмена IP-адресами пользователей из этих регионов. Убедитесь, что вы предоставляете пользователям четкую и исчерпывающую информацию о данных, которые вы собираете на своих сайтах, в приложениях и других ресурсах, и получаете согласие там, где это требуется по закону или в соответствии с применимыми политиками Google. Дополнительную информацию см. на странице «Об импорте офлайн-конверсий» .
Генерация спроса
- В сегмент
ad_network_typeдобавлены новые значения, позволяющие сегментировать кампании по генерации спроса по каналам:-
MAPS -
GMAIL -
DISCOVER
-
- Добавлены метрики для сравнения показателей конверсии на разных платформах:
-
platform_comparable_conversions_from_interactions_rate -
platform_comparable_conversions -
platform_comparable_conversions_value -
platform_comparable_conversions_value_per_cost -
platform_comparable_conversions_by_conversion_date -
platform_comparable_conversions_value_by_conversion_date -
platform_comparable_conversions_from_interactions_value_per_interaction -
value_per_platform_comparable_conversion -
value_per_platform_comparable_conversions_by_conversion_date -
cost_converted_currency_per_platform_comparable_conversion
-
Рекомендации
- Добавлена поддержка параметра
ShoppingSettingпри создании кампании с использованиемGenerateRecommendationsRequest.- В функцию
GenerateRecommendationsRequestдобавлено полеmerchant_center_account_idуказывающее, когда следует генерировать рекомендации для розничной торговли, а не для стандартных кампаний Performance Max.
- В функцию
Планирование
- Добавлен
AudienceInsightsDimension.YOUTUBE_LINEUPдля заменыAudienceInsightsDimension.YOUTUBE_DYNAMIC_LINEUPвAudienceInsightsServiceиContentCreatorInsightsService. Этот новый параметр позволяет получать аналитические данные и метаданные для линеек YouTube Select (YTS). Заменены объекты, связанные сYOUTUBE_DYNAMIC_LINEUP, такие какDynamicLineupAttributeMetadataиAudienceInsightsDynamicLineup, в соответствии с общим удалением динамических линеек в Google Ads. Эта функция доступна только для аккаунтов, включенных в список разрешенных. - Добавлены
AdditionalApplicationInfoиApplicationInstanceв классыAudienceInsightsService,ContentCreatorInsightsServiceиReachPlanService. Эта функция доступна только для учетных записей, включенных в список разрешенных. - Обновлены
AudienceInsightsServiceиContentCreatorInsightsServiceдля предоставления более подробной информации. Теперь вы можете сегментировать данные о создателях контента по устройствам, используя новые свойстваAudienceInsightsDimension.DEVICEиAudienceInsightsAttribute.deviceв обоих сервисах. Эта функция доступна только для учетных записей, включенных в список разрешенных. - Added additional aggregated video metrics to
GenerateCreatorInsightsResponsefor more comprehensive content creator analysis:engagement_rate,average_views_per_video,average_likes_per_video,average_shares_per_video,average_comments_per_video,shorts_views_count,shorts_video_count, andis_brand_connect_creator. This feature is only available to accounts on an allowlist. - Added
sub_country_locationstoGenerateCreatorInsightsRequestfor theContentCreatorInsightsService. This allows specifying sub-country geographic locations to refine searches for creator insights. Thesub_country_locationsfield is only supported when using thesearch_attributesoneof in thecriteriafield. Ifsub_country_locationsare provided with other criteria types, the request will be invalid. This enables more granular geographical targeting and analysis for content creator insights. This feature is only available to accounts on an allowlist. - Added
ReachPlanService.ListPlannableUserLists, which returns first-party user lists owned by a customer, and addedUserListInfoto the audience targeting options inGenerateReachForecastRequest. This lets you retrieve plannable user lists for a given customer and then generate reach forecasts for campaigns targeting those specific audiences. These enhancements improve tailored reach planning by incorporating your first-party audience data directly into forecasting. Reach forecasting is available to allowlisted accounts only.
Видео
- Added
AdFormatType.PAUSEads served on organic YouTube videos on TV screens, which is included in reporting. These ads are displayed directly next to the static video frame on the pause screen. This does not include Demand Gen video ads displayed on the ad panel below or on top of a paused organic video, which are reported underAdFormatType.INFEED.
Archived release notes
See Sunsetted versions for archived release notes.