Google Ads API Version 22 теперь доступен.

от

Google недавно запустила версию 22 своего Google Ads API, значительное обновление с многочисленными улучшениями. Ключевые изменения включают расширенные возможности для Smart Bidding, улучшения кампаний DemandGen и Performance Max (PMax), а также обновления кампаний App, предназначенные для увеличения установок, среди прочего.

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

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

Google объявила, что для использования новейших функций в версии 22 вам потребуется обновить свои программные библиотеки и код, который их использует. Они уже выпустили все обновленные библиотеки и примеры, чтобы помочь вам в этом.

Вот история последних релизов. Текущая версия следует за 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 г.). Релизы в 2022 году включали 12.0 (октябрь), 11.0 (июнь) и 11.1 (август), а также 10.1 (27 апреля) и 10.0 (9 февраля). Наконец, AdWords API был прекращён и полностью перестанет работать в конце июля.

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

Активы:

  • Добавлен LANDING_PAGE_PREVIEW как новый тип поля для изображений активов.
  • Представлен AssetGenerationService (Бета): Этот сервис позволяет генерировать текстовые и графические активы с использованием генеративного ИИ. Этот сервис изначально доступен только ограниченному числу участников закрытой бета-версии. GenerateText: Генерирует текст на основе входных данных, таких как конечный URL, произвольные подсказки, ключевые слова и существующий контекст кампании. GenerateImages: Генерирует изображения на основе входных данных, таких как конечный URL, произвольные подсказки, существующий контекст кампании или путем переконтекстуализации существующих изображений продуктов. Ошибки при генерации активов возвращаются с кодами из AssetGenerationErrorEnum.

Кампании:

  • Добавлены новые цели назначения ставок для кампаний приложений для установок (ACi) для оптимизации без указания целевого показателя, полезно для быстрого масштабирования или когда определение правильного целевого показателя затруднительно. В AppCampaignBiddingStrategyGoalType:
  • Добавлена поддержка типа стратегии назначения ставок с фиксированной долей охвата.
  • Добавлено Campaign.feed_types, показывающее типы фидов, прикрепленных к кампании. Для кампаний Performance Max это может указывать на бизнес-вертикаль, например, MERCHANT_CENTER_FEED для розничной торговли.
  • Разрешено прикрепление общих наборов NEGATIVE_KEYWORDS к кампаниям MULTI_CHANNEL (для кампаний приложений) и LOCAL.

Demand Gen:

  • Добавлена стратегия назначения ставок TargetCPC для кампаний Demand Gen. Эта стратегия устанавливает ставки для максимизации кликов по сконфигурированной целевой цене за клик (CPC).
  • Добавлен новый тип автоматизации активов: GENERATE_DESIGN_VERSIONS_FOR_IMAGES: Доступен для DemandGenMultiAssetAds. Если включено, это добавляет элементы дизайна и встраивает текстовые активы в графические активы для создания новых графических активов с разными соотношениями сторон. Новые DemandGenMultiAssetAds включены по умолчанию.
  • Добавлен новый тип автоматизации активов: GENERATE_VIDEOS_FROM_OTHER_ASSETS: Доступен для DemandGenMultiAssetAds. Если включено, он генерирует видео, используя другие активы, такие как изображения и текст. Эти видео затем можно использовать для создания новых DemandGenVideoResponsiveAds. Новые DemandGenMultiAssetAds включены по умолчанию.
  • Переименовано поле BudgetPerDayMinimumErrorDetails.minimum_bugdet_amount_micros в minimum_budget_amount_micros.

Общее:

  • Добавлено ограничение в 10 000 операций на запрос AddBatchJobOperations.
  • Добавлен новый код ошибки: QuotaError.PAYMENTS_PROFILE_ACTIVATION_RATE_LIMIT_EXCEEDED, указывающий на превышение лимита скорости активации платежных профилей.

Performance Max:

  • Добавлены новые значения AssetAutomationType для кампаний Performance Max: GENERATE_IMAGE_ENHANCEMENT: Включает автоматическое создание улучшенных изображений, таких как автоматическая обрезка. Включено по умолчанию. GENERATE_IMAGE_EXTRACTION: Включает автоматический поиск изображений из конечных URL-адресов. По умолчанию используется настройка расширения динамических изображений на уровне аккаунта.
  • Удалён AssetPerformanceLabel для кампаний Performance Max.
  • Функциональность удалённой Campaign.url_expansion_opt_out теперь управляется установкой AssetAutomationType FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION в AssetAutomationSetting.
  • Добавлены новые сегменты для кампаний Performance Max. Каждый из этих сегментов доступен только для кампаний Performance Max и не будет возвращать данные при выборе любого другого типа кампании. ad_using_product_data: Указывает, использует ли реклама данные о продукте из фида Google Merchant Center. ad_using_video: Указывает, использует ли реклама видеоактив.

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

  • В UserListCrmDataSourceType добавлено значение THIRD_PARTY_PARTNER_DATA.
  • Добавлены новые коды ошибок, связанные с партнерскими аудиториями:
  • Добавлено is_active_live_stream_creator в YouTubeMetrics. Это возвращается ContentCreatorInsightsService.GenerateCreatorInsights и указывает, опубликовал ли создатель контента прямую трансляцию за последние 90 дней.
  • Добавлено новое сообщение PlannableUserListMetadata, которое содержит UserListCrmDataSourceType в PlannableUserList. Это сообщение возвращается ‘ReachPlanService.ListPlannableUserLists’, чтобы показать, является ли источник данных списка пользователей CRM FIRST_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, а также более сложные комбинации AND/OR тем и аудиторий.

Отчёты:

  • Добавлены два новых типа кликов: CLICK_TO_MESSAGE_THIRD_PARTY_CLICK и CLICK_TO_MESSAGE_LANDING_PAGE_CLICK.
  • AssetGroupAsset теперь может быть сегментирован по устройству, conversion_action, conversion_action_name и conversion_action_category.
  • AdGroupAdAssetView и AdGroupAdAssetCombinationView теперь полностью поддерживают показатели эффективности и конверсий для RESPONSIVE_SEARCH_AD. Ранее, только показы возвращались для этого типа объявлений в этих представлениях.
  • Для упрощения изучения Smart Bidding, следующие показатели теперь могут быть сегментированы по полям даты (дата, месяц, квартал, неделя, год): clicks_unique_query_clusters, conversions_unique_query_clusters, impressions_unique_query_clusters
  • Добавлены новые сегменты для PMax кампаний. См. обновления Performance Max.

Покупки:

  • Исправлена область применения метрик в ресурсе ShoppingProduct для кампаний и групп объявлений.

Общие цели:

  • Добавлена поддержка целей удержания клиентов для оптимизации повторного вовлечения существующих клиентов.
  • Настройте таргетинг, используя CampaignRetentionGoalSettings.target_option: TARGET_SPECIFIC: Использует только пользователей из списков пользователей, связанных с кампанией. (В настоящее время только разрешающий список). TARGET_ALL (По умолчанию): Нацелен на всех пользователей для повторного вовлечения.

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

2025-10-16 14:46