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

v0 (2025-06-12)

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

Новые поля

Мы добавляем

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

v0 (21.01.2025)

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

Расширение МСС

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

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

v0 (2024-11-08)

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

Новые поля

Мы добавляем 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 ).

v0 (2024-10-07)

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

Метрики добавлены

  • 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 ( ad_group_effective_label ).

v0 (2024-08-23)

В этом обновлении метаданные пользовательских столбцов добавляют поле 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 (2024-04-18)

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

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

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

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

v0 (2024-02-12)

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

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

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

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

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

v0 (2023-11-09)

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

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

См. сведения о ресурсе 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 (2023-08-15)

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

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

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

См. сведения о ресурсе 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 (2023-05-15)

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

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

См. сведения о ресурсе ad_group_ad .

v0 (2023-04-06)

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

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

См. сведения о ресурсе 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 (2022-12-05)

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

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

См. сведения о ресурсе ad_group .

Торги

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

Кампании

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

Конверсионное действие

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

Клиент

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

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

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

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

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

SearchAds360FieldService

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

SearchAds360Сервис

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

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

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

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

  • SearchAds360Service позволяет сегментировать по полям, например, полям даты. Узнать больше .