Примечания к выпуску

v20 (04.06.2025)

В версии 20 добавлены следующие новые функции и обновления.

Ресурсы

Добавлено несколько новых показателей и столбцов сегментов для отчета asset_group .

Столбцы показателей

Сегментные столбцы

Кампании

Конверсии

  • Теперь вы можете обновить поле google_ads_conversion_customer для существующего клиента, чтобы включить отслеживание конверсий между аккаунтами или изменить его существующий родительский аккаунт отслеживания конверсий на другой управляющий аккаунт.

  • Добавлено поле ClickConversion.user_ip_address . Google Ads не поддерживает сопоставление IP-адресов для конечных пользователей в Европейской экономической зоне (ЕЭЗ), Соединенном Королевстве (UK) или Швейцарии (CH). Добавьте логику для условного исключения обмена IP-адресами от пользователей из этих регионов. Убедитесь, что вы предоставляете пользователям четкую и полную информацию о данных, которые вы собираете на своих сайтах, в приложениях и других объектах, и получите согласие, если это требуется по закону или любым применимым политикам Google. Подробнее см. на странице Об импорте офлайн-конверсий.

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

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

  • Добавлено поле merchant_center_account_id в GenerateRecommendationsRequest чтобы указать, когда следует генерировать рекомендации для розничной торговли, а не для стандартных кампаний Performance Max.

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

  • Добавлен AudienceInsightsDimension.YOUTUBE_LINEUP для замены AudienceInsightsDimension.YOUTUBE_DYNAMIC_LINEUP в AudienceInsightsService и ContentCreatorInsightsService . Это новое измерение позволяет извлекать аналитику и метаданные для подборок YouTube Select (YTS). Заменены объекты, связанные с YOUTUBE_DYNAMIC_LINEUP , такие как DynamicLineupAttributeMetadata и AudienceInsightsDynamicLineup , для соответствия более широкому удалению динамических подборок в Google Ads. Эта функция доступна только для учетных записей в списке разрешенных.
  • Добавлены AdditionalApplicationInfo и ApplicationInstance в AudienceInsightsService , ContentCreatorInsightsService и ReachPlanService . Эта функция доступна только для учетных записей в списке разрешенных.
  • Обновлены AudienceInsightsService и ContentCreatorInsightsService для предоставления более подробных сведений. Теперь вы можете сегментировать данные создателей контента по устройству, используя новые AudienceInsightsDimension.DEVICE и AudienceInsightsAttribute.device в обеих службах. Эта функция доступна только для учетных записей из белого списка.
  • Добавлены дополнительные агрегированные метрики видео в GenerateCreatorInsightsResponse для более полного анализа создателей контента: engagement_rate , average_views_per_video , average_likes_per_video , average_shares_per_video , average_comments_per_video , shorts_views_count , shorts_video_count и is_brand_connect_creator . Эта функция доступна только для учетных записей из белого списка.
  • Добавлен sub_country_locations в GenerateCreatorInsightsRequest для ContentCreatorInsightsService . Это позволяет указывать географические местоположения субстран для уточнения поиска информации о создателях. Поле sub_country_locations поддерживается только при использовании search_attributes oneof в поле criteria . Если sub_country_locations указаны с другими типами критериев, запрос будет недействительным. Это обеспечивает более детальный географический таргетинг и анализ для информации о создателях контента. Эта функция доступна только для учетных записей в разрешенном списке.
  • Добавлен ReachPlanService.ListPlannableUserLists , который возвращает списки пользователей первой стороны, принадлежащие клиенту, и добавил UserListInfo к параметрам таргетинга аудитории в GenerateReachForecastRequest . Это позволяет вам получать планируемые списки пользователей для определенного клиента, а затем генерировать прогнозы охвата для кампаний, нацеленных на эти конкретные аудитории. Эти улучшения улучшают индивидуальное планирование охвата за счет включения данных вашей аудитории первой стороны непосредственно в прогнозирование. Прогнозирование охвата доступно только для учетных записей, включенных в белый список.

Видео

  • Добавлены объявления AdFormatType.PAUSE , показываемые в органических видеороликах YouTube на экранах телевизоров, которые включены в отчетность. Эти объявления отображаются непосредственно рядом со статическим видеокадром на экране паузы. Это не включает в себя видеообъявления Demand Gen, отображаемые на панели объявлений ниже или поверх приостановленного органического видео, которые сообщаются в AdFormatType.INFEED .

