Method: accounts.reports.search

Truy xuất báo cáo được xác định theo truy vấn tìm kiếm. Phản hồi có thể chứa ít hàng hơn so với chỉ định của pageSize. Dựa vào nextPageToken để xác định xem có thêm hàng nào cần được yêu cầu hay không.

Yêu cầu HTTP

POST https://merchantapi.googleapis.com/reports/v1beta/{parent=accounts/*}/reports:search

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Tham số
parent

string

Bắt buộc. Mã của tài khoản thực hiện cuộc gọi. Bạn phải dùng một tài khoản độc lập hoặc tài khoản phụ của tài khoản nhiều khách hàng (MCA). Định dạng: accounts/{account}

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "query": string,
  "pageSize": integer,
  "pageToken": string
}
Trường
query

string

Bắt buộc. Truy vấn xác định báo cáo cần truy xuất.

Để biết chi tiết về cách tạo truy vấn của bạn, hãy xem hướng dẫn Ngôn ngữ truy vấn. Để biết danh sách đầy đủ các bảng và trường hiện có, hãy xem các trường Có sẵn.
pageSize

integer

Không bắt buộc. Số ReportRows truy xuất trong một trang. Giá trị mặc định là 1000. Các giá trị lớn hơn 5000 sẽ bị buộc thành 5000.
pageToken

string

Không bắt buộc. Mã thông báo của trang cần truy xuất. Nếu không được chỉ định, trang kết quả đầu tiên sẽ được trả về. Để yêu cầu trang kết quả tiếp theo, giá trị nhận được từ nextPageToken trong phản hồi trước đó nên được sử dụng.

Nội dung phản hồi

Thông báo phản hồi cho phương thức ReportService.Search.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "results": [
    {
      object (ReportRow)
    }
  ],
  "nextPageToken": string
}
Trường
results[]

object (ReportRow)

Các hàng phù hợp với cụm từ tìm kiếm.
nextPageToken

string

Mã thông báo có thể được gửi dưới dạng pageToken để truy xuất trang tiếp theo. Nếu bỏ qua thì sẽ không có trang tiếp theo nào.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/content

Để biết thêm thông tin, hãy xem bài viết Tổng quan về OAuth 2.0.

ReportRow

Hàng kết quả được trả về từ cụm từ tìm kiếm.

Chỉ thông báo tương ứng với bảng được truy vấn mới được điền sẵn vào phản hồi. Trong thông báo được điền sẵn, chỉ những trường được yêu cầu rõ ràng trong truy vấn mới được điền sẵn.

Biểu diễn dưới dạng JSON 
{
  "productPerformanceView": {
    object (ProductPerformanceView)
  },
  "nonProductPerformanceView": {
    object (NonProductPerformanceView)
  },
  "productView": {
    object (ProductView)
  },
  "priceCompetitivenessProductView": {
    object (PriceCompetitivenessProductView)
  },
  "priceInsightsProductView": {
    object (PriceInsightsProductView)
  },
  "bestSellersProductClusterView": {
    object (BestSellersProductClusterView)
  },
  "bestSellersBrandView": {
    object (BestSellersBrandView)
  },
  "competitiveVisibilityCompetitorView": {
    object (CompetitiveVisibilityCompetitorView)
  },
  "competitiveVisibilityTopMerchantView": {
    object (CompetitiveVisibilityTopMerchantView)
  },
  "competitiveVisibilityBenchmarkView": {
    object (CompetitiveVisibilityBenchmarkView)
  }
}
Trường
productPerformanceView

object (ProductPerformanceView)

Các trường có sẵn cho truy vấn trong bảng productPerformanceView.
nonProductPerformanceView

object (NonProductPerformanceView)

Các trường có sẵn cho truy vấn trong bảng nonProductPerformanceView.
productView

object (ProductView)

Các trường có sẵn cho truy vấn trong bảng productView.
priceCompetitivenessProductView

object (PriceCompetitivenessProductView)

Các trường có sẵn cho truy vấn trong bảng priceCompetitivenessProductView.
priceInsightsProductView

object (PriceInsightsProductView)

Các trường có sẵn cho truy vấn trong bảng priceInsightsProductView.
bestSellersProductClusterView

object (BestSellersProductClusterView)

Các trường có sẵn cho truy vấn trong bảng bestSellersProductClusterView.
bestSellersBrandView

object (BestSellersBrandView)

Các trường có sẵn cho truy vấn trong bảng bestSellersBrandView.
competitiveVisibilityCompetitorView

object (CompetitiveVisibilityCompetitorView)

Các trường có sẵn cho truy vấn trong bảng competitiveVisibilityCompetitorView.
competitiveVisibilityTopMerchantView

object (CompetitiveVisibilityTopMerchantView)

Các trường có sẵn cho truy vấn trong bảng competitiveVisibilityTopMerchantView.
competitiveVisibilityBenchmarkView

object (CompetitiveVisibilityBenchmarkView)

Các trường có sẵn cho truy vấn trong bảng competitiveVisibilityBenchmarkView.

ProductPerformanceView

Các trường có sẵn cho truy vấn trong bảng productPerformanceView.

Dữ liệu hiệu suất sản phẩm cho tài khoản của bạn, bao gồm cả các chỉ số hiệu suất (ví dụ: clicks) và các phương diện theo đó các chỉ số hiệu suất được phân đoạn (ví dụ: offerId). Giá trị của các phương diện sản phẩm, chẳng hạn như offerId, cho biết trạng thái của sản phẩm tại thời điểm hiển thị.

Bạn không thể chọn các trường phân đoạn trong truy vấn nếu không chọn cả ít nhất một trường chỉ số.

Giá trị chỉ được đặt cho các trường được yêu cầu rõ ràng trong truy vấn tìm kiếm của yêu cầu.

Biểu diễn dưới dạng JSON 
{
  "date": {
    object (Date)
  },
  "week": {
    object (Date)
  },
  "conversionValue": {
    object (Price)
  },
  "marketingMethod": enum (MarketingMethodEnum),
  "customerCountryCode": string,
  "offerId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "customLabel0": string,
  "customLabel1": string,
  "customLabel2": string,
  "customLabel3": string,
  "customLabel4": string,
  "clicks": string,
  "impressions": string,
  "clickThroughRate": number,
  "conversions": number,
  "conversionRate": number
}
Trường
date

object (Date)

Ngày theo múi giờ của người bán mà các chỉ số áp dụng. Phân đoạn.

Điều kiện trên date là bắt buộc trong mệnh đề WHERE.
week

object (Date)

