Предыдущая версия 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": "productAdvertised" .

{
...
  "reportType": "productAdvertised",
  "columns": [
    {
      "columnName": string,
      "headerText": string,
      "startDate": string,
      "endDate": string
    }
  ],
  "filters": [
    {
      "column": {
        "columnName": string,
      },
      ...
    },
    ...
  ],
...
}

Для каждого столбца, который вы хотите вернуть или отфильтровать в отчете, укажите columnName указанное в таблице ниже. Вы также можете дополнительно указать headerText , startDate и endDate . Обратите внимание, что некоторые столбцы нельзя фильтровать; см. «Фильтрация» в таблице ниже.

`columnName`	Описание	Поведение	Тип	Фильтруемый
`status`	Статус товара, указанный в учетной записи: `Active` или `Removed` .	атрибут	`Status`	Да
`creationTimestamp`	Отметка времени создания продукта, указанная в инвентарном учете, в формате ISO 8601.	атрибут	`Timestamp`	Да
`lastModifiedTimestamp`	Отметка времени самой последней модификации продукта, указанная в инвентарном учете, модификация в формате ISO 8601.	атрибут	`Timestamp`	Да
`agency`	Название агентства.	атрибут	`String`	Да
`agencyId`	Идентификатор агентства DS.	атрибут	`ID`	Да
`advertiser`	Имя рекламодателя.	атрибут	`String`	Да
`advertiserId`	Идентификатор рекламодателя DS.	атрибут	`ID`	Да
`productId`	Идентификатор товара.	атрибут	`String`	Да
`productCountry`	Страна, зарегистрированная для фида товаров.	атрибут	`String`	Да
`productLanguage`	Язык, зарегистрированный для фида товаров.	атрибут	`String`	Да
`productMpn`	Атрибут MPN (номер детали производителя) товара.	атрибут	`String`	Да
`productColor`	Атрибут цвета элемента продукта.	атрибут	`String`	Да
`productSize`	Атрибут размера товара.	атрибут	`String`	Да
`productMaterial`	Атрибут материала элемента продукта.	атрибут	`String`	Да
`productPattern`	Атрибут шаблона элемента продукта.	атрибут	`String`	Да
`productAvailability`	Атрибут доступности товара.	атрибут	`Product availability`	Да
`productGender`	Атрибут пола товара.	атрибут	`String`	Да
`productAgeGroup`	Атрибут возрастной группы товара.	атрибут	`String`	Да
`productLandingPageUrl`	Атрибут целевой страницы товара.	атрибут	`String`	Да
`productCategory`	Атрибут категории продукта Google для элемента продукта.	атрибут	`String`	Да
`productCategoryLevel1`	Атрибут категории продукта Google уровня 1 элемента продукта.	атрибут	`String`	Да
`productCategoryLevel2`	Атрибут 2-го уровня категории продукта Google для элемента продукта.	атрибут	`String`	Да
`productCategoryLevel3`	Атрибут категории продукта Google уровня 3 элемента продукта.	атрибут	`String`	Да
`productCategoryLevel4`	Атрибут категории продукта Google уровня 4 элемента продукта.	атрибут	`String`	Да
`productCategoryLevel5`	Атрибут 5-го уровня категории продукта Google для элемента продукта.	атрибут	`String`	Да
`productBrand`	Атрибут бренда товара.	атрибут	`String`	Да
`productGtin`	Атрибут GTIN (глобальный номер предмета торговли) товара.	атрибут	`String`	Да
`productPrice`	Ценовой атрибут товара.	атрибут	`Money`	Да
`productSalePrice`	Ценовой атрибут товара.	атрибут	`Money`	Да
`productTypeLevel1`	Атрибут типа продукта уровня 1 элемента продукта.	атрибут	`String`	Да
`productTypeLevel2`	Атрибут типа продукта уровня 2 позиции продукта.	атрибут	`String`	Да
`productTypeLevel3`	Атрибут типа продукта уровня 3 элемента продукта.	атрибут	`String`	Да
`productTypeLevel4`	Атрибут типа продукта уровня 4 элемента продукта.	атрибут	`String`	Да
`productTypeLevel5`	Атрибут типа продукта 5-го уровня для позиции продукта.	атрибут	`String`	Да
`productCondition`	Атрибут условия товара.	атрибут	`String`	Да
`productCustomLabel0`	Пользовательский атрибут label 0 элемента продукта.	атрибут	`String`	Да
`productCustomLabel1`	Пользовательский атрибут label 1 элемента продукта.	атрибут	`String`	Да
`productCustomLabel2`	Пользовательский атрибут label 2 элемента продукта.	атрибут	`String`	Да
`productCustomLabel3`	Пользовательский атрибут label 3 элемента продукта.	атрибут	`String`	Да
`productCustomLabel4`	Пользовательский атрибут label 4 элемента продукта.	атрибут	`String`	Да
`productCostOfGoodsSold`	Общая стоимость продажи товара, указанная в фиде ресурсов .	атрибут	`Money`	Да
`productStoreId`	Магазин, в котором товар рекламировался в рекламе местного ассортимента. Это должно совпадать с идентификаторами магазинов, используемыми в вашем фиде местных продуктов.	атрибут	`String`	Да
`productChannel`	Атрибут канала продаж товара: `Online` или `Local` .	атрибут	`Product channel`	Да
`productChannelExclusivity`	Атрибут эксклюзивности канала для элемента продукта.	атрибут	`Product channel exclusivity`	Да
`productItemGroupId`	Атрибут идентификатора группы товаров для товара.	атрибут	`String`	Да
`productTitle`	Атрибут title элемента продукта.	атрибут	`String`	Да
`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`	Да
`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`	Да
`accountId`	Идентификатор учетной записи механизма DS.	сегмент	`ID`	Да
`campaignId`	Сегментирует отчет по кампаниям. Эта строка возвращает идентификатор кампании DS, связанный со строкой.	сегмент	`ID`	Да
`adGroupId`	Сегментирует отчет по группам объявлений. Эта строка возвращает идентификатор группы объявлений, связанный со строкой.	сегмент	`ID`	Да