Показатели производительности и атрибуты конфигурации для групп продуктов. Отчеты по группам продуктов отличаются от отчетов по ключевым словам по нескольким причинам. Узнать больше .
Этот отчет может быть возвращен только асинхронным запросом (то есть через метод Reports.request() ).
Запросить выдержку
Отправьте обычное тело запроса Reports.request() , но укажите "reportType": "productGroup" .
{
...
"reportType": "productGroup",
"columns": [
{
"columnName": string,
"headerText": string,
"startDate": string,
"endDate": string
}
],
"filters": [
{
"column": {
"columnName": string,
},
...
},
...
],
...
} Для каждого столбца, который вы хотите вернуть или отфильтровать в отчете, укажите columnName , указанное в таблице ниже. Вы также можете дополнительно указать headerText , startDate и endDate . Обратите внимание, что некоторые столбцы нельзя фильтровать; см. раздел «Фильтрируемый» в таблице ниже.
columnName | Описание | Поведение | Тип | Фильтруемый |
|---|---|---|---|---|
status | Статус группы товаров. Он всегда Active . | атрибут | Status | Да |
engineStatus | Дополнительный статус группы товаров во внешнем аккаунте движка. Возможные статусы (в зависимости от типа внешней учетной записи): 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 | Да |
productGroupId | Идентификатор группы продуктов DS. DS генерирует эти идентификаторы, которые могут измениться, даже если результирующее дерево групп продуктов не изменится. Узнать больше . | атрибут | ID | Да |
productGroup | Критерии, которые использовались для определения группы продуктов, например AND(CATEGORY="Электроника",BRAND = "пример"). | атрибут | String | Нет |
productGroupPartitionType | Тип раздела для группы продуктов: Subdivided , Excluded или Biddable . | атрибут | Product group partition type | Да |
productGroupLandingPage | Целевая страница группы товаров. См. URL-адреса целевой страницы и сервера кликов . | атрибут | String | Да |
productGroupClickserverUrl | URL-адрес, который DS использует для отслеживания активности. Пользователь, нажимающий на объявление, сначала посетит URL-адрес сервера кликов, а затем будет перенаправлен на конечную целевую страницу. См. URL-адреса целевой страницы и сервера кликов . | атрибут | String | Да |
productGroupMaxCpc | Возвращает максимальную цену за клик, установленную для этой группы продуктов, если она существует. Если для этой группы продуктов не установлена максимальная цена за клик, это поле остается пустым, и группа продуктов наследует настройку максимальной цены за клик из группы объявлений. | атрибут | Money | Да |
effectiveProductGroupMaxCpc | Максимальная цена за клик (максимальная цена за клик), действующая для этой группы продуктов. Это будет либо то же значение, что и максимальная цена за клик группы объявлений, либо, если товарная цель переопределяет настройку группы объявлений, собственная максимальная цена за клик товарной цели. | атрибут | Money | Да |
productGroupMaxBid | Если эта группа продуктов управляется стратегией назначения ставок DS, она никогда не будет поднимать ставки выше этого предела. См. раздел Применение стратегии назначения ставок к группе продуктов . | атрибут | Money | Да |
productGroupMinBid | Если эта группа продуктов управляется стратегией назначения ставок DS, она никогда не будет снижать ставки ниже этого предела. См. раздел Применение стратегии назначения ставок к группе продуктов . | атрибут | 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 | Да |
date | Сегментирует отчет по дням; каждая строка и ее совокупные показатели разбиваются на несколько строк, по одной на каждый день. Этот столбец возвращает дату каждой строки. | сегмент | Date | Да |
monthStart | Сегментирует отчет по месяцам; каждая строка и ее совокупные показатели разбиваются на несколько строк, по одной на каждый месяц. Этот столбец возвращает первый день месяца каждой строки. | сегмент | Date | Да |
monthEnd | Сегментирует отчет по месяцам; каждая строка и ее совокупные показатели разбиваются на несколько строк, по одной на каждый месяц. Этот столбец возвращает последний день месяца каждой строки. | сегмент | Date | Да |
quarterStart | Сегментирует отчет по кварталам; каждая строка и ее совокупные показатели разбиваются на несколько строк, по одной на каждый квартал. Этот столбец возвращает первый день квартала каждой строки. | сегмент | Date | Да |
quarterEnd | Сегментирует отчет по кварталам; каждая строка и ее совокупные показатели разбиваются на несколько строк, по одной на каждый квартал. Этот столбец возвращает последний день квартала каждой строки. | сегмент | Date | Да |
weekStart | Сегментирует отчет по неделям (с воскресенья по субботу); каждая строка и ее совокупные показатели разбиваются на несколько строк, по одной на каждую неделю. Этот столбец возвращает первый день (воскресенье) каждой строки. | сегмент | Date | Да |
weekEnd | Сегментирует отчет по неделям (с воскресенья по субботу); каждая строка и ее совокупные показатели разбиваются на несколько строк, по одной на каждую неделю. Этот столбец возвращает последний день (суббота) каждой строки. | сегмент | Date | Да |
yearStart | Сегментирует отчет по годам; каждая строка и ее совокупные показатели разбиваются на несколько строк, по одной на каждый год. Этот столбец возвращает первый день года каждой строки. | сегмент | Date | Да |
yearEnd | Сегментирует отчет по годам; каждая строка и ее совокупные показатели разбиваются на несколько строк, по одной на каждый год. Этот столбец возвращает последний день года каждой строки. | сегмент | Date | Да |
deviceSegment | Сегментирует отчет по устройствам; каждая строка и ее совокупные показатели разбиваются на несколько строк, до одной для каждого сегмента устройства. Этот столбец возвращает сегмент устройства каждой строки. | сегмент | Device segment | Да |