Оценка товаров

С помощью Merchant Reports API можно просматривать данные об эффективности, фильтровать товары по определенным атрибутам и улучшать ценообразование.

Оценка результатов.

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

Требования

Чтобы получить этот отчет, у вас должна быть роль "Эффективность и статистика".

Чтобы назначить роль "Эффективность и статистика" существующему пользователю, создайте запрос на исправление и назначьте пользователю право доступа PERFORMANCE_REPORTING. В следующем примере показано, как создать запрос PATCH для назначения права доступа PERFORMANCE_REPORTING:

PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/users/{EMAIL_ID}

{
  "accessRights": [
    "PERFORMANCE_REPORTING"
  ]
}

Замените следующее:

  • {ACCOUNT_ID} – уникальный идентификатор аккаунта Merchant Center.
  • {EMAIL_ID} – адрес электронной почты пользователя, которому вы хотите назначить роль.

Пример запроса

Следующий запрос извлекает impressions, clicks и click_through_rate для всех товаров в вашем аккаунте за определенный 30-дневный период. Чтобы выполнить запрос, передайте методу accounts.reports.search следующую инструкцию на языке запросов Merchant Center:

SELECT impressions, clicks, click_through_rate
FROM product_performance_view
WHERE date BETWEEN '2020-12-01' AND '2020-12-30'

Дополнительную информацию вы найдете в руководстве по отчетам об эффективности.

Отфильтровать товары

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

В запрос необходимо включить поле id в пункте SELECT. Значение id совпадает со значением идентификатора REST товара.

Фильтровать можно по всем доступным полям, кроме следующих:

  • status_per_reporting_context
  • item_issues

Ответ можно отсортировать по всем доступным полям, кроме следующих:

  • gtin
  • status_per_reporting_context
  • item_issues

Чтобы узнать, соответствует ли товар требованиям, проверьте поле aggregated_reporting_context_status. В этом поле агрегируются статусы по всем контекстам отчетов о товаре.

Вот пример, который возвращает товары с агрегированным статусом ELIGIBLE_LIMITED, то есть они могут показываться по крайней мере в одном, но не во всех целевых контекстах отчетов. Вы можете запросить подробный статус товара для каждого контекста отчета и проблемы с товарами, чтобы провести дальнейшее исследование. Чтобы выполнить запрос, передайте методу accounts.reports.search следующую инструкцию на языке запросов Merchant Center:

SELECT
  id,
  offer_id,
  feed_label,
  title,
  aggregated_reporting_context_status,
  status_per_reporting_context,
  item_issues
FROM product_view
WHERE aggregated_reporting_context_status = 'ELIGIBLE_LIMITED'

Вот пример ответа на предыдущий запрос:

{
  "results": [
    {
      "productView": {
        "id": "en~US~id0",
        "offerId": "id0",
        "feedLabel": "US",
        "aggregatedReportingContextStatus": "ELIGIBLE_LIMITED",
        "statusPerReportingContext": [
          {
            "reportingContext": "SHOPPING_ADS",
            "disapprovedCountries": [
              "US"
            ]
          },
          {
            "reportingContext": "FREE_LISTINGS",
            "approvedCountries": [
              "US"
            ]
          }
        ]
        "itemIssues": [
          {
            "type": {
              "code": "invalid_string_value",
              "canonicalAttribute": "n:product_code"
            },
            "severity": {
              "severityPerReportingContext": [
                {
                  "reportingContext": "SHOPPING_ADS",
                  "disapprovedCountries": [
                    "US"
                  ]
                },
                {
                  "reportingContext": "FREE_LISTINGS",
                  "disapprovedCountries": [
                    "US"
                  ]
                }
              ],
              "aggregatedSeverity": "DISAPPROVED"
            },
            "resolution": "MERCHANT_ACTION"
          },
          {
            "type": {
              "code": "apparel_missing_brand",
              "canonicalAttribute": "n:brand"
            },
            "severity": {
              "severityPerReportingContext": [
                {
                  "reportingContext": "SHOPPING_ADS",
                  "disapprovedCountries": [
                    "US"
                  ]
                }
              ],
              "aggregatedSeverity": "DEMOTED"
            },
            "resolution": "MERCHANT_ACTION"
          }
        ]
      }
    }
  ]
}

Чтобы посмотреть информацию о товарах в определенном контексте отчета, можно использовать фильтр по полю reporting_context в условии WHERE. Если вы отфильтруете данные по параметру reporting_context, то показатель aggregated_reporting_context_status будет рассчитываться только на основе выбранного контекста отчета, а показатели status_per_reporting_context и item_issues будут возвращать данные только для этого контекста.

Подробную информацию о полях, доступных для запроса, можно найти в статье Поля в таблице product_view.

Улучшение ценообразования

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

Подробнее об отчете "Динамика цен"…

Запрос price_insights_product_view для просмотра рекомендуемых цен со скидкой для ваших товаров.

Ниже приведен пример запроса, с помощью которого можно посмотреть рекомендуемые цены со скидкой для ваших товаров. Чтобы сделать запрос, передайте методу accounts.reports.search следующую инструкцию на языке запросов Merchant Center:

SELECT
  id,
  title,
  brand,
  price,
  suggested_price,
  predicted_impressions_change_fraction,
  predicted_clicks_change_fraction,
  predicted_conversions_change_fraction
FROM price_insights_product_view

Вот пример ответа на предыдущий запрос:

{
   "results": [
    {
      "priceInsightsProductView": {
        "id": "en~US~12345",
        "title": "UGG Women's s Classic Mini",
        "brand": "UGG",
        "price" {
          "amountMicros": "124990000",
          "currencyCode": "USD"
        },
        "suggestedPrice" {
          "amountMicros": "135680000",
          "currencyCode": "USD"
        },
        "predictedImpressionsChangeFraction": "0.12609300017356873",
        "predictedClicksChangeFraction": "0.508745014667511",
        "predictedConversionsChangeFraction": "2.3431060314178467"
      }
    },
    {
      "priceInsightsProductView": {
        "id": "en~US~12346",
        "title": "Nike React Infinity Run Flyknit 2",
        "brand": "Nike",
        "price" {
          "amountMicros": "119990000"
          "currencyCode": "USD"
        },
        "suggestedPrice" {
          "amountMicros": "125440000",
          "currencyCode": "USD"
        },
        "predictedImpressionsChangeFraction": "0.1799899935722351",
        "predictedClicksChangeFraction": "0.6203680038452148",
        "predictedConversionsChangeFraction": "1.234868049621582"
      }
    },
    {
      "priceInsightsProductView": {
        "id": "en~US~12347",
        "title": "  New Balance 327 White Trainers",
        "brand": "New Balance",
        "price" {
          "amountMicros": "84990000"
          "currencyCode": "USD"
        },
        "suggestedPrice" {
          "amountMicros": "82000000",
          "currencyCode": "USD"
        },
        "predictedImpressionsChangeFraction": "0.11538799852132797",
        "predictedClicksChangeFraction": "0.5869849920272827",
        "predictedConversionsChangeFraction": "1.3622850179672241"
      }
    }
  ]
}

Подробную информацию о полях, доступных для запроса, можно найти в статье Поля в таблице priceInsightsProductView.

Назад
Get started
Далее
Performance reports