Отчеты

Обзор

На этих страницах перечислены ресурсы, которые можно запрашивать в API с помощью SearchAds360Service.SearchStream или SearchAds360Service.Search. Названия ресурсов являются ссылками на их страницы. На каждой странице показаны следующие списки:

  • Артефакты (ресурсы, сегменты или показатели), которые можно использовать в одном предложении SELECT с ресурсом.
  • Ресурсы атрибуции, поля которых не будут сегментировать показатели, если они включены в те же предложения SELECT и WHERE, что и поля этих ресурсов.

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

  • category
  • data type
  • type URL
  • filterable
  • selectable
  • sortable
  • repeated
Используется для фильтрации?
В этой строке указано, можно ли использовать поле в условиях пункта WHERE запроса.
Выбираемый
В этой строке указано, можно ли использовать поле в условии SELECT запроса.
Sortable
В этой строке указано, можно ли сортировать поле и использовать его в предложении ORDER BY запроса.
Повтор
В этой строке указано, повторяется ли поле, которое должно обрабатываться как список.

Список всех ресурсов

Типы ресурсов
accessible_bidding_strategy Представляет представление стратегий назначения ставок, принадлежащих клиенту и доступных ему. В отличие от BiddingStrategy, этот ресурс включает стратегии, принадлежащие управляющим аккаунтам клиента и доступные этому клиенту, а также стратегии, принадлежащие этому клиенту. Этот ресурс не предоставляет показатели и содержит только ограниченный набор атрибутов BiddingStrategy.
ad_group Группа объявлений.
ad_group_ad Объявление из группы объявлений.
ad_group_ad_effective_label Связь между объявлением из группы и действующим ярлыком. Действующий ярлык – это ярлык, унаследованный или напрямую назначенный этому объявлению из группы.
ad_group_ad_label Связь между объявлением из группы и ярлыком.
ad_group_asset Связь между группой объявлений и объектом.
ad_group_asset_set AdGroupAssetSet – это связь между группой объявлений и набором объектов. Создание AdGroupAssetSet связывает набор объектов с группой объявлений.
ad_group_audience_view Представление аудитории группы объявлений. Содержит данные об эффективности, полученные из списков интересов и ремаркетинга для объявлений в контекстно-медийной сети и на YouTube, а также из списков ремаркетинга для поисковых объявлений. Данные агрегируются на уровне аудитории.
ad_group_bid_modifier Представляет модификатор ставки на уровне группы объявлений.
ad_group_criterion Критерий группы объявлений. Отчет ad_group_criterion содержит только критерии, которые были явно добавлены в группу объявлений.
ad_group_criterion_effective_label Связь между критерием группы объявлений и действующим ярлыком. Действующий ярлык – это ярлык, унаследованный или напрямую назначенный этому критерию группы объявлений.
ad_group_criterion_label Связь между критерием группы объявлений и ярлыком.
ad_group_effective_label Связь между группой объявлений и действующим ярлыком. Действующий ярлык – это ярлык, унаследованный или напрямую назначенный этой группе объявлений.
ad_group_label Связь между группой объявлений и ярлыком.
age_range_view Представление возрастного диапазона. Представление показателей эффективности клиента (например, показов и кликов), агрегированных по возрастному диапазону. Все статистические данные агрегируются на уровне группы объявлений. Примечание. Хотя вы можете сегментировать показатели по возрастному диапазону с помощью age_range_view или по полу с помощью gender_view, Search Ads 360 API не поддерживает одновременную сегментацию показателей по возрастному диапазону и полу в одном запросе. Анализ эффективности по обоим параметрам одновременно не поддерживается в Search Ads 360 API.
asset Объект – это часть объявления, которая может использоваться в нескольких объявлениях. Это может быть изображение (ImageAsset), видео (YoutubeVideoAsset) и т. д. Объекты неизменяемы и не могут быть удалены. Чтобы объект перестал показываться, удалите его из объекта, в котором он используется.
asset_group Группа объектов. AssetGroupAsset используется для связывания объекта с группой объектов. AssetGroupSignal используется для связывания сигнала с группой объектов.
asset_group_asset AssetGroupAsset – это связь между объектом и группой объектов. Добавление AssetGroupAsset связывает объект с группой объектов.
asset_group_listing_group_filter AssetGroupListingGroupFilter представляет узел дерева фильтров группы товаров в группе объектов.
asset_group_signal AssetGroupSignal представляет сигнал в группе объектов. Сигнал аудитории позволяет кампании с максимальной эффективностью определить, кто с наибольшей вероятностью совершит конверсию. Кампания с максимальной эффективностью использует сигнал для поиска новых пользователей с аналогичным или более высоким намерением совершить конверсию в поисковой сети, КМС, на видеоплатформах и других ресурсах.
asset_group_top_combination_view Представление с данными об использовании лучших комбинаций объектов из группы.
asset_set Набор объектов, представляющий собой коллекцию объектов. Чтобы связать объект с набором объектов, используйте AssetSetAsset.
asset_set_asset AssetSetAsset – это связь между объектом и набором объектов. Добавление AssetSetAsset связывает объект с набором объектов.
аудитория Аудитория – это эффективный вариант таргетинга, который позволяет пересекать различные атрибуты сегментов, такие как подробные демографические данные и интересы, для создания аудиторий, представляющих разделы ваших целевых сегментов.
bidding_strategy Стратегия назначения ставок.
кампания кампания;
campaign_asset Связь между кампанией и объектом.
campaign_asset_set CampaignAssetSet – это связь между кампанией и набором объектов. Добавление CampaignAssetSet связывает набор объектов с кампанией.
campaign_audience_view Представление аудитории кампании. Содержит данные об эффективности, полученные из списков интересов и ремаркетинга для объявлений в контекстно-медийной сети и на YouTube, а также из списков ремаркетинга для поисковых объявлений. Данные агрегируются по кампаниям и критериям аудитории. В этом представлении показаны только аудитории, прикрепленные на уровне кампании.
campaign_budget Бюджет кампании.
campaign_criterion Критерий кампании.
campaign_effective_label Представляет связь между кампанией и действующим ярлыком. Действующий ярлык – это ярлык, унаследованный кампанией или назначенный ей напрямую.
campaign_label Представляет связь между кампанией и ярлыком.
cart_data_sales_view Просмотр данных о продажах в корзине. Содержит информацию о товарах, которые были куплены, если настроено отслеживание конверсий с данными корзины. Показатели эффективности, такие как доход, валовая прибыль, показатели лидов и перекрестных продаж, а также атрибуты Merchant Center, такие как бренд и категория, доступны для товаров, определенных в фиде ассортимента и проданных в результате показа объявлений Google. Для покупок, связанных с кликами по товарным объявлениям, можно одновременно просматривать параметры как проданных товаров, так и товаров, по которым были выполнены клики.
конверсия Конверсия.
conversion_action Действие-конверсия.
conversion_custom_variable Пользовательская переменная конверсии. Подробнее https://support.google.com/sa360/answer/13567857…
customer Клиент.
customer_asset Связь между клиентом и объектом.
customer_asset_set CustomerAssetSet – это связь между клиентом и набором объектов. Добавление CustomerAssetSet связывает набор объектов с клиентом.
customer_client Связь между указанным клиентом и клиентским аккаунтом. Объекты CustomerClient существуют только для управляющих аккаунтов. Включает все прямые и косвенные клиентские аккаунты, а также сам управляющий аккаунт.
customer_manager_link Представляет связь между клиентом и менеджером.
dynamic_search_ads_search_term_view Представление поисковых запросов для динамических поисковых объявлений.
gender_view Ресурс представления по полу. Представляет представление показателей эффективности клиента, агрегированных по полу. Все статистические данные агрегируются на уровне группы объявлений. Примечание. Хотя вы можете сегментировать показатели по возрастному диапазону с помощью age_range_view или по полу с помощью gender_view, Search Ads 360 API не поддерживает одновременную сегментацию показателей по возрастному диапазону и полу в одном запросе. Анализ эффективности по обоим параметрам одновременно не поддерживается в Search Ads 360 API.
geo_target_constant Константа геотаргетинга.
keyword_view Представление ключевых слов.
label Ярлык.
language_constant Язык.
location_view Представление местоположений содержит сводные данные об эффективности кампаний по критерию местоположения.
product_bidding_category_constant Категория ставок для товара.
product_group_view Представление группы товаров.
shopping_performance_view Представление "Эффективность Покупок". Предоставляет статистику торговых кампаний и кампаний с максимальной эффективностью, агрегированную на нескольких уровнях параметров товаров. Значения параметров товаров из Merchant Center, такие как бренд, категория, настраиваемые атрибуты, состояние и тип товара, будут отражать состояние каждого параметра на дату и время регистрации соответствующего события. Количество показов и кликов, для которых shopping_performance_view возвращает статистику, может отличаться от данных в отчетах о кампаниях. shopping_performance_view показывает показы и клики по товарам, появляющимся в объявлениях, а отчеты о кампаниях показывают показы и клики по самим объявлениям. В зависимости от формата в объявлении может быть показано от нуля до нескольких товаров, поэтому числа могут не совпадать. В интерфейсе Поисковой рекламы 360 можно запрашивать данные о показах и кликах по товарам, которые появляются в объявлениях. Для этого в редакторе отчетов выберите столбец из раздела "Атрибуты товаров". Например, если вы выберете столбец "Бренд", это будет эквивалентно выбору segments.product_brand.
user_list Список пользователей. Это список пользователей, на которых клиент может настроить таргетинг. Уникальный ключ списка пользователей состоит из следующих полей: id. Обратите внимание, что значение name также должно быть уникальным для списков пользователей, принадлежащих определенному клиенту, за исключением некоторых случаев, когда для access_reason задано значение SHARED. При нарушении этого правила возникает ошибка UserListError.INVALID_NAME.
user_location_view Представление местоположений пользователей. В представлении "Местоположение пользователя" содержатся все показатели, агрегированные на уровне страны (одна строка на страну). В нем содержатся показатели эффективности для фактического местоположения пользователя с указанием того, является оно целевым или нет. Если используются другие поля сегментов, вы можете получить более одной строки на страну.
посещение Посещение.
webpage_view Просмотр веб-страницы.