Как перенести отчеты из Content API for Shopping

Merchant Reports API позволяет получать данные о товарах, их эффективности и конкурентной среде в Google.

Merchant Reports API позволяет:

• Оценка эффективности товаров. В Merchant API MerchantPerformanceView теперь называется product_performance_view.
• Фильтровать товары по определенным полям. В Merchant API можно фильтровать товары по всем доступным полям, кроме item_issues.
• Улучшение ценообразования. В Merchant API поля amount micros и currency объединены в одно поле с типом Price.
• Анализировать рынок. С помощью Merchant API вы можете получать данные о лидерах продаж и популярных брендах, конкурентоспособных ценах, рекомендуемых ценах со скидкой и конкурентной среде в вашей отрасли.
• Изучайте конкурентную среду. Вы можете получать отчеты, которые помогут вам анализировать конкурентную среду на уровне категории товаров и вовремя принимать меры, чтобы улучшить видимость вашей рекламы.

Ниже рассказывается, как интегрировать Merchant Reports API с существующей реализацией Content API for Shopping.

Запросы

Для Merchant Reports API используйте следующий формат URL запроса:

POST https://merchantapi.googleapis.com/reports/v1/{PARENT}/reports:search

Ниже приведено сравнение Content API for Shopping и Merchant Reports API для запросов search.

Методы

Чтобы отправить запрос к Merchant Reports API, вызовите метод ReportService.Search.

Просмотры

В Merchant API названия таблиц изменены с CamelCase на snake_case.

MerchantPerformanceView теперь называется product_performance_view.

Ниже приведено сопоставление названий таблиц в Content API for Shopping и Merchant API.

В Merchant API больше не нужно указывать префикс поля, например segments.offer_id. Вместо этого используйте название поля offer_id.

Ниже приведен пример сравнения запросов в Content API for Shopping и Merchant API.

   SELECT
     segments.offer_id,
     metrics.clicks
   FROM MerchantPerformanceView
   WHERE segments.date DURING LAST_7_DAYS
   

   SELECT
     offer_id,
     clicks
   FROM product_performance_view
   WHERE date DURING LAST_7_DAYS
   

Пример ответа:

{
  "segments":{
    "offerId":"abc"
  },
  "metrics":{
    "clicks":"123"
  }
}

{
  "productPerformanceView" : {
    "offerId": "abc",
    "clicks": "123"
  }
}

Название таблицы можно использовать в качестве префикса поля. Например, в запросе Merchant API можно использовать как offer_id, так и product_performance_view.offer_id.

Эффективность

Вот что изменилось в представлении эффективности в Merchant Reports API:

Новые значения методов маркетинга

Ниже приведено сопоставление значений segments.program и marketing_method.

Товар

Вот что изменилось в представлении товаров в Merchant Reports API:

Информация о ценах

Вот что изменилось в представлении информации о ценах в Merchant Reports API:

Конкурентоспособность цен

Вот что изменилось в представлении конкурентоспособности цен в Merchant Reports API:

Лидеры продаж

Вот что изменилось в представлениях лидеров продаж в Merchant Reports API:

Видимость по сравнению с конкурентами

Вот что изменилось в представлениях сравнительной видимости в Merchant Reports API: