Тип отчета: кампания

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

Этот отчет может быть возвращен только асинхронным запросом (то есть через метод 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 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 Статус кампании: Active , Paused ​​или Removed . Обратите внимание, что кампании, группы объявлений, ключевые слова, объявления и цели имеют собственный статус. Смотрите статус . атрибут Status Да
campaignEngineId ID кампании во внешнем аккаунте движка. атрибут 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 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 Да
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 Реклама. Приблизительно средняя ставка CPC, необходимая в течение периода времени, указанного в отчете, чтобы ваши объявления регулярно появлялись на верхних позициях над результатами поиска. метрика 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 Да