Представляем Google Ads API версии 24

Среда, 22 апреля 2026 г.

Сегодня мы выпускаем версию 24 Google Ads API. Чтобы использовать новые функции версии 24, необходимо обновить клиентские библиотеки и код клиента. Все обновленные клиентские библиотеки и примеры кода уже опубликованы.

Присоединяйтесь к нам на прямой трансляции этого выпуска в рамках мероприятия Google Ads API Release Highlights в Discord, Ads Developers YouTube Live или трансляции в LinkedIn завтра (23 апреля в 10:00 по восточному времени). Мы также запишем трансляцию и опубликуем ее на YouTube для тех, кто не сможет присоединиться к нам в прямом эфире. Если у вас есть вопросы или вы хотите обсудить эту запись, свяжитесь с нами в Discord на канале #ads-api.

Новые функции

Поддержка конверсий с данными корзины. Конверсии с данными корзины – это дополнительная функция отслеживания конверсий на сайте или в приложении, которая позволяет получать информацию о товарах, проданных в ходе каждой транзакции. Благодаря этому вы можете получать расширенные отчеты о продажах и прибыли, а также статистику для вашего аккаунта Google Рекламы и кампаний (данные о количестве заказов, среднем размере корзины, доходе и валовой прибыли).

В Google Ads API версии 24 поддержка этой функции реализована следующим образом:

  • Добавлен новый ресурс CartDataSalesView, который позволяет сегментировать показатели конверсий не только по товару, по которому был выполнен клик, но и по проданному товару, с помощью таких сегментов, как product_sold_brand. Они позволяют рекламодателям просматривать статистику по товарам, которые клиенты фактически купили после нажатия на объявления, даже если в объявлении рекламировался другой товар.
  • Добавлено несколько показателей без назначения ставок, которые включают конверсии, для которых ваши кампании не оптимизируются, например all_cost_of_goods_sold_micros. Новые показатели добавлены во все ресурсы, поддерживающие соответствующие показатели, доступные для назначения ставок.
  • В ресурс ShoppingPerformanceView добавлен сегмент conversion_attribution_event_type, который можно выбирать вместе с данными корзины и другими показателями конверсий. Этот сегмент показывает, связана ли конверсия с кликом или просмотром. Он необходим для распознавания данных корзины, полученных в результате конверсий по показам.

Обновленные функции

В версии 24 обновлены существующие функции, поэтому при переходе на нее потребуется изменить код. Ниже перечислены самые важные из них. Полный список изменений можно найти в примечаниях к выпуску.

Настройки исключенного видеоконтента в кампаниях. Мы упростили настройку исключенного видеоконтента в отдельных кампаниях. Эта настройка доступна на уровне клиента и применяется ко всем кампаниям. Настройки исключения контента позволяют более гибко управлять показом рекламы: вы можете исключать контент, который хотя и соответствует нашим правилам, но не подходит для вашего бренда. Подробнее https://support.google.com/google-ads/answer/7515513…

Изменения в AudienceInsightsService. В рамках рефакторинга кода мы переместили поле запроса InsightsAudience.topic_audience_combinations в пространство имен common. В некоторых языках программирования может потребоваться обновить директивы импорта.

Изменения в ReachPlanService. В рамках рефакторинга кода мы перенесли поле youtube_select_lineups из сервиса ReachPlanService.ListPlannableProducts. Подборки теперь доступны в поле youtube_select_lineup_targeting. Подборки YouTube Select – это продукт с резервированием, который дает доступ к 1 % самых популярных каналов на YouTube. Это позволяет охватить наиболее вовлеченную аудиторию зрителей. Подробнее…

Изменения в ContentCreatorInsightsService. В рамках рефакторинга кода мы удалили поле is_brand_connect_creator из сервисов ContentCreatorInsightsService.GenerateCreatorInsights и ContentCreatorInsightsService.GenerateTrendingInsights.
Вместо этого пользователям следует искать автора, у которого доступен параметр CREATOR_PARTNERSHIPS в partnership_opportunities. "Коллаборации на YouTube" в Google Рекламе – это раздел, где можно находить авторов YouTube для сотрудничества при создании рекламного контента и эффективно управлять партнерскими отношениями. Подробнее…

Изменения в KeywordPlanIdeaService. Чтобы повысить удобство и надежность, мы объединили инфраструктуру прогнозирования. В Google Ads API версии 24 представлен обновленный метод GenerateKeywordForecastMetrics, который упрощает процесс планирования, фокусируясь на показателях, которые наиболее непосредственно влияют на вашу эффективность. В ближайшие дни мы опубликуем запись в блоге с подробной информацией об этом изменении.

Изменения в ресурсе campaign_budget. Мы удалили сегмент ad_sub_network_type для ресурса campaign_budget, поскольку он несовместим с этим представлением.

Изменения в представлениях объектов. Мы удалили сегмент click_type из представлений ad_group_asset, campaign_asset и customer_asset. Это изменение соответствует недавнему изменению продукта, в результате которого этот сегмент был удален из Google Рекламы, чтобы избежать искажения данных. Вы можете использовать сегментацию click_type из ресурса ad_group_ad, чтобы получить подробные сведения об эффективности объявления и объекте, с которым оно было показано.

Изменения в адаптивном видеообъявлении: VideoResponsiveAdInfo теперь можно отключить. В рамках этого изменения мы пометили поля videos, business_name и logo_images как обязательные в объектах DemandGenVideoResponsiveAdInfo и VideoResponsiveAdInfo.

Изменения в ShareablePreviewService. В ShareablePreviewService.GenerateShareablePreviews больше не используется частичная ошибка. Если запрос не удастся выполнить для какого-либо идентификатора, появится сообщение об ошибке. Подробнее…

Следующие ресурсы помогут вам начать работу:

Если у вас возникли технические проблемы, обратитесь в службу поддержки: https://support.google.com/google-ads/contact/google_ads_api.

Портрет автора – , Google Ads API Team

Ярлыки: google-ads-api, release