Отчетные данные для учетных записей системы, в том числе:
- Показатели эффективности всех кампаний системного аккаунта.
- Атрибуты конфигурации для учетной записи механизма.
Запросить выдержку
Отправьте обычное тело запроса Reports.request() или Reports.generate() , но укажите "reportType": "account"
.
{ ... "reportType": "account", "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 | Да |
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 | Да |
accountCurrencyCode | Код валюты расчетного счета в формате ISO 4217. | атрибут | String | Да |
accountTimeZone | Часовой пояс учетной записи системы в формате базы данных часовых поясов 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 Реклама. Приблизительно равна средней цене за клик, необходимой в течение периода времени, указанного в отчете, чтобы ваши объявления регулярно появлялись на верхних позициях над результатами поиска. | метрика | 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 | Да |