Google выпустил 23-ю версию Google Ads API, это крупный релиз с десятками обновлений. Обновления включают данные отчетов с максимальной эффективностью с разбивкой по типам рекламных сетей, дополнительные стимулы, отчеты и элементы управления конверсиями, а также многое другое.

Google написал«Сегодня мы объявляем о выпуске версии 23 Google Ads API. Это первый выпуск 2026 года и начало нашего перехода к более быстрой частоте выпусков».

До этого выпуска была версия 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 года. Версия 12.0 была выпущена в октябре 2022 года, версия 11.0 Google Ads API была выпущена в июне, а версия 11.1 — в августе. Также версия 10.1 была выпущена 27 апреля 2022 года, а версия 10.0 — 9 февраля 2022 года. А Google прекратил работу API AdWords 27 апреля, который полностью перестанет работать в конце июля.

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

Объявления:

  • Добавлен AD_SHARING_NOT_ALLOWED в AdGroupAdErrorEnum. Эта ошибка возвращается при попытке совместного использования объявления несколькими группами объявлений, что больше не разрешено.

  • В AdFormatType добавлены новые типы форматов: TEXT, VERTICAL_ADS_BOOKING_LINK, VERTICAL_ADS_PROMOTION.

  • Удалена поддержка CallAd и CallAdInfo в версии 23. Посмотрите, чтобы узнать больше.

Ресурсы:

ЧИТАТЬ  «Некоторые компании уже умерли». У производителей оружия есть только один способ заработать на новых разработках для войны – интервью генерального директора Skyeton Княженко.

  • В отчет assets_group добавлены дополнительные метрики: metrics.engagements, metrics.engagement_rate, metrics.average_cpe.

  • В отчет assets_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

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

Конверсии:

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

Общий спрос:

  • Добавлено поле DemandGenVideoResponsiveAdInfo.companion_banner.

  • Удалено поле lead_form_only из DemandGenMultiAssetAdInfo.

Стимулы:

  • Добавлена ​​поддержка стимулов «Выбери свой собственный» (CYO), позволяющая партнерам программно получать и применять стимулы Google Рекламы для своих клиентов:

  • Метод FetchIncentive позволяет получить доступные стимулы для пользователя на основе страны, языка и, при необходимости, адреса электронной почты пользователя. Это может вернуть персонализированные варианты поощрений «Выбери свой» (CYO).

  • Метод ApplyIncentive позволяет применить выбранный пользователем стимул к определенной учетной записи клиента Google Рекламы.

  • Добавлен ресурс AppliedIncentive, доступный только для чтения, доступный для запросов через GoogleAdsService.Search и GoogleAdsService.SearchStream. В нем представлена ​​подробная информация об использованных поощрениях, включая их статус, ход выполнения, суммы вознаграждений и соответствующие даты.

  • Добавлены новые коды ошибок в IncentiveErrorEnum для решения проблем, связанных с получением или применением поощрений.

  • Добавлен INVALID_EMAIL_ADDRESS в AuthenticationErrorEnum.

  • Чтобы облегчить более детальную программную обработку сбоев, мы добавим дополнительные коды ошибок в IncentivesService в будущих выпусках. Мы рекомендуем вам следить за предстоящими объявлениями и примечаниями к выпуску на предмет этих новых кодов ошибок, чтобы убедиться, что ваши приложения могут справиться с этими новыми режимами сбоев.
ЧИТАТЬ  Google уточняет ответы на отзывы владельцев бизнеса

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

  • Добавлен LIFE_EVENT_USER_INTEREST в AudienceInsightsDimension. Это новое измерение позволяет пользователям создавать аудитории, используя события из жизни, следующими методами:

  • Ответ ReachPlanService.GenerateConversionRates теперь включает поверхности, что позволяет предлагать различные коэффициенты конверсии на основе элементов управления поверхностью (например, Gmail, Shorts). Это поддерживается только для кампаний по формированию спроса.

  • В YouTubeChannelInsights добавлен LanguageDistribution, обеспечивающий распределение языков в контенте канала YouTube.

  • Добавлен сервис BenchmarksService для сравнения данных о рекламе на YouTube с отраслевыми показателями.

  • Добавлен AudienceInsightsService.GenerateAudienceDefinition для перевода произвольного текстового описания целевой аудитории в соответствующие атрибуты аудитории с помощью генеративного искусственного интеллекта.

  • Добавлен YouTubeChannelInsights.relevance_score, который оценивает, насколько автор соответствует теме, взвешенной по просмотрам.

  • Добавлен TrendInsightMetrics.trend_change_percent, который представляет процентное изменение значения тренда за период сравнения.

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

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

Отчеты:

  • Метрики и сегментация: AdGroupAdAssetView и AdGroupAdAssetCombinationView теперь поддерживают показатели показов, эффективности и конверсий для RESPONSIVE_DISPLAY_AD.

  • Метрики и сегментация: добавлен сегмент ad_sub_network_type для более детальной разбивки эффективности в рекламной сети. Первоначально это доступно для кампаний DemandGen на YouTube (In-Stream, In-Feed, Shorts). Этот сегмент необходимо выбрать вместе с ad_network_type.

  • Метрики и сегментация: включена разбивка по типам рекламных сетей для кампаний с максимальной эффективностью.

  • Метрики и сегментация: UserLocationView и GeographicView теперь поддерживают метрики, сегментированные по дате конверсии:

  • Новые сегменты для вертикальной рекламы

  • Новые представления: добавлен PerStoreView для запроса сведений о местоположении магазина. Добавлен MatchedLocationInterestView для кампаний AI Max, предоставляющий показатели эффективности с разбивкой по географическим местоположениям, к которым пользователи проявили интерес.

  • Максимальная эффективность: включена разбивка по типам рекламных сетей для кампаний с максимальной эффективностью.

  • Удаления: удалены совокупные показатели эффективности активов. Перечисление меток производительности больше не возвращается для поиска и отображения.
ЧИТАТЬ  Google Analytics 4: три показателя, которые нужно знать для оптимизации Google Ads

Шоппинг:

  • ShoppingPerformanceView теперь поддерживает следующие показатели, сегментированные по дате конверсии: конверсии_по_конверсии_дате, all_conversions_by_conversion_date, конверсии_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.

Вертикальные объявления:

  • В кампании AdGroup для поиска с использованием фидов путешествий добавлен параметрвертикальный_ads_format_setting, позволяющий контролировать, какие форматы объявлений могут показываться.

  • В AdGroupCriterion добавлен тип критериявертикальный_ads_item_group_rule_list. Добавленвертикальный_ads_item_group_rule в SharedCriterion. Эти критерии позволяют настраивать таргетинг на группы товаров в поисковых кампаниях с помощью фидов о путешествиях.

  • Теперь вы можете подключить фид данных вертикальных объявлений к поисковой кампании, в которой используется AI Max, чтобы она показывала объявления о рекламе недвижимости и ссылках на бронирование наряду с вашими текстовыми объявлениями. На уровне группы объявлений вы можете контролировать, какие форматы показывать, с помощью вертикального_ads_format_setting и определить набор правил группы элементов для таргетинга на подмножество ваших объектов из фида данных вертикальных объявлений. Кроме того, теперь отчеты можно сегментировать как по AdFormatType, так и по параметрам из фида данных вертикальных объявлений.

Видео:

  • Добавлено поле AdVideoAssetInfo.ad_video_asset_feature_control.

  • Добавлен код ошибки CampaignCriterionError.INVALID_VIDEO_LINEUP_ID.

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

Обсуждение на форуме LinkedIn.



Source link