Ngày đầu tiên trong tuần (thứ Hai) của ngày chỉ số theo múi giờ của người bán. Phân đoạn.
conversionValue

object (Price)

Giá trị lượt chuyển đổi được phân bổ cho sản phẩm, được báo cáo vào ngày chuyển đổi. Chỉ số.

Chỉ dành cho nguồn lưu lượng truy cập FREE.
marketingMethod

enum (MarketingMethodEnum)

Phương pháp tiếp thị áp dụng các chỉ số. Phân đoạn.
customerCountryCode

string

Mã quốc gia nơi khách hàng sinh sống tại thời điểm diễn ra sự kiện. Được trình bày ở định dạng ISO 3166. Phân đoạn.

Nếu không thể xác định quốc gia của khách hàng, mã 'ZZ' đặc biệt sẽ được trả về.
offerId

string

Mã sản phẩm do người bán cung cấp. Phân đoạn.
title

string

Tiêu đề của sản phẩm. Phân đoạn.
brand

string

Thương hiệu của sản phẩm. Phân đoạn.
categoryL1

string

Danh mục sản phẩm (cấp 1) trong thông tin phân loại sản phẩm của Google. Phân đoạn.
categoryL2

string

Danh mục sản phẩm (cấp 2) trong hệ thống phân loại sản phẩm của Google. Phân đoạn.
categoryL3

string

Danh mục sản phẩm (cấp 3) trong hệ thống phân loại sản phẩm của Google. Phân đoạn.
categoryL4

string

Danh mục sản phẩm (cấp 4) trong hệ thống phân loại sản phẩm của Google. Phân đoạn.
categoryL5

string

Danh mục sản phẩm (cấp 5) trong hệ thống phân loại sản phẩm của Google. Phân đoạn.
productTypeL1

string

Loại sản phẩm (cấp 1) trong hệ thống phân loại sản phẩm của chính người bán. Phân đoạn.
productTypeL2

string

Loại sản phẩm (cấp 2) trong hệ thống phân loại sản phẩm của chính người bán. Phân đoạn.
productTypeL3

string

Loại sản phẩm (cấp 3) trong hệ thống phân loại sản phẩm của chính người bán. Phân đoạn.
productTypeL4

string

Loại sản phẩm (cấp 4) trong hệ thống phân loại sản phẩm của chính người bán. Phân đoạn.
productTypeL5

string

Loại sản phẩm (cấp 5) trong hệ thống phân loại sản phẩm của chính người bán. Phân đoạn.
customLabel0

string

Nhãn tuỳ chỉnh 0 để nhóm sản phẩm tuỳ chỉnh. Phân đoạn.
customLabel1

string

Nhãn tuỳ chỉnh 1 để nhóm sản phẩm tuỳ chỉnh. Phân đoạn.
customLabel2

string

Nhãn tuỳ chỉnh 2 để nhóm sản phẩm tuỳ chỉnh. Phân đoạn.
customLabel3

string

Nhãn tuỳ chỉnh 3 để nhóm sản phẩm tuỳ chỉnh. Phân đoạn.
customLabel4

string

Nhãn tuỳ chỉnh 4 để nhóm sản phẩm tuỳ chỉnh. Phân đoạn.
clicks

string (int64 format)

Số lượt nhấp. Chỉ số.
impressions

string (int64 format)

Số lần sản phẩm của người bán xuất hiện. Chỉ số.
clickThroughRate

number

Tỷ lệ nhấp – số lượt nhấp mà sản phẩm của người bán nhận được (số lượt nhấp) chia cho số lượt hiển thị sản phẩm (số lượt hiển thị). Chỉ số.
conversions

number

Số lượt chuyển đổi được phân bổ cho sản phẩm, được báo cáo vào ngày chuyển đổi. Tuỳ thuộc vào mô hình phân bổ, một lượt chuyển đổi có thể được phân bổ trên nhiều lượt nhấp, trong đó mỗi lượt nhấp sẽ được chỉ định giá trị đóng góp riêng. Chỉ số này là tổng của tất cả các khoản tín dụng đó. Chỉ số.

Chỉ dành cho nguồn lưu lượng truy cập FREE.
conversionRate

number

Số lượt chuyển đổi chia cho số lượt nhấp, được báo cáo vào ngày hiển thị. Chỉ số.

Chỉ dành cho nguồn lưu lượng truy cập FREE.

MarketingMethodEnum

Giá trị của phương thức tiếp thị.

Enum
MARKETING_METHOD_ENUM_UNSPECIFIED Chưa chỉ định.
ORGANIC Tiếp thị tự nhiên.
ADS Tiếp thị dựa trên quảng cáo.

NonProductPerformanceView

Các trường có sẵn cho truy vấn trong bảng nonProductPerformanceView.

Dữ liệu hiệu suất của hình ảnh và đường liên kết đến cửa hàng trực tuyến dẫn đến những trang không liên quan đến sản phẩm. Điều này bao gồm các chỉ số hiệu suất (ví dụ: clicks) và những phương diện theo đó chỉ số hiệu suất được phân đoạn (ví dụ: date).

Bạn không thể chọn các trường phân đoạn trong truy vấn nếu không chọn cả ít nhất một trường chỉ số.

Giá trị chỉ được đặt cho các trường được yêu cầu rõ ràng trong truy vấn tìm kiếm của yêu cầu.

Biểu diễn dưới dạng JSON 
{
  "date": {
    object (Date)
  },
  "week": {
    object (Date)
  },
  "clicks": string,
  "impressions": string,
  "clickThroughRate": number
}
Trường
date

object (Date)

Ngày theo múi giờ của người bán mà các chỉ số áp dụng. Phân đoạn.

Điều kiện trên date là bắt buộc trong mệnh đề WHERE.
week

object (Date)

Ngày đầu tiên trong tuần (thứ Hai) của ngày chỉ số theo múi giờ của người bán. Phân đoạn.
clicks

string (int64 format)

Số lượt nhấp vào hình ảnh và đường liên kết đến cửa hàng trực tuyến dẫn đến các trang không liên quan đến sản phẩm. Chỉ số.
impressions

string (int64 format)

Số lần hình ảnh và đường liên kết đến cửa hàng trực tuyến dẫn đến các trang không liên quan đến sản phẩm của bạn xuất hiện. Chỉ số.
clickThroughRate

number

Tỷ lệ nhấp – số lượt nhấp (clicks) chia cho số lượt hiển thị (impressions) của hình ảnh và đường liên kết đến cửa hàng trực tuyến dẫn đến các trang không liên quan đến sản phẩm. Chỉ số.

ProductView

Các trường có sẵn cho truy vấn trong bảng productView.

