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

Версия 0 (09.11.2026)

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

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

v0 (01.08.2026)

Новые поля

Мы добавляем synthetic_content_info в ресурсы ad и asset, а также поддерживающее сообщение SyntheticContentInfo и перечисления SyntheticContentAttestationStatus и SyntheticContentSource.

Версия 0 (10.03.2026)

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

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

v0 (2025-12-05)

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

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

Мы добавляем следующие показатели конверсий с данными корзины:

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

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

v0 (10.11.2025)

Новые поля 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)

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

Новые поля

Мы добавляем

для перемещения по иерархии аккаунтов Поисковой рекламы 360.

v0 (21.01.2025)

В этом обновлении добавлен новый параметр для настройки расширения 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 добавлены два новых ресурса, которые хранят метаданные о связи между действующими ярлыками и ad_group_ad (ad_group_ad_effective_label) или ad_group_criterion (ad_group_criterion_effective_label).

Версия 0 (7 октября 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 metrics.all_conversions_by_conversion_date
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 metrics.all_conversions_by_conversion_date

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

Новые поля

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

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

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

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

v0 (23.08.2024)

В этом обновлении в метаданные специальных столбцов добавлено поле 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.

В поле ad_group_ad.ad.type добавлено значение MULTIMEDIA_AD.

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

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

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

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

Подробную информацию можно найти в показателях.

Версия 0 (18 апреля 2024 г.)

В этом обновлении добавлен ресурс Accessible Bidding Strategy.

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

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

Подробные сведения о ресурсе accessible_bidding_strategy.

Версия 0 (12 февраля 2024 г.)

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

Специальные столбцы

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

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

Теперь в запросе можно указывать пользовательские переменные Floodlight для статистики, собранной после 30 января 2024 г. Подробную информацию вы найдете в документации по пользовательским переменным Floodlight.

Версия 0 (9 ноября 2023 г.)

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

Группа объектов

Подробнее asset_group…

Объект в группе объектов

Подробнее asset_group_asset…

Фильтр группы товаров для группы объектов

Подробные сведения о ресурсе asset_group_listing_group_filter.

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

Подробнее asset_group_signal…

Просмотр лучших комбинаций группы объектов

Подробные сведения о ресурсе asset_group_top_combination_view.

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

Подробнее cart_data_sales_view…

Конверсия

Подробнее о ресурсе conversion…

Просмотр эффективности покупок

Подробные сведения о ресурсе shopping_performance_view.

Перейти

Подробнее о ресурсе visit…

Версия 0 (15 августа 2023 г.)

В этом обновлении добавлены перечисленные ниже ресурсы и новый параметр для настройки конвертации валют в показателях.

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

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

Подробнее ad_group_asset…

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

Подробнее ad_group_asset_set…

Объект

Подробнее о ресурсе asset…

Набор объектов

Подробнее asset_set…

Объект набора объектов

Подробнее asset_set_asset…

Объект кампании

Подробнее campaign_asset…

Набор объектов кампании

Подробнее campaign_asset_set…

Объект клиента

Подробнее customer_asset…

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

Подробнее customer_asset_set…

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

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

Как создать список доступных клиентов

Получите список всех доступных аккаунтов с помощью метода ListAccessibleCustomers.

Версия 0 (15 мая 2023 г.)

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

Объявление из группы объявлений

Подробнее ad_group_ad…

Версия 0 (6 апреля 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…

Ярлык

Подробнее о ресурсе label…

v0 (2022-12-05)

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

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

Подробнее ad_group…

Ставки

Подробнее bidding_strategy…

Кампании

Подробные сведения о ресурсе campaign.

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

Подробнее conversion_action…

Клиент

Подробнее о ресурсе customer…

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

Подробные сведения о ресурсе 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 позволяет сегментировать данные по полям, например по дате. Подробнее…