このページは Cloud Translation API によって翻訳されました。

商品を評価する

Merchant Reports API を使用すると、パフォーマンスデータの表示、特定の属性による商品のフィルタリング、価格の改善を行うことができます。

パフォーマンスの測定

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

要件

アカウントにパフォーマンスと分析情報のロールを付与するには、Content API for Shopping の accounts.update メソッドを使用して reportsManager フィールドを true に設定します。

accounts.update は、Account リソース全体を置き換えます。accounts.get を使用して Account リソース全体を取得し、情報が失われないように accounts.update リクエストにすべてのフィールドを指定します。

クエリの例

次のクエリは、特定の 30 日間のアカウント内のすべての商品の impressions、clicks、clickThroughRate を取得します。リクエストを行うには、次の Merchant Center のクエリ言語ステートメントを accounts.reports.search メソッドに渡します。

SELECT impressions, clicks, clickThroughRate
FROM ProductPerformanceView
WHERE date BETWEEN '2020-12-01' AND '2020-12-30'

クエリの指標を分割して、より詳細なパフォーマンスレポートを作成することもできます。

プロダクトのフィルタ

Merchant Reports API の ProductView を使用すると、商品のステータスなど、商品データをフィルタして表示できます。たとえば、ProductView をクエリして、問題のある商品のリストを取得したり、新しい商品のリストを取得して配信を確認したりできます。

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

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

gtin
itemIssues

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

SELECT
  id,
  offerId,
  feedLabel,
  title,
  aggregatedReportingContextStatus
  itemIssues
FROM ProductView
WHERE aggregatedReportingContextStatus = '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"
          }
        ]
      }
    }
  ]
}

特定のフィールドと動作について詳しくは、ProductView リファレンスをご覧ください。

料金を改善する

価格分析ビューを使用すると、商品の提案セール価格と、商品の価格を更新した場合に期待できるパフォーマンスの予測を確認できます。価格分析レポートを使用すると、商品の価格設定をより効果的に行うことができます。

詳しくは、価格分析レポートを使用して商品の価格設定を改善するをご覧ください。

商品の提案セール価格を表示するには、PriceInsightsProductView をクエリします。

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

SELECT
  id,
  title,
  brand,
  price,
  suggested_price,
  predictedImpressionsChangeFraction,
  predictedClicksChangeFraction,
  predictedConversionChangeFraction
FROM PriceInsightsProductView

上記のクエリのレスポンス例を次に示します。

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