v19.1 (16.04.2025)

В версии 19.1 были добавлены следующие функции и изменения.

Ресурсы

Кампании

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

История изменений

  • Добавлена ​​поддержка еще трех типов ресурсов в ChangeStatusResourceType :
    • CAMPAIGN_BUDGET
    • ASSET_SET
    • CAMPAIGN_ASSET_SET
  • Эти три более детализированных типа можно получить из отчета change_status .

Конверсии

Реклама местных услуг

  • Добавлен новый RPC ProvideLeadFeedback в LocalServicesLeadService для предоставления отзывов о качестве LocalServicesLead .
  • Добавлено новое поле lead_feedback_submitted в ресурс LocalServicesLead , которое подтверждает, был ли предоставлен отзыв для определенного ресурса.

Планирование услуг

  • Добавлена ​​поддержка ежемесячных прогнозов целевой частоты в ReachPlanService.GenerateReachForecast .
    • Разработчики могут задать TargetFrequencyTimeUnit.MONTHLY в TargetFrequencySettings при использовании планируемого кода продукта TARGET_FREQUENCY для создания прогноза ежемесячного охвата целевой частоты.
  • Добавлен новый метод ReachPlanService.GenerateConversionRates , который позволяет рекламодателям запрашивать предлагаемые коэффициенты конверсии для поддерживаемых планируемых продуктов.
  • Прогнозирование спроса в ReachPlanService.GenerateReachForecast :
    • Разработчики теперь могут запрашивать прогнозы охвата для кампаний Demand Gen. Разработчики могут использовать новый планируемый код продукта DEMAND_GEN_MAX_CONVERSIONS для создания прогнозов охвата Demand Gen.
    • Добавлено новое поле conversion_rate , позволяющее разработчикам, запрашивающим прогнозы охвата Demand Gen, предоставлять коэффициент конверсии. Предложенные коэффициенты конверсии можно получить с помощью нового метода ReachPlanService.GenerateConversionRates . Это поле обязательно для запросов прогнозирования Demand Gen. Оно не поддерживается для других планируемых продуктов.
    • Добавлено новое поле conversions в возвращаемые прогнозы. Это поле содержит количество конверсий в заданной точке кривой охвата. Конверсии поддерживаются только для планируемого продукта DEMAND_GEN_MAX_CONVERSIONS .

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

  • Новое поле ad_strength доступно для ImprovePerformanceMaxAdStrengthRecommendation , которое возвращает текущую оценку эффективности объявления для группы активов, связанной с рекомендацией.

Покупки

  • Теперь вы можете переопределить исключения брендов для объявлений Shopping в кампаниях Performance Max. Это отображается через новое поле pmax_campaign_settings на уровне кампании и работает только для кампаний PMax для Retail . Новая ошибка CampaignError.BRAND_TARGETING_OVERRIDES_NOT_SUPPORTED будет выдана, если вы попытаетесь задать это поле для несовместимого типа кампании.

Видео

  • Добавлена ​​поддержка только для чтения для аудиообъявлений. См. Справочный центр Google Ads, чтобы узнать об этой функции. Эти изменения раскрывают:
    • Новый подтип AdvertisingChannelSubType с именем YOUTUBE_AUDIO .
    • Новый AdGroupType с именем YOUTUBE_AUDIO .
    • Новое перечисление форматов рекламы с именем YOUTUBE_AUDIO_AD и соответствующие ему поля YouTubeAudioAdInfo .
  • Добавлены новые метрики и сегменты для запроса метрик охвата с демо-настройкой. В рамках этих изменений,
    • Были введены два новых столбца показателей: coviewed_impressions и primary_impressions .
    • Были введены два новых сегмента: adjusted_age_range и adjusted_gender .
    • Если какой-либо из двух новых сегментов выбран вместе с полем метрики охвата ( coviewed_impressions , primary_impressions , unique_users или average_impression_frequency_per_user ), необходимо также выбрать другой сегмент, чтобы получить допустимую статистику для этих столбцов.
    • В настоящее время эта функция доступна только для клиентов, включенных в разрешенный список.

v19 (2025-02-26)

В версии 19 были добавлены следующие функции и изменения.

