Segmentation

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

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

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

SELECT marketingMethod, offerId, clicks
FROM ProductPerformanceView
WHERE date BETWEEN '2020-11-01' AND '2020-11-30'

Ответ на этот запрос включает строку для каждой комбинации offerId и marketingMethod с количеством кликов для этой комбинации:

{
  "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"
      }
    }
  ]
}

Внимание: поскольку для каждой комбинации полей сегментов в предложении SELECT возвращается новая строка, общее количество строк в вашем ответе увеличивается экспоненциально с каждым дополнительным полем сегментов.

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

Язык запросов 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

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

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

SELECT conversionValue
FROM ProductPerformanceView
WHERE date = '2020-11-01'

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

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

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

SELECT conversions, conversionValue
FROM ProductPerformanceView
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"
        }
      }
    }
  ]
}

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