Показатели эффективности и атрибуты конфигурации для кампаний.
Этот отчет может быть возвращен только асинхронным запросом (то есть через метод Reports.request() ).
Запросить выдержку
Отправьте обычное тело запроса Reports.request() , но укажите "reportType": "campaign" .
{
...
"reportType": "campaign",
"columns": [
{
"columnName": string,
"headerText": string,
"startDate": string,
"endDate": string
}
],
"filters": [
{
"column": {
"columnName": string,
},
...
},
...
],
...
} Для каждого столбца, который вы хотите вернуть или отфильтровать в отчете, укажите columnName , указанное в таблице ниже. Вы также можете дополнительно указать headerText , startDate и endDate . Обратите внимание, что некоторые столбцы нельзя фильтровать; см. раздел «Фильтрируемый» в таблице ниже.
columnName | Описание | Поведение | Тип | Фильтруемый |
|---|---|---|---|---|
status | Псевдоним атрибута campaignStatus . | атрибут | Status | Да |
engineStatus | Дополнительный статус кампании во внешнем аккаунте движка. Возможные статусы (в зависимости от типа внешнего аккаунта): disapproved , budget constrained и т. д. | атрибут | 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 | Статус кампании: Active , Paused или Removed . Обратите внимание, что кампании, группы объявлений, ключевые слова, объявления и цели имеют свой собственный статус. Смотрите статус . | атрибут | Status | Да |
campaignEngineId | Идентификатор кампании во внешнем аккаунте системы. | атрибут | ID | Да |
campaignStartDate | Дата начала кампании. | атрибут | Date | Да |
campaignEndDate | Дата окончания кампании. | атрибут | Date | Да |
bingAdsBudgetType | Как контролируется бюджет для кампаний Bing Ads: Daily budget , Monthly even spend , Monthly accelerated spend , Daily accelerated spend или Daily even spend . | атрибут | Microsoft Advertising budget type | Да |
dailyBudget | Дневной бюджет кампании. | атрибут | Money | Да |
monthlyBudget | Ежемесячный бюджет кампании. | атрибут | Money | Да |
deliveryMethod | Способ доставки бюджета кампании: Standard или Accelerated . | атрибут | Budget delivery method | Да |
adWordsBidStrategy | Стратегия назначения ставок, которую Google Реклама использует для этой кампании: Manual cpc , Manual cpm , Percent cpa , Budget optimizer или Conversion optimizer . В кампаниях, использующих стратегии назначения ставок DS, установлена Manual cpc или Manual cpm . | атрибут | AdWords bid strategy | Да |
yahooJapanBidStrategy | Стратегия ставок Yahoo! В ЯПОНИИ для этой кампании используется Manual cpc или Budget optimizer . В кампаниях, использующих стратегии назначения ставок DS, установлена Manual cpc . | атрибут | Yahoo! JAPAN bid strategy | Да |
keywordNearMatchEnabled | Включено ли ключевое слово, близкое к совпадению, для кампании: Enabled или Disabled . | атрибут | Keyword match setting | Да |
campaignMobileBidAdjustment | Процент корректировки ставок для мобильных устройств. Например, 0,2 означает увеличение на 20 %, поэтому ставки для мобильных устройств в 1,2 раза превышают ставку по умолчанию. Диапазон допустимых значений различается в зависимости от внешнего механизма. | атрибут | Number | Да |
campaignTabletBidAdjustment | Процент корректировки ставок для планшетов. Например, 0,2 означает увеличение на 20 %, поэтому ставки для планшетов в 1,2 раза превышают ставку по умолчанию. Диапазон допустимых значений различается в зависимости от внешнего механизма. | атрибут | Number | Да |
campaignDesktopBidAdjustment | Процент корректировки ставок для настольных компьютеров. Например, 0,2 означает увеличение на 20 %, поэтому ставки для настольных компьютеров в 1,2 раза превышают ставку по умолчанию. Диапазон допустимых значений различается в зависимости от внешнего механизма. | атрибут | Number | Да |
networkTarget | Тип сетей, в которых рекламируется кампания. | атрибут | String | Нет |
yahooGeoTargets | Географические цели для кампаний Yahoo Search Marketing. См. раздел Загрузка шаблонов загрузки и географических/языковых кодов . | атрибут | String | Нет |
campaignLabels | Названия ярлыков, напрямую назначенных этой кампании; унаследованные метки не включаются. | атрибут | String list | Да |
campaignType | Указывает тип кампании: Manual , Inventory , Inventory - PLA , Shopping , Comparison shopping , Mobile app install , Universal app или Smart shopping . | атрибут | Campaign type | Да |
effectiveBidStrategyId | Идентификатор DS стратегии назначения ставок, назначенной этому объекту или унаследованной этим объектом. | атрибут | ID | Да |
effectiveBidStrategy | Название стратегии назначения ставок, назначенное этому объекту или унаследованное этим объектом. | атрибут | String | Да |
bidStrategyInherited | Указывает, наследуется ли стратегия назначения ставок этого объекта. | атрибут | Boolean | Да |
deviceTargets | Таргетинг на устройства на уровне кампании; сочетание Desktop , Mobile , Tablet или Other . | атрибут | String | Нет |
effectiveDeviceTargets | Таргетинг на устройства на уровне кампании; сочетание Desktop , Mobile , Tablet или Other . | атрибут | String | Нет |
languageTargets | Языковые цели на уровне кампании. Загрузите шаблоны загрузки и географические/языковые коды . | атрибут | String | Нет |
countryTargets | Страновые цели, включенные в кампанию. Загрузите шаблоны загрузки и географические/языковые коды . | атрибут | String | Нет |
provinceTargets | Провинциальные цели включены в кампанию. Загрузите шаблоны загрузки и географические/языковые коды . | атрибут | String | Нет |
metroTargets | Цели метро, включенные в кампанию. Загрузите шаблоны загрузки и географические/языковые коды . | атрибут | String | Нет |
cityTargets | Городские цели, включенные в кампанию. Загрузите шаблоны загрузки и географические/языковые коды . | атрибут | String | Нет |
effectiveCountryTargets | Страновые цели, включенные в кампанию. Загрузите шаблоны загрузки и географические/языковые коды . | атрибут | String | Нет |
effectiveProvinceTargets | Провинциальные цели включены в кампанию. Загрузите шаблоны загрузки и географические/языковые коды . | атрибут | String | Нет |
effectiveMetroTargets | Цели метро, включенные в кампанию. Загрузите шаблоны загрузки и географические/языковые коды . | атрибут | String | Нет |
effectiveCityTargets | Городские цели, включенные в кампанию. Загрузите шаблоны загрузки и географические/языковые коды . | атрибут | String | Нет |
excludedCountryTargets | Целевые страны исключены из кампании. Загрузите шаблоны загрузки и географические/языковые коды . | атрибут | String | Нет |
excludedProvinceTargets | Провинциальные цели исключены из кампании. Загрузите шаблоны загрузки и географические/языковые коды . | атрибут | String | Нет |
excludedMetroTargets | Объекты Metro исключены из кампании. Загрузите шаблоны загрузки и географические/языковые коды . | атрибут | String | Нет |
excludedCityTargets | Городские цели исключены из кампании. Загрузите шаблоны загрузки и географические/языковые коды . | атрибут | String | Нет |
effectiveLabels | Названия всех ярлыков, унаследованных или напрямую назначенных этой кампании. | атрибут | String list | Да |
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 | Да |
searchBudgetLostImpressionShare | Только Google Ads и Bing Ads. Процент времени, когда ваши объявления не показывались в поисковой сети из-за недостаточного бюджета. Возвращается в виде числа от 0 до 0,9 или, если доля больше 0,9, в виде строки > 90% . | метрика | 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 | Да |
displayBudgetLostImpressionShare | Только Google Реклама. Процент времени, когда ваши объявления не показывались в контекстно-медийной сети из-за недостаточного бюджета. Возвращается в виде числа от 0 до 0,9 или, если доля больше 0,9, в виде строки > 90% . | метрика | Impression share | Да |
displayRankLostImpressionShare | Только Google Реклама. Процент времени, когда ваши объявления не показывались в контекстно-медийной сети из-за низкого рейтинга объявления. Возвращается в виде числа от 0 до 0,9 или, если доля больше 0,9, в виде строки > 90% . | метрика | Impression share | Да |
qualityScoreAvg | Только Google Ads и Bing Ads. Средневзвешенное по показам значение показателя качества (QS) системы по всем дням и ключевым словам в области отчета. | метрика | Number | Да |
topOfPageBidAvg | Только Google Реклама. Приблизительно равна средней цене за клик, необходимой в течение периода времени, указанного в отчете, чтобы ваши объявления регулярно появлялись на верхних позициях над результатами поиска. | метрика | Money | Да |
absoluteTopImpressionPercentage | Процент показов вашей рекламы, которые показываются как самое первое объявление над результатами обычного поиска. | метрика | Impression share | Да |
searchAbsoluteTopImpressionShare | Количество показов, которые вы получили в абсолютно верхней позиции (самое первое объявление над обычными результатами поиска), разделенное на расчетное количество показов, которые вы имели право получить в верхней позиции. | метрика | Impression share | Да |
topImpressionPercentage | Процент показов вашей рекламы, которые показываются где-либо над обычными результатами поиска. | метрика | Impression share | Да |
searchTopImpressionShare | Показы, которые вы получили в верхней позиции (любом месте над обычными результатами поиска), по сравнению с расчетным количеством показов, которые вы имели право получить в верхней позиции. | метрика | Impression share | Да |
searchBudgetLostAbsoluteTopImpressionShare | Оценивает, как часто ваше объявление не занимало первое место над результатами обычного поиска из-за низкого бюджета. | метрика | Impression share | Да |
searchBudgetLostTopImpressionShare | Помогает вам понять, как часто ваше объявление не показывалось над результатами обычного поиска из-за низкого бюджета. | метрика | 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 | Да |