Управление счетом

  • Добавлены следующие значения в CustomerError для учета предстоящих изменений:
    • CREATION_DENIED_FOR_POLICY_VIOLATION
    • CREATION_DENIED_INELIGIBLE_MCC

Реклама

Ресурсы

Конверсии

  • Цели конверсии
  • Устаревший ConversionActionType.SALESFORCE .

Ленты

  • Удалены все сущности, связанные с фидом, такие как Feed , FeedMapping , FeedService , AdGroupFeed , feed_placeholder_view и т. д. Теперь пользователи должны использовать assets для достижения той же цели. Посетите Migration Notes для списка всех удаленных сущностей.

Отели и путешествия

  • Сделал min_days и max_days из ValueRuleItineraryAdvanceBookingWindow optional полями, чтобы разрешить указывать 0 в качестве значения. Это поддерживает таргетинг для поисков путешествий, которые происходят сегодня.

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

  • (Только для разрешенных учетных записей) Правила бренда
    • Параметр Campaign.brand_guidelines_enabled теперь можно изменять только при создании кампании с максимальной эффективностью.
    • Это несовместимо с Performance Max для целей путешествий .
    • Чтобы включить правила бренда для существующих кампаний Performance Max, используйте недавно добавленный CampaignService.EnablePMaxBrandGuidelines . Отключение правил бренда не поддерживается.
    • Добавлены Campaign.brand_guidelines и BrandGuidelines , позволяющие настраивать цвета и семейство шрифтов бренда.
    • Новые значения ошибок:
    • CampaignError
    • BRAND_GUIDELINES_NOT_ENABLED_FOR_CAMPAIGN
    • BRAND_GUIDELINES_MAIN_AND_ACCENT_COLORS_REQUIRED
    • BRAND_GUIDELINES_COLOR_INVALID_FORMAT
    • BRAND_GUIDELINES_UNSUPPORTED_FONT_FAMILY
    • BRAND_GUIDELINES_UNSUPPORTED_CHANNEL
    • CANNOT_ENABLE_BRAND_GUIDELINES_FOR_TRAVEL_GOALS
    • CUSTOMER_NOT_ALLOWLISTED_FOR_BRAND_GUIDELINES
  • Добавлен AssetAutomationType.GENERATE_ENHANCED_YOUTUBE_VIDEOS для поддержки автоматического создания расширенных видеоресурсов для кампаний с максимальной эффективностью.

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

  • (Только для учетных записей из разрешенного списка) Добавлен ContentCreatorInsightsService.GenerateTrendingInsights , который позволяет пользователям видеть популярные темы контента на YouTube для заданных определений аудитории.
  • Добавлен GenerateCreatorInsightsRequest.country_locations[] для указания стран для поиска по заданным критериям.
  • Добавлен GenerateCreatorInsightsRequest.search_brand для указания бренда для поиска создателей.
  • Добавлены новые поля в YouTubeChannelInsights для предоставления дополнительной информации о канале для запросов search_channels :
    • channel_url
    • channel_description
    • top_videos
  • Добавлены новые поля метаданных в AudienceInsightsAttributeMetadata :
    • youtube_video_metadata
    • user_interest_attribute_metadata
    • knowledge_graph_attribute_metadata

Видео

  • После выпуска DataLinkService.CreateDataLink мы добавили следующие методы, позволяющие изменять ранее созданные ссылки на данные:
    • RemoveDataLink для удаления ссылок на данные в аккаунте Google Ads
    • UpdateDataLink для принятия, отклонения и отзыва ссылок на данные в аккаунте Google Ads
  • Удалена поддержка VIDEO_OUTSTREAM из следующих перечислений:

v18 (16.10.2024)

В версии 18 были добавлены следующие новые функции и обновления.

Управление счетом

  • (Только для разрешенных аккаунтов) Добавлен DataLinkService.CreateDataLink , который позволяет связать аккаунт Google Ads с видео создателя, размещенными на канале создателя на YouTube. Связывание видео позволяет аккаунту Google Ads запускать партнерские объявления с использованием видео создателя.

Группы объявлений

  • Добавлен AdGroup.exclude_demographic_expansion , который позволяет исключить демографические данные из расширения, если optimized_targeting_enabled имеет значение true ; ранее эта функция поддерживалась только для Demand Gen.

