Тип отчета: рекламодатель

Отчетные данные для рекламодателей, в том числе:

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

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

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

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

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

columnName Описание Поведение Тип Фильтруемый
status Статус рекламодателя: Active , Paused или Removed . атрибут Status Да
creationTimestamp Временная метка создания рекламодателя в формате ISO 8601. атрибут Timestamp Да
lastModifiedTimestamp Временная метка последней модификации рекламодателя в формате ISO 8601. атрибут Timestamp Да
agency Название агентства. атрибут String Да
agencyId Идентификатор агентства DS. атрибут ID Да
advertiser Имя рекламодателя. атрибут String Да
advertiserId Идентификатор рекламодателя DS. атрибут ID Да
dfaAdvertiserId Идентификатор рекламодателя Менеджера кампаний, связанного с этим рекламодателем DS. атрибут ID Да
dfaNetworkId Идентификатор сети Менеджера кампаний, связанной с этим рекламодателем DS. атрибут ID Да
dfaNetworkTimeZone Часовой пояс сети менеджера кампании, связанной с этим рекламодателем DS, в формате базы данных часовых поясов IANA, например America/New_York . атрибут String Да
advertiserCurrencyCode Код валюты рекламодателя в формате ISO 4217. атрибут String Да
googleAnalyticsTimeZone Часовой пояс представления Google Analytics, связанного с этим рекламодателем DS. Использует формат базы данных часовых поясов IANA, например America/New_York . атрибут String Да
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 Реклама. Приблизительно равна средней ставке 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 Да