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
, показывающий типы фидов, привязанных к кампании. Для кампаний с максимальной эффективностью это может указывать на вертикаль бизнеса, например,MERCHANT_CENTER_FEED
для розничной торговли. - Разрешено прикреплять общие наборы
NEGATIVE_KEYWORDS
к кампаниямMULTI_CHANNEL
(для кампаний приложений) иLOCAL
.
Генерация спроса
- Добавлена стратегия назначения ставок TargetCPC для кампаний Demand Gen. Эта стратегия устанавливает ставки для максимального количества кликов по заданной целевой цене за клик (CPC).
- Установите целевую цену за клик на уровне кампании с помощью
Campaign.target_cpc
. - Переопределить на уровне группы объявлений с помощью
AdGroup.target_cpc_micros
.
- Установите целевую цену за клик на уровне кампании с помощью
- Добавлен новый
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
для кампаний с максимальной эффективностью. - Функциональность удаленного
Campaign.url_expansion_opt_out
теперь управляется настройкойAssetAutomationType
FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION
вAssetAutomationSetting
. - Добавлены новые сегменты для кампаний с максимальной эффективностью. Каждый из этих сегментов доступен только для кампаний с максимальной эффективностью и не будет возвращать данные при выборе любого другого типа кампании.
-
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, чтобы показать, является ли источник данных списка пользователей CRMFIRST_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
, а также более сложные комбинации И/ИЛИ тем и аудиторий.
Отчеты
- Добавлены два новых типа кликов:
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 for Search Campaigns. Добавлены новые сегменты для кампаний PMax. См. обновления 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 for Search кампаний. AI Max for Search кампании расширяют охват поисковой кампании за счет сопоставления поисковых запросов и позволяют контролировать, будут ли отображаться элементы управления таргетингом и креативами при их установке. Элементы управления автоматизацией текстовых ресурсов и списком брендов, установленные в запросах предыдущей версии, будут по-прежнему учитываться до тех пор, пока AI Max for Search кампании не будут явно отключены.Campaign.ai_max_setting.bundling_required
можно использовать для определения того, нужно ли включать AI Max for Search кампании для соблюдения или изменения автоматизации текстовых ресурсов и элементов управления списком брендов.AdGroup.ai_max_ad_group_setting.disable_search_term_matching
можно использовать для отключения сопоставления поисковых запросов, если в родительской кампании включены кампании AI Max for Search. См. публикацию в нашем блоге Откройте для себя новый уровень эффективности с помощью кампаний AI Max for Search .Добавлена
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
для отчёта об эффективности комбинаций поисковых запросов, заголовков и целевых страниц. Это представление показывает, какие поисковые запросы запускали показ ваших объявлений и как эти комбинации были эффективны. В будущем выпуске будет добавлено дополнительное представление, которое также будет включать данные по максимальной эффективности. Если вы не хотите переносить свою реализацию для получения данных по максимальной эффективности, дождитесь этого выпуска.Добавлено
AI_MAX
в качестве нового значения для сегментаsearch_term_match_type
.
Ресурсы
Добавлены поля
terms_and_conditions_text
,terms_and_conditions_uri
,promotion_barcode_info
иpromotion_qr_code_info
вPromotionAsset
. Поля штрихкода и QR-кода находятся в атрибутеpromotion_trigger
oneof . См. статью Справочного центра «Об активах для продвижения» .Добавлен
FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION
вAssetAutomationTypeEnum
. С помощью этого параметра вы можете управлять автоматической генерацией текстовых ресурсов и целевых страниц из конечного URL в поисковых кампаниях.Добавлен новый сервис
AutomaticallyCreatedAssetRemovalService.RemoveCampaignAutomaticallyCreatedAsset
для удаления автоматически созданных ресурсов изCampaign
. Этот сервис поддерживает удаление только ресурса расширения конечного URL.Добавлен
DESCRIPTION_PREFIX
в перечислениеServedAssetFieldType
. Это устраняет проблему, из-за которойserved_asset_field_type
вad_group_ad_asset_combination_view
былUNKNOWN
для активов, служивших префиксом описания.
Кампании
Добавлено новое значение перечисления
MISSING_LOCATION_TARGETING
вCampaignPrimaryStatusReason
. Эта новая причина статуса будет возвращаться только для кампаний с ограничением по местоположению, в которых не указан таргетинг по местоположению. В кампаниях с ограничением по местоположению любая попытка добавить таргетинг по местоположению за пределами разрешенной области приведет к ошибке критерия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
. Для запросов с включённым частичным сбоем будет возвращатьсяLISTING_GROUP_ERROR_IN_ANOTHER_OPERATION
вместоINVALID_LISTING_GROUP_HIERARCHY
.Добавлен новый ресурс
LocationInterestView
, который суммирует эффективность критериев интереса к местоположению группы объявлений.
Конверсии
Добавлено
ENGAGED_VIEW
как новое значение для сегментаconversion_attribution_event_type
.Клиенты больше не будут иметь доступа к режиму
debug_enabled
вConversionUploadService
. Это поле, если установлено вTRUE
, ранее использовалось для различения ошибокCLICK_NOT_FOUND
иSUCCESS
для расширенного отслеживания конверсий при импорте лидов.
Генерация спроса
- Добавлен код ошибки
CampaignBudgetError.BUDGET_BELOW_DAILY_MINIMUM
. В будущем эта ошибка будет возвращаться при попытке установить очень низкий размер бюджета для кампании Demand Gen. Подробную информацию о требуемом минимальном бюджете можно найти в новом поле сведений об ошибкеbudgetDailyMinimumErrorDetails
.
Изменения в политической рекламе в ЕС
Эти изменения в политической рекламе ЕС также были внесены в версии v19.2 и v20.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
в качестве нового значения для сегмента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
.Обновлён тип данных аудитории на
InsightsAudience
дляAudienceInsightsService.GenerateTargetingSuggestionMetrics
. Новый тип данных аудитории позволяет комбинировать интересы пользователей по принципу «И-ИЛИ», поддерживая потенциальные метрики охвата для более точного определения аудитории.В
TrendInsightMetrics
добавлен показатель доли аудитории для получения информации о доле аудитории, соответствующей тренду.Добавлены новые связанные категории в
KnowledgeGraphAttributeMetadata
, чтобы пользователи могли фильтровать атрибуты Knowledge Graph по категориям.
Отчеты
Теперь для
AssetGroupAsset
,ChannelAggregateAssetView
иCampaignAggregateAssetView
доступен ряд новых метрик. Кроме того, дляChannelAggregateAssetView
иCampaignAggregateAssetView
impressions
, который ранее обнулялся для кампаний с максимальной эффективностью, теперь будет отображать своё истинное значение.Ресурс
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
, который можно выбрать в представлении ключевых слов.Добавлена поддержка метрик для уникальных кластеров намерений запроса с:
Добавлен новый тип клика
VEHICLE_ASSETS
в сегментациюclick_view
для отслеживания и составления отчетов по кликам, связанным с форматами объявлений, относящимися к активам транспортных средств.
Исследование интеллектуальных ставок для стратегий целевой рентабельности инвестиций в рекламу в поиске
Теперь вы можете включить Smart Bidding Exploration в поисковых кампаниях, установив поле
target_roas_tolerance_percent_millis
в стратегиях назначения ставокMaximizeConversionValue
иTargetRoas
на любое значение, кратное 1000, в диапазоне от 10 000 (10%) до 30 000 (30%) включительно. Для стратегий назначения ставокMaximizeConversionValue
также потребуется задать полеtarget_roas
.TargetRoas.target_roas_tolerance_percent_millis
доступен только для портфельных стратегий. См. публикацию в нашем блоге об Smart Bidding Exploration и статью в справочном центре.Агрегированная отчётность по разнообразию теперь поддерживается для следующих показателей для кластеров уникальных запросов. В интерфейсе Google Рекламы доступен сегментированный по времени просмотр.
Видео
Добавлен
YouTubeVideoListAsset
. Также добавленAsset#youtube_video_list_asset
, который можно использовать для создания связи междуcampaign
и типомYouTubeVideoListAsset
. См. статью Справочного центра « Использование похожих видео» .Добавлены новые поля метаданных в
YouTubeChannelInsights
иYouTubeVideoAttributeMetadata
.Открыты новые типы кликов:
VIDEO_RELATED_VIDEOS_CLICK
,VIDEO_CHANNEL_CLICK
иPRODUCT_ASSETS
.Добавлено поле
allow_non_skippable_in_stream
вVideoAdInventoryControl
, позволяющее использовать адаптивные видеообъявления в качестве in-stream-объявлений без возможности пропуска. Эта опция доступна для кампаний, поддерживающих сочетание формата без возможности пропуска с другими форматами.Добавлены поля
Campaign.VideoCampaignSettings.video_ad_sequence
иAdGroup.VideoAdGroupSettings.VideoAdSequenceStepSetting
(только для чтения). См. статью Справочного центра «О последовательном показе видеорекламы» .Добавлены новые поля метаданных в
YouTubeChannelInsights
иYouTubeVideoAttributeMetadata
.Добавлены тип критерия
VIDEO_LINEUP
и полеvideo_lineup
вCampaignCriterion
иAdGroupCriterion
. Эта функция доступна только для аккаунтов из белого списка. За подробностями обращайтесь к своему представителю отдела развития бизнеса Google.Добавлен отчёт о пригодности контента как для детализации , так и для группового уровня. См. статью в Справочном центре «Об отчёте о пригодности контента» .
v20.1 (06.08.2025)
Эти изменения в политической рекламе ЕС также были внесены в версии v19.2 и v21 .
Изменения в политической рекламе в ЕС
Добавлено поле
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
Кампании
- Добавлена поддержка добавления и обновления минус-слов на уровне кампании для кампаний с максимальной эффективностью.
Конверсии
Теперь вы можете обновить поле
google_ads_conversion_customer
для существующего клиента, чтобы включить отслеживание конверсий между аккаунтами или изменить его существующий родительский аккаунт отслеживания конверсий на другой управляющий аккаунт.Добавлено поле
ClickConversion.user_ip_address
. Google Реклама не поддерживает сопоставление IP-адресов конечных пользователей в Европейской экономической зоне (ЕЭЗ), Великобритании (UK) и Швейцарии (CH). Добавьте логику, чтобы условно исключить предоставление IP-адресов пользователями из этих регионов. Обязательно предоставляйте пользователям чёткую и полную информацию о данных, которые вы собираете на своих сайтах, в приложениях и других ресурсах, и получайте их согласие, если это требуется законом или применимыми политиками Google. Подробнее см. на странице «Об импорте офлайн-конверсий» .
Генерация спроса
- Добавлены новые значения в сегмент
ad_network_type
, которые позволяют сегментировать кампании Demand Gen по каналу:-
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
-
cost_per_platform_comparable_conversion
-
value_per_platform_comparable_conversion
-
value_per_platform_comparable_conversions_by_conversion_date
-
cost_converted_currency_per_platform_comparable_conversion
-
Рекомендации
- Добавлена поддержка
ShoppingSetting
во время построения кампании при использованииGenerateRecommendationsRequest
. - Добавлено поле
merchant_center_account_id
вGenerateRecommendationsRequest
чтобы указать, когда следует генерировать рекомендации для розничной торговли, а не для стандартных кампаний Performance Max.
Планирование
- Добавлен
AudienceInsightsDimension.YOUTUBE_LINEUP
для заменыAudienceInsightsDimension.YOUTUBE_DYNAMIC_LINEUP
вAudienceInsightsService
иContentCreatorInsightsService
. Этот новый параметр позволяет получать статистику и метаданные для подборок YouTube Select (YTS). Заменены объекты, связанные сYOUTUBE_DYNAMIC_LINEUP
, такие какDynamicLineupAttributeMetadata
иAudienceInsightsDynamicLineup
, в соответствии с более широким удалением динамических подборок в Google Рекламе. Эта функция доступна только для аккаунтов из белого списка. - Добавлены
AdditionalApplicationInfo
иApplicationInstance
вAudienceInsightsService
,ContentCreatorInsightsService
иReachPlanService
. Эта функция доступна только для учётных записей из разрешённого списка. -
AudienceInsightsService
иContentCreatorInsightsService
обновлены для предоставления более подробной аналитики. Теперь вы можете сегментировать данные о создателях контента по устройствам, используя новые параметрыAudienceInsightsDimension.DEVICE
иAudienceInsightsAttribute.device
в обоих сервисах. Эта функция доступна только для учётных записей из белого списка. - В
GenerateCreatorInsightsResponse
добавлены дополнительные агрегированные метрики видео для более полного анализа создателей контента:engagement_rate
,average_views_per_video
,average_likes_per_video
,average_shares_per_video
,average_comments_per_video
,shorts_views_count
,shorts_video_count
иis_brand_connect_creator
. Эта функция доступна только для учётных записей из белого списка. - Добавлен
sub_country_locations
вGenerateCreatorInsightsRequest
дляContentCreatorInsightsService
. Это позволяет указывать географические регионы для уточнения поиска информации об авторах. Полеsub_country_locations
поддерживается только при использовании параметраsearch_attributes
oneof в полеcriteria
. Еслиsub_country_locations
указан с другими типами критериев, запрос будет недействительным. Это обеспечивает более детальный географический таргетинг и анализ информации об авторах. Эта функция доступна только для учетных записей из белого списка. - Добавлен
ReachPlanService.ListPlannableUserLists
, который возвращает списки собственных пользователей, принадлежащих клиенту, а также добавленUserListInfo
к параметрам таргетинга аудитории вGenerateReachForecastRequest
. Это позволяет получать списки планируемых пользователей для конкретного клиента, а затем генерировать прогнозы охвата для кампаний, ориентированных на эти аудитории. Эти улучшения улучшают индивидуальное планирование охвата, включая данные о собственных пользователях непосредственно в прогнозирование. Прогнозирование охвата доступно только для учетных записей из белого списка.
Видео
- Добавлены объявления
AdFormatType.PAUSE
, показываемые в органических видеороликах YouTube на телевизорах, что учитывается в отчётности. Эти объявления отображаются непосредственно рядом со статическим видеокадром на экране паузы. Это не относится к видеорекламе Demand Gen, показываемой на рекламной панели ниже или поверх приостановленного органического видео, что учитывается в отчётностиAdFormatType.INFEED
.
v19.2 (06.08.2025)
Эти изменения в политической рекламе ЕС также были внесены в версии v20.1 и v21 .
Изменения в политической рекламе в ЕС
Добавлено поле
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
, если кампании эксперимента не указали самостоятельно, содержат ли они политическую рекламу, нацеленную на Европейский союз.
v19.1 (16.04.2025)
В версии 19.1 были добавлены следующие функции и изменения.
Ресурсы
- Добавлено поле
asset_coverage
дляAssetGroup
, которое возвращает информацию о пробелах в вашей группе активов .- Содержит подполе
ad_strength_action_items
, которое возвращает список действий, которые рекламодатель может предпринять для повышения эффективности рекламы группы активов.
- Содержит подполе
Кампании
- Теперь вы можете оценивать лиды в кампаниях местных услуг или оставлять отзывы. В рамках этого изменения, версия 19.1
- Добавлен новый сервис
LocalServicesLeadService
. Вы можете использовать методProvideLeadFeedback
для загрузки рейтинга и отзывов о лидах. - Добавлено новое поле
lead_feedback_submitted
вLocalServicesLead
, которое поможет определить, был ли отправлен отзыв лиду.
- Добавлен новый сервис
- Добавлен новый столбец показателей
biddable_cohort_app_post_install_conversions
для кампаний приложений.
Генерация спроса
- В службы планирования были введены дополнительные методы для поддержки Demand Gen.
Добавлена поддержка управления каналами на уровне AdGroup для кампаний Demand Gen. Вы можете выбрать предопределенную общую группу каналов или подмножество каналов с помощью поля
demand_gen_ad_group_settings
. В текущей версии поддерживаются следующие каналы :- YouTube In-Stream
- YouTube In-Feed
- YouTube Shorts
- Обнаружить
- Gmail
- Отображать
Добавлен новый тип актива для
TALL_PORTRAIT_MARKETING_IMAGE
. Этот тип актива относится к полюtall_portrait_marketing_images
формата Demand Gen Multi Asset Ad .
История изменений
- Добавлена поддержка еще трех типов ресурсов в ChangeStatusResourceType :
-
CAMPAIGN_BUDGET
-
ASSET_SET
-
CAMPAIGN_ASSET_SET
-
- Эти три более детализированных типа можно получить из отчета
change_status
.
Конверсии
Теперь вы можете задать поле
google_ads_conversion_customer
при создании нового клиента через API Google Ads. Ранее это поле было доступно только для чтения.ПРИМЕЧАНИЕ: Эта функция находится в закрытом списке разрешенных. Чтобы воспользоваться ею, обратитесь к своему менеджеру аккаунта.
Теперь при загрузке офлайн-конверсий можно указать тип клиента, связанного с конверсией.
Для
ClickConversion
введено новое полеsession_attributes
.
Реклама местных услуг
- Добавлен новый RPC
ProvideLeadFeedback
вLocalServicesLeadService
для предоставления отзывов о качествеLocalServicesLead
. - Добавлено новое поле
lead_feedback_submitted
в ресурсLocalServicesLead
, которое подтверждает, был ли предоставлен отзыв для определенного ресурса.
Планирование услуг
- Добавлена поддержка ежемесячных прогнозов целевой частоты в
ReachPlanService.GenerateReachForecast
.- Разработчики могут задать
TargetFrequencyTimeUnit.MONTHLY
вTargetFrequencySettings
при использовании планируемого кода продуктаTARGET_FREQUENCY
для создания прогноза ежемесячного охвата целевой частоты.
- Разработчики могут задать
- Добавлен новый метод
ReachPlanService.GenerateConversionRates
, который позволяет рекламодателям запрашивать рекомендуемые коэффициенты конверсии для поддерживаемых планируемых продуктов. - Прогнозирование спроса в
ReachPlanService.GenerateReachForecast
:- Разработчики теперь могут запрашивать прогнозы охвата для кампаний Demand Gen. Разработчики могут использовать новый планируемый код продукта
DEMAND_GEN_MAX_CONVERSIONS
для создания прогнозов охвата Demand Gen. - Добавлено новое поле
conversion_rate
, позволяющее разработчикам, запрашивающим прогнозы охвата Demand Gen, предоставлять коэффициент конверсии. Предлагаемые коэффициенты конверсии можно получить с помощью нового методаReachPlanService.GenerateConversionRates
. Это поле обязательно для запросов прогнозирования Demand Gen. Оно не поддерживается для других планируемых продуктов. - Добавлено новое поле
conversions
для возвращаемых прогнозов. Это поле содержит количество конверсий в заданной точке кривой охвата. Конверсии поддерживаются только для планируемого продуктаDEMAND_GEN_MAX_CONVERSIONS
.
- Разработчики теперь могут запрашивать прогнозы охвата для кампаний Demand Gen. Разработчики могут использовать новый планируемый код продукта
Рекомендации
Новое поле
ad_strength
доступно дляImprovePerformanceMaxAdStrengthRecommendation
, которое возвращает текущий показатель силы объявления группы активов, связанной с рекомендацией.Покупки
Теперь вы можете переопределять исключения брендов для товарных объявлений в кампаниях с максимальной эффективностью. Это реализовано через новое поле
pmax_campaign_settings
на уровне кампании и работает только для кампаний PMax для розничной торговли . При попытке установить это поле для несовместимого типа кампании возникнет новая ошибкаCampaignError.BRAND_TARGETING_OVERRIDES_NOT_SUPPORTED
Видео
- Добавлена поддержка аудиорекламы только для чтения. Подробнее об этой функции см. в Справочном центре Google Рекламы . Это изменение раскрывает:
- Новый
AdvertisingChannelSubType
с названиемYOUTUBE_AUDIO
. - Новый
AdGroupType
с именемYOUTUBE_AUDIO
. - Новое перечисление форматов рекламы с именем
YOUTUBE_AUDIO_AD
и соответствующие ему поляYouTubeAudioAdInfo
.
- Новый
- Добавлены новые метрики и сегменты для запроса метрик охвата с корректировкой демо-версии. В рамках этих изменений
- Были введены два новых столбца показателей:
coviewed_impressions
иprimary_impressions
. - Были введены два новых сегмента:
adjusted_age_range
иadjusted_gender
. - Если какой-либо из двух новых сегментов выбран вместе с полем метрики охвата (
coviewed_impressions
,primary_impressions
,unique_users
илиaverage_impression_frequency_per_user
), необходимо также выбрать другой сегмент, чтобы получить допустимую статистику для этих столбцов. - В настоящее время эта функция доступна только для клиентов из разрешенного списка.
- Были введены два новых столбца показателей:
v19 (26.02.2025)
В версии 19 были добавлены следующие функции и изменения.
Инструкции см. в разделе Обновление до последней версии .
Управление счетами
- Added the following values to
CustomerError
to account for upcoming changes:-
CREATION_DENIED_FOR_POLICY_VIOLATION
-
CREATION_DENIED_INELIGIBLE_MCC
-
Реклама
- Added
DemandGenMultiAssetAdInfo.tall_portrait_marketing_images
to support portrait image assets with aspect ratio 9:16 in Demand Gen ads.
Ресурсы
- (For allowlisted accounts only) Added support for message assets through
Asset.business_message_asset
,BusinessMessageAsset
and the following enums and errors.- Enums:
- Added
AssetAutomationType.GENERATE_LANDING_PAGE_PREVIEW
to support automatically generating a landing page preview. -
AssetAutomationType.GENERATE_SHORTER_YOUTUBE_VIDEOS
is now opted-in by default for Demand Gen video responsive ads . - (For allowlisted accounts only; allowlist is currently closed) Added
Asset.app_deep_link_asset
andAppDeepLinkAsset
.
Конверсии
- Цели конверсии
-
LifecycleGoalValueSettings.high_lifetime_value
is out of beta and now mutable. - Added
CustomerLifecycleGoal.owner_customer
to show the resource name of the customer which owns the customer lifecycle goal.
-
- Deprecated
ConversionActionType.SALESFORCE
.
Ленты
- Removed all feed-related entities, such as
Feed
,FeedMapping
,FeedService
,AdGroupFeed
,feed_placeholder_view
, etc. Users should now useassets
to achieve the same purpose.
Отель и путешествия
- Made
min_days
andmax_days
ofValueRuleItineraryAdvanceBookingWindow
anoptional
field to allow specifying 0 as a value. This supports targeting for travel searches that happen today.
Максимальная производительность
- (For allowlisted accounts only) Brand guidelines
- Made
Campaign.brand_guidelines_enabled
mutable only when creating a Performance Max campaign. - This is incompatible with Performance Max for travel goals .
- To enable brand guidelines for existing Performance Max campaigns, use a newly added
CampaignService.EnablePMaxBrandGuidelines
. Disabling brand guidelines is not supported. - Added
Campaign.brand_guidelines
andBrandGuidelines
to allow setting the brand's colors and font family. - New error values:
-
BatchJobError.CAMPAIGN_AND_CAMPAIGN_ASSET_TRANSACTION_FAILURE
-
BrandGuidelinesMigrationError
-
BRAND_GUIDELINES_ALREADY_ENABLED
-
CANNOT_ENABLE_BRAND_GUIDELINES_FOR_REMOVED_CAMPAIGN
-
BRAND_GUIDELINES_LOGO_LIMIT_EXCEEDED
-
CANNOT_AUTO_POPULATE_BRAND_ASSETS_WHEN_BRAND_ASSETS_PROVIDED
-
AUTO_POPULATE_BRAND_ASSETS_REQUIRED_WHEN_BRAND_ASSETS_OMITTED
-
TOO_MANY_ENABLE_OPERATIONS
-
-
CampaignError
-
BRAND_GUIDELINES_NOT_ENABLED_FOR_CAMPAIGN
-
BRAND_GUIDELINES_MAIN_AND_ACCENT_COLORS_REQUIRED
-
BRAND_GUIDELINES_COLOR_INVALID_FORMAT
-
BRAND_GUIDELINES_UNSUPPORTED_FONT_FAMILY
-
BRAND_GUIDELINES_UNSUPPORTED_CHANNEL
-
CANNOT_ENABLE_BRAND_GUIDELINES_FOR_TRAVEL_GOALS
-
CUSTOMER_NOT_ALLOWLISTED_FOR_BRAND_GUIDELINES
- Made
- Added
AssetAutomationType.GENERATE_ENHANCED_YOUTUBE_VIDEOS
to support automatically generating enhanced video assets for Performance Max campaigns.
Планирование
- (For allowlisted accounts only) Added
ContentCreatorInsightsService.GenerateTrendingInsights
which allows users to see trending content topics on YouTube for given audience definitions. - Added
GenerateCreatorInsightsRequest.country_locations[]
to specify countries to search for the given criteria - Added
GenerateCreatorInsightsRequest.search_brand
to specify a brand to search for creators - Added new fields to
YouTubeChannelInsights
to provide additional channel information forsearch_channels
requests:-
channel_url
-
channel_description
-
top_videos
-
- Added new metadata fields to
AudienceInsightsAttributeMetadata
:-
youtube_video_metadata
-
user_interest_attribute_metadata
-
knowledge_graph_attribute_metadata
-
Видео
- Following the release of
DataLinkService.CreateDataLink
, we added the following methods to allow for mutating previously created data links:-
RemoveDataLink
for removing data links in a Google Ads account -
UpdateDataLink
for accepting, rejecting and revoking data links in a Google Ads account
-
- Removed support for
VIDEO_OUTSTREAM
from the following enums:
Archived release notes
See Sunsetted versions for archived release notes.