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

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)

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

Новые поля

Мы добавляем

для облегчения перемещения по иерархии аккаунтов Search Ads 360 .

v0 (21.01.2025)

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

Расширение MCC

При запросе bidding_strategy теперь можно задать логическое значение ( enable_mcc_expansion ) в разделе ПАРАМЕТРЫ.

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

v0 (08.11.2024)

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

Новые поля

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

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

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

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

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

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

В связи с новыми полями efficient_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 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 .

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

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

Связанные с новыми полями efficient_labels, новые ресурсы хранят метаданные связи между эффективными метками и кампанией ( campaign_effective_label ) или ad_group ( ad_group_effective_label ).

v0 (23.08.2024)

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

Подробности см. в описании CustomColumnRenderType .

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

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

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)

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

Стратегия доступных торгов

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

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

v0 (2024-02-12)

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

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

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

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

Пользовательские переменные 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 в разделе ПАРАМЕТРЫ.

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

Вывести список всех доступных учетных записей с помощью метода 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 позволяет сегментировать данные по полям, например, по датам. Подробнее .