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

v20 (04.06.2025)

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

Ресурсы

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

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

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

Кампании

Конверсии

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

  • Добавлено поле ClickConversion.user_ip_address . Google Реклама не поддерживает сопоставление 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 Рекламе. Эта функция доступна только для аккаунтов из белого списка.
  • Добавлены 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 , которое возвращает текущий показатель силы объявления группы активов, связанной с рекомендацией.

Покупки

Видео

  • Добавлена поддержка аудиорекламы только для чтения. Подробнее об этой функции см. в Справочном центре Google Рекламы . Это изменение раскрывает:
    • Новый 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 (26.02.2025)

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

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

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

Реклама

Ресурсы

Конверсии

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

Ленты

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

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

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

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

  • (Только для разрешенных учетных записей) Правила бренда
  • Добавлен 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.

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

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

  • PhoneCallDetails.call_recording_url будет пустым вместо предоставления недействительного URL-адреса, если запись звонка не существует для заданного разговора с ведущим специалистом Local Services.
  • Добавлен CategoryBid.target_cpa_bid_micro , который позволяет устанавливать целевую цену за конверсию для категории через Campaign.local_services_campaign_settings .

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

  • Поддержка руководств бренда
    • Добавлен Campaign.brand_guidelines_enabled , который показывает, включены ли правила бренда для данной кампании с максимальной эффективностью. Если они включены, ресурсы с 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 . Кампании «Максимальная эффективность» для онлайн-продаж с фидом продуктов должны соответствовать этому требованию только при наличии ресурсов, связанных с группами ресурсов кампании.
    • Добавлены следующие значения в AssetLinkError :
    • BRAND_ASSETS_NOT_LINKED_AT_ASSET_GROUP_LEVEL , которая возникает при попытке связать активы бренда с кампаниями как ресурсы CampaignAsset вместо ресурсов AssetGroupAsset в кампаниях с максимальной эффективностью, если не включены правила бренда.
    • Ошибка BRAND_ASSETS_NOT_LINKED_AT_CAMPAIGN_LEVEL , которая возникает при попытке связать активы бренда с кампаниями как ресурсы AssetGroupAsset вместо ресурсов CampaignAsset в кампаниях Performance Max с включенными правилами бренда.
  • Добавлен 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

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

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