Sản phẩm trong kho hàng hiện tại. Sản phẩm trong bảng này giống như trong API phụ sản phẩm nhưng không phải tất cả thuộc tính sản phẩm trong API phụ sản phẩm đều có sẵn để truy vấn trong bảng này. Trái ngược với API phụ sản phẩm, bảng này cho phép lọc danh sách sản phẩm được trả về theo thuộc tính sản phẩm. Để truy xuất một sản phẩm trước id hoặc liệt kê tất cả sản phẩm, bạn nên sử dụng API phụ của Sản phẩm.

Giá trị chỉ được đặt cho các trường được yêu cầu rõ ràng trong truy vấn tìm kiếm của yêu cầu.

Biểu diễn dưới dạng JSON 
{
  "price": {
    object (Price)
  },
  "gtin": [
    string
  ],
  "creationTime": string,
  "expirationDate": {
    object (Date)
  },
  "itemIssues": [
    {
      object (ItemIssue)
    }
  ],
  "clickPotential": enum (ClickPotential),
  "id": string,
  "channel": enum (ChannelEnum),
  "languageCode": string,
  "feedLabel": string,
  "offerId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "condition": string,
  "availability": string,
  "shippingLabel": string,
  "itemGroupId": string,
  "thumbnailLink": string,
  "aggregatedReportingContextStatus": enum (AggregatedReportingContextStatus),
  "clickPotentialRank": string
}
Trường
price

object (Price)

Giá sản phẩm. Không có thông tin nếu không có thông tin về giá của sản phẩm.
gtin[]

string

Danh sách Mã số sản phẩm thương mại toàn cầu (GTIN) của sản phẩm.
creationTime

string (Timestamp format)

Thời gian người bán tạo sản phẩm tính bằng giây dấu thời gian.
expirationDate

object (Date)

Ngày hết hạn của sản phẩm, được chỉ định khi chèn.
itemIssues[]

object (ItemIssue)

Danh sách các vấn đề về mặt hàng đối với sản phẩm.

Không thể dùng trường này để sắp xếp kết quả.

Bạn chỉ có thể dùng những thuộc tính đã chọn của trường này (ví dụ: itemIssues.severity.aggregated_severity) để lọc kết quả.
clickPotential

enum (ClickPotential)

Tiềm năng ước tính về hiệu suất so với các sản phẩm có hiệu suất cao nhất của người bán.
id

string

Mã REST của sản phẩm, ở dạng channel~languageCode~feedLabel~offerId. Các phương thức API Merchant Center hoạt động trên sản phẩm sẽ lấy thông số này làm tham số name.

Bắt buộc trong mệnh đề SELECT.
channel

enum (ChannelEnum)

Kênh của sản phẩm. Giá trị này có thể là ONLINE hoặc LOCAL.
languageCode

string

Mã ngôn ngữ của sản phẩm ở định dạng BCP 47.
feedLabel

string

Nhãn nguồn cấp dữ liệu của sản phẩm.
offerId

string

Mã sản phẩm do người bán cung cấp.
title

string

Tiêu đề của sản phẩm.
brand

string

Thương hiệu của sản phẩm.
categoryL1

string

Danh mục sản phẩm (cấp 1) trong hệ thống phân loại sản phẩm của Google.
categoryL2

string

Danh mục sản phẩm (cấp 2) trong hệ thống phân loại sản phẩm của Google.
categoryL3

string

Danh mục sản phẩm (cấp 3) trong hệ thống phân loại sản phẩm của Google.
categoryL4

string

Danh mục sản phẩm (cấp 4) trong hệ thống phân loại sản phẩm của Google.
categoryL5

string

Danh mục sản phẩm (cấp 5) trong hệ thống phân loại sản phẩm của Google.
productTypeL1

string

Loại sản phẩm (cấp 1) trong thông tin phân loại sản phẩm của chính người bán.
productTypeL2

string

Loại sản phẩm (cấp 2) trong dữ liệu phân loại sản phẩm của chính người bán.
productTypeL3

string

Loại sản phẩm (cấp 3) trong dữ liệu phân loại sản phẩm của chính người bán.
productTypeL4

string

Loại sản phẩm (cấp 4) trong dữ liệu phân loại sản phẩm của chính người bán.
productTypeL5

string

Loại sản phẩm (cấp 5) trong dữ liệu phân loại sản phẩm của chính người bán.
condition

string

Tình trạng của sản phẩm.
availability

string

Tình trạng còn hàng của sản phẩm.
shippingLabel

string

Nhãn vận chuyển chuẩn hoá được chỉ định trong nguồn dữ liệu.
itemGroupId

string

Mã nhóm mặt hàng do người bán cung cấp để nhóm các biến thể lại với nhau.
aggregatedReportingContextStatus

enum (AggregatedReportingContextStatus)

Trạng thái tổng hợp.
clickPotentialRank

string (int64 format)

Thứ hạng của sản phẩm dựa trên tiềm năng tạo lượt nhấp. Sản phẩm có clickPotentialRank 1 có tiềm năng tạo lượt nhấp cao nhất trong số các sản phẩm của người bán đáp ứng các điều kiện của cụm từ tìm kiếm.

AggregatedReportingContextStatus

Trạng thái của sản phẩm được tổng hợp cho tất cả các bối cảnh báo cáo.

Dưới đây là ví dụ về cách tính trạng thái tổng hợp:

Trang thông tin miễn phí Quảng cáo Mua sắm Trạng thái
Approved Approved ĐỦ ĐIỀU KIỆN
Approved Đang chờ xử lý ĐỦ ĐIỀU KIỆN
Approved Bị từ chối ELIGIBLE_LIMITED
Đang chờ xử lý Đang chờ xử lý ĐANG CHỜ GIẢI QUYẾT
Bị từ chối Bị từ chối NOT_ELIGIBLE_OR_DISAPPROVED
Enum
AGGREGATED_REPORTING_CONTEXT_STATUS_UNSPECIFIED Chưa chỉ định.
NOT_ELIGIBLE_OR_DISAPPROVED Sản phẩm không đủ điều kiện hoặc bị từ chối trong mọi bối cảnh báo cáo.
PENDING Trạng thái của sản phẩm là đang chờ xử lý trong tất cả ngữ cảnh báo cáo.
ELIGIBLE_LIMITED Sản phẩm đủ điều kiện cho một số (nhưng không phải tất cả) ngữ cảnh báo cáo.
ELIGIBLE Sản phẩm này đủ điều kiện cho tất cả các bối cảnh báo cáo.

ItemIssue

Vấn đề về mặt hàng liên quan đến sản phẩm.

