Предыдущая версия Search Ads 360 Reporting API будет прекращена и будет прекращена 30 июня 2024 года. Обратите внимание, что это не повлияет на Search Ads 360 Conversion API и продолжит поддерживаться. При разработке всех новых отчетов следует использовать новый Search Ads 360 Reporting API .

Начиная с апреля 2024 г. при запросе отчета будет возвращаться ошибка unsupportedApiVersion. Подробности смотрите здесь .

Мы также настоятельно рекомендуем вам перенести все существующие реализации Search Ads 360 на новый API. Дополнительную информацию можно найти в новом руководстве по началу работы и переходу к Search Ads 360 Reporting API.

Эта страница переведена с помощью Cloud Translation API.

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

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

Этот отчет может быть возвращен только асинхронным запросом (то есть через метод 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`	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`	Статус кампании, содержащей этот элемент.	атрибут	`Status`	Да
`adGroup`	Название группы объявлений.	атрибут	`String`	Да
`adGroupId`	Идентификатор группы объявлений DS.	атрибут	`ID`	Да
`adGroupStatus`	Статус группы объявлений, содержащей этот элемент.	атрибут	`Status`	Да
`keywordId`	Идентификатор ключевого слова DS. Значение 0 указывает на то, что ключевое слово не имеет атрибуции.	атрибут	`ID`	Да
`keywordMatchType`	Тип соответствия ключевого слова: `Broad` , `Exact` , `Phrase` или `Content` .	атрибут	`Match type`	Да
`keywordText`	Текст ключевого слова.	атрибут	`String`	Да
`keywordEngineId`	ID ключевого слова в аккаунте внешней системы.	атрибут	`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 Ads". Когда создается действие-конверсия Google Реклама, рекламодатель может выбрать, учитывать ли эти конверсии в столбце отчетов "Конверсии" .	метрика	`Number`	Да
`adWordsConversionValue`	Совокупная ценность конверсий Google Ads.	метрика	`Number`	Да
`adWordsViewThroughConversions`	Общее количество конверсий по показам в Google Рекламе.	метрика	`Integer`	Да
`visits`	Общее количество посещений ДС.	метрика	`Integer`	Да
`qualityScoreAvg`	Только Google Ads и Bing Ads. Средневзвешенное значение показателя качества (QS) системы за все дни и ключевые слова в области отчета, взвешенное по количеству показов.	метрика	`Number`	Да
`topOfPageBidAvg`	Только Google Реклама. Приблизительно средняя ставка CPC, необходимая за период времени, указанный в отчете, чтобы ваши объявления регулярно появлялись на верхних позициях над результатами поиска.	метрика	`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`	Сегментирует отчет по объявлениям; каждая строка и ее совокупные показатели разбиты на несколько строк, до одной для каждого объявления. Этот столбец возвращает первую строку описания объявления в каждой строке.	сегмент	`String`	Да
`adDescription2`	Сегментирует отчет по объявлениям; каждая строка и ее совокупные показатели разбиты на несколько строк, до одной для каждого объявления. Этот столбец возвращает вторую строку описания объявления в каждой строке.	сегмент	`String`	Да
`adDisplayUrl`	Сегментирует отчет по объявлениям; каждая строка и ее совокупные показатели разбиты на несколько строк, до одной для каждого объявления. Этот столбец возвращает отображаемый URL объявления в каждой строке.	сегмент	`String`	Да
`adLandingPage`	Сегментирует отчет по объявлениям; каждая строка и ее совокупные показатели разбиты на несколько строк, до одной для каждого объявления. Этот столбец возвращает целевую страницу объявления в каждой строке.	сегмент	`String`	Да
`adType`	Сегментирует отчет по объявлениям; каждая строка и ее совокупные показатели разбиты на несколько строк, до одной для каждого объявления. Этот столбец возвращает тип объявления в каждой строке: `Text` или `Product` .	сегмент	`Ad type`	Да
`adPromotionLine`	Сегментирует отчет по объявлениям; каждая строка и ее совокупные показатели разбиты на несколько строк, до одной для каждого объявления. Этот столбец возвращает строку продвижения рекламного объявления продукта в каждой строке.	сегмент	`String`	Да