Обзор
На этих страницах перечислены ресурсы, которые можно запрашивать в API с помощью SearchAds360Service.SearchStream или SearchAds360Service.Search. Названия ресурсов являются ссылками на их страницы. На каждой странице показаны следующие списки:
- Артефакты (ресурсы, сегменты или показатели), которые можно использовать в одном предложении SELECT с ресурсом.
- Ресурсы атрибуции, поля которых не будут сегментировать показатели, если они включены в те же предложения SELECT и WHERE, что и поля этих ресурсов.
После этих списков представлены таблицы с названиями полей, сегментов и показателей ресурса, которые можно включить в поисковый запрос, если этот ресурс указан в предложении FROM. Каждое название связано с таблицей, содержащей метаданные:
categorydata typetype URLfilterableselectablesortablerepeated
- Используется для фильтрации?
- В этой строке указано, можно ли использовать поле в условиях пункта
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 | Просмотр веб-страницы. |