Реклама

  • Добавлен параметр AdGroupAd.ad_group_ad_asset_automation_settings , который позволяет включать или выключать автоматическую генерацию активов для объявлений.
  • Добавлены следующие значения в AssetAutomationType :
    • GENERATE_VERTICAL_YOUTUBE_VIDEOS
    • GENERATE_SHORTER_YOUTUBE_VIDEOS
  • Добавлен AdNetworkType.GOOGLE_OWNED_CHANNELS , который используется рекламой, показываемой на каналах, принадлежащих Google, таких как YouTube, Gmail и лента Discover.

Ресурсы

Кампании

Критерий

  • Добавлен content_criterion_view , который возвращает показатели эффективности целевого контента , такого как ключевые слова, места размещения и темы, для кампаний Display, Demand Gen и Video.

Отели и путешествия

Местные услуги

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

  • Поддержка руководств бренда
    • Добавлен Campaign.brand_guidelines_enabled , который показывает, включены ли брендовые руководства для данной кампании Performance Max. Если включено, активы с field_type , установленным на BUSINESS_NAME , LOGO , LANDSCAPE_LOGO должны быть связаны как ресурсы CampaignAsset вместо ресурсов AssetGroupAsset .
    • Добавлены ошибки CampaignError.REQUIRED_BUSINESS_NAME_ASSET_NOT_LINKED и CampaignError.REQUIRED_LOGO_ASSET_NOT_LINKED , которые указывают на то, что кампании «Максимальная эффективность» с включенными рекомендациями по бренду не имеют необходимых ресурсов CampaignAsset , связанных с кампанией.
    • Если включены правила бренда, по крайней мере один актив с field_type , установленным на BUSINESS_NAME и по крайней мере один с LOGO должны быть связаны с кампанией как ресурсы CampaignAsset . Кампании Performance Max для онлайн-продаж с фидом продуктов должны соответствовать этому требованию только в том случае, если есть активы, которые связаны с группами активов кампании.
    • Добавлены следующие значения в AssetLinkError :
    • BRAND_ASSETS_NOT_LINKED_AT_ASSET_GROUP_LEVEL , которое возникает при попытке связать активы бренда с кампаниями как ресурсы CampaignAsset вместо ресурсов AssetGroupAsset в кампаниях с максимальной эффективностью, если не включены правила бренда.
    • Ошибка BRAND_ASSETS_NOT_LINKED_AT_CAMPAIGN_LEVEL , которая возникает при попытке связать активы бренда с кампаниями как ресурсы AssetGroupAsset вместо ресурсов CampaignAsset в кампаниях с максимальной эффективностью с включенными рекомендациями по бренду.
  • Добавлен performance_max_placement_view , который возвращает показы мест размещения, где показывались объявления с максимальной эффективностью.
  • Добавлен AssetGroupListingGroupFilterError.TREE_WAS_INVALID_BEFORE_MUTATION

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

  • (Только для разрешенных учетных записей) Добавлен новый сервис с методом ContentCreatorInsightsService.GenerateCreatorInsights , который позволяет пользователям изучать информацию о лучших создателях YouTube. Это позволяет клиентам искать создателей с учетом комбинации таргетинга аудитории и таргетинга контента или информацию о создателях с учетом списка идентификаторов каналов YouTube.
  • Обновления AudienceInsightsService.GenerateSuggestedTargetingInsights :
    • Перемещены audience , baseline_audience и data_month в audience_definition .
    • Добавлена audience_description для генерации предложений по таргетингу из текстового описания свободной формы с использованием генеративного ИИ.
  • Добавлен AudienceInsightsService.GenerateTargetingSuggestionMetrics , который возвращает потенциальные показатели охвата для заданных комбинаций таргетинга аудитории.

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

Отчетность

  • Заменены поля summary_row_setting и return_total_results_count SearchGoogleAdsRequest на поле search_settings , тип которого SearchSettings со следующими полями:
    • omit_results
    • return_summary_row
    • return_total_results_count
  • Добавлены следующие новые метрики об общих недействительных кликах, таких как те, которые генерируются ботами или краулерами, те, которые имеют нерегулярные шаблоны. Их можно запросить с помощью отчета campaign .
  • Добавлены следующие значения в QuotaError :
    • EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION

Архивные заметки о выпуске

Архивные заметки о выпуске см. в разделе «Устаревшие версии» .