Перенос отчетов из Content API for Shopping

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

API Merchant Reports можно использовать для следующих целей:

• Измеряйте производительность своих продуктов : в API MerchantPerformanceView теперь называется product_performance_view .
• Фильтрация товаров по определенным полям : с помощью API продавца вы можете фильтровать товары по всем доступным полям, за исключением item_issues .
• Улучшить ценообразование продуктов : с помощью API торговца поля микросуммы и валюты объединены в одно поле с типом Price .
• Понимание рынка : с помощью API торговцев вы можете получить данные о самых продаваемых товарах и брендах, конкурентоспособных ценах, предложениях по ценам распродаж и информацию о конкурентной среде в вашей отрасли.
• Изучите свою конкурентную среду : вы можете получить отчет, чтобы понять свою конкурентную среду на уровне категории продуктов и принять меры по улучшению своей видимости.

Вот как можно интегрировать API отчетов о торговле с существующей реализацией API контента для покупок .

Запросы

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

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

Вот пример сравнения API контента для покупок с API отчетов о продавцах для search запросов:

Методы

Вы можете выполнить запрос к API Merchant Reports, вызвав метод ReportService.Search .

Просмотры

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

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

Ниже приведено сопоставление имен таблиц в API контента для покупок и API торговца:

В 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"
  }
}

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

Производительность

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

Ценности нового метода маркетинга

Вот сопоставление значений segments.program и marketing_method :

Продукт

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

Ценовая аналитика

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

Ценовая конкурентоспособность

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

Бестселлеры

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

Конкурентная видимость

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