Тип отчета: ключевое слово

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

Этот отчет может быть возвращен только асинхронным запросом (то есть через метод 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 Да