Показатели эффективности и атрибуты конфигурации для групп объявлений.
Этот отчет может быть возвращен только асинхронным запросом (то есть через метод 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 | ID аккаунта во внешнем движке аккаунта. | атрибут | 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 Ads). | атрибут | Money | Да |
adGroupExactMaxCpc | Ставка по умолчанию для ключевых слов с точным соответствием в этой группе объявлений (только для Bing Ads). | атрибут | Money | Да |
adGroupPhraseMaxCpc | Ставка по умолчанию для ключевых слов с фразовым соответствием в этой группе объявлений (только для Bing Ads). | атрибут | 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 | Метроцели, включенные в группу объявлений. Загрузите шаблоны загрузки и коды географических/языковых кодов . | атрибут | String | Нет |
cityTargets | Городские цели, включенные в группу объявлений. Загрузите шаблоны загрузки и коды географических/языковых кодов . | атрибут | String | Нет |
effectiveCountryTargets | Целевые страны включены в группу объявлений или унаследованы от кампании. Загрузите шаблоны загрузки и коды географических/языковых кодов . | атрибут | String | Нет |
effectiveProvinceTargets | Целевые регионы включены в группу объявлений или унаследованы от кампании. Загрузите шаблоны загрузки и коды географических/языковых кодов . | атрибут | String | Нет |
effectiveMetroTargets | Метроцели, включенные в группу объявлений или унаследованные от кампании. Загрузите шаблоны загрузки и коды географических/языковых кодов . | атрибут | 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 Ads". Когда создается действие-конверсия Google Реклама, рекламодатель может выбрать, учитывать ли эти конверсии в столбце отчетов "Конверсии" . | метрика | Number | Да |
adWordsConversionValue | Совокупная ценность конверсий Google Ads. | метрика | Number | Да |
adWordsViewThroughConversions | Общее количество конверсий по показам в Google Рекламе. | метрика | Integer | Да |
visits | Общее количество посещений ДС. | метрика | 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 | Да |