Оцените свою продукцию

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

Измерение производительности

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

Требования

Чтобы получить этот отчет, вам нужна роль «Производительность и аналитика» .

Чтобы предоставить учетной записи роль производительности и аналитики, исправьте ресурс User для учетной записи с правом доступа PERFORMANCE_REPORTING .

accounts.v1beta.accounts.users.patch заменяет весь ресурс User . Чтобы избежать потери информации, вызовите accounts.v1beta.accounts.users.get , чтобы получить полный ресурс User , а затем укажите все поля в своем запросе accounts.v1beta.accounts.users.patch .

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

Следующий запрос получает количество 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 API Merchant Reports API, чтобы отобразить отфильтрованное представление данных о ваших продуктах, включая статусы продуктов. Например, вы можете запросить product_view чтобы получить список продуктов, у которых есть проблемы, или получить список ваших новых продуктов и проверить их обслуживание.

Вы должны включить поле id в предложение SELECT вашего запроса. id имеет то же значение, что и REST ID продукта.

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

  • gtin
  • item_issues

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

SELECT
  id,
  offer_id,
  feed_label,
  title,
  aggregated_reporting_context_status
  item_issues
FROM ProductView
WHERE aggregated_reporting_context_status = 'NOT_ELIGIBLE_OR_DISAPPROVED'

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

{
  "results": [
    {
      "productView": {
        "id": "online~en~US~id0"
        "offerId": "id0",
        "feedLabel": "US",
        "aggregatedReportingContextStatus": "NOT_ELIGIBLE_OR_DISAPPROVED",
        "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"
          }
        ]
      }
    }
  ]
}

Дополнительную информацию о конкретных полях и поведении см. в справочнике 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_conversion_change_fraction
FROM price_insights_product_view

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

{
   "results": [
    {
      "priceInsightsProductView": {
        "id": "online~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": "online~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": "online~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"
      }
    }
  ]
}