- Yêu cầu HTTP
- Tham số đường dẫn
- Nội dung yêu cầu
- Nội dung phản hồi
- Phạm vi uỷ quyền
- ReportRow
- ProductPerformanceView
- MarketingMethodEnum
- NonProductPerformanceView
- ProductView
- AggregatedReportingContextStatus
- ItemIssue
- ItemIssueType
- ItemIssueSeverity
- IssueSeverityPerReportingContext
- AggregatedIssueSeverity
- ItemIssueResolution
- ClickPotential
- PriceCompetitivenessProductView
- PriceInsightsProductView
- Hiệu quả
- BestSellersProductClusterView
- ReportGranularityEnum
- InventoryStatus
- RelativeDemandEnum
- RelativeDemandChangeTypeEnum
- BestSellersBrandView
- CompetitiveVisibilityCompetitorView
- TrafficSourceEnum
- CompetitiveVisibilityTopMerchantView
- CompetitiveVisibilityBenchmarkView
- Hãy làm thử!
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 |
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 |
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 |
Không bắt buộc. Số |
pageToken |
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ị thu được từ |
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 ( |
Trường | |
---|---|
results[] |
Các hàng phù hợp với cụm từ tìm kiếm. |
nextPageToken |
Mã thông báo có thể được gửi dưới dạng |
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ừ truy vấn 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 ( |
Trường | |
---|---|
productPerformanceView |
Các trường có sẵn cho truy vấn trong bảng |
nonProductPerformanceView |
Các trường có sẵn cho truy vấn trong bảng |
productView |
Các trường có sẵn cho truy vấn trong bảng |
priceCompetitivenessProductView |
Các trường có sẵn cho truy vấn trong bảng |
priceInsightsProductView |
Các trường có sẵn cho truy vấn trong bảng |
bestSellersProductClusterView |
Các trường có sẵn cho truy vấn trong bảng |
bestSellersBrandView |
Các trường có sẵn cho truy vấn trong bảng |
competitiveVisibilityCompetitorView |
Các trường có sẵn cho truy vấn trong bảng |
competitiveVisibilityTopMerchantView |
Các trường có sẵn cho truy vấn trong bảng |
competitiveVisibilityBenchmarkView |
Các trường có sẵn cho truy vấn trong bảng |
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à những phương diện được phân đoạn theo chỉ số hiệu suất (ví dụ: offerId
). Giá trị của kích thước sản phẩm, chẳng hạn như offerId
, phản ánh 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 ( |
Trường | |
---|---|
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 |
week |
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 |
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 |
marketingMethod |
Phương pháp tiếp thị áp dụng các chỉ số. Phân đoạn. |
customerCountryCode |
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, thì 'ZZ' đặc biệt được trả về. |
offerId |
Mã sản phẩm do người bán cung cấp. Phân đoạn. |
title |
Tiêu đề của sản phẩm. Phân đoạn. |
brand |
Thương hiệu của sản phẩm. Phân đoạn. |
categoryL1 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
Nhãn tuỳ chỉnh 0 để nhóm sản phẩm tuỳ chỉnh. Phân đoạn. |
customLabel1 |
Nhãn tuỳ chỉnh 1 để nhóm sản phẩm tuỳ chỉnh. Phân đoạn. |
customLabel2 |
Nhãn tuỳ chỉnh 2 để nhóm sản phẩm tuỳ chỉnh. Phân đoạn. |
customLabel3 |
Nhãn tuỳ chỉnh 3 để nhóm sản phẩm tuỳ chỉnh. Phân đoạn. |
customLabel4 |
Nhãn tuỳ chỉnh 4 để nhóm sản phẩm tuỳ chỉnh. Phân đoạn. |
clicks |
Số lượt nhấp. Chỉ số. |
impressions |
Số lần sản phẩm của người bán xuất hiện. Chỉ số. |
clickThroughRate |
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 |
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 |
conversionRate |
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 |
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 ( |
Trường | |
---|---|
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 |
week |
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 |
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 |
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 |
Tỷ lệ nhấp – số lượt nhấp ( |
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 ( |
Trường | |
---|---|
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[] |
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 |
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 |
Ngày hết hạn của sản phẩm, được chỉ định khi chèn. |
itemIssues[] |
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ụ: |
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 |
Mã REST của sản phẩm, ở dạng Bắt buộc trong mệnh đề |
channel |
Kênh của sản phẩm. Giá trị này có thể là |
languageCode |
Mã ngôn ngữ của sản phẩm ở định dạng BCP 47. |
feedLabel |
Nhãn nguồn cấp dữ liệu của sản phẩm. |
offerId |
Mã sản phẩm do người bán cung cấp. |
title |
Tiêu đề của sản phẩm. |
brand |
Thương hiệu của sản phẩm. |
categoryL1 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
Tình trạng của sản phẩm. |
availability |
Tình trạng còn hàng của sản phẩm. |
shippingLabel |
Nhãn vận chuyển chuẩn hoá được chỉ định trong nguồn dữ liệu. |
itemGroupId |
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. |
thumbnailLink |
Đường liên kết đến hình ảnh đã xử lý của sản phẩm, được lưu trữ trên cơ sở hạ tầng của Google. |
aggregatedReportingContextStatus |
Trạng thái tổng hợp. |
clickPotentialRank |
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ó |
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Ờ XỬ LÝ |
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 ( |
Trường | |
---|---|
type |
Loại vấn đề về mặt hàng. |
severity |
Mức độ nghiêm trọng của vấn đề về mặt hàng. |
resolution |
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 |
Mã lỗi của vấn đề, tương đương với |
canonicalAttribute |
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 ( |
Trường | |
---|---|
severityPerReportingContext[] |
Mức độ nghiêm trọng của vấn đề theo ngữ cảnh báo cáo. |
aggregatedSeverity |
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 ( |
Trường | |
---|---|
disapprovedCountries[] |
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[] |
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 |
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 ( |
Trường | |
---|---|
price |
Giá hiện tại của sản phẩm. |
benchmarkPrice |
Giá chuẩn mới nhất hiện có cho danh mục sản phẩm tại quốc gia đo điểm chuẩn. |
reportCountryCode |
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 đề |
id |
Mã REST của sản phẩm, ở dạng Bắt buộc trong mệnh đề |
offerId |
Mã sản phẩm do người bán cung cấp. |
title |
Tiêu đề của sản phẩm. |
brand |
Thương hiệu của sản phẩm. |
categoryL1 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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
.
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 ( |
Trường | |
---|---|
price |
Giá hiện tại của sản phẩm. |
suggestedPrice |
Giá đề xuất mới nhất cho sản phẩm. |
effectiveness |
Hiệu quả dự đoán của việc áp dụng đề xuất về giá, được phân nhóm. |
id |
Mã REST của sản phẩm, ở dạng Bắt buộc trong mệnh đề |
offerId |
Mã sản phẩm do người bán cung cấp. |
title |
Tiêu đề của sản phẩm. |
brand |
Thương hiệu của sản phẩm. |
categoryL1 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 ( |
Trường | |
---|---|
reportDate |
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:
Bắt buộc trong mệnh đề |
variantGtins[] |
GTIN của các biến thể mẫu của cụm sản phẩm. |
reportGranularity |
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 đề |
reportCountryCode |
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 đề |
reportCategoryId |
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 đề |
title |
Tiêu đề của cụm sản phẩm. |
brand |
Thương hiệu của cụm sản phẩm. |
categoryL1 |
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 |
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 |
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 |
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 |
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 |
Liệu cụm sản phẩm có là 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 |
Cho dù có ít nhất một sản phẩm của thương hiệu hiện đang 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 |
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 |
Thứ hạng mức độ phổ biến trong tuần hoặc tháng trước. |
relativeDemand |
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 |
Nhu cầu ước tính liên quan đến cụ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 |
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 ( |
Trường | |
---|---|
reportDate |
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:
Bắt buộc trong mệnh đề |
reportGranularity |
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 đề |
reportCountryCode |
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 đề |
reportCategoryId |
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 đề |
brand |
Tên của thương hiệu. |
rank |
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 |
Thứ hạng mức độ phổ biến trong tuần hoặc tháng trước. |
relativeDemand |
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 |
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 |
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 ( |
Trường | |
---|---|
date |
Ngày của hàng này. Cần có một điều kiện trên |
domain |
Miền của đối thủ cạnh tranh hoặc miền của bạn, nếu là "isYourDomains" là đúng. Bắt buộc trong mệnh đề |
isYourDomain |
Đúng nếu hàng này chứa dữ liệu cho miền của bạn. Không thể lọc vào trong 'WHERE' mệnh đề. |
reportCountryCode |
Quốc gia nơi số lượt hiển thị xuất hiện. Bắt buộc trong mệnh đề |
reportCategoryId |
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 đề |
trafficSource |
Nguồn lưu lượng truy cập của lượt hiển thị. Bắt buộc trong mệnh đề |
rank |
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 ( Không thể lọc vào trong 'WHERE' mệnh đề. |
adsOrganicRatio |
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ể lọc vào trong 'WHERE' mệnh đề. |
pageOverlapRate |
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ể lọc vào trong 'WHERE' mệnh đề. |
higherPositionRate |
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ể lọc vào trong 'WHERE' mệnh đề. |
relativeVisibility |
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ể lọc vào trong 'WHERE' mệnh đề. |
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 ( |
Trường | |
---|---|
date |
Ngày của hàng này. Không thể chọn được trong mệnh đề |
domain |
Miền của đối thủ cạnh tranh hoặc miền của bạn, nếu là "isYourDomains" là đúng. Bắt buộc trong mệnh đề |
isYourDomain |
Đúng nếu hàng này chứa dữ liệu cho miền của bạn. Không thể lọc vào trong 'WHERE' mệnh đề. |
reportCountryCode |
Quốc gia nơi số lượt hiển thị xuất hiện. Bắt buộc trong mệnh đề |
reportCategoryId |
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 đề |
trafficSource |
Nguồn lưu lượng truy cập của lượt hiển thị. Bắt buộc trong mệnh đề |
rank |
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 ( Không thể lọc vào trong 'WHERE' mệnh đề. |
adsOrganicRatio |
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ể lọc vào trong 'WHERE' mệnh đề. |
pageOverlapRate |
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ể lọc vào trong 'WHERE' mệnh đề. |
higherPositionRate |
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ể lọc vào trong 'WHERE' mệnh đề. |
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 ( |
Trường | |
---|---|
date |
Ngày của hàng này. Bắt buộc trong mệnh đề |
reportCountryCode |
Quốc gia nơi số lượt hiển thị xuất hiện. Bắt buộc trong mệnh đề |
reportCategoryId |
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 đề |
trafficSource |
Nguồn lưu lượng truy cập của lượt hiển thị. Bắt buộc trong mệnh đề |
yourDomainVisibilityTrend |
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ể lọc vào trong 'WHERE' mệnh đề. |
categoryBenchmarkVisibilityTrend |
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ể lọc vào trong 'WHERE' mệnh đề. |