Performance reports

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

Метрики

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

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

SELECT clicks
FROM product_performance_view
WHERE date BETWEEN '2023-12-01' AND '2023-12-21'

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

Приведенный ниже пример ответа показывает, что в период с 1 декабря 2023 года по 21 декабря 2023 года продавец совершил в общей сложности 4440 кликов по всем товарам и с использованием всех маркетинговых методов.

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

Сегменты

Для сегментации в отчетах о производительности можно использовать поля сегментов . Например, запрос по параметру marketing_method возвращает отчет со строкой для каждого метода маркетинга и метриками , которые вы указываете для этого метода маркетинга в предложении SELECT .

Поля сегментов могут представлять собой атрибуты продукта (например, offer_id , brand и category ) или атрибуты события (например, date и marketing_method ).

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

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

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

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

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

Как и в случае с пользовательскими отчетами в Merchant Center, с помощью API Merchant Reports вы можете указать несколько сегментов в одном запросе.

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

SELECT marketing_method, offer_id, clicks
FROM product_performance_view
WHERE date BETWEEN '2023-11-01' AND '2023-11-30'

В ответ на этот запрос для каждой комбинации offer_id и marketing_method содержится строка с указанием количества кликов для этой комбинации:

{
  "results": [
    {
      "productPerformanceView": {
        "marketingMethod": "ADS",
        "offerId": "12345",
        "clicks": "38"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ADS",
        "offerId": "12346",
        "clicks": "125"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ORGANIC",
        "offerId": "12346",
        "clicks": "23"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ADS",
        "offerId": "12347",
        "clicks": "8"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ORGANIC",
        "offerId": "12347",
        "clicks": "3"
      }
    }
  ]
}

Категория и тип продукта

Язык запросов Merchant Center поддерживает сегментацию метрик по двум группам атрибутов, которые вы можете определить для организации своего инвентаря:

Уровни категорий
Категории из товарной таксономии Google . Google может автоматически присвоить категорию вашему продукту, если она не была указана, или дополнительно уточнить предоставленную категорию.
Уровни типов продукции
Типы товаров, которые вы присваиваете на основе вашей категоризации . В отличие от уровней категорий, здесь нет предопределенного набора поддерживаемых значений.

Атрибуты категории и типа продукта организованы в иерархическую структуру с несколькими уровнями. В спецификации продукта каждый уровень разделяется символом > , но в отчетах каждый уровень иерархии выбирается отдельно.

Например, рассмотрим продукт со следующими уровнями типов:

Home & Garden > Kitchen & Dining > Kitchen Appliances > Refrigerators

Отчеты отображают каждый уровень в отдельном поле:

Сегмент Ценить
product_type_l1 Home & Garden
product_type_l2 Kitchen & Dining
product_type_l3 Kitchen Appliances
product_type_l4 Refrigerators

Показатели валюты и цен

Показатели ценообразования, такие как conversion_value , представляются с использованием типа Price . Если показатель доступен в нескольких валютах, значение для каждой валюты возвращается в отдельной строке. Например, следующий запрос:

SELECT conversion_value
FROM product_performance_view
WHERE date = '2023-11-01'

возвращает следующие результаты:

{
  "results": [
    {
      "productPerformanceView": {
        "conversionValue": {
          "amountMicros": "150000000",
          "currencyCode": "USD"
        }
      }
    },
    {
      "productPerformanceView": {
        "conversionValue": {
          "amountMicros": "70000000",
          "currencyCode": "CAD"
        }
      }
    }
  ]
}

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

SELECT conversions, conversion_value
FROM product_performance_view
WHERE date = '2020-11-01'

возвращает следующий ответ: 

{
  "results": [
    {
      "productPerformanceView": {
        "conversions": "27",
        "conversionValue": {
          "amountMicros": "0",
          "currencyCode": ""
        }
      }
    },
    {
      "productPerformanceView": {
        "conversions": "0",
        "conversionValue": {
          "amountMicros": "150000000",
          "currencyCode": "USD"
        }
      }
    },
    {
      "productPerformanceView": {
        "conversions": "0",
        "conversionValue": {
          "amountMicros": "70000000",
          "currencyCode": "CAD"
        }
      }
    }
  ]
}

В ответе будут возвращены все выбранные вами поля, даже если их значение по-прежнему равно значению по умолчанию или нулю.

Для получения дополнительной информации о полях, доступных для запроса, см. раздел «Поля в таблице productPerformanceView .