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теперь управляется настройкойAssetAutomationTypeFINAL_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_triggeroneof . См. статью Справочного центра «Об активах для продвижения» .Добавлен
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иCampaignAggregateAssetViewimpressions, который ранее обнулялся для кампаний с максимальной эффективностью, теперь будет отображать своё истинное значение.Ресурс
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_attributesoneof в поле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
CustomerErrorto account for upcoming changes:-
CREATION_DENIED_FOR_POLICY_VIOLATION -
CREATION_DENIED_INELIGIBLE_MCC
-
Реклама
- Added
DemandGenMultiAssetAdInfo.tall_portrait_marketing_imagesto 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,BusinessMessageAssetand the following enums and errors.- Enums:
- Added
AssetAutomationType.GENERATE_LANDING_PAGE_PREVIEWto support automatically generating a landing page preview. -
AssetAutomationType.GENERATE_SHORTER_YOUTUBE_VIDEOSis now opted-in by default for Demand Gen video responsive ads . - (For allowlisted accounts only; allowlist is currently closed) Added
Asset.app_deep_link_assetandAppDeepLinkAsset.
Конверсии
- Цели конверсии
-
LifecycleGoalValueSettings.high_lifetime_valueis out of beta and now mutable. - Added
CustomerLifecycleGoal.owner_customerto 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 useassetsto achieve the same purpose.
Отель и путешествия
- Made
min_daysandmax_daysofValueRuleItineraryAdvanceBookingWindowanoptionalfield 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_enabledmutable 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_guidelinesandBrandGuidelinesto 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_VIDEOSto support automatically generating enhanced video assets for Performance Max campaigns.
Планирование
- (For allowlisted accounts only) Added
ContentCreatorInsightsService.GenerateTrendingInsightswhich 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_brandto specify a brand to search for creators - Added new fields to
YouTubeChannelInsightsto provide additional channel information forsearch_channelsrequests:-
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:-
RemoveDataLinkfor removing data links in a Google Ads account -
UpdateDataLinkfor accepting, rejecting and revoking data links in a Google Ads account
-
- Removed support for
VIDEO_OUTSTREAMfrom the following enums:
Archived release notes
See Sunsetted versions for archived release notes.