отчеты

Обзор

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

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

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

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

Примеры отчетов

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

Типы ресурсов
available_bidding_strategy Представляет представление BiddingStrategies, принадлежащее клиенту и совместно используемое с ним. В отличие от BiddingStrategy, этот ресурс включает в себя стратегии, принадлежащие менеджерам заказчика и предоставленные этому заказчику, в дополнение к стратегиям, принадлежащим этому заказчику. Этот ресурс не предоставляет метрик и предоставляет только ограниченное подмножество атрибутов BiddingStrategy.
account_budget Бюджет на уровне аккаунта. Он содержит информацию о самом бюджете, а также о последних утвержденных изменениях в бюджете и предлагаемых изменениях, ожидающих утверждения. Предлагаемые изменения, ожидающие утверждения, если таковые имеются, находятся в 'pending_proposal'. Действующие сведения о бюджете можно найти в полях с префиксом «утверждено_», «скорректировано_» и без префикса. Поскольку некоторые действующие данные могут отличаться от того, что пользователь изначально запросил (например, лимит расходов), эти различия сопоставляются с помощью полей «предложено_», «утверждено_» и, возможно, «скорректировано_». Этот ресурс изменяется с помощью AccountBudgetProposal и не может быть изменен напрямую. Бюджет может иметь не более одного ожидающего рассмотрения предложения в любой момент времени. Читается через pending_proposal. После утверждения бюджет может подвергаться корректировкам, например корректировкам кредита. Корректировки создают различия между полями «утверждено» и «скорректировано», которые в противном случае были бы идентичными.
account_budget_proposal Предложение по бюджету на уровне аккаунта. Все поля с префиксом «предложено» не обязательно могут применяться напрямую. Например, предлагаемые лимиты расходов могут быть скорректированы до их применения. Это верно, если «предлагаемое» поле имеет «утвержденный» аналог, например лимиты расходов. Обратите внимание, что тип предложения (proposal_type) изменяет, какие поля являются обязательными, а какие должны оставаться пустыми.
account_link Представляет соединение для обмена данными между аккаунтом Google Реклама и другим аккаунтом.
группа_объявлений Группа объявлений.
ad_group_ad Объявление группы объявлений.
ad_group_ad_asset_view Связь между AdGroupAd и активом. В настоящее время мы поддерживаем только AdGroupAdAssetView для AppAds.
ad_group_ad_label Связь между объявлением группы объявлений и ярлыком.
ad_group_asset Связь между группой объявлений и объектом.
ad_group_audience_view Представление аудитории группы объявлений. Включает данные об эффективности из интересов и списков ремаркетинга для контекстно-медийной сети и сети YouTube, а также списки ремаркетинга для поисковых объявлений (RLSA), объединенные на уровне аудитории.
ad_group_bid_modifier Представляет модификатор ставки группы объявлений.
ad_group_criterion Критерий группы объявлений.
ad_group_criterion_customizer Значение настройщика для связанного CustomizerAttribute на уровне AdGroupCriterion.
ad_group_criterion_label Связь между критерием группы объявлений и ярлыком.
ad_group_criterion_simulation Моделирование критерия группы объявлений. Поддерживаемые комбинации типа рекламного канала, типа критерия, типа моделирования и метода модификации моделирования подробно описаны ниже соответственно. Операции моделирования Hotel AdGroupCriterion, начиная с V5. 1. ДИСПЛЕЙ - КЛЮЧЕВОЕ СЛОВО - CPC_BID - UNIFORM 2. ПОИСК - КЛЮЧЕВОЕ СЛОВО - CPC_BID - UNIFORM 3. SHOPPING - LISTING_GROUP - CPC_BID - UNIFORM 4. HOTEL - LISTING_GROUP - CPC_BID - UNIFORM 5. HOTEL - LISTING_GROUP - PERCENT_CPC_BID - UNIFORM
ad_group_customizer Значение настройщика для связанного CustomizerAttribute на уровне AdGroup.
ad_group_extension_setting Настройка расширения группы объявлений.
рекламная_группа_лента Фид группы объявлений.
ad_group_label Связь между группой объявлений и ярлыком.
ad_group_simulation Моделирование группы объявлений. Ниже подробно описаны поддерживаемые комбинации типа рекламного канала, типа имитации и метода модификации имитации. 1. ПОИСК – CPC_BID – ПО УМОЛЧАНИЮ 2. ПОИСК – CPC_BID – UNIFORM 3. ПОИСК – TARGET_CPA – UNIFORM 4. ПОИСК – TARGET_ROAS – UNIFORM ВИДЕО – CPV_BID – ПО УМОЛЧАНИЮ 9. ВИДЕО – CPV_BID — UNIFORM
ad_parameter Параметр объявления, который используется для обновления числовых значений (таких как цены или уровни запасов) в любой текстовой строке объявления (включая URL-адреса). Для каждого критерия группы объявлений может быть максимум два AdParameters. (Один с параметром index_index = 1 и один с параметром_index = 2.) В объявлении на параметры ссылается заполнитель в форме "{param#:value}". Например, "{параметр1:$17}"
ad_schedule_view Представление расписания показа объявлений суммирует эффективность кампаний по критериям AdSchedule.
age_range_view Представление возрастного диапазона.
актив Ресурс — это часть объявления, которую можно использовать в нескольких объявлениях. Это может быть изображение (ImageAsset), видео (YoutubeVideoAsset) и т. д. Активы неизменяемы и не могут быть удалены. Чтобы прекратить обслуживание ресурса, удалите его из объекта, который его использует.
assets_field_type_view Представление типа поля актива. В этом представлении отображаются метрики без пересчета для каждого типа поля актива, когда актив используется в качестве расширения.
группа активов Группа активов. AssetGroupAsset будет использоваться для привязки актива к группе активов. AssetGroupHint будет использоваться для связывания подсказки с группой активов.
актив_группа_актив AssetGroupAsset — это связь между активом и группой активов. Добавление AssetGroupAsset связывает актив с группой активов.
assets_group_listing_group_filter AssetGroupListingGroupFilter представляет узел дерева фильтров группы списков в группе активов.
assets_group_product_group_view Представление группы продуктов группы активов.
актив_набор Набор активов, представляющий коллекцию активов. Используйте AssetSetAsset, чтобы связать актив с набором активов.
актив_сет_актив AssetSetAsset — это связь между активом и набором активов. Добавление AssetSetAsset связывает актив с набором активов.
batch_job Список мутаций, обрабатываемых асинхронно. Мутации загружаются пользователем. Сами изменения недоступны для чтения, а результаты задания можно прочитать только с помощью BatchJobService.ListBatchJobResults.
bidding_data_exclusion Представляет исключение данных ставок. См. раздел "Об исключениях данных" на странице https://support.google.com/google-ads/answer/10370710 .
bidding_seasonality_adjustment Представляет сезонную корректировку ставок. См. раздел "Сезонные корректировки" на странице https://support.google.com/google-ads/answer/10369906 .
bidding_strategy Стратегия торгов.
bidding_strategy_simulation Моделирование стратегии торгов. Поддерживаемые комбинации типа моделирования и метода модификации моделирования подробно описаны ниже соответственно. 1. TARGET_CPA – ЕДИНАЯ 2. TARGET_ROAS – ЕДИНАЯ
billing_setup Настройки выставления счетов, связывающие платежный аккаунт и рекламодателя. Настройки платежных данных относятся к одному рекламодателю.
call_view Представление звонков, которое включает данные для отслеживания звонков объявлений только с номером телефона или расширений номеров телефонов.
кампания Кампания.
кампания_актив Связь между кампанией и активом.
кампания_актив_сет CampaignAssetSet — это связь между кампанией и набором активов. Добавление CampaignAssetSet связывает набор активов с кампанией.
кампания_audience_view Представление аудитории кампании. Включает данные об эффективности из интересов и списков ремаркетинга для контекстно-медийной сети и сети YouTube, а также списки ремаркетинга для поисковых объявлений (RLSA), объединенные по критерию кампании и аудитории. Это представление включает только аудитории, прикрепленные на уровне кампании.
кампания_bid_modifier Представляет критерий с возможностью изменения ставок на уровне кампании.
кампания_бюджет Бюджет кампании.
кампания_конверсия_цель Настройка возможности назначения ставок для указанной кампании только для всех действий-конверсий с соответствующей категорией и источником.
кампания_критерий Критерий кампании.
кампания_критерий_симуляция Моделирование критерия кампании. Поддерживаемые комбинации типа рекламного канала, идентификаторов критериев, типа моделирования и метода модификации моделирования подробно описаны ниже соответственно. 1. ПОИСК - 30000,30001,30002 - BID_MODIFIER - UNIFORM 2. ПОКУПКИ - 30000,30001,30002 - BID_MODIFIER - UNIFORM 3. ПОКАЗАТЬ - 30001 - BID_MODIFIER - UNIFORM
кампания_настройщик Значение настройщика для связанного CustomizerAttribute на уровне Campaign.
кампания_драфт Проект кампании.
кампания_эксперимент Эксперимент A/B, в котором сравнивается эффективность базовой кампании (контрольной) и варианта этой кампании (экспериментальной).
кампания_extension_setting Настройка расширения кампании.
кампания_фид Канал кампании.
метка_кампании Представляет связь между кампанией и ярлыком.
кампания_shared_set CampaignSharedSets используются для управления общими наборами, связанными с кампанией.
кампания_симуляция Симуляция кампании. Ниже подробно описаны поддерживаемые комбинации типа рекламного канала, типа имитации и метода модификации имитации. Поиск - CPC_BID - UNIFORM SEAST - CPC_BIBD - SCASING SEAST - TARGET_CPA - Единый поиск - TARGET_CPA - Масштабирование поиск - TARGET_ROAS - Единый поиск - TARGET_IMPRESSION_SHARE - Единый Поиск - Бюджет - унифицированный покупки - Бюджет - унифицированный покупки OWNED_AND_OPERATED – TARGET_CPA – ДИСПЛЕЙ ПО УМОЛЧАНИЮ – TARGET_CPA – UNIFORM
носитель_константа Критерий оператора связи, который можно использовать в таргетинге кампании.
change_event Описывает детальное изменение возвращаемого ресурса определенных типов ресурсов. Будут показаны изменения, внесенные через пользовательский интерфейс, API и новые версии редактора внешними пользователями (включая внешних пользователей и внутренних пользователей, которые могут быть показаны снаружи) за последние 30 дней. Изменение показывает старые значения измененных полей до изменения и новые значения сразу после изменения. ChangeEvent может иметь задержку до 3 минут, чтобы отразить новое изменение.
изменить статус Описывает состояние возвращенного ресурса. ChangeStatus может иметь задержку до 3 минут, чтобы отразить новое изменение.
click_view Представление кликов с агрегированными показателями на каждом уровне кликов, включая как действительные, так и недействительные клики. Для кампаний, не связанных с поисковой сетью, metrics.clicks представляет количество действительных и недействительных взаимодействий. Запросы, включая ClickView, должны иметь фильтр, ограничивающий результаты одним днем, и могут быть запрошены для дат, предшествующих 90 дням до времени запроса.
комбинированная_аудитория Опишите ресурс для комбинированной аудитории, который включает разные аудитории.
convert_action Конверсионное действие.
convert_custom_variable Пользовательская переменная конверсии. См. раздел "О пользовательских переменных для конверсий" на странице https://support.google.com/google-ads/answer/9964350 .
convert_goal_campaign_config Настройки цели конверсии для кампании.
convert_value_rule Правило ценности конверсии
convert_value_rule_set Набор правил ценности конверсии
валюта_константа Валютная константа.
custom_audience Пользовательская аудитория. Это список пользователей по интересам.
custom_conversion_goal Пользовательская цель конверсии, которая может сделать произвольные действия-конверсии доступными для ставок.
custom_interest Пользовательский интерес. Это список пользователей по интересам.
покупатель Клиент.
клиент_актив Связь между клиентом и активом.
клиент_клиент Связь между данным клиентом и клиентом клиента. CustomerClients существуют только для менеджеров клиентов. Включены все прямые и непрямые клиенты-клиенты, а также сам менеджер.
customer_client_link Представляет отношение связи клиент-клиент.
customer_conversion_goal Контроль возможности назначения ставок для действий-конверсий с соответствующей категорией и источником.
customer_customizer Значение настройщика для связанного CustomizerAttribute на уровне клиента.
customer_extension_setting Настройка расширения клиента.
клиент_фид Лента клиентов.
customer_label Представляет связь между клиентом и меткой. Этот клиент может не иметь доступа ко всем ярлыкам, прикрепленным к нему. Дополнительные CustomerLabels могут быть возвращены путем увеличения разрешений с идентификатором пользователя-клиента.
customer_manager_link Представляет отношение связи клиент-менеджер.
customer_negative_criterion Отрицательный критерий исключения на уровне клиента.
customer_user_access Представляет разрешение одного пользователя на одного клиента.
customer_user_access_invitation Представлять приглашение новому пользователю в этой учетной записи клиента.
настройщик_атрибут Атрибут настройщика. Используйте CustomerCustomizer, CampaignCustomizer, AdGroupCustomizer или AdGroupCriterionCustomizer, чтобы связать атрибут настройщика и установить его значение на уровне критерия клиента, кампании, группы объявлений или группы объявлений соответственно.
detail_placement_view Представление с метриками, агрегированными по группе объявлений и URL-адресу или видео YouTube.
подробный_демографический Подробная демографическая информация: определенная вертикаль на основе интересов, на которую нужно ориентироваться, чтобы привлечь пользователей на основе фактов из долгосрочной жизни.
display_keyword_view Просмотр ключевого слова в КМС.
Distance_view Представление о расстоянии с показателями, агрегированными по расстоянию пользователя от адресов рекламодателя. Каждый DistanceBucket включает все показы, которые находятся в пределах его расстояния, и один показ будет влиять на показатели для всех DistanceBuckets, которые включают расстояние пользователя.
категория_домена Категория, созданная автоматически при сканировании домена. Если в кампании используется DynamicSearchAdsSetting, то для домена будут созданы категории домена. Категории могут быть настроены с помощью WebpageConditionInfo. См.: https://support.google.com/google-ads/answer/2471185 .
dynamic_search_ads_search_term_view Представление поискового запроса динамических поисковых объявлений.
expand_landing_page_view Представление целевой страницы с метриками, собранными на уровне расширенного конечного URL.
extension_feed_item Элемент ленты расширений.
подача Корм.
feed_item Элемент фида.
feed_item_set Представляет набор элементов фида. Этот набор можно использовать и совместно использовать для определенных функций элемента фида. Например, на набор можно ссылаться в функциях сопоставления CustomerFeed, CampaignFeed и AdGroupFeed.
feed_item_set_link Представляет связь между FeedItem и FeedItemSet.
feed_item_target Цель элемента фида.
feed_mapping Отображение каналов.
feed_placeholder_view Представление заполнителя фида.
гендер_представление Гендерный взгляд.
geo_target_constant Константа геотаргетинга.
geographic_view Географический вид. Географическое представление включает все показатели, агрегированные на уровне страны, по одной строке на страну. Он сообщает о показателях либо в фактическом физическом местонахождении пользователя, либо в интересующей его области. Если используются другие поля сегмента, вы можете получить более одной строки для каждой страны.
group_placement_view Просмотр группового размещения.
hotel_group_view Групповой вид отеля.
hotel_performance_view Обзор производительности отеля.
hotel_reconciliation Гостиничное примирение. Он содержит информацию о конверсиях из бронирований отелей для сверки с записями рекламодателей. Эти строки могут быть обновлены или аннулированы до выставления счетов с помощью массовой загрузки.
доход_диапазон_просмотра Представление диапазона доходов.
план_ключевых_слов План Планировщика ключевых слов. Максимальное количество сохраненных планов ключевых слов: 10000. При достижении лимита планы можно удалить.
группа ключевых_планов_объявлений Группа объявлений Планировщика ключевых слов. Максимальное количество групп объявлений плана ключевых слов на план: 200.
keyword_plan_ad_group_keyword Ключевое слово группы объявлений плана ключевых слов. Максимальное количество ключевых слов в плане ключевых слов на план: 10000.
keyword_plan_campaign Кампания с планом ключевых слов. Максимально допустимое количество кампаний с планом ключевых слов на план: 1.
keyword_plan_campaign_keyword Ключевое слово кампании плана ключевых слов. Для ключевого слова кампании поддерживаются только минус-слова.
ключевое слово_тема_константа Константа темы ключевого слова Smart Campaign.
ключевое_просмотр Просмотр по ключевому слову.
этикетка Этикетка.
лендинг_страница_просмотр Представление целевой страницы с метриками, собранными на уровне нераскрытого конечного URL.
язык_константа Язык.
случай из жизни Жизненное событие: определенная вертикаль на основе интересов, на которую нужно ориентироваться, чтобы привлечь пользователей, когда они находятся в разгаре важных жизненных вех.
location_view Представление местоположения суммирует эффективность кампаний по критериям местоположения.
Managed_placement_view Представление управляемого места размещения.
медиа_файл Медиафайл.
mobile_app_category_constant Константа категории мобильного приложения.
mobile_device_constant Константа мобильного устройства.
offline_user_data_job Задание, содержащее автономные пользовательские данные о посетителях магазина или членах списка пользователей, которые будут обрабатываться асинхронно. Загруженные данные недоступны для чтения, а результаты обработки задания можно прочитать только с помощью OfflineUserDataJobService.GetOfflineUserDataJob.
операционная_система_версия_константа Версия мобильной операционной системы или диапазон версий, в зависимости от operator_type . Список доступных мобильных платформ на странице https://developers.google.com/google-ads/api/reference/data/codes-formats#mobile-platforms .
платный_органический_поиск_термин_просмотр Платное представление поисковых запросов, обеспечивающее просмотр статистики поиска по объявлениям и органическим спискам, сгруппированных по поисковым запросам на уровне группы объявлений.
parental_status_view Просмотр родительского статуса.
product_bidding_category_constant Категория ставок продукта.
product_group_view Представление группы товаров.
рекомендация Рекомендация.
remarketing_action Действие ремаркетинга. Фрагмент кода JavaScript, который будет собирать идентификатор продукта и тип страницы, посещенной людьми (страница продукта, страница корзины покупок, страница покупки, общее посещение сайта) на веб-сайте рекламодателя.
search_term_view Представление поискового запроса с показателями, агрегированными по поисковым запросам на уровне группы объявлений.
общий_критерий Критерий, принадлежащий общему набору.
общий_набор SharedSets используются для совместного использования исключений критериев в нескольких кампаниях.
shopping_performance_view Просмотр эффективности покупок. Предоставляет статистику торговой кампании, агрегированную по нескольким уровням параметров продукта. Значения параметров продукта из Merchant Center, таких как бренд, категория, настраиваемые атрибуты, состояние продукта и тип продукта, будут отражать состояние каждого параметра на дату и время регистрации соответствующего события.
smart_campaign_search_term_view Представление поискового запроса умной кампании.
smart_campaign_setting Настройки для настройки умных кампаний.
Third_Party_app_analytics_link Соединение для обмена данными, позволяющее импортировать аналитику сторонних приложений в клиента Google Рекламы.
тема_константа Используйте темы для таргетинга или исключения мест размещения в контекстно-медийной сети Google в зависимости от категории, к которой относится это место размещения (например, «Домашние животные и животные/Домашние животные/Собаки»).
тема_представление Тематический вид.
user_interest Интерес пользователя: конкретная вертикаль на основе интересов, на которую нужно ориентироваться.
список_пользователей Список пользователей. Это список пользователей, на которых может ориентироваться клиент.
user_location_view Просмотр местоположения пользователя. Представление местоположения пользователя включает все показатели, агрегированные на уровне страны, по одной строке на страну. Он сообщает о показателях фактического физического местоположения пользователя по целевому или нецелевому местоположению. Если используются другие поля сегмента, вы можете получить более одной строки для каждой страны.
видео Видео.
веб-страница_просмотр Просмотр веб-страницы.