Performance reports

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

Метрики

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

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

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

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

В следующем примере ответа показано, что с 1 по 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 API.

Вот пример запроса, который возвращает количество кликов по всем продуктам в вашем аккаунте за 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"
        }
      }
    }
  ]
}

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