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

Google написал«Чтобы использовать некоторые функции версии 22, необходимо обновить клиентские библиотеки и клиентский код. Все обновленные клиентские библиотеки и примеры кода опубликованы».

До этого выпуска была версия 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 апреля, который полностью перестанет работать в конце июля.

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

Ресурсы:

  • Добавлен LANDING_PAGE_PREVIEW в качестве нового типа поля изображения.

  • Представлен AssetGenerationService (бета-версия): этот сервис позволяет генерировать текстовые и графические ресурсы с использованием генеративного искусственного интеллекта. Изначально эта услуга доступна только ограниченному кругу участников закрытого бета-тестирования. GenerateText: генерирует текст на основе таких входных данных, как конечный URL, запросы произвольной формы, ключевые слова и существующий контекст кампании. GenerateImages: генерирует изображения на основе таких входных данных, как конечный URL, подсказки в произвольной форме, существующий контекст кампании или путем реконтекстуализации существующих изображений продуктов. Ошибки во время создания актива возвращаются с кодами из AssetGenerationErrorEnum.
ЧИТАТЬ  SEO-руководство по оптимизации вашего аккаунта Google Publisher Center

Кампании:

  • Добавлены новые цели ставок для кампаний приложений по установкам (ACi), которые можно оптимизировать без указания цели, что полезно для быстрого масштабирования или в тех случаях, когда определение правильной цели затруднено. В AppCampaignBiddingStrategyGoalType:

  • Добавлена ​​поддержка фиксированной доли типа стратегии голосового назначения ставок.

  • Добавлен Campaign.feed_types, показывающий типы каналов, прикрепленных к кампании. Для кампаний с максимальной эффективностью это может указывать на вертикаль бизнеса, например MERCHANT_CENTER_FEED для розничной торговли.

  • Разрешено прикреплять общие наборы NEGATIVE_KEYWORDS к MULTI_CHANNEL (для кампаний для приложений) и ЛОКАЛЬНЫМ кампаниям.

Общий спрос:

  • Добавлена ​​стратегия назначения ставок TargetCPC для кампаний по формированию спроса. Эта стратегия устанавливает ставки для получения максимального количества кликов по настроенной целевой цене за клик (CPC).

  • Добавлен новый тип AssetAutomationType: GENERATE_DESIGN_VERSIONS_FOR_IMAGES: доступен для DemandGenMultiAssetAds. Если этот параметр включен, это добавляет элементы дизайна и встраивает текстовые ресурсы в ресурсы изображений для создания новых ресурсов изображений с разными соотношениями сторон. Новые объявления DemandGenMultiAssetAd включены по умолчанию.

  • Добавлен новый тип AssetAutomationType: GENERATE_VIDEOS_FROM_OTHER_ASSETS: доступен для DemandGenMultiAssetAds. Если этот параметр включен, он генерирует видео с использованием других ресурсов, таких как изображения и текст. Эти видео затем можно использовать для создания новых объявлений DemandGenVideoResponsiveAds. Новые объявления DemandGenMultiAssetAd включены по умолчанию.

  • Поле BudgetPerDayMinimumErrorDetails.minimum_bugdet_amount_micros переименовано в минимальное_бюджет_amount_micros.

Общий:

  • Добавлено ограничение в 10 000 операций на запрос AddBatchJobOperations.

  • Обновлена ​​обработка поля page_size в ListBatchJobResultsRequest: если параметр page_size не установлен или равен 0, теперь по умолчанию используется максимальное значение 1000 (ранее возвращалось INVALID_PAGE_SIZE). Если page_size превышает 1000, API теперь возвращает ошибку INVALID_PAGE_SIZE (ранее автоматически ограничивалась значением 1000).

  • Добавлен новый код ошибки: QuotaError.PAYMENTS_PROFILE_ACTIVATION_RATE_LIMIT_EXCEEDED, указывающий, когда превышен лимит ставок активации платежного профиля.
