Тип отчета: группа объявлений.

Показатели эффективности и атрибуты конфигурации для групп объявлений.

Этот отчет может быть возвращен только асинхронным запросом (то есть через метод Reports.request() ).

Запросить выдержку

Отправьте обычное тело запроса Reports.request() , но укажите "reportType": "adGroup" . 

{
...
  "reportType": "adGroup",
  "columns": [
    {
      "columnName": string,
      "headerText": string,
      "startDate": string,
      "endDate": string
    }
  ],
  "filters": [
    {
      "column": {
        "columnName": string,
      },
      ...
    },
    ...
  ],
...
}

Для каждого столбца, который вы хотите вернуть или отфильтровать в отчете, укажите columnName , указанное в таблице ниже. Вы также можете дополнительно указать headerText , startDate и endDate . Обратите внимание, что некоторые столбцы нельзя фильтровать; см. раздел «Фильтрируемый» в таблице ниже.

columnName Описание Поведение Тип Фильтруемый
status Псевдоним атрибута adGroupStatus . атрибут Status Да
engineStatus Дополнительный статус группы объявлений во внешнем аккаунте движка. Возможные статусы (в зависимости от типа внешней учетной записи): eligible , campaign ended и т. д. атрибут String Да
creationTimestamp Временная метка создания группы объявлений в формате ISO 8601. атрибут Timestamp Да
lastModifiedTimestamp Временная метка последнего изменения группы объявлений в формате ISO 8601. атрибут Timestamp Да
agency Название агентства. атрибут String Да
agencyId Идентификатор агентства DS. атрибут ID Да
advertiser Имя рекламодателя. атрибут String Да
advertiserId Идентификатор рекламодателя DS. атрибут ID Да
account Имя учетной записи системы. атрибут String Да
accountId Идентификатор учетной записи ядра DS. атрибут ID Да
accountEngineId Идентификатор учетной записи во внешней учетной записи системы. атрибут String Да
accountType Тип учетной записи системы: Google AdWords , Bing Ads , Yahoo Japan Listing Ads , Yahoo Search Marketing , Yahoo Gemini , Baidu или Comparison Shopping . атрибут Engine type Да
campaign Название кампании. атрибут String Да
campaignId Идентификатор кампании DS. атрибут ID Да
campaignStatus Статус кампании, содержащей этот элемент. атрибут Status Да
adRotation Ротация показа объявлений, используемая группой объявлений: Optimize или Rotate indefinitely . атрибут String Нет
adGroup Название группы объявлений. атрибут String Да
adGroupId Идентификатор группы объявлений DS. атрибут ID Да
adGroupStatus Статус группы объявлений: Active , Paused или Removed . Обратите внимание, что кампании, группы объявлений, ключевые слова, объявления и цели имеют свой собственный статус. Смотрите статус . атрибут Status Да
adGroupEngineId Идентификатор группы объявлений во внешнем аккаунте системы. атрибут ID Да
adGroupStartDate Дата начала группы объявлений. атрибут Date Да
adGroupEndDate Дата окончания группы объявлений. атрибут Date Да
adGroupSearchMaxCpc Ставка по умолчанию для поисковых ключевых слов в этой группе объявлений. атрибут Money Да
adGroupBroadMaxCpc Ставка по умолчанию для ключевых слов поиска с широким соответствием в этой группе объявлений (только для объявлений Bing). атрибут Money Да
adGroupExactMaxCpc Ставка по умолчанию для ключевых слов с точным соответствием в этой группе объявлений (только для объявлений Bing). атрибут Money Да
adGroupPhraseMaxCpc Ставка по умолчанию для ключевых слов с фразовым соответствием в этой группе объявлений (только для объявлений Bing). атрибут Money Да
adGroupContentMaxCpc Ставка по умолчанию для ключевых слов содержания в этой группе объявлений. атрибут Money Да
adGroupMobileBidAdjustment Процент корректировки ставок для мобильных устройств. Например, 0,2 означает увеличение на 20 %, поэтому ставки для мобильных устройств в 1,2 раза превышают ставку по умолчанию. Диапазон допустимых значений различается в зависимости от внешнего механизма. атрибут Number Да
adGroupTabletBidAdjustment Процент корректировки ставок для планшетов. Например, 0,2 означает увеличение на 20 %, поэтому ставки для планшетов в 1,2 раза превышают ставку по умолчанию. Диапазон допустимых значений различается в зависимости от внешнего механизма. атрибут Number Да
adGroupDesktopBidAdjustment Процент корректировки ставок для настольных компьютеров. Например, 0,2 означает увеличение на 20 %, поэтому ставки для настольных компьютеров в 1,2 раза превышают ставку по умолчанию. Диапазон допустимых значений различается в зависимости от внешнего механизма. атрибут Number Да
adGroupType (Применимо только к Google Рекламе) Указывает тип группы объявлений: Standard , Dynamic или Showcase . атрибут Ad group type Да
bingAdsLanguage Язык объявлений и ключевых слов в группе объявлений Bing Ads. атрибут Microsoft language code Да
bingAdsAdDistributions Каналы распространения рекламы, используемые группами объявлений Bing Ads; сочетание Search и Content . атрибут String Нет
adGroupLabels Названия ярлыков, напрямую присвоенных этой группе объявлений; унаследованные метки не включаются. атрибут String list Да
effectiveBidStrategyId Идентификатор DS стратегии назначения ставок, назначенной этому объекту или унаследованной этим объектом. атрибут ID Да
effectiveBidStrategy Название стратегии назначения ставок, назначенное этому объекту или унаследованное этим объектом. атрибут String Да
bidStrategyInherited Указывает, наследуется ли стратегия назначения ставок этого объекта. атрибут Boolean Да
deviceTargets Таргетинг на устройства на уровне группы объявлений; сочетание Desktop , Mobile , Tablet или Other . атрибут String Нет
effectiveDeviceTargets Целевые устройства на уровне группы объявлений или унаследованные от кампании; сочетание Desktop , Mobile , Tablet или Other . атрибут String Нет
countryTargets Целевые страны, включенные в группу объявлений. Загрузите шаблоны загрузки и географические/языковые коды . атрибут String Нет
provinceTargets Целевые регионы включены в группу объявлений. Загрузите шаблоны загрузки и географические/языковые коды . атрибут String Нет
metroTargets Целевые объекты Metro, включенные в группу объявлений. Загрузите шаблоны загрузки и географические/языковые коды . атрибут String Нет
cityTargets Целевые города, включенные в группу объявлений. Загрузите шаблоны загрузки и географические/языковые коды . атрибут String Нет
effectiveCountryTargets Целевые страны включены в группу объявлений или унаследованы от кампании. Загрузите шаблоны загрузки и географические/языковые коды . атрибут String Нет
effectiveProvinceTargets Целевые регионы включены в группу объявлений или унаследованы от кампании. Загрузите шаблоны загрузки и географические/языковые коды . атрибут String Нет
effectiveMetroTargets Цели Metro, включенные в группу объявлений или унаследованные от кампании. Загрузите шаблоны загрузки и географические/языковые коды . атрибут String Нет
effectiveCityTargets Целевые города, включенные в группу объявлений или унаследованные от кампании. Загрузите шаблоны загрузки и географические/языковые коды . атрибут String Нет
effectiveLabels Названия всех ярлыков, унаследованных или напрямую назначенных этой группе объявлений. атрибут String list Да
engineRemarketingListTargetAll Указывает, использует ли группа объявлений только цели ремаркетинга для корректировки ставок.

