Примечания к выпуску

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 для отслеживания и составления отчетов по кликам, связанным с форматами объявлений, относящимися к активам транспортных средств.

Видео

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 .

Столбцы показателей

Сегментные столбцы

Кампании

Конверсии

  • Теперь вы можете обновить поле google_ads_conversion_customer для существующего клиента, чтобы включить отслеживание конверсий между аккаунтами или изменить его существующий родительский аккаунт отслеживания конверсий на другой управляющий аккаунт.

  • Добавлено поле ClickConversion.user_ip_address . Google Реклама не поддерживает сопоставление IP-адресов конечных пользователей в Европейской экономической зоне (ЕЭЗ), Великобритании (UK) и Швейцарии (CH). Добавьте логику, чтобы условно исключить предоставление IP-адресов пользователями из этих регионов. Обязательно предоставляйте пользователям чёткую и полную информацию о данных, которые вы собираете на своих сайтах, в приложениях и других ресурсах, и получайте их согласие, если это требуется законом или применимыми политиками Google. Подробнее см. на странице «Об импорте офлайн-конверсий» .

Генерация спроса

Рекомендации

  • Добавлена ​​поддержка 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 были добавлены следующие функции и изменения.

Ресурсы

Кампании

Генерация спроса

История изменений

  • Добавлена ​​поддержка еще трех типов ресурсов в 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 .

Рекомендации

Видео

  • Добавлена ​​поддержка аудиорекламы только для чтения. Подробнее об этой функции см. в Справочном центре 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 были добавлены следующие функции и изменения.

Инструкции см. в разделе Обновление до последней версии .

Управление счетами

  • Добавлены следующие значения в CustomerError для учета предстоящих изменений:
    • CREATION_DENIED_FOR_POLICY_VIOLATION
    • CREATION_DENIED_INELIGIBLE_MCC

Реклама

Ресурсы

Конверсии

  • Цели конверсии
  • Устаревший ConversionActionType.SALESFORCE .

Ленты

  • Удалены все сущности, связанные с фидами, такие как Feed , FeedMapping , FeedService , AdGroupFeed , feed_placeholder_view и т. д. Теперь пользователи должны использовать assets для достижения той же цели.

Отель и путешествия

  • Параметры min_days и max_days для ValueRuleItineraryAdvanceBookingWindow теперь optional , что позволяет указать значение 0. Это поддерживает таргетинг для поисков поездок, которые выполняются сегодня.

Максимальная производительность

  • (Только для разрешенных учетных записей) Правила бренда
  • Добавлен AssetAutomationType.GENERATE_ENHANCED_YOUTUBE_VIDEOS для поддержки автоматического создания расширенных видеоресурсов для кампаний с максимальной эффективностью.

Планирование

  • (Только для учетных записей из разрешенного списка) Добавлен ContentCreatorInsightsService.GenerateTrendingInsights , который позволяет пользователям просматривать популярные темы контента на YouTube для заданных определений аудитории.
  • Добавлен GenerateCreatorInsightsRequest.country_locations[] для указания стран для поиска по заданным критериям.
  • Добавлен GenerateCreatorInsightsRequest.search_brand для указания бренда для поиска создателей.
  • Добавлены новые поля в YouTubeChannelInsights для предоставления дополнительной информации о канале для запросов search_channels :
    • channel_url
    • channel_description
    • top_videos
  • Добавлены новые поля метаданных в AudienceInsightsAttributeMetadata :
    • youtube_video_metadata
    • user_interest_attribute_metadata
    • knowledge_graph_attribute_metadata

Видео

  • После выпуска DataLinkService.CreateDataLink мы добавили следующие методы, позволяющие изменять ранее созданные ссылки на данные:
    • RemoveDataLink для удаления ссылок на данные в аккаунте Google Ads
    • UpdateDataLink для принятия, отклонения и отзыва ссылок на данные в аккаунте Google Ads
  • Удалена поддержка VIDEO_OUTSTREAM из следующих перечислений:

Архивные заметки о выпуске

Архивные заметки о выпуске см. в разделе «Устаревшие версии» .