ЧИТАТЬ  Теперь Бард может подключаться к вашим приложениям и сервисам Google.

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

  • Добавлены новые значения AssetAutomationType для кампаний с максимальной эффективностью: GENERATE_IMAGE_ENHANCEMENT: включает автоматическое создание улучшенных изображений, например автоматическое кадрирование. Включено по умолчанию. GENERATE_IMAGE_EXTRACTION: позволяет автоматически получать изображения из конечных URL-адресов. По умолчанию используется параметр расширения динамического изображения на уровне учетной записи.

  • Удален AssetPerformanceLabel для кампаний с максимальной эффективностью.

  • Функциональность удаленного Campaign.url_expansion_opt_out теперь управляется путем установки AssetAutomationType FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION в AssetAutomationSetting.

  • Добавлены новые сегменты для кампаний с максимальной эффективностью. Каждый из этих сегментов доступен только для кампаний с максимальной эффективностью и не возвращает данные, если выбран любой другой тип кампании. ad_using_product_data: указывает, использует ли объявление данные о продукте из фида Google Merchant Center. ad_using_video: указывает, используется ли в объявлении видеоресурс.

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

  • В UserListCrmDataSourceType добавлено значение THIRD_PARTY_PARTNER_DATA.

  • Добавлены новые коды ошибок, связанные с партнерскими аудиториями:

  • В YouTubeMetrics добавлен is_active_live_stream_creator. Возвращается ContentCreatorInsightsService.GenerateCreatorInsights и указывает, публиковал ли автор прямую трансляцию за последние 90 дней.

  • Добавлено новое сообщение PlannableUserListMetadata, которое содержит UserListCrmDataSourceType в PlannableUserList. Это сообщение возвращается ReachPlanService.ListPlannableUserLists, чтобы показать, является ли источником данных списка пользователей CRM FIRST_PARTY или THIRD_PARTY_PARTNER_DATA.

  • В ReachPlanService добавлено поле trueview_views, которое заменяет поле представлений.

  • В TrendInsight добавлена ​​поддержка связанных_видео и связанных_креаторов. Также добавлены метаданные свойств видео и даты публикации в YouTubeVideoAttributeMetadata.video_properties и YouTubeVideoAttributeMetadata.publish_date.

  • AudienceInsightsService.GenerateInsightsFinderReport теперь поддерживает родительский_статус и диапазоны дохода, а также более сложные комбинации И/ИЛИ тем и аудиторий.

Отчеты:

  • Добавлены два новых типа кликов: CLICK_TO_MESSAGE_THIRD_PARTY_CLICK и CLICK_TO_MESSAGE_LANDING_PAGE_CLICK.

  • AssetGroupAsset теперь сегментируется по устройству, действию_конверсии, имени_действия_конверсии и категории_действия_конверсии.

  • AdGroupAdAssetView и AdGroupAdAssetCombinationView теперь полностью поддерживают показатели эффективности и конверсии для RESPONSIVE_SEARCH_AD. Раньше при таких просмотрах возвращались только показы для этого типа объявлений.

  • Чтобы упростить исследование интеллектуального назначения ставок, следующие показатели теперь можно сегментировать по полям дат (дата, месяц, квартал, неделя, год): clicks_unique_query_clusters, конверсии_unique_query_clusters, показы_уникальный_query_clusters.

  • Добавлен новый ресурс: TargetingExpansionView, который сообщает показатели расширений по сравнению с ручным таргетингом, например расширение без ключевых слов для AI Max для поисковых кампаний.

  • Добавлены новые сегменты для кампаний с максимальной эффективностью. См. обновления с максимальной эффективностью.
ЧИТАТЬ  Лучшие британские рэперы 2024 года: 9 самых популярных британских рэперов - Bscholarly

Шоппинг:

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

Единые цели:

  • Добавлена ​​поддержка целей удержания клиентов для оптимизации повторного привлечения существующих клиентов.

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

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



Source link