商品を評価する

Merchant Reports API を使用すると、パフォーマンス データを表示したり、特定の属性で商品をフィルタしたり、価格設定を改善したりできます。

パフォーマンスの測定

Merchant Reports API product_performance_view を使用して、アカウントのパフォーマンス指標を取得できます。

要件

このレポートを取得するには、パフォーマンスと分析情報のロールが必要です。

アカウントにパフォーマンスと分析情報のロールを与えるには、アカウントの User リソースに PERFORMANCE_REPORTING アクセス権をパッチします。

accounts.v1beta.accounts.users.patchUser リソース全体を置き換えます。情報を失わないようにするには、accounts.v1beta.accounts.users.get を呼び出して User リソース全体を取得し、accounts.v1beta.accounts.users.patch リクエストのすべてのフィールドを提供します。

クエリの例

次のクエリは、特定の 30 日間にアカウント内のすべての商品の impressionsclicksclick_through_rate を取得します。リクエストを送信するには、次の Merchant Center Query Language ステートメントを accounts.reports.search メソッドに渡します。

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

パフォーマンス レポートの詳細については、パフォーマンス レポート ガイドをご覧ください。

プロダクトのフィルタ

Merchant Reports API の product_view を使用すると、商品ステータスを含む商品データのフィルタされたビューを表示できます。たとえば、product_view にクエリを実行して問題のある商品を一覧表示したり、新しい商品のリストを取得して配信を確認したりできます。

クエリの SELECT 句に id フィールドを含める必要があります。id は、プロダクトの REST ID と同じ値です。

item_issues を除く、使用可能なフィールドすべてに基づいてフィルタできます。レスポンスは、次のフィールドを除く、使用可能なすべてのフィールドに基づいて並べ替えることができます。

  • gtin
  • item_issues

ステータスが NOT_ELIGIBLE_OR_DISAPPROVED の商品を返す例を次に示します。リクエストを実行するには、次の Merchant Center Query Language ステートメントを accounts.reports.search メソッドに渡します。

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 をクエリして、商品の推奨セール価格を表示します。

商品の提案セール価格を確認するために使用できるサンプルを以下に示します。リクエストを実行するには、次の Merchant Center Query Language ステートメントを accounts.reports.search メソッドに渡します。

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