Merchant API phiên bản v1beta đã ngừng hoạt động và ngừng cung cấp từ ngày 28 tháng 2 năm 2026. Để biết các bước chuyển đổi sang phiên bản ổn định mới nhất, hãy xem phần Di chuyển từ v1beta sang v1.

Đánh giá sản phẩm

Bạn có thể sử dụng Merchant Reports API để xem dữ liệu hiệu suất , lọc sản phẩm theo các thuộc tính cụ thể và cải thiện cách định giá.

Đo lường hiệu suất

Bạn có thể truy xuất các chỉ số hiệu suất cho tài khoản của mình bằng Merchant Reports API product_performance_view.

Yêu cầu

Để truy xuất báo cáo này, bạn cần có vai trò Hiệu suất và thông tin chi tiết.

Để chỉ định vai trò Hiệu suất và thông tin chi tiết cho một người dùng hiện có, hãy tạo một yêu cầu vá và chỉ định quyền truy cập PERFORMANCE_REPORTING cho người dùng đó. Yêu cầu sau đây cho biết cách tạo một yêu cầu vá để chỉ định quyền truy cập PERFORMANCE_REPORTING:

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

{
  "accessRights": [
    "PERFORMANCE_REPORTING"
  ]
}

Thay thế nội dung sau:

{ACCOUNT_ID}: Mã nhận dạng duy nhất của tài khoản Merchant Center.
{EMAIL_ID}: Địa chỉ email của người dùng mà bạn muốn chỉ định vai trò.

Truy vấn mẫu

Truy vấn sau đây truy xuất impressions, clicks và click_through_rate cho tất cả sản phẩm trong tài khoản của bạn trong một khoảng thời gian 30 ngày cụ thể. Để đưa ra yêu cầu, hãy chuyển câu lệnh Ngôn ngữ truy vấn Merchant Center sau đây đến phương thức accounts.reports.search:

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

Để biết thêm thông tin về báo cáo hiệu suất, hãy xem hướng dẫn Báo cáo hiệu suất.

Lọc sản phẩm

Bạn có thể sử dụng Merchant Reports API's product_view để hiển thị chế độ xem đã lọc về dữ liệu sản phẩm, bao gồm cả trạng thái sản phẩm. Ví dụ: bạn có thể truy vấn product_view để liệt kê những sản phẩm gặp vấn đề hoặc để lấy danh sách sản phẩm mới và xác minh việc phân phát.

Bạn phải đưa trường id vào mệnh đề SELECT của truy vấn. id có cùng giá trị với mã nhận dạng REST của sản phẩm.

Bạn có thể lọc dựa trên tất cả các trường có sẵn, ngoại trừ những trường sau:

status_per_reporting_context
item_issues.

Bạn có thể sắp xếp phản hồi dựa trên tất cả các trường có sẵn, ngoại trừ những trường sau:

gtin
status_per_reporting_context
item_issues

Bạn có thể kiểm tra trường aggregated_reporting_context_status để hiểu rõ về điều kiện tổng thể của một sản phẩm. Trường này tổng hợp trạng thái trên tất cả các bối cảnh báo cáo của một sản phẩm.

Dưới đây là một ví dụ trả về các sản phẩm có trạng thái tổng hợp là ELIGIBLE_LIMITED, nghĩa là các sản phẩm đó đủ điều kiện phân phát trong ít nhất một nhưng không phải tất cả các bối cảnh báo cáo được nhắm mục tiêu. Bạn có thể yêu cầu trạng thái sản phẩm chi tiết theo bối cảnh báo cáo và các vấn đề về sản phẩm để điều tra thêm. Để đưa ra yêu cầu, hãy chuyển câu lệnh Ngôn ngữ truy vấn Merchant Center sau đây đến accounts.reports.search phương thức:

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'

Dưới đây là một phản hồi mẫu từ truy vấn trước đó:

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

Bạn có thể sử dụng bộ lọc trên reporting_context trong mệnh đề WHERE để xem thông tin chi tiết về sản phẩm cho một bối cảnh báo cáo cụ thể. Khi bạn lọc theo reporting_context, aggregated_reporting_context_status chỉ được tính dựa trên bối cảnh báo cáo đã chọn và status_per_reporting_context và item_issues chỉ trả về thông tin chi tiết cho bối cảnh đó.

Để biết thêm thông tin về các trường có sẵn cho truy vấn, hãy xem Các trường trong bảng product_view.

Cải thiện cách định giá

Bạn có thể sử dụng chế độ xem thông tin chi tiết về giá để xem giá ưu đãi được đề xuất cho sản phẩm và dự đoán hiệu suất mà bạn có thể đạt được nếu cập nhật giá sản phẩm. Việc khai thác báo cáo thông tin chi tiết về giá có thể giúp bạn định giá sản phẩm một cách hiệu quả hơn.

Để biết thêm thông tin, hãy xem Cải thiện cách định giá sản phẩm bằng báo cáo thông tin chi tiết về giá.

Truy vấn price_insights_product_view để xem giá ưu đãi được đề xuất cho sản phẩm.

Dưới đây là một mẫu mà bạn có thể sử dụng để xem giá ưu đãi được đề xuất cho sản phẩm. Để đưa ra yêu cầu, hãy chuyển câu lệnh Ngôn ngữ truy vấn Merchant Center sau đây đến phương thức 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