Показатели эффективности и атрибуты конфигурации для ключевых слов.
Этот отчет может быть возвращен только асинхронным запросом (то есть через метод Reports.request() ).
Запросить выдержку
Отправьте обычное тело запроса Reports.request() , но укажите "reportType": "keyword"
.
{ ... "reportType": "keyword", "columns": [ { "columnName": string, "headerText": string, "startDate": string, "endDate": string } ], "filters": [ { "column": { "columnName": string, }, ... }, ... ], ... }
Для каждого столбца, который вы хотите вернуть или отфильтровать в отчете, укажите columnName
, указанное в таблице ниже. Вы также можете дополнительно указать headerText , startDate и endDate . Обратите внимание, что некоторые столбцы нельзя фильтровать; см. раздел «Фильтрируемый» в таблице ниже.
columnName | Описание | Поведение | Тип | Фильтруемый |
---|---|---|---|---|
status | Статус ключевого слова: Active , Paused или Removed . Обратите внимание, что кампании, группы объявлений, ключевые слова и объявления имеют свой собственный статус. Смотрите статус . | атрибут | Status | Да |
engineStatus | Дополнительный статус ключевого слова во внешнем аккаунте движка. Возможные статусы (в зависимости от типа внешней учетной записи): criterion rarely served , criterion below first page bid , criterion low quality score , review , campaign paused и т. д. | атрибут | 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 | Статус кампании, содержащей этот элемент. | атрибут | Status | Да |
adGroup | Название группы объявлений. | атрибут | String | Да |
adGroupId | Идентификатор группы объявлений DS. | атрибут | ID | Да |
adGroupStatus | Статус группы объявлений, содержащей этот элемент. | атрибут | Status | Да |
keywordId | Идентификатор ключевого слова DS. Значение 0 указывает, что ключевое слово не имеет атрибута. | атрибут | ID | Да |
keywordMatchType | Тип соответствия ключевого слова: Broad , Exact , Phrase или Content . | атрибут | Match type | Да |
keywordText | Текст ключевого слова. | атрибут | String | Да |
keywordEngineId | Идентификатор ключевого слова во внешней учетной записи системы. | атрибут | ID | Да |
keywordMaxCpc | Переопределяет максимальную цену за клик для группы объявлений и устанавливает максимальную сумму, которую вы готовы заплатить, если кто-то нажмет на объявление по этому конкретному ключевому слову. Если это поле пусто, для ключевого слова будет использоваться максимальная цена за клик группы объявлений. | атрибут | Money | Да |
effectiveKeywordMaxCpc | Максимальная цена за клик (максимальная цена за клик), действующая для этого ключевого слова. Это будет либо то же значение, что и максимальная цена за клик для группы объявлений, либо, если ключевое слово переопределяет настройку группы объявлений, собственная максимальная цена за клик для ключевого слова. | атрибут | Money | Да |
keywordLandingPage | Конечный URL, который пользователь посетит после нажатия на ваше объявление. См. URL-адреса целевой страницы и сервера кликов . | атрибут | String | Да |
keywordClickserverUrl | URL-адрес, который DS использует для отслеживания активности. Пользователь, нажимающий на объявление, сначала посетит URL-адрес сервера кликов, а затем будет перенаправлен на конечную целевую страницу. См. URL-адреса целевой страницы и сервера кликов . | атрибут | String | Да |
isDisplayKeyword | Указывает, является ли это ключевым словом-заполнителем, которое используется для отчетов по отображению и размещению. | атрибут | Boolean | Да |
keywordMaxBid | Если это ключевое слово управляется стратегией назначения ставок DS, эта стратегия никогда не будет поднимать ставки выше этого предела. См. раздел Применение стратегии назначения ставок к ключевым словам . | атрибут | Money | Да |
keywordMinBid | Если это ключевое слово управляется стратегией назначения ставок DS, эта стратегия никогда не будет снижать ставки ниже этого предела. См. раздел Применение стратегии назначения ставок к ключевым словам . | атрибут | Money | Да |
keywordUrlParams | На целевую страницу добавлены дополнительные параметры URL. См. раздел Добавление параметров URL . | атрибут | String | Да |
bingKeywordParam2 | Param2 ключевого слова Bing Ads. | атрибут | String | Да |
bingKeywordParam3 | Param3 ключевого слова Bing Ads. | атрибут | String | Да |
keywordLabels | Имена меток, напрямую присвоенные этому ключевому слову; унаследованные метки не включаются. | атрибут | String list | Да |
qualityScoreCurrent | Только Google Ads и Bing Ads. Самое последнее значение показателя качества (QS) системы для ключевого слова. Обратите внимание, что в этом столбце всегда отображаются последние QS для ключевого слова, независимо от временного диапазона отчета. | атрибут | Integer | Да |
topOfPageBidCurrent | Только Google Реклама. Приблизительно равна текущей цене за клик, необходимой для того, чтобы ваше объявление регулярно появлялось на верхних позициях над результатами поиска. Обратите внимание, что в этом столбце всегда указывается необходимая в данный момент цена за клик независимо от временного диапазона отчета. | атрибут | Money | Да |
effectiveBidStrategyId | Идентификатор DS стратегии назначения ставок, назначенной этому объекту или унаследованной этим объектом. | атрибут | ID | Да |
effectiveBidStrategy | Название стратегии назначения ставок, назначенное этому объекту или унаследованное этим объектом. | атрибут | String | Да |
bidStrategyInherited | Указывает, наследуется ли стратегия назначения ставок этого объекта. | атрибут | Boolean | Да |
effectiveLabels | Имена всех ярлыков, унаследованных или напрямую присвоенных этому ключевому слову. | атрибут | String list | Да |
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 | Да |
qualityScoreAvg | Только Google Ads и Bing Ads. Средневзвешенное по показам значение показателя качества (QS) системы за все дни и ключевые слова в области отчета. | метрика | Number | Да |
topOfPageBidAvg | Только Google Реклама. Приблизительно равна средней цене за клик, необходимой в течение периода времени, указанного в отчете, чтобы ваши объявления регулярно появлялись на верхних позициях над результатами поиска. | метрика | Money | Да |
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 | Да |
ad | Сегментирует отчет по объявлениям; каждая строка и ее совокупные показатели разбиваются на несколько строк, по одной для каждого объявления. Этот столбец возвращает название объявления в каждой строке. | сегмент | String | Да |
adId | Сегментирует отчет по объявлениям; каждая строка и ее совокупные показатели разбиваются на несколько строк, по одной для каждого объявления. В этом столбце возвращается идентификатор DS объявления в каждой строке. | сегмент | ID | Да |
isUnattributedAd | Сегментирует отчет по объявлениям; каждая строка и ее совокупные показатели разбиваются на несколько строк, по одной для каждого объявления. В этом столбце указывается, связаны ли показатели в этой строке с конкретным объявлением. | сегмент | Boolean | Да |
adHeadline | Сегментирует отчет по объявлениям; каждая строка и ее совокупные показатели разбиваются на несколько строк, по одной для каждого объявления. Этот столбец возвращает заголовок объявления в каждой строке. | сегмент | String | Да |
adHeadline2 | Сегментирует отчет по объявлениям; каждая строка и ее совокупные показатели разбиваются на несколько строк, по одной для каждого объявления. Этот столбец возвращает заголовок 2 объявления в каждой строке. Недоступно для некоторых двигателей. | сегмент | String | Да |
adHeadline3 | Сегментирует отчет по объявлениям; каждая строка и ее совокупные показатели разбиваются на несколько строк, по одной для каждого объявления. Этот столбец возвращает заголовок 3 объявления в каждой строке. Недоступно для некоторых двигателей. | сегмент | String | Да |
adDescription1 | Сегментирует отчет по объявлениям; каждая строка и ее совокупные показатели разбиваются на несколько строк, по одной для каждого объявления. Этот столбец возвращает строку описания 1 объявления в каждой строке. | сегмент | String | Да |
adDescription2 | Сегментирует отчет по объявлениям; каждая строка и ее совокупные показатели разбиваются на несколько строк, по одной для каждого объявления. В этом столбце отображается вторая строка описания объявления в каждой строке. | сегмент | String | Да |
adDisplayUrl | Сегментирует отчет по объявлениям; каждая строка и ее совокупные показатели разбиваются на несколько строк, по одной для каждого объявления. В этом столбце возвращается отображаемый URL объявления в каждой строке. | сегмент | String | Да |
adLandingPage | Сегментирует отчет по объявлениям; каждая строка и ее совокупные показатели разбиваются на несколько строк, по одной для каждого объявления. Этот столбец возвращает целевую страницу объявления в каждой строке. | сегмент | String | Да |
adType | Сегментирует отчет по объявлениям; каждая строка и ее совокупные показатели разбиваются на несколько строк, по одной для каждого объявления. В этом столбце возвращается тип объявления в каждой строке: Text или Product . | сегмент | Ad type | Да |
adPromotionLine | Сегментирует отчет по объявлениям; каждая строка и ее совокупные показатели разбиваются на несколько строк, по одной для каждого объявления. В этом столбце отображается рекламная строка объявления продукта в каждой строке. | сегмент | String | Да |