Google Ads API Version 23 Теперь Доступна

от

Google выпустила значительное обновление API Google Ads – версию 23. Этот релиз включает в себя множество улучшений, таких как детальная отчетность для кампаний Performance Max, показывающая, где отображалась ваша реклама, расширенные возможности для стимулов и больший контроль над отчетностью и конверсиями.

Купил акции на все деньги, а они упали? А Илон Маск снова написал твит? Знакомо. У нас тут клуб тех, кто пытается понять этот цирк и не сойти с ума.

Купить на падении (нет)

Google только что объявила о выпуске версии 23 Google Ads API. Это первое обновление 2026 года и сигнализирует о том, что Google будет выпускать обновления чаще в будущем.

Вот история выпусков, ведущая к текущей версии. Недавние версии включают 22 (15 октября 2025 г.), 21 (6 августа 2025 г.), 20 (5 июня 2025 г.), 19.1 (апрель 2025 г.) и 19 (февраль 2025 г.). До этого была версия 18 (октябрь 2024 г.), 17.1 (август 2024 г.), 17.0 (июнь 2024 г.), 16.1 и 16 (февраль 2024 г.). Если заглянуть ещё дальше, версия 15 была выпущена в октябре 2023 г., за ней последовала 14.1 в августе и 13.1 в апреле 2023 г. Версия 13 была выпущена в феврале 2023 г. Ещё более ранние выпуски включают версию 12.0 (октябрь 2022 г.), версию 11.0 (июнь 2022 г.) и 11.1 (август 2022 г.), а также версию 10.1 (27 апреля 2022 г.) и 10.0 (9 февраля 2022 г.). Обратите внимание, что AdWords API был выведен из эксплуатации и полностью прекратит функционирование в конце июля.

Вот примечания к выпуску:

Реклама:

  • Добавлено AD_SHARING_NOT_ALLOWED в AdGroupAdErrorEnum. Эта ошибка возвращается при попытке поделиться рекламой между несколькими группами объявлений, что больше не допускается.
  • Добавлены новые типы форматов в AdFormatType: TEXT, VERTICAL_ADS_BOOKING_LINK, VERTICAL_ADS_PROMOTION.
  • Удалена поддержка CallAd и CallAdInfo в v23. Подробнее см. https://support.google.com/google-ads/answer/6341403.

Assets:

  • Добавлены дополнительные метрики в отчёт asset_group: metrics.engagements, metrics.engagement_rate, metrics.average_cpe
  • Добавлены дополнительные метрики в отчёт asset_group_asset: metrics.average_cpe, metrics.average_cpm, metrics.trueview_average_cpv, metrics.video_trueview_view_rate, metrics.video_trueview_views, metrics.interaction_event_types
  • Добавлено поле только для чтения orientation к изображениям и видео активам в Asset.
  • Добавлена поддержка извлечения CampaignAsset с типом поля HEADLINE и DESCRIPTION.
  • Добавлены HEADLINE_AS_SITELINK_POSITION_ONE, HEADLINE_AS_SITELINK_POSITION_TWO, DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_ONE и DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_TWO в ServedAssetFieldType для активов, используемых в качестве сителинков.

Выставление счетов:

  • InvoiceService.ListInvoices теперь может возвращать более детализированную информацию в счете, включая разбивку затрат на уровне кампании, детализированные нормативные расходы и информацию о корректировках, установив include_granular_level_invoice_details в ListInvoicesRequest.
  • Добавлены RegulatoryFeeTypeEnum и UnitOfMeasureEnum.

Кампании:

  • Добавлены коды ошибок CampaignError.DURATION_TOO_LONG_FOR_TOTAL_BUDGET и CampaignError.END_DATE_TIME_REQUIRED_FOR_TOTAL_BUDGET.
  • Добавлены Campaign.start_date_time и Campaign.end_date_time для замены Campaign.start_date и Campaign.end_date, позволяющие указывать компоненты времени для определенных типов кампаний.

Изменения:

  • Добавлено YOUTUBE_FOLLOW_ON_VIEWS в ConversionActionCategory для отслеживания пользователей, которые посмотрели рекламу, а затем посмотрели видео с того же канала.

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

  • Добавлено поле companion_banner в DemandGenVideoResponsiveAdInfo.
  • Удалено поле lead_form_only из DemandGenMultiAssetAdInfo.

