Показатели эффективности и атрибуты конфигурации для элементов фида (например, дополнительная ссылка, местоположение, номер телефона или дополнительная информация о приложении).
Этот отчет может быть возвращен только асинхронным запросом (то есть через метод Reports.request() ).
Запросить выдержку
Отправьте обычное тело запроса Reports.request() , но укажите "reportType": "feedItem" .
{
...
"reportType": "feedItem",
"columns": [
{
"columnName": string,
"headerText": string,
"startDate": string,
"endDate": string
}
],
"filters": [
{
"column": {
"columnName": string,
},
...
},
...
],
...
} Для каждого столбца, который вы хотите вернуть или отфильтровать в отчете, укажите columnName указанное в таблице ниже. Вы также можете дополнительно указать headerText , startDate и endDate . Обратите внимание, что некоторые столбцы нельзя фильтровать; см. «Фильтрация» в таблице ниже.
columnName | Описание | Поведение | Тип | Фильтруемый |
|---|---|---|---|---|
status | Статус элемента фида: Active , Paused или Removed . | атрибут | Status | Да |
engineStatus | Дополнительный статус элемента фида в аккаунте внешнего движка. Возможные статусы (в зависимости от типа внешней учетной записи): review , active и т. д. | атрибут | 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 | Да |
sitelinkDisplayText | Отображаемый текст дополнительной ссылки элемента фида. | атрибут | String | Да |
sitelinkDescription1 | Описание дополнительной ссылки элемента фида 1. | атрибут | String | Да |
sitelinkDescription2 | Описание дополнительной ссылки элемента фида 2. | атрибут | String | Да |
sitelinkLandingPageUrl | URL целевой страницы дополнительной ссылки элемента фида. | атрибут | String | Да |
sitelinkClickserverUrl | URL-адрес сервера кликов для дополнительной ссылки элемента фида. | атрибут | String | Да |
locationBusinessName | Название компании, указанное в обновленном расширении адреса. | атрибут | String | Да |
locationCategory | Категория, определенная для компании в обновленном расширении адреса. | атрибут | String | Да |
locationDetails | Подробная информация о компании, указанной в обновленном расширении адреса. | атрибут | String | Да |
callPhoneNumber | Номер телефона добавочного номера. | атрибут | String | Да |
callCountryCode | Код страны для номера телефона. | атрибут | String | Да |
callIsTracked | Возвращает true, если звонки с номера телефона будут отслеживаться, и false в противном случае. | атрибут | Boolean | Да |
callCallOnly | Возвращает значение true, если расширение вызова настроено на отображение только номера телефона. Возвращает false, если будут показаны и вызов, и ссылка. | атрибут | Boolean | Да |
callConversionTracker | Название средства отслеживания конверсий, связанного с этим номером телефона, если оно существует. | атрибут | String | Да |
callConversionTrackerId | Идентификатор средства отслеживания конверсий, связанного с этим элементом фида, если таковой существует. | атрибут | ID | Да |
appId | Идентификатор приложения, определенный для расширения приложения. | атрибут | String | Да |
appStore | Тип магазина приложений (Apple App Store, Google Play Store), определенный для расширения приложения. | атрибут | App store | Да |
feedItemId | Идентификатор строки элемента фида. | атрибут | ID | Да |
feedId | Идентификатор таблицы каналов | атрибут | ID | Да |
clicksWithFeedItemShowing | Клики по любой ссылке в объявлении во время отображения элемента фида. Этот столбец возвращает значение только в отчете об элементах фида или в отчете, сегментированном по столбцу элементов фида. | метрика | Integer | Да |
costWithFeedItemShowing | Стоимость всех объявлений при показе элемента фида. Этот столбец возвращает значение только в отчете об элементах фида или в отчете, сегментированном по столбцу элементов фида. | метрика | Money | Да |
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 | Да |
date | Сегментирует отчет по дням; каждая строка и ее совокупные показатели разбиты на несколько строк, по одной на каждый день. Этот столбец возвращает дату каждой строки. | сегмент | Date | Да |
monthStart | Сегментирует отчет по месяцам; каждая строка и ее сводные показатели разбиты на несколько строк, по одной на каждый месяц. Этот столбец возвращает первый день месяца каждой строки. | сегмент | Date | Да |
monthEnd | Сегментирует отчет по месяцам; каждая строка и ее сводные показатели разбиты на несколько строк, по одной на каждый месяц. Этот столбец возвращает последний день месяца каждой строки. | сегмент | Date | Да |
quarterStart | Сегментирует отчет по кварталам; каждая строка и ее совокупные показатели разбиты на несколько строк, по одной на каждый квартал. Этот столбец возвращает первый день квартала каждой строки. | сегмент | Date | Да |
quarterEnd | Сегментирует отчет по кварталам; каждая строка и ее совокупные показатели разбиты на несколько строк, по одной на каждый квартал. Этот столбец возвращает последний день квартала каждой строки. | сегмент | Date | Да |
weekStart | Сегментирует отчет по неделям (с воскресенья по субботу); каждая строка и ее совокупные показатели разбиты на несколько строк, по одной на каждую неделю. Этот столбец возвращает первый день (воскресенье) каждой строки. | сегмент | Date | Да |
weekEnd | Сегментирует отчет по неделям (с воскресенья по субботу); каждая строка и ее совокупные показатели разбиты на несколько строк, по одной на каждую неделю. Этот столбец возвращает последний день (субботу) каждой строки. | сегмент | Date | Да |
yearStart | Сегментирует отчет по годам; каждая строка и ее совокупные показатели разбиты на несколько строк, по одной на каждый год. Этот столбец возвращает первый день года каждой строки. | сегмент | Date | Да |
yearEnd | Сегментирует отчет по годам; каждая строка и ее совокупные показатели разбиты на несколько строк, по одной на каждый год. Этот столбец возвращает последний день года для каждой строки. | сегмент | Date | Да |
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 | Да |