Biểu diễn dưới dạng JSON 
{
  "type": {
    object (ItemIssueType)
  },
  "severity": {
    object (ItemIssueSeverity)
  },
  "resolution": enum (ItemIssueResolution)
}
Trường
type

object (ItemIssueType)

Loại vấn đề về mặt hàng.
severity

object (ItemIssueSeverity)

Mức độ nghiêm trọng của vấn đề về mặt hàng.
resolution

enum (ItemIssueResolution)

Giải quyết vấn đề về mặt hàng.

ItemIssueType

Loại vấn đề.

Biểu diễn dưới dạng JSON 
{
  "code": string,
  "canonicalAttribute": string
}
Trường
code

string

Mã lỗi của vấn đề, tương đương với code của Vấn đề về sản phẩm.
canonicalAttribute

string

Tên thuộc tính chuẩn cho các vấn đề về thuộc tính cụ thể.

ItemIssueSeverity

Ảnh hưởng của vấn đề đến hoạt động phân phát sản phẩm.

Biểu diễn dưới dạng JSON 
{
  "severityPerReportingContext": [
    {
      object (IssueSeverityPerReportingContext)
    }
  ],
  "aggregatedSeverity": enum (AggregatedIssueSeverity)
}
Trường
severityPerReportingContext[]

object (IssueSeverityPerReportingContext)

Mức độ nghiêm trọng của vấn đề theo ngữ cảnh báo cáo.
aggregatedSeverity

enum (AggregatedIssueSeverity)

Mức độ nghiêm trọng tổng hợp của vấn đề đối với tất cả bối cảnh báo cáo mà vấn đề đó ảnh hưởng.

Trường này có thể dùng để lọc kết quả.

IssueSeverityPerReportingContext

Mức độ nghiêm trọng của vấn đề theo ngữ cảnh báo cáo.

Biểu diễn dưới dạng JSON 
{
  "disapprovedCountries": [
    string
  ],
  "demotedCountries": [
    string
  ],
  "reportingContext": enum (ReportingContextEnum)
}
Trường
disapprovedCountries[]

string

Danh sách các quốc gia bị từ chối trong ngữ cảnh báo cáo, được trình bày theo định dạng ISO 3166.
demotedCountries[]

string

Danh sách các quốc gia bị giảm hạng trong ngữ cảnh báo cáo, được trình bày theo định dạng ISO 3166.
reportingContext

enum (ReportingContextEnum)

Bối cảnh báo cáo có liên quan đến vấn đề.

AggregatedIssueSeverity

Tổng mức độ nghiêm trọng của vấn đề cho tất cả ngữ cảnh báo cáo.

Enum
AGGREGATED_ISSUE_SEVERITY_UNSPECIFIED Chưa chỉ định.
DISAPPROVED Vấn đề sẽ từ chối sản phẩm trong ít nhất một ngữ cảnh báo cáo.
DEMOTED Vấn đề làm giảm hạng sản phẩm trong mọi ngữ cảnh báo cáo mà nó ảnh hưởng.
PENDING Vấn đề đang được xử lý PENDING_PROCESSING.

ItemIssueResolution

Cách giải quyết vấn đề.

Enum
ITEM_ISSUE_RESOLUTION_UNSPECIFIED Chưa chỉ định.
MERCHANT_ACTION Người bán phải khắc phục vấn đề.
PENDING_PROCESSING Vấn đề sẽ được tự động giải quyết (ví dụ: thu thập thông tin hình ảnh) hoặc thông qua một quy trình xem xét của Google. Người bán không cần làm gì vào lúc này. Việc giải quyết có thể dẫn đến một vấn đề khác (ví dụ: không thu thập dữ liệu được).

ClickPotential

Tiềm năng tạo lượt nhấp của sản phẩm ước tính tiềm năng về hiệu suất so với các sản phẩm có hiệu suất cao nhất của người bán. Tiềm năng tạo lượt nhấp của sản phẩm giúp người bán sắp xếp thứ tự ưu tiên cho những sản phẩm nào cần khắc phục và giúp họ hiểu rõ hiệu suất của sản phẩm so với tiềm năng.

Enum
CLICK_POTENTIAL_UNSPECIFIED Tác động nhấp chuột dự đoán không xác định.
LOW Có tiềm năng nhận được số lượt nhấp thấp so với những sản phẩm có hiệu suất cao nhất của người bán.
MEDIUM Có tiềm năng nhận được số lượt nhấp vừa phải so với những sản phẩm có hiệu suất cao nhất của người bán.
HIGH Có tiềm năng nhận được số lượt nhấp tương tự như những sản phẩm có hiệu suất cao nhất của người bán.

PriceCompetitivenessProductView

Các trường có sẵn cho truy vấn trong bảng priceCompetitivenessProductView.

Báo cáo sức cạnh tranh về giá.

Giá trị chỉ được đặt cho các trường được yêu cầu rõ ràng trong truy vấn tìm kiếm của yêu cầu.

Biểu diễn dưới dạng JSON 
{
  "price": {
    object (Price)
  },
  "benchmarkPrice": {
    object (Price)
  },
  "reportCountryCode": string,
  "id": string,
  "offerId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string
}
Trường
price

object (Price)

Giá hiện tại của sản phẩm.
benchmarkPrice

object (Price)

Mức giá chuẩn mới nhất hiện có cho danh mục sản phẩm tại quốc gia có giá chuẩn.
reportCountryCode

string

Quốc gia của mức giá chuẩn. Được trình bày ở định dạng ISO 3166.

Bắt buộc trong mệnh đề SELECT.
id

string

Mã REST của sản phẩm, ở dạng channel~languageCode~feedLabel~offerId. Có thể dùng để kết hợp dữ liệu với bảng productView.

Bắt buộc trong mệnh đề SELECT.
offerId

string

Mã sản phẩm do người bán cung cấp.
title

string

Tiêu đề của sản phẩm.
brand

string

Thương hiệu của sản phẩm.
categoryL1

string

Danh mục sản phẩm (cấp 1) trong hệ thống phân loại sản phẩm của Google.
categoryL2

string

Danh mục sản phẩm (cấp 2) trong hệ thống phân loại sản phẩm của Google.
categoryL3

string

Danh mục sản phẩm (cấp 3) trong hệ thống phân loại sản phẩm của Google.
categoryL4

string

Danh mục sản phẩm (cấp 4) trong hệ thống phân loại sản phẩm của Google.
categoryL5

string

Danh mục sản phẩm (cấp 5) trong hệ thống phân loại sản phẩm của Google.
productTypeL1

string

