Performance reports

Merchant API предлагает отчеты о производительности, например ProductPerformanceView . На этой странице объясняется структура отчетов о производительности.

Метрики

Вы можете запросить показатели (например, clicks и impressions ), которые вы хотите получить. Необходимо добавить фильтр по диапазону дат, чтобы запросить у службы отчетов данные о производительности.

Вот пример запроса, который возвращает одну строку с общим количеством кликов в указанном диапазоне дат:

SELECT clicks
FROM ProductPerformanceView
WHERE date BETWEEN '2020-12-01' AND '2020-12-21'

Вы должны указать данные, которые хотите вернуть. Подстановочные знаки (например, SELECT * ) возвращают ошибку.

В следующем примере ответа показано, что с 1 по 21 декабря 2020 г. продавец получил в общей сложности 4440 кликов по всем продуктам и всем методам маркетинга.

{
  "results": [
    {
      "productPerformanceView": {
        "clicks": "4,440"
      }
    }
  ]
}

Сегменты

Вы можете использовать MCQL для запроса полей сегментов. Полями сегментов могут быть атрибуты продукта (например, offerId , brand и category ) или атрибуты события (например, date и marketingMethod ).

Поля сегментов действуют аналогично GROUP BY в SQL. Поля сегментов разделяют выбранные показатели, группируя их по каждому сегменту в предложении SELECT .

Ниже приведен пример запроса, который возвращает количество кликов в день в порядке убывания clicks в пределах добавленного условия диапазона дат. Возвращаются только строки, в которых хотя бы одна запрошенная метрика не равна нулю.

SELECT
  date,
  clicks
FROM ProductPerformanceView
WHERE date BETWEEN '2020-12-01' AND '2020-12-03'
ORDER BY clicks DESC

В следующем примере ответа показано, что 1 декабря 2020 г. у продавца было 1546 кликов по всем продуктам и всем методам маркетинга, а 2 декабря 2020 г. — 829 кликов по всем продуктам и всем методам маркетинга. 3 декабря 2020 г., поэтому за эту дату ничего не возвращается.

{
  "results": [
    {
      "productPerformanceView": {
        "date": {
          "year": 2020,
          "month": 12,
          "day": 1
        },
        "clicks": "1546"
      }
    },
    {
      "productPerformanceView": {
        "date": {
          "year": 2020,
          "month": 12,
          "day": 2
        },
        "clicks": "829"
      }
    }
  ]
}