評估產品

您可以使用 Merchant Reports API 查看成效資料、依特定屬性篩選產品,以及改善價格設定

衡量成效

您可以使用 Merchant Reports API product_performance_view 擷取帳戶的成效指標

需求條件

如要擷取這份報表,您必須具備成效和洞察角色

如要為帳戶授予成效和洞察角色,請使用 PERFORMANCE_REPORTING 存取權,為帳戶修補 User 資源。如要完成這項操作,請將整個 User 資源替換為 accounts.v1beta.accounts.users.patch

為避免遺失資訊,請呼叫 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 product_view
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"
          }
        ]
      }
    }
  ]
}

如要進一步瞭解可供查詢的欄位,請參閱「productView 資料表中的欄位」。

改善定價

你可以透過價格深入分析檢視畫面,查看產品的建議特價,以及更新產品價格後的預期成效預測。價格深入分析報表可協助你更有效地設定產品價格。

詳情請參閱「透過價格分析報表改善產品價格」。

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

如要進一步瞭解可供查詢的欄位,請參閱「priceInsightsProductView 資料表中的欄位」。