Возможные значения:

  • Да. В группе объявлений используются цели ремаркетинга для корректировки ставок.
  • Нет. Группа объявлений показывает рекламу только участникам целей ремаркетинга и может использовать цели ремаркетинга для корректировки ставок.
 атрибут Boolean Да
clicksWithFeedItemShowing Нажимает на любую ссылку в объявлении во время отображения элемента ленты. Этот столбец возвращает значение только в отчете по элементам фида или в отчете, сегментированном по столбцу элемента фида. метрика Integer Да
costWithFeedItemShowing Стоимость всех объявлений во время показа элемента фида. Этот столбец возвращает значение только в отчете по элементам фида или в отчете, сегментированном по столбцу элемента фида. метрика Money Да
dfaActions Общее количество действий Менеджера кампании. метрика Integer Да
dfaRevenue Совокупный доход, полученный от транзакций Менеджера кампаний. метрика Money Да
dfaTransactions Общее количество транзакций Менеджера кампаний. метрика Integer Да
dfaWeightedActions Взвешенная сумма действий Менеджера кампании. метрика Number Да
dfaActionsCrossEnv Общее количество действий Менеджера кампании в разных средах. метрика Number Да
dfaRevenueCrossEnv Совокупный доход, полученный от транзакций Менеджера кампаний в разных средах. метрика Money Да
dfaTransactionsCrossEnv Общее количество транзакций Менеджера кампаний в разных средах. метрика Number Да
dfaWeightedActionsCrossEnv Взвешенная сумма действий менеджера кампании в разных средах. метрика Number Да
avgCpc Средняя стоимость клика. метрика Money Да
avgCpm Средняя стоимость за тысячу показов. метрика Money Да
avgPos Средняя позиция. метрика Number Да
clicks Совокупность кликов. метрика Integer Да
cost Совокупная стоимость, выплаченная на счет(а) системы. метрика Money Да
ctr Средний рейтинг кликов. метрика Number Да
impr Общее количество показов. метрика Integer Да
adWordsConversions Данные, которые рекламодатель настроил для отображения в столбце «Конверсии Google Рекламы». При создании действия-конверсии Google Рекламы рекламодатель может выбрать, следует ли учитывать эти конверсии в столбце отчета "Конверсии" . метрика Number Да
adWordsConversionValue Совокупная ценность конверсий Google Рекламы. метрика Number Да
adWordsViewThroughConversions Общее количество конверсий по показам Google Рекламы. метрика Integer Да
visits Общее количество посещений DS. метрика Integer Да
searchImpressionShare Только Google Ads и Bing Ads. Количество показов, полученных вами в поисковой сети, разделенное на расчетное количество показов, которые вы имели право получить. Возвращается как число от 0,1 до 1 или, если доля меньше 0,1, строка < 10% . метрика Impression share Да
searchRankLostImpressionShare Только Google Ads и Bing Ads. Процент времени, когда ваши объявления не показывались в поисковой сети из-за низкого рейтинга объявления. Возвращается в виде числа от 0 до 0,9 или, если доля больше 0,9, в виде строки > 90% . метрика Impression share Да
displayImpressionShare Только Google Реклама. Количество показов, полученных вами в контекстно-медийной сети, разделенное на расчетное количество показов, которые вы имели право получить. Возвращается как число от 0,1 до 1 или, если доля меньше 0,1, строка < 10% . метрика Impression share Да
displayRankLostImpressionShare Только Google Реклама. Процент времени, когда ваши объявления не показывались в контекстно-медийной сети из-за низкого рейтинга объявления. Возвращается в виде числа от 0 до 0,9 или, если доля больше 0,9, в виде строки > 90% . метрика Impression share Да
qualityScoreAvg Только Google Ads и Bing Ads. Средневзвешенное по показам значение показателя качества (QS) системы за все дни и ключевые слова в области отчета. метрика Number Да
topOfPageBidAvg Только Google Реклама. Приблизительно равна средней ставке CPC, необходимой в течение периода времени, указанного в отчете, чтобы ваши объявления регулярно появлялись на верхних позициях над результатами поиска. метрика Money Да
absoluteTopImpressionPercentage Процент показов вашей рекламы, которые показываются как самое первое объявление над результатами обычного поиска. метрика Impression share Да
searchAbsoluteTopImpressionShare Количество показов, полученных вами в самой верхней позиции (самое первое объявление над обычными результатами поиска), разделенное на расчетное количество показов, которые вы имели право получить в самой верхней позиции. метрика Impression share Да
topImpressionPercentage Процент показов вашей рекламы, которые показываются где-либо над обычными результатами поиска. метрика Impression share Да
searchTopImpressionShare Показы, которые вы получили в верхней позиции (любом месте над обычными результатами поиска), по сравнению с расчетным количеством показов, которые вы имели право получить в верхней позиции. метрика Impression share Да
searchRankLostAbsoluteTopImpressionShare Оценивает, как часто ваше объявление не было самым первым объявлением над результатами обычного поиска из-за низкого рейтинга объявления. метрика Impression share Да
searchRankLostTopImpressionShare Оценивает, как часто ваше объявление не показывалось над результатами обычного поиска из-за низкого рейтинга объявления. метрика Impression share Да
date Сегментирует отчет по дням; каждая строка и ее совокупные показатели разбиваются на несколько строк, по одной на каждый день. Этот столбец возвращает дату каждой строки. сегмент Date Да
monthStart Сегментирует отчет по месяцам; каждая строка и ее совокупные показатели разбиваются на несколько строк, по одной на каждый месяц. Этот столбец возвращает первый день месяца каждой строки. сегмент Date Да
monthEnd Сегментирует отчет по месяцам; каждая строка и ее совокупные показатели разбиваются на несколько строк, по одной на каждый месяц. Этот столбец возвращает последний день месяца каждой строки. сегмент Date Да
quarterStart Сегментирует отчет по кварталам; каждая строка и ее совокупные показатели разбиваются на несколько строк, по одной на каждый квартал. Этот столбец возвращает первый день квартала каждой строки. сегмент Date Да
quarterEnd Сегментирует отчет по кварталам; каждая строка и ее совокупные показатели разбиваются на несколько строк, по одной на каждый квартал. Этот столбец возвращает последний день квартала каждой строки. сегмент Date Да
weekStart Сегментирует отчет по неделям (с воскресенья по субботу); каждая строка и ее совокупные показатели разбиваются на несколько строк, по одной на каждую неделю. Этот столбец возвращает первый день (воскресенье) каждой строки. сегмент Date Да
weekEnd Сегментирует отчет по неделям (с воскресенья по субботу); каждая строка и ее совокупные показатели разбиваются на несколько строк, по одной на каждую неделю. Этот столбец возвращает последний день (суббота) каждой строки. сегмент Date Да
yearStart Сегментирует отчет по годам; каждая строка и ее совокупные показатели разбиваются на несколько строк, по одной на каждый год. Этот столбец возвращает первый день года каждой строки. сегмент Date Да
yearEnd Сегментирует отчет по годам; каждая строка и ее совокупные показатели разбиваются на несколько строк, по одной на каждый год. Этот столбец возвращает последний день года каждой строки. сегмент Date Да
deviceSegment Сегментирует отчет по устройствам; каждая строка и ее совокупные показатели разбиваются на несколько строк, до одной для каждого сегмента устройства. Этот столбец возвращает сегмент устройства каждой строки. сегмент Device segment Да
floodlightGroup Сегментирует отчет по группам Floodlight; каждая строка и ее совокупные показатели разбиваются на несколько строк, до одной для каждой группы Floodlight. В этом столбце возвращается название группы Floodlight для каждой строки. Обратите внимание, что некоторые показатели не имеют сегментированных значений Floodlight, например клики и посещения. сегмент String Да
floodlightGroupId Сегментирует отчет по группам Floodlight; каждая строка и ее совокупные показатели разбиваются на несколько строк, до одной для каждой группы Floodlight. В этом столбце возвращается идентификатор группы DS Floodlight для каждой строки. Обратите внимание, что некоторые показатели не имеют сегментированных значений Floodlight, например клики и посещения. сегмент ID Да
floodlightGroupTag Сегментирует отчет по группам Floodlight; каждая строка и ее совокупные показатели разбиваются на несколько строк, до одной для каждой группы Floodlight. В этом столбце возвращается тег группы Floodlight для каждой строки. Обратите внимание, что некоторые показатели не имеют сегментированных значений Floodlight, например клики и посещения. сегмент String Да
floodlightActivity Сегментирует отчет по действиям Floodlight; каждая строка и ее совокупные показатели разбиваются на несколько строк, до одной для каждого действия Floodlight. В этом столбце возвращается название действия Floodlight для каждой строки. Обратите внимание, что некоторые показатели не имеют сегментированных значений Floodlight, например клики и посещения. сегмент String Да
floodlightActivityId Сегментирует отчет по действиям Floodlight; каждая строка и ее совокупные показатели разбиваются на несколько строк, до одной для каждого действия Floodlight. В этом столбце возвращается идентификатор действия DS Floodlight для каждой строки. Обратите внимание, что некоторые показатели не имеют сегментированных значений Floodlight, например клики и посещения. сегмент ID Да
floodlightActivityTag Сегментирует отчет по действиям Floodlight; каждая строка и ее совокупные показатели разбиваются на несколько строк, до одной для каждого действия Floodlight. В этом столбце возвращается тег активности Floodlight для каждой строки. Обратите внимание, что некоторые показатели не имеют сегментированных значений Floodlight, например клики и посещения. сегмент String Да
sitelinkDisplayText Сегментирует отчет по дополнительным ссылкам; каждая строка и ее совокупные показатели разделены на несколько строк, по одной для каждой дополнительной ссылки. В этом столбце отображается текст дополнительной ссылки для каждой строки. сегмент String Да
sitelinkDescription1 Сегментирует отчет по дополнительным ссылкам; каждая строка и ее совокупные показатели разделены на несколько строк, по одной для каждой дополнительной ссылки. В этом столбце возвращается описание дополнительной ссылки 1 для каждой строки. сегмент String Да
sitelinkDescription2 Сегментирует отчет по дополнительным ссылкам; каждая строка и ее совокупные показатели разделены на несколько строк, по одной для каждой дополнительной ссылки. В этом столбце возвращается описание дополнительной ссылки 2 для каждой строки. сегмент String Да
sitelinkLandingPageUrl Сегментирует отчет по дополнительным ссылкам; каждая строка и ее совокупные показатели разделены на несколько строк, по одной для каждой дополнительной ссылки. В этом столбце возвращается URL-адрес целевой страницы дополнительной ссылки в каждой строке. сегмент String Да
sitelinkClickserverUrl Сегментирует отчет по дополнительным ссылкам; каждая строка и ее совокупные показатели разделены на несколько строк, по одной для каждой дополнительной ссылки. В этом столбце возвращается URL-адрес сервера кликов дополнительной ссылки для каждой строки. сегмент String Да
locationBusinessName Сегментирует отчет по обновленным расширениям адресов, связанным с аккаунтом профиля компании; каждая строка и ее совокупные показатели разбиваются на несколько строк, по одной для каждого местоположения, в котором имеются доступные метрики. Этот столбец возвращает название компании для каждой строки. сегмент String Да
locationCategory Сегментирует отчет по обновленным расширениям адресов, связанным с аккаунтом профиля компании; каждая строка и ее совокупные показатели разбиваются на несколько строк, по одной для каждого местоположения, в котором имеются доступные метрики. Этот столбец возвращает категорию местоположения для каждой строки. сегмент String Да
locationDetails Сегментирует отчет по обновленным расширениям адресов, связанным с аккаунтом профиля компании; каждая строка и ее совокупные показатели разбиваются на несколько строк, по одной для каждого местоположения, в котором имеются доступные метрики. Этот столбец возвращает сведения о местоположении каждой строки. сегмент String Да
locationFilter Сегментирует отчет по обновленным расширениям адресов, связанным с аккаунтом профиля компании; каждая строка и ее совокупные показатели разбиваются на несколько строк, по одной для каждого местоположения, в котором имеются доступные метрики. Этот столбец возвращает фильтр местоположения для каждой строки. сегмент String Нет
callPhoneNumber Сегментирует отчет по номеру телефона; каждая строка и ее совокупные показатели разбиваются на несколько строк, по одной для каждого добавочного номера телефона. В этом столбце возвращается номер телефона расширения. сегмент String Да
callCountryCode Сегментирует отчет по номеру телефона; каждая строка и ее совокупные показатели разбиваются на несколько строк, по одной для каждого добавочного номера телефона. В этом столбце возвращается код страны расширения номера телефона в каждой строке. сегмент String Да
callIsTracked Сегментирует отчет по номеру телефона; каждая строка и ее совокупные показатели разбиваются на несколько строк, по одной для каждого добавочного номера телефона. Этот столбец возвращает значение true, если вызовы добавочного номера телефона будут отслеживаться, в противном случае — значение false. сегмент Boolean Да
callCallOnly Сегментирует отчет по номеру телефона; каждая строка и ее совокупные показатели разбиваются на несколько строк, по одной для каждого добавочного номера телефона. Этот столбец возвращает значение true, если расширение вызова показывает только номер телефона, или значение false, если расширение отображает и номер телефона, и ссылку. сегмент Boolean Да
callConversionTracker Сегментирует отчет по номерам телефонов; каждая строка и ее совокупные показатели разбиваются на несколько строк, по одной для каждого добавочного номера телефона. В этом столбце возвращается имя средства отслеживания конверсий, связанного с элементом фида, если оно существует. сегмент String Да
callConversionTrackerId Сегментирует отчет по номерам телефонов; каждая строка и ее совокупные показатели разбиваются на несколько строк, по одной для каждого добавочного номера телефона. В этом столбце возвращается идентификатор средства отслеживания конверсий, связанного с номером телефона, если таковой существует. сегмент ID Да
appId Сегментирует отчет по расширению приложения; каждая строка и ее совокупные показатели разбиваются на несколько строк, по одной для каждого расширения приложения. Этот столбец возвращает идентификатор приложения, если таковой существует. сегмент String Да
appStore Сегментирует отчет по расширению приложения; каждая строка и ее совокупные показатели разбиваются на несколько строк, по одной для каждого расширения приложения. В этом столбце возвращается тип магазина приложений (Apple App Store, Google Play Store), если таковой существует. сегмент App store Да
feedItemId Сегментирует отчет по элементам фида; каждая строка и ее совокупные показатели разбиваются на несколько строк, по одной для каждого элемента фида. В этом столбце возвращается идентификатор строки элемента фида DS для каждой строки. сегмент ID Да
feedId Сегментирует отчет по элементам фида; каждая строка и ее совокупные показатели разбиваются на несколько строк, по одной для каждого элемента фида. Этот столбец возвращает идентификатор таблицы каналов DS для каждой строки. сегмент ID Да
feedType Сегментирует отчет по элементам фида; каждая строка и ее совокупные показатели разбиваются на несколько строк, по одной для каждого элемента фида. Этот столбец возвращает тип элемента фида для каждой строки. сегмент Feed type Да