Стимулы:

  • Добавлена поддержка стимулов «Выбери свой» (CYO), позволяющая партнёрам программно получать и применять стимулы Google Ads для своих клиентов:
  • Метод FetchIncentive позволяет получить доступные стимулы для пользователя на основе страны, языка и, опционально, адреса электронной почты пользователя. Это может вернуть персонализированные варианты стимулов «Выбери свой» (CYO).
  • Метод ApplyIncentive позволяет применить выбранный пользователем стимул к конкретному аккаунту Google Ads.
  • Добавлен ресурс только для чтения AppliedIncentive, доступный для запроса через GoogleAdsService.Search и GoogleAdsService.SearchStream. Он предоставляет подробную информацию о погашенных стимулах, включая их статус, прогресс выполнения, суммы вознаграждения и соответствующие даты.
  • Добавлены новые коды ошибок в IncentiveErrorEnum для обработки проблем, связанных с получением или применением стимулов.
  • Добавлен INVALID_EMAIL_ADDRESS в AuthenticationErrorEnum.
  • Для обеспечения более детальной программной обработки сбоев мы добавим дополнительные коды ошибок в IncentivesService в будущих выпусках. Мы рекомендуем вам отслеживать предстоящие объявления и примечания к выпуску для этих новых кодов ошибок, чтобы убедиться, что ваши приложения могут управлять этими новыми режимами сбоев.

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

  • Добавлено LIFE_EVENT_USER_INTEREST в AudienceInsightsDimension. Это новое измерение позволяет пользователям создавать аудитории, используя Жизненные События, для следующих методов:
  • Ответ ReachPlanService.GenerateConversionRates теперь включает поверхности, позволяя предлагать различные коэффициенты конверсии в зависимости от элементов управления поверхностями (например, Gmail, Shorts). Это поддерживается только для кампаний Demand Gen.
  • Добавлено LanguageDistribution в YouTubeChannelInsights, предоставляющее распределение языка в контенте YouTube-канала.
  • Добавлено BenchmarksService для сравнения данных рекламы YouTube с отраслевыми бенчмарками.
  • Добавлено AudienceInsightsService.GenerateAudienceDefinition для преобразования текстового описания целевой аудитории в соответствующие атрибуты аудитории с использованием генеративного ИИ.
  • Добавлено YouTubeChannelInsights.relevance_score, которое оценивает, насколько релевантен создатель контента для темы, взвешенной по количеству просмотров.
  • Добавлено TrendInsightMetrics.trend_change_percent, которое представляет собой процентное изменение значения тренда за период сравнения.

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

  • Добавлено поле is_new_customer в GenerateRecommendationsRequest. При установке значения true для рекомендаций типа CAMPAIGN_BUDGET, генерируются рекомендации с использованием модели для новых клиентов. Это рекомендуется только для клиентов без кампаний.

Отчёты:

  • Метрики и сегментация: AdGroupAdAssetView и AdGroupAdAssetCombinationView теперь поддерживают метрики показов, эффективности и конверсий для RESPONSIVE_DISPLAY_AD.
  • Метрики и сегментация: Добавлен сегмент ad_sub_network_type для более детального анализа эффективности в рамках рекламной сети. Первоначально он доступен для кампаний DemandGen на YouTube (In-stream, In-feed, Shorts). Этот сегмент должен быть выбран вместе с ad_network_type.
  • Метрики и сегментация: Включена разбивка по типу рекламной сети для кампаний Performance Max.
  • Метрики и сегментация: UserLocationView и GeographicView теперь поддерживают метрики, сегментированные по дате конверсии:
  • Новые сегменты для вертикальной рекламы
  • Новые представления: Добавлено PerStoreView для запроса деталей местоположения магазина. Добавлено MatchedLocationInterestView для AI Max кампаний, предоставляющее метрики эффективности, разбитые по географическим местоположениям, в которых пользователи проявляли интерес.
  • Performance Max: Включена разбивка по типу рекламной сети для кампаний Performance Max.
  • Удаления: Удалены метрики агрегированной эффективности актива. Перечисление меток эффективности больше не возвращается для Search и Display.

Покупки:

  • ShoppingPerformanceView теперь поддерживает следующие метрики, сегментированные по дате конверсии: conversions_by_conversion_date, all_conversions_by_conversion_date, conversions_value_by_conversion_date, all_conversions_value_by_conversion_date, value_per_conversions_by_conversion_date, value_per_all_conversions_by_conversion_date.
  • ShoppingPerformanceView теперь поддерживает следующие соревновательные метрики: search_budget_lost_impression_share, search_rank_lost_impression_share, search_budget_lost_absolute_top_impression_share, search_rank_lost_absolute_top_impression_share.
  • Добавлен product_image_uri в ShoppingProduct.

Вертикальная реклама:

  • Добавлена настройка vertical_ads_format_setting в AdGroup для поисковых кампаний с использованием каналов передач данных о путешествиях, что позволяет контролировать, какие форматы рекламы могут показываться.
  • Добавлен тип критерия vertical_ads_item_group_rule_list в AdGroupCriterion. Добавлен vertical_ads_item_group_rule в SharedCriterion. Эти критерии позволяют таргетировать группы элементов в поисковых кампаниях с использованием каналов передач данных о путешествиях.
  • Теперь вы можете подключить канал передач данных вертикальной рекламы к поисковой кампании, работающей в режиме AI Max, чтобы показывать рекламу продвижения недвижимости и ссылки на бронирование путешествий вместе с вашими текстовыми объявлениями. На уровне группы объявлений вы можете контролировать, какие форматы показывать с помощью vertical_ads_format_setting, и определить набор правил групп элементов для таргетинга подмножества ваших сущностей из канала передач данных Vertical Ads. Кроме того, отчетность теперь может быть сегментирована как по AdFormatType, так и по измерениям из канала передач данных вертикальной рекламы.

Видео:

  • Добавлено поле ad_video_asset_feature_control в AdVideoAssetInfo.
  • Добавлен код ошибки INVALID_VIDEO_LINEUP_ID в CampaignCriterionError.
  • Добавлены метрики слышимости для аудиорекламы на YouTube, сообщающие, была ли реклама слышна и на скольких показах можно было измерить слышимость.

Смотрите также

2026-01-29 15:47