Показатели эффективности и атрибуты конфигурации для групп объявлений.
Этот отчет может быть возвращен только асинхронным запросом (то есть через метод 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 | Да |