Loại sản phẩm (cấp 1) trong thông tin phân loại sản phẩm của chính người bán.
productTypeL2

string

Loại sản phẩm (cấp 2) trong dữ liệu phân loại sản phẩm của chính người bán.
productTypeL3

string

Loại sản phẩm (cấp 3) trong dữ liệu phân loại sản phẩm của chính người bán.
productTypeL4

string

Loại sản phẩm (cấp 4) trong dữ liệu phân loại sản phẩm của chính người bán.
productTypeL5

string

Loại sản phẩm (cấp 5) trong dữ liệu phân loại sản phẩm của chính người bán.

PriceInsightsProductView

Các trường có sẵn cho truy vấn trong bảng priceInsightsProductView.

Thông tin chi tiết về giá.

Giá trị chỉ được đặt cho các trường được yêu cầu rõ ràng trong truy vấn tìm kiếm của yêu cầu.

Biểu diễn dưới dạng JSON 
{
  "price": {
    object (Price)
  },
  "suggestedPrice": {
    object (Price)
  },
  "effectiveness": enum (Effectiveness),
  "id": string,
  "offerId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "predictedImpressionsChangeFraction": number,
  "predictedClicksChangeFraction": number,
  "predictedConversionsChangeFraction": number
}
Trường
price

object (Price)

Giá hiện tại của sản phẩm.
suggestedPrice

object (Price)

Giá đề xuất mới nhất cho sản phẩm.
effectiveness

enum (Effectiveness)

Hiệu quả dự đoán của việc áp dụng đề xuất về giá, được phân nhóm.
id

string

Mã REST của sản phẩm, ở dạng channel~languageCode~feedLabel~offerId. Có thể dùng để kết hợp dữ liệu với bảng productView.

Bắt buộc trong mệnh đề SELECT.
offerId

string

Mã sản phẩm do người bán cung cấp.
title

string

Tiêu đề của sản phẩm.
brand

string

Thương hiệu của sản phẩm.
categoryL1

string

Danh mục sản phẩm (cấp 1) trong hệ thống phân loại sản phẩm của Google.
categoryL2

string

Danh mục sản phẩm (cấp 2) trong hệ thống phân loại sản phẩm của Google.
categoryL3

string

Danh mục sản phẩm (cấp 3) trong hệ thống phân loại sản phẩm của Google.
categoryL4

string

Danh mục sản phẩm (cấp 4) trong hệ thống phân loại sản phẩm của Google.
categoryL5

string

Danh mục sản phẩm (cấp 5) trong hệ thống phân loại sản phẩm của Google.
productTypeL1

string

Loại sản phẩm (cấp 1) trong thông tin phân loại sản phẩm của chính người bán.
productTypeL2

string

Loại sản phẩm (cấp 2) trong dữ liệu phân loại sản phẩm của chính người bán.
productTypeL3

string

Loại sản phẩm (cấp 3) trong dữ liệu phân loại sản phẩm của chính người bán.
productTypeL4

string

Loại sản phẩm (cấp 4) trong dữ liệu phân loại sản phẩm của chính người bán.
productTypeL5

string

Loại sản phẩm (cấp 5) trong dữ liệu phân loại sản phẩm của chính người bán.
predictedImpressionsChangeFraction

number

Mức thay đổi dự đoán về số lượt hiển thị dưới dạng tỷ lệ phần trăm sau khi đưa ra giá đề xuất so với giá hiện tại. Ví dụ: 0, 05 là mức tăng dự đoán về số lượt hiển thị là 5%.
predictedClicksChangeFraction

number

Mức thay đổi dự đoán về số lượt nhấp dưới dạng tỷ lệ nhỏ sau khi đưa ra giá được đề xuất so với giá hiện tại. Ví dụ: 0, 05 là mức tăng dự đoán về số lượt nhấp thêm 5%.
predictedConversionsChangeFraction

number

Mức thay đổi được dự đoán về số lượt chuyển đổi dưới dạng tỷ lệ nhỏ sau khi đưa ra giá đề xuất so với giá hiện tại. Ví dụ: 0, 05 là mức tăng dự đoán của số lượt chuyển đổi là 5%).

Hiệu quả

Nhóm mức độ hiệu quả theo dự đoán.

Mức độ hiệu quả cho biết những sản phẩm nào sẽ được hưởng lợi nhiều nhất khi giá thay đổi. Điểm xếp hạng này tính đến mức tăng hiệu suất theo dự đoán bằng cách điều chỉnh giá ưu đãi và mức chênh lệch giữa giá hiện tại so với giá đề xuất. Những đề xuất về giá có mức độ hiệu quả là HIGH được dự đoán sẽ giúp hiệu suất gia tăng nhiều nhất.

Enum
EFFECTIVENESS_UNSPECIFIED Mức độ hiệu quả chưa được xác định.
LOW Mức độ hiệu quả thấp.
MEDIUM Mức độ hiệu quả trung bình.
HIGH Mức độ hiệu quả cao.

BestSellersProductClusterView

Các trường có sẵn cho truy vấn trong bảng bestSellersProductClusterView.

Báo cáo Sản phẩm và thương hiệu bán chạy nhất có các cụm sản phẩm hàng đầu. Cụm sản phẩm là một nhóm gồm nhiều mặt hàng và biến thể đại diện cho cùng một sản phẩm, ví dụ như Google Pixel 7.

Giá trị chỉ được đặt cho các trường được yêu cầu rõ ràng trong truy vấn tìm kiếm của yêu cầu.

Biểu diễn dưới dạng JSON 
{
  "reportDate": {
    object (Date)
  },
  "variantGtins": [
    string
  ],
  "reportGranularity": enum (ReportGranularityEnum),
  "reportCountryCode": string,
  "reportCategoryId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "inventoryStatus": enum (InventoryStatus),
  "brandInventoryStatus": enum (InventoryStatus),
  "rank": string,
  "previousRank": string,
  "relativeDemand": enum (RelativeDemandEnum),
  "previousRelativeDemand": enum (RelativeDemandEnum),
  "relativeDemandChange": enum (RelativeDemandChangeTypeEnum)
}
Trường
reportDate

object (Date)

Ngày báo cáo. Giá trị của trường này chỉ có thể là một trong những giá trị sau:

  • Ngày đầu tiên trong tuần (thứ Hai) để báo cáo hàng tuần,
  • Ngày đầu tiên của tháng đối với báo cáo hằng tháng.

Bắt buộc trong mệnh đề SELECT. Nếu bạn không chỉ định điều kiện WHERE trong reportDate trong truy vấn, thì báo cáo hằng tuần hoặc hằng tháng mới nhất sẽ được trả về.
variantGtins[]

string

GTIN của các biến thể mẫu của cụm sản phẩm.
reportGranularity

enum (ReportGranularityEnum)

Mức độ chi tiết của báo cáo. Quá trình xếp hạng có thể diễn ra trong khung thời gian một tuần hoặc một tháng.

Bắt buộc trong mệnh đề SELECT. Điều kiện trên reportGranularity là bắt buộc trong mệnh đề WHERE.
reportCountryCode

string

Quốc gia nơi thứ hạng được tính. Được trình bày ở định dạng ISO 3166.

Bắt buộc trong mệnh đề SELECT. Điều kiện trên reportCountryCode là bắt buộc trong mệnh đề WHERE.
reportCategoryId

string (int64 format)

Mã danh mục sản phẩm của Google để tính thứ hạng, được trình bày trong hệ thống phân loại sản phẩm của Google.

Bắt buộc trong mệnh đề SELECT. Nếu điều kiện WHERE trên reportCategoryId không được chỉ định trong truy vấn, xếp hạng cho tất cả danh mục cấp cao nhất sẽ được trả về.
title

string

Tiêu đề của cụm sản phẩm.
brand

string

Thương hiệu của cụm sản phẩm.
categoryL1

string

Danh mục sản phẩm (cấp 1) của cụm sản phẩm, được trình bày trong hệ thống phân loại sản phẩm của Google.
categoryL2

string

Danh mục sản phẩm (cấp 2) của cụm sản phẩm, được trình bày trong hệ thống phân loại sản phẩm của Google.
categoryL3

string

Danh mục sản phẩm (cấp 3) của cụm sản phẩm, được trình bày trong phân loại sản phẩm của Google.
categoryL4

string

Danh mục sản phẩm (cấp 4) của cụm sản phẩm, được trình bày trong hệ thống phân loại sản phẩm của Google.
categoryL5

string

Danh mục sản phẩm (cấp 5) của cụm sản phẩm, được trình bày trong hệ thống phân loại sản phẩm của Google.
inventoryStatus

enum (InventoryStatus)

Liệu cụm sản phẩm có là IN_STOCK trong nguồn dữ liệu sản phẩm của bạn ở ít nhất một trong các quốc gia, OUT_OF_STOCK trong nguồn dữ liệu sản phẩm ở tất cả các quốc gia hay hoàn toàn là NOT_IN_INVENTORY.

Trường này không tính bộ lọc theo quốc gia của báo cáo thương hiệu và sản phẩm bán chạy nhất.
brandInventoryStatus

enum (InventoryStatus)

Cho dù có ít nhất một sản phẩm của thương hiệu hiện đang IN_STOCK trong nguồn dữ liệu sản phẩm tại ít nhất một trong các quốc gia, thì tất cả sản phẩm đều có giá trị là OUT_OF_STOCK trong nguồn dữ liệu sản phẩm ở tất cả các quốc gia hoặc NOT_IN_INVENTORY.

Trường này không tính bộ lọc theo quốc gia của báo cáo thương hiệu và sản phẩm bán chạy nhất.
rank

string (int64 format)

Mức độ phổ biến của cụm sản phẩm trên Google Ads và các nền tảng không tính phí, trong danh mục và quốc gia đã chọn, dựa trên số lượng đơn vị sản phẩm ước tính đã bán.
previousRank

string (int64 format)

Thứ hạng mức độ phổ biến trong tuần hoặc tháng trước.
relativeDemand

enum (RelativeDemandEnum)

Nhu cầu ước tính so với nhóm sản phẩm có thứ hạng mức độ phổ biến cao nhất trong cùng danh mục và quốc gia.
previousRelativeDemand

enum (RelativeDemandEnum)

Nhu cầu ước tính liên quan đến nhóm sản phẩm có thứ hạng mức độ phổ biến cao nhất trong cùng danh mục và quốc gia vào tuần trước hoặc tháng trước.
relativeDemandChange

enum (RelativeDemandChangeTypeEnum)

Thay đổi về nhu cầu ước tính. Dù nó tăng lên, chìm hay đứng yên.

ReportGranularityEnum

Giá trị độ chi tiết của báo cáo.

Enum
REPORT_GRANULARITY_ENUM_UNSPECIFIED Chưa chỉ định.
WEEKLY Báo cáo được tính toán trong khung thời gian một tuần.
MONTHLY Báo cáo được tính toán trong khung thời gian một tháng.

InventoryStatus

Trạng thái của cụm sản phẩm hoặc thương hiệu trong kho hàng của bạn.

Enum
INVENTORY_STATUS_UNSPECIFIED Chưa chỉ định.
IN_STOCK Bạn có một sản phẩm cho nhóm sản phẩm hoặc thương hiệu này còn hàng.
OUT_OF_STOCK Bạn có một sản phẩm cho cụm sản phẩm hoặc thương hiệu này trong kho hàng nhưng sản phẩm này hiện đã hết hàng.
NOT_IN_INVENTORY Bạn không có sản phẩm nào cho cụm sản phẩm hoặc thương hiệu này trong kho hàng.

RelativeDemandEnum

Giá trị nhu cầu tương đối.

Enum
RELATIVE_DEMAND_ENUM_UNSPECIFIED Chưa chỉ định.
VERY_LOW Nhu cầu chiếm 0-5% nhu cầu cho cụm sản phẩm hoặc thương hiệu được xếp hạng cao nhất.
LOW Nhu cầu chiếm 6-10% nhu cầu cho cụm sản phẩm hoặc thương hiệu được xếp hạng cao nhất.
MEDIUM Nhu cầu chiếm 11-20% nhu cầu cho cụm sản phẩm hoặc thương hiệu được xếp hạng cao nhất.
HIGH Nhu cầu chiếm 21-50% nhu cầu cho cụm sản phẩm hoặc thương hiệu được xếp hạng cao nhất.
VERY_HIGH Nhu cầu đạt 51-100% so với nhu cầu cho cụm sản phẩm hoặc thương hiệu được xếp hạng cao nhất.

RelativeDemandChangeTypeEnum

Giá trị loại thay đổi về nhu cầu tương đối.

Enum
RELATIVE_DEMAND_CHANGE_TYPE_ENUM_UNSPECIFIED Chưa chỉ định.
SINKER Nhu cầu tương đối thấp hơn khoảng thời gian trước đó.
FLAT Nhu cầu tương đối bằng với khoảng thời gian trước đó.
RISER Nhu cầu tương đối cao hơn khoảng thời gian trước đó.

BestSellersBrandView

Các trường có sẵn cho truy vấn trong bảng bestSellersBrandView.

Báo cáo Bán chạy nhất có các thương hiệu hàng đầu.

Giá trị chỉ được đặt cho các trường được yêu cầu rõ ràng trong truy vấn tìm kiếm của yêu cầu.

Biểu diễn dưới dạng JSON 
{
  "reportDate": {
    object (Date)
  },
  "reportGranularity": enum (ReportGranularityEnum),
  "reportCountryCode": string,
  "reportCategoryId": string,
  "brand": string,
  "rank": string,
  "previousRank": string,
  "relativeDemand": enum (RelativeDemandEnum),
  "previousRelativeDemand": enum (RelativeDemandEnum),
  "relativeDemandChange": enum (RelativeDemandChangeTypeEnum)
}
Trường
reportDate

object (Date)

Ngày báo cáo. Giá trị của trường này chỉ có thể là một trong những giá trị sau:

  • Ngày đầu tiên trong tuần (thứ Hai) để báo cáo hàng tuần,
  • Ngày đầu tiên của tháng đối với báo cáo hằng tháng.

Bắt buộc trong mệnh đề SELECT. Nếu bạn không chỉ định điều kiện WHERE trong reportDate trong truy vấn, thì báo cáo hằng tuần hoặc hằng tháng mới nhất sẽ được trả về.
reportGranularity

enum (ReportGranularityEnum)

Mức độ chi tiết của báo cáo. Quá trình xếp hạng có thể diễn ra trong khung thời gian một tuần hoặc một tháng.

Bắt buộc trong mệnh đề SELECT. Điều kiện trên reportGranularity là bắt buộc trong mệnh đề WHERE.
reportCountryCode

string

Quốc gia nơi thứ hạng được tính. Được trình bày ở định dạng ISO 3166.

Bắt buộc trong mệnh đề SELECT. Điều kiện trên reportCountryCode là bắt buộc trong mệnh đề WHERE.
reportCategoryId

string (int64 format)

Mã danh mục sản phẩm của Google để tính thứ hạng, được trình bày trong hệ thống phân loại sản phẩm của Google.

Bắt buộc trong mệnh đề SELECT. Nếu điều kiện WHERE trên reportCategoryId không được chỉ định trong truy vấn, xếp hạng cho tất cả danh mục cấp cao nhất sẽ được trả về.
brand

string

Tên của thương hiệu.
rank

string (int64 format)

Mức độ phổ biến của thương hiệu trên quảng cáo và các nền tảng không tính phí, trong danh mục và quốc gia đã chọn, dựa trên số lượng đơn vị sản phẩm ước tính đã bán.
previousRank

string (int64 format)

Thứ hạng mức độ phổ biến trong tuần hoặc tháng trước.
relativeDemand

enum (RelativeDemandEnum)

Nhu cầu ước tính so với thương hiệu có thứ hạng mức độ phổ biến cao nhất trong cùng danh mục và quốc gia.
previousRelativeDemand

enum (RelativeDemandEnum)

Nhu cầu ước tính so với thương hiệu có thứ hạng mức độ phổ biến cao nhất trong cùng danh mục và quốc gia vào tuần trước hoặc tháng trước.
relativeDemandChange

enum (RelativeDemandChangeTypeEnum)

Thay đổi về nhu cầu ước tính. Dù nó tăng lên, chìm hay đứng yên.

CompetitiveVisibilityCompetitorView

Các trường có sẵn cho truy vấn trong bảng competitiveVisibilityCompetitorView.

Báo cáo Mức độ hiển thị cạnh tranh với các doanh nghiệp có mức độ hiển thị tương tự.

Giá trị chỉ được đặt cho các trường được yêu cầu rõ ràng trong truy vấn tìm kiếm của yêu cầu.

Biểu diễn dưới dạng JSON 
{
  "date": {
    object (Date)
  },
  "domain": string,
  "isYourDomain": boolean,
  "reportCountryCode": string,
  "reportCategoryId": string,
  "trafficSource": enum (TrafficSourceEnum),
  "rank": string,
  "adsOrganicRatio": number,
  "pageOverlapRate": number,
  "higherPositionRate": number,
  "relativeVisibility": number
}
Trường
date

object (Date)

Ngày của hàng này.

Cần có một điều kiện trên date trong mệnh đề WHERE.
domain

string

Miền của đối thủ cạnh tranh hoặc miền của bạn, nếu "isYourDomains" là đúng.

Bắt buộc trong mệnh đề SELECT. Không thể được lọc trong mệnh đề 'WHERE'.
isYourDomain

boolean

Đúng nếu hàng này chứa dữ liệu cho miền của bạn.

Không thể được lọc trong mệnh đề 'WHERE'.
reportCountryCode

string

Quốc gia nơi số lượt hiển thị xuất hiện.

Bắt buộc trong mệnh đề SELECT. Cần có một điều kiện trên reportCountryCode trong mệnh đề WHERE.
reportCategoryId

string (int64 format)

Mã danh mục sản phẩm của Google để tính toán báo cáo, được thể hiện trong dữ liệu phân loại sản phẩm của Google.

Bắt buộc trong mệnh đề SELECT. Cần có một điều kiện trên reportCategoryId trong mệnh đề WHERE.
trafficSource

enum (TrafficSourceEnum)

Nguồn lưu lượng truy cập của lượt hiển thị.

Bắt buộc trong mệnh đề SELECT.
rank

string (int64 format)

Vị trí của miền trong bảng xếp hạng các doanh nghiệp tương tự cho các khoá đã chọn (date, reportCategoryId, reportCountryCode, trafficSource) dựa trên số lượt hiển thị. 1 là cao nhất.

Không thể được lọc trong mệnh đề 'WHERE'.
adsOrganicRatio

number

Tỷ lệ quảng cáo / tự nhiên cho biết tần suất miền nhận được lượt hiển thị từ quảng cáo Mua sắm so với lưu lượng tự nhiên. Số được làm tròn và phân giỏ.

Không thể được lọc trong mệnh đề 'WHERE'.
pageOverlapRate

number

Tỷ lệ trùng lặp trang cho biết tần suất các mặt hàng của các nhà bán lẻ cạnh tranh xuất hiện cùng với các mặt hàng của bạn trên cùng một trang.

Không thể được lọc trong mệnh đề 'WHERE'.
higherPositionRate

number

Tỷ lệ hiển thị ở vị trí cao hơn cho biết tần suất mặt hàng của đối thủ cạnh tranh được đặt ở vị trí cao hơn trên trang so với mặt hàng của bạn.

Không thể được lọc trong mệnh đề 'WHERE'.
relativeVisibility

number

Khả năng hiển thị tương đối cho biết tần suất các mặt hàng của đối thủ cạnh tranh của bạn xuất hiện so với các mặt hàng của bạn. Nói cách khác, đây là số lượt hiển thị đã diễn ra của một nhà bán lẻ đối thủ cạnh tranh chia cho số lượt hiển thị đã diễn ra trong một khoảng thời gian đã chọn cho một danh mục sản phẩm và quốc gia đã chọn.

Không thể được lọc trong mệnh đề 'WHERE'.

TrafficSourceEnum

Giá trị nguồn lưu lượng truy cập.

Enum
TRAFFIC_SOURCE_ENUM_UNSPECIFIED Chưa chỉ định.
ORGANIC Lưu lượng tự nhiên.
ADS Lưu lượng truy cập từ quảng cáo.
ALL Lưu lượng tự nhiên và lưu lượng truy cập từ quảng cáo.

CompetitiveVisibilityTopMerchantView

Các trường có sẵn cho truy vấn trong bảng competitiveVisibilityTopMerchantView.

Báo cáo Khả năng hiển thị so với đối thủ cạnh tranh có doanh nghiệp có mức độ hiển thị cao nhất.

Giá trị chỉ được đặt cho các trường được yêu cầu rõ ràng trong truy vấn tìm kiếm của yêu cầu.

Biểu diễn dưới dạng JSON 
{
  "date": {
    object (Date)
  },
  "domain": string,
  "isYourDomain": boolean,
  "reportCountryCode": string,
  "reportCategoryId": string,
  "trafficSource": enum (TrafficSourceEnum),
  "rank": string,
  "adsOrganicRatio": number,
  "pageOverlapRate": number,
  "higherPositionRate": number
}
Trường
date

object (Date)

Ngày của hàng này.

Không thể chọn được trong mệnh đề SELECT. Cần có một điều kiện trên date trong mệnh đề WHERE.
domain

string

Miền của đối thủ cạnh tranh hoặc miền của bạn, nếu "isYourDomains" là đúng.

Bắt buộc trong mệnh đề SELECT. Không thể được lọc trong mệnh đề 'WHERE'.
isYourDomain

boolean

Đúng nếu hàng này chứa dữ liệu cho miền của bạn.

Không thể được lọc trong mệnh đề 'WHERE'.
reportCountryCode

string

Quốc gia nơi số lượt hiển thị xuất hiện.

Bắt buộc trong mệnh đề SELECT. Cần có một điều kiện trên reportCountryCode trong mệnh đề WHERE.
reportCategoryId

string (int64 format)

Mã danh mục sản phẩm của Google để tính toán báo cáo, được thể hiện trong dữ liệu phân loại sản phẩm của Google.

Bắt buộc trong mệnh đề SELECT. Cần có một điều kiện trên reportCategoryId trong mệnh đề WHERE.
trafficSource

enum (TrafficSourceEnum)

Nguồn lưu lượng truy cập của lượt hiển thị.

Bắt buộc trong mệnh đề SELECT.
rank

string (int64 format)

Vị trí của miền trong bảng xếp hạng những người bán hàng đầu cho các khoá đã chọn (date, reportCategoryId, reportCountryCode, trafficSource) dựa trên số lượt hiển thị. 1 là cao nhất.

Không thể được lọc trong mệnh đề 'WHERE'.
adsOrganicRatio

number

Tỷ lệ quảng cáo / tự nhiên cho biết tần suất miền nhận được lượt hiển thị từ quảng cáo Mua sắm so với lưu lượng tự nhiên. Số được làm tròn và phân giỏ.

Không thể được lọc trong mệnh đề 'WHERE'.
pageOverlapRate

number

Tỷ lệ trùng lặp trang cho biết tần suất các mặt hàng của các nhà bán lẻ cạnh tranh xuất hiện cùng với các mặt hàng của bạn trên cùng một trang.

Không thể được lọc trong mệnh đề 'WHERE'.
higherPositionRate

number

Tỷ lệ hiển thị ở vị trí cao hơn cho biết tần suất mặt hàng của đối thủ cạnh tranh được đặt ở vị trí cao hơn trên trang so với mặt hàng của bạn.

Không thể được lọc trong mệnh đề 'WHERE'.

CompetitiveVisibilityBenchmarkView

Các trường có sẵn cho truy vấn trong bảng competitiveVisibilityBenchmarkView.

Báo cáo Khả năng hiển thị so với đối thủ cạnh tranh có điểm chuẩn của danh mục.

Giá trị chỉ được đặt cho các trường được yêu cầu rõ ràng trong truy vấn tìm kiếm của yêu cầu.

Biểu diễn dưới dạng JSON 
{
  "date": {
    object (Date)
  },
  "reportCountryCode": string,
  "reportCategoryId": string,
  "trafficSource": enum (TrafficSourceEnum),
  "yourDomainVisibilityTrend": number,
  "categoryBenchmarkVisibilityTrend": number
}
Trường
date

object (Date)

Ngày của hàng này.

Bắt buộc trong mệnh đề SELECT. Cần có một điều kiện trên date trong mệnh đề WHERE.
reportCountryCode

string

Quốc gia nơi số lượt hiển thị xuất hiện.

Bắt buộc trong mệnh đề SELECT. Cần có một điều kiện trên reportCountryCode trong mệnh đề WHERE.
reportCategoryId

string (int64 format)

Mã danh mục sản phẩm của Google để tính toán báo cáo, được thể hiện trong dữ liệu phân loại sản phẩm của Google.

Bắt buộc trong mệnh đề SELECT. Cần có một điều kiện trên reportCategoryId trong mệnh đề WHERE.
trafficSource

enum (TrafficSourceEnum)

Nguồn lưu lượng truy cập của lượt hiển thị.

Bắt buộc trong mệnh đề SELECT.
yourDomainVisibilityTrend

number

Thay đổi về khả năng hiển thị dựa trên số lượt hiển thị cho miền của bạn tương ứng với thời điểm bắt đầu trong phạm vi thời gian đã chọn (hoặc ngày đầu tiên có số lượt hiển thị khác 0).

Không thể được lọc trong mệnh đề 'WHERE'.
categoryBenchmarkVisibilityTrend

number

Thay đổi về khả năng hiển thị dựa trên số lượt hiển thị đối với thời điểm bắt đầu trong phạm vi thời gian đã chọn (hoặc ngày đầu tiên với số lượt hiển thị khác 0) đối với một nhóm người bán kết hợp có khả năng hiển thị cao nhất gần đúng thị trường.

Không thể được lọc trong mệnh đề 'WHERE'.