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

v0 (2026-03-10)

Новые сегменты

Мы добавляем следующие сегменты:

v0 (05.12.2025)

Новые показатели

Теперь при запросе к ресурсу campaign доступны следующие метрики:

Мы добавляем следующие метрики конверсии с использованием данных корзины (CwCD):

Новые сегменты

Теперь сегментацию по почтовому индексу можно указывать в запросе. Подробнее см. в segments.geo_target_postal_code .

v0 (2025-11-10)

Новые поля URL

Мы добавляем

Новые метрики для UserLocationView

Теперь при запросе ресурса user_location_view доступны следующие метрики:

Исправление названия ресурса

В шаблоне имени ресурса для следующих эффективных ресурсов меток исправлено использование owner_customer_id , чтобы гарантировать наличие идентификатора клиента, которому принадлежит метка:

  • CampaignEffectiveLabel
  • AdGroupEffectiveLabel
  • CriterionEffectiveLabel (в AdGroupCriterionEffectiveLabel )
  • AdGroupAdEffectiveLabel

Пример: Шаблон для CampaignEffectiveLabel изменился с customers/{customer_id}/campaignEffectiveLabels/{campaign_id}~{label_id} на customers/{owner_customer_id}/campaignEffectiveLabels/{campaign_id}~{label_id} .

v0 (12.06.2025)

В это обновление добавлены новые поля для ресурсов клиентов . Обязательно обновите библиотеку клиентов , чтобы воспользоваться всеми этими изменениями.

Новые поля

Мы добавляем

чтобы помочь ориентироваться в иерархии аккаунтов Search Ads 360 .

v0 (2025-01-21)

В это обновление добавлен новый параметр для настройки расширения MCC.

Расширение MCC

При запросе параметра bidding_strategy теперь можно задать логическое значение ( enable_mcc_expansion ) в разделе PARAMETERS.

Если этот параметр включен, в ответе возвращаются данные из всех учетных записей в иерархии учетных записей, корнем которой является customer_id .

v0 (08.11.2024)

Это обновление включает новые поля и ресурсы. Обязательно обновите клиентскую библиотеку , чтобы воспользоваться всеми этими изменениями.

Новые поля

Мы добавляем ad_group_ad.effective_labels и ad_group_criterion.effective_labels .

Эффективные ярлыки — это ярлыки, унаследованные или присвоенные напрямую.

Новые ресурсы

Просмотр местоположения пользователя

Использование этого инструмента с географическими сегментами позволяет получать метрики, относящиеся к региону, мегаполису и городу.

См. подробности о ресурсе user_location_view .

В связи с новыми полями effective_labels появились 2 новых ресурса, которые хранят метаданные о связи между эффективными метками и ad_group_ad ( ad_group_ad_effective_label ) или ad_group_criterion ( ad_group_criterion_effective_label ).

v0 (07.10.2024)

Это обновление включает новые метрики, ресурсы, поля и некоторые новые определения сопоставлений. Обязательно обновите клиентскую библиотеку , чтобы воспользоваться всеми этими изменениями.

Добавлены метрики

  • cross_device_conversions_by_conversion_date : Количество преобразований между устройствами в зависимости от даты преобразования.
  • cross_device_conversions_value_by_conversion_date : Сумма значений конверсий между устройствами по дате конверсии.
  • general_invalid_click_rate : Процент кликов, отфильтрованных из общего числа кликов (отфильтрованные + неотфильтрованные клики) как недействительные клики.
  • general_invalid_clicks : Количество общих недействительных кликов.

cross_device_conversions_by_conversion_date и cross_device_conversions_value_by_conversion_date совместимы со следующими ресурсами: ad_group_ad , ad_group_audience_view , ad_group , bidding_strategy , campaign , customer , campaign_audience_view , keyword_view и shopping_performance_view .

Пересмотр сопоставления полей

В некоторых устаревших отчетах изменилось сопоставление полей для dfaActions , dfaActionsCrossEnv , dfaRevenue , dfaRevenueCrossEnv , dfaTransactions , dfaTransactionsCrossEnv .

Поле Ранее Новое определение
dfaActions metrics.all_conversions - metrics.cross_device_conversions metrics.all_conversions_by_conversion_date - metrics.cross_device_conversions_by_conversion_date
dfaActionsCrossEnv metrics.all_conversions метрики.все_конверсии_по_дате_конверсии
dfaRevenue metrics.all_conversions_value - metrics.cross_device_conversions_value metrics.all_conversions_value_by_conversion_date - metrics.cross_device_conversions_value_by_conversion_date
dfaRevenueCrossEnv metrics.all_conversions_value metrics.all_conversions_value_by_conversion_date
dfaTransactions metrics.all_conversions - metrics.cross_device_conversions metrics.all_conversions_by_conversion_date - metrics.cross_device_conversions_by_conversion_date
dfaTransactionsCrossEnv metrics.all_conversions метрики.все_конверсии_по_дате_конверсии

Список устаревших отчетов, в которых изменилось сопоставление полей.

Новые поля

Мы добавляем campaign.effective_labels и ad_group.effective_labels .

Эффективные ярлыки — это ярлыки, унаследованные или присвоенные напрямую.

Новые ресурсы

В связи с новыми полями effective_labels, новые ресурсы хранят метаданные о связи между эффективными метками и кампанией ( campaign_effective_label ) или группой объявлений ( ad_group_effective_label ).

v0 (2024-08-23)

В этом обновлении в метаданные пользовательского столбца добавлено поле renderType .

См. подробности о типе CustomColumnRenderType .

В ресурсы campaign_label , ad_group_label , ad_group_ad_label и ad_group_criterion_label добавлено новое поле owner_customer_id .

Обязательно обновите клиентскую библиотеку , чтобы воспользоваться преимуществами этих новых полей.

v0 (01.08.2024)

Это обновление включает в себя почасовую сегментацию и несколько новых полей.

Почасовая сегментация

Теперь в запросе можно указывать почасовую сегментацию. Подробнее см. в segments.hour .

Более подробная информация доступна в файле customer_manager_link.start_time.

Добавлено MULTIMEDIA_AD в ad_group_ad.ad.type

Теперь метрики и сегменты можно выбирать с помощью типа MULTIMEDIA_AD. Запросы к атрибутам, специфичным для мультимедиа, в этой версии не поддерживаются.

Добавлен тип кампании SOCIAL в campaign.advertising_channel_type и подтип SOCIAL_FACEBOOK_TRACKING_ONLY в campaign.advertising_channel_sub_type.

Теперь метрики и сегменты можно выбирать по типу кампании SOCIAL и подтипу SOCIAL_FACEBOOK_TRACKING_ONLY. Запросы по атрибутам, специфичным для SOCIAL или SOCIAL_FACEBOOK_TRACKING_ONLY, в этой версии не поддерживаются.

Добавлена ​​поддержка параметра average_quality_score.

Более подробная информация в метриках.

v0 (18.04.2024)

В это обновление включен ресурс «Стратегия доступных торгов»

Доступная стратегия торгов

Представляет собой обзор стратегий назначения ставок, принадлежащих клиенту и используемых совместно с ним. В отличие от стратегии назначения ставок, этот ресурс включает стратегии, принадлежащие менеджерам клиента и используемые совместно с ним, в дополнение к стратегиям, принадлежащим самому клиенту. Этот ресурс не предоставляет метрик и отображает лишь ограниченное подмножество атрибутов стратегии назначения ставок.

См. подробную информацию о ресурсе accessible_bidding_strategy .

v0 (12.02.2024)

Это обновление включает доступ к пользовательским столбцам и пользовательским переменным подсветки.

Пользовательские столбцы

Теперь в запросе можно указывать пользовательские столбцы для преобразования значений и пользовательские столбцы с формулами. Подробнее см. в документации по пользовательским столбцам .

Пользовательские параметры прожектора

Теперь пользовательские переменные Floodlight можно указывать в запросе для статистики после 30.01.2024. Подробнее см. в документации по пользовательским переменным Floodlight .

v0 (09.11.2023)

Это обновление включает следующие ресурсы. Перейдите по ссылкам, чтобы увидеть поля, которые можно запрашивать из этих ресурсов, а также метрики и сегментации, которые можно с ними использовать.

Группа активов

См. подробные сведения о ресурсе asset_group .

Группа активов Актив

См. подробные сведения о ресурсе asset_group_asset .

Фильтр группы активов

См. подробные сведения о ресурсе asset_group_listing_group_filter .

Сигнал группы активов

См. подробности о ресурсе asset_group_signal .

Обзор основных комбинаций активов группы компаний

См. подробные сведения о ресурсе asset_group_top_combination_view .

Данные корзины. Просмотр продаж.

См. подробности о ресурсе cart_data_sales_view .

Конвертация

См. подробную информацию о ресурсах для конвертации .

Просмотр показателей эффективности покупок

См. подробности о ресурсе shopping_performance_view .

Посещать

См. подробную информацию о посещении ресурса.

v0 (15.08.2023)

Это обновление включает следующие ресурсы и новый параметр для настройки конвертации валюты для метрик.

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

Актив группы объявлений

См. подробные сведения о ресурсе ad_group_asset .

Набор ресурсов для рекламной группы

См. подробности о ресурсе ad_group_asset_set .

Объект

См. подробную информацию об активе и ресурсе.

Набор активов

См. подробности о ресурсе asset_set .

Набор активов Актив

См. подробности о ресурсе asset_set_asset .

Материалы кампании

См. подробности о ресурсе campaign_asset .

Набор ресурсов кампании

См. подробности о ресурсе campaign_asset_set .

Активы клиента

См. подробные сведения о ресурсе customer_asset .

Набор активов клиента

См. подробные сведения о ресурсе customer_asset_set .

Конвертация валюты

Валюта для расчета метрик может быть указана с помощью параметра metrics_currency в разделе PARAMETERS.

Список доступных клиентов

Вывести список всех доступных учетных записей, используя метод ListAccessibleCustomers.

v0 (15.05.2023)

Это обновление включает следующий ресурс. Перейдите по ссылкам, чтобы увидеть поля, которые можно запрашивать из этого ресурса, а также метрики и сегментации, которые можно с ним использовать.

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

См. подробности о ресурсе ad_group_ad .

v0 (06.04.2023)

Это обновление включает следующие ресурсы. Перейдите по ссылкам, чтобы увидеть поля, которые можно запрашивать для каждого ресурса, а также метрики и сегментации, которые можно использовать с этим ресурсом.

Просмотр аудитории группы объявлений

См. подробности о ресурсе ad_group_audience_view .

Метка критерия группы объявлений

См. подробности ресурса ad_group_criterion_label .

Метка группы объявлений

См. подробности о ресурсе ad_group_label .

Возрастной диапазон

См. подробности о ресурсе age_range_view .

Критерий кампании

См. подробности о ресурсе campaign_criterion .

Метка кампании

См. подробности ресурса campaign_label

Динамическая поисковая реклама Просмотр поискового запроса

См. подробную информацию о ресурсе dynamic_search_ads_search_term_view .

Просмотр веб-страницы

См. подробности о ресурсе webpage_view .

Этикетка

См. подробную информацию об источнике информации в этикетке .

v0 (05.12.2022)

Версия v0 включает следующие ресурсы и сервисы. Перейдите по ссылкам, чтобы увидеть поля, которые можно запрашивать для каждого ресурса, а также метрики и сегментации, которые можно использовать с этим ресурсом.

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

См. подробности о ресурсе ad_group .

Торги

См. подробную информацию о ресурсе bidding_strategy .

Кампании

См. подробную информацию о ресурсах кампании .

Действие конверсии

См. подробности ресурса conversion_action .

Клиент

См. подробную информацию о ресурсах для клиентов .

Ключевое слово

См. подробности ресурса keyword_view .

Группа продуктов

См. подробности ресурса product_group_view .

SearchAds360FieldService

  • Сервис SearchAds360FieldService предоставляет каталог всех полей, доступных для запросов. Метаданные этих полей включают описания, типы и совместимость с другими полями. Подробнее .

SearchAds360Service

  • SearchAds360Service предназначен для получения нескольких ресурсов в одном запросе. К ресурсам , доступным для запросов, относятся:

    • AdGroup
    • BiddingStrategy
    • Campaign
    • ConversionAction
    • Customer
    • Keyword
    • ProductGroup

  • С помощью SearchAds360Service для этих ресурсов также можно получить такие показатели , как показы и клики:

    • AdGroup
    • BiddingStrategy
    • Campaign
    • ConversionAction
    • Customer
    • Keyword
    • ProductGroup

  • SearchAds360Service позволяет сегментировать аудиторию по полям, например, по полям с датами. Подробнее .