Package google.shopping.merchant.reports.v1beta

Chỉ mục

ReportService

Dịch vụ truy xuất báo cáo và thông tin chi tiết về sản phẩm, hiệu suất và môi trường cạnh tranh của sản phẩm trên Google.

Tìm kiếm

rpc Search(SearchRequest) returns (SearchResponse)

Truy xuất báo cáo được xác định bằng một cụm từ tìm kiếm. Phản hồi có thể chứa ít hàng hơn so với số lượng hàng do page_size chỉ định. Hãy dựa vào next_page_token để xác định xem có thêm hàng nào cần yêu cầu hay khô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 OAuth 2.0 Overview.

BestSellersBrandView

Các trường có thể truy vấn trong bảng best_sellers_brand_view.

Báo cáo Sản phẩm bán chạy nhất với 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 cụm từ tìm kiếm của yêu cầu.

Trường
report_date

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) đối với 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 trên report_date trong truy vấn, thì báo cáo hằng tuần hoặc hằng tháng mới nhất có sẵn sẽ được trả về.
report_granularity

ReportGranularityEnum

Mức độ chi tiết của báo cáo. Bạn có thể xếp hạng trong khoảng 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 report_granularity là bắt buộc trong mệnh đề WHERE.
report_country_code

string

Quốc gia nơi thứ hạng được tính toán. Được biểu thị ở định dạng ISO 3166.

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

int64

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

Bắt buộc trong mệnh đề SELECT. Nếu bạn không chỉ định điều kiện WHERE trên report_category_id trong truy vấn, thì hệ thống sẽ trả về thứ hạng của tất cả danh mục cấp cao nhất.
brand

string

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

int64

Mức độ phổ biến của thương hiệu trên quảng cáo và các nền tảng tự nhiên, 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.
previous_rank

int64

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

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.
previous_relative_demand

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 trong tuần hoặc tháng trước.
relative_demand_change

RelativeDemandChangeTypeEnum

Thay đổi về nhu cầu ước tính. Liệu giá trị đó có tăng, giảm hay giữ nguyên.

BestSellersProductClusterView

Các trường có thể truy vấn trong bảng best_sellers_product_cluster_view.

Báo cáo Sản phẩm 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 các mặt hàng và biến thể đại diện cho cùng một sản phẩm, ví dụ: Google Pixel 7.

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

Trường
report_date

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) đối với 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 trên report_date trong truy vấn, thì báo cáo hằng tuần hoặc hằng tháng mới nhất có sẵn sẽ được trả về.
variant_gtins[]

string

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

ReportGranularityEnum

Mức độ chi tiết của báo cáo. Bạn có thể xếp hạng trong khoảng 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 report_granularity là bắt buộc trong mệnh đề WHERE.
report_country_code

string

Quốc gia nơi thứ hạng được tính toán. Được biểu thị ở định dạng ISO 3166.

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

int64

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

Bắt buộc trong mệnh đề SELECT. Nếu bạn không chỉ định điều kiện WHERE trên report_category_id trong truy vấn, thì hệ thống sẽ trả về thứ hạng của tất cả danh mục cấp cao nhất.
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.
category_l1

string

Danh mục sản phẩm (cấp 1) của cụm sản phẩm, được thể hiện trong cây phân loại sản phẩm của Google.
category_l2

string

Danh mục sản phẩm (cấp 2) của cụm sản phẩm, được thể hiện trong cây phân loại sản phẩm của Google.
category_l3

string

Danh mục sản phẩm (cấp 3) của cụm sản phẩm, được thể hiện trong cây phân loại sản phẩm của Google.
category_l4

string

Danh mục sản phẩm (cấp 4) của cụm sản phẩm, được thể hiện trong cây phân loại sản phẩm của Google.
category_l5

string

Danh mục sản phẩm (cấp 5) của cụm sản phẩm, được thể hiện trong cây phân loại sản phẩm của Google.
inventory_status

InventoryStatus

Liệu cụm sản phẩm có phải là IN_STOCK trong nguồn dữ liệu sản phẩm ở ít nhất một 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 NOT_IN_INVENTORY hay không.

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

InventoryStatus

Liệu 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 của bạn ở ít nhất một trong các quốc gia, tất cả sản phẩm đều OUT_OF_STOCK trong nguồn dữ liệu sản phẩm của bạn ở tất cả các quốc gia hay NOT_IN_INVENTORY.

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

int64

Mức độ phổ biến của cụm sản phẩm trên quảng cáo và các nền tảng tự nhiên, 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.
previous_rank

int64

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

RelativeDemandEnum

Nhu cầu ước tính so với 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.
previous_relative_demand

RelativeDemandEnum

Nhu cầu ước tính so với 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 trong tuần hoặc tháng trước.
relative_demand_change

RelativeDemandChangeTypeEnum

Thay đổi về nhu cầu ước tính. Liệu giá trị đó có tăng, giảm hay giữ nguyên.

InventoryStatus

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

Enum
INVENTORY_STATUS_UNSPECIFIED Chưa chỉ định.
IN_STOCK Bạn có sản phẩm trong kho cho cụm sản phẩm hoặc thương hiệu này.
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 đó 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.

CompetitiveVisibilityBenchmarkView

Các trường có thể truy vấn trong bảng competitive_visibility_benchmark_view.

Báo cáo Mức độ 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 cụm từ tìm kiếm của yêu cầu.

Trường
date

Date

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

Bắt buộc trong mệnh đề SELECT. Bạn phải có một điều kiện trên date trong mệnh đề WHERE.
report_country_code

string

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

Bắt buộc trong mệnh đề SELECT. Bạn phải có một điều kiện trên report_country_code trong mệnh đề WHERE.
report_category_id

int64

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

Bắt buộc trong mệnh đề SELECT. Bạn phải có một điều kiện trên report_category_id trong mệnh đề WHERE.
traffic_source

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.
your_domain_visibility_trend

double

Mức thay đổi về mức độ hiển thị dựa trên số lượt hiển thị cho miền của bạn so với thời điểm bắt đầu của 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 theo trong mệnh đề "WHERE".
category_benchmark_visibility_trend

double

Mức thay đổi về khả năng hiển thị dựa trên số lượt hiển thị so với thời điểm bắt đầu 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) đố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 với thị trường.

Không thể lọc theo trong mệnh đề "WHERE".

CompetitiveVisibilityCompetitorView

Các trường có thể truy vấn trong bảng competitive_visibility_competitor_view.

Báo cáo Khả năng hiển thị so với đối 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 cụm từ tìm kiếm của yêu cầu.

Trường
date

Date

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

Bạn phải 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 "is_your_domain" là đúng.

Bắt buộc trong mệnh đề SELECT. Không thể lọc theo trong mệnh đề "WHERE".
is_your_domain

bool

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

Không thể lọc theo trong mệnh đề "WHERE".
report_country_code

string

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

Bắt buộc trong mệnh đề SELECT. Bạn phải có một điều kiện trên report_country_code trong mệnh đề WHERE.
report_category_id

int64

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

Bắt buộc trong mệnh đề SELECT. Bạn phải có một điều kiện trên report_category_id trong mệnh đề WHERE.
traffic_source

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

int64

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

Không thể lọc theo trong mệnh đề "WHERE".
ads_organic_ratio

double

Tỷ lệ quảng cáo / lưu lượng truy cập 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 truy cập tự nhiên. Số này được làm tròn và gộp vào một nhóm.

Không thể lọc theo trong mệnh đề "WHERE".
page_overlap_rate

double

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

Không thể lọc theo trong mệnh đề "WHERE".
higher_position_rate

double

Tỷ lệ xuất hiện ở 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 theo trong mệnh đề "WHERE".
relative_visibility

double

Mức độ hiển thị tương đối cho biết tần suất hiển thị của các mặt hàng của đối thủ cạnh tranh 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ẻ cạnh tranh chia cho số lượt hiển thị đã diễn ra của bạn trong một phạm vi thời gian đã chọn theo một danh mục sản phẩm và quốc gia đã chọn.

Không thể lọc theo trong mệnh đề "WHERE".

CompetitiveVisibilityTopMerchantView

Các trường có thể truy vấn trong bảng competitive_visibility_top_merchant_view.

Báo cáo Khả năng hiển thị so với đối thủ cạnh tranh với 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 cụm từ tìm kiếm của yêu cầu.

Trường
date

Date

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

Không thể chọn trong mệnh đề SELECT. Bạn phải 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 "is_your_domain" là đúng.

Bắt buộc trong mệnh đề SELECT. Không thể lọc theo trong mệnh đề "WHERE".
is_your_domain

bool

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

Không thể lọc theo trong mệnh đề "WHERE".
report_country_code

string

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

Bắt buộc trong mệnh đề SELECT. Bạn phải có một điều kiện trên report_country_code trong mệnh đề WHERE.
report_category_id

int64

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

Bắt buộc trong mệnh đề SELECT. Bạn phải có một điều kiện trên report_category_id trong mệnh đề WHERE.
traffic_source

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

int64

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

Không thể lọc theo trong mệnh đề "WHERE".
ads_organic_ratio

double

Tỷ lệ quảng cáo / lưu lượng truy cập 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 truy cập tự nhiên. Số này được làm tròn và phân thành nhóm.

Không thể lọc theo trong mệnh đề "WHERE".
page_overlap_rate

double

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

Không thể lọc theo trong mệnh đề "WHERE".
higher_position_rate

double

Tỷ lệ xuất hiện ở 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 theo trong mệnh đề "WHERE".

MarketingMethod

Loại này không có trường nào.

Phương thức tiếp thị dùng để quảng bá sản phẩm của bạn trên Google (tự nhiên so với quảng cáo).

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ó thể truy vấn trong bảng non_product_performance_view.

Dữ liệu hiệu suất về 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. Báo cáo này bao gồm các chỉ số về hiệu suất (ví dụ: clicks) và các phương diện theo đó các chỉ số về 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 khúc trong truy vấn mà không chọn í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 cụm từ tìm kiếm của yêu cầu.

Trường
date

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

Date

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

int64

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 phải là trang sản phẩm. Chỉ số.
impressions

int64

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 phải trang sản phẩm của bạn xuất hiện. Chỉ số.
click_through_rate

double

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ố.

PriceCompetitivenessProductView

Các trường có thể truy vấn trong bảng price_competitiveness_product_view.

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 cụm từ tìm kiếm của yêu cầu.

Trường
price

Price

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

Price

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

string

Quốc gia của mức giá chuẩn. Được biểu thị ở định dạng ISO 3166.

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

string

Mã nhận dạng 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 product_view.

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

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.
category_l1

string

Danh mục sản phẩm (cấp 1) trong cây phân loại sản phẩm của Google.
category_l2

string

Danh mục sản phẩm (cấp 2) trong cây phân loại sản phẩm của Google.
category_l3

string

Danh mục sản phẩm (cấp 3) trong cây phân loại sản phẩm của Google.
category_l4

string

Danh mục sản phẩm (cấp 4) trong cây phân loại sản phẩm của Google.
category_l5

string

Danh mục sản phẩm (cấp 5) trong cây phân loại sản phẩm của Google.
product_type_l1

string

Loại sản phẩm (cấp 1) trong cây phân loại sản phẩm của người bán.
product_type_l2

string

Loại sản phẩm (cấp 2) trong cấu trúc phân loại sản phẩm của người bán.
product_type_l3

string

Loại sản phẩm (cấp 3) trong cấu trúc phân loại sản phẩm của người bán.
product_type_l4

string

Loại sản phẩm (cấp 4) trong cấu trúc phân loại sản phẩm của người bán.
product_type_l5

string

Loại sản phẩm (cấp 5) trong cấu trúc phân loại sản phẩm của người bán.

PriceInsightsProductView

Các trường có thể truy vấn trong bảng price_insights_product_view.

Báo cáo 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 cụm từ tìm kiếm của yêu cầu.

Trường
price

Price

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

Price

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

Effectiveness

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

string

Mã nhận dạng 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 product_view.

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

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.
category_l1

string

Danh mục sản phẩm (cấp 1) trong cây phân loại sản phẩm của Google.
category_l2

string

Danh mục sản phẩm (cấp 2) trong cây phân loại sản phẩm của Google.
category_l3

string

Danh mục sản phẩm (cấp 3) trong cây phân loại sản phẩm của Google.
category_l4

string

Danh mục sản phẩm (cấp 4) trong cây phân loại sản phẩm của Google.
category_l5

string

Danh mục sản phẩm (cấp 5) trong cây phân loại sản phẩm của Google.
product_type_l1

string

Loại sản phẩm (cấp 1) trong cây phân loại sản phẩm của người bán.
product_type_l2

string

Loại sản phẩm (cấp 2) trong cấu trúc phân loại sản phẩm của người bán.
product_type_l3

string

Loại sản phẩm (cấp 3) trong cấu trúc phân loại sản phẩm của người bán.
product_type_l4

string

Loại sản phẩm (cấp 4) trong cấu trúc phân loại sản phẩm của người bán.
product_type_l5

string

Loại sản phẩm (cấp 5) trong cấu trúc phân loại sản phẩm của người bán.
predicted_impressions_change_fraction

double

Mức thay đổi dự kiến về số lượt hiển thị dưới dạng phân số sau khi áp dụng giá đề xuất so với giá hiện tại đang hoạt động. Ví dụ: 0, 05 là mức tăng dự kiến là 5% về số lượt hiển thị.
predicted_clicks_change_fraction

double

Mức thay đổi dự kiến về số lượt nhấp dưới dạng phân số sau khi áp dụng giá đề xuất so với giá hiện tại đang hoạt động. Ví dụ: 0, 05 là mức tăng 5% được dự đoán của số lượt nhấp.
predicted_conversions_change_fraction

double

Mức thay đổi dự kiến về số lượt chuyển đổi dưới dạng phân số sau khi áp dụng giá đề xuất so với giá hiện tại đang hoạt động. Ví dụ: 0, 05 là mức tăng dự kiến là 5% về số lượt chuyển đổi).

Hiệu quả

Nhóm hiệu quả 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ả HIGH được dự đoán sẽ giúp hiệu suất gia tăng nhiều nhất.

Enum
EFFECTIVENESS_UNSPECIFIED Không xác định được hiệu quả.
LOW Mức độ hiệu quả thấp.
MEDIUM Mức độ hiệu quả là trung bình.
HIGH Có hiệu quả cao.

ProductPerformanceView

Các trường có thể truy vấn trong bảng product_performance_view.

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 chỉ số hiệu suất (ví dụ: clicks) và phương diện theo đó các chỉ số hiệu suất được phân đoạn (ví dụ: offer_id). Giá trị của các phương diện sản phẩm, chẳng hạn như offer_id, phản ánh trạng thái của một 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 khúc trong truy vấn mà không chọn í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 cụm từ tìm kiếm của yêu cầu.

Trường
date

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

Date

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

Price

Giá trị của các 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.
marketing_method

MarketingMethodEnum

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

string

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

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

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.
category_l1

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. Phân đoạn.
category_l2

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.
category_l3

string

Danh mục sản phẩm (cấp 3) trong cây phân loại sản phẩm của Google. Phân đoạn.
category_l4

string

Danh mục sản phẩm (cấp 4) trong cây phân loại sản phẩm của Google. Phân đoạn.
category_l5

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.
product_type_l1

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

int64

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

int64

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

double

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ần sản phẩm xuất hiện (số lượt hiển thị). Chỉ số.
conversions

double

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ổ cho nhiều lượt nhấp, trong đó mỗi lượt nhấp đượ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.
conversion_rate

double

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.

ProductView

Các trường có thể truy vấn trong bảng product_view.

Các sản phẩm trong kho hàng hiện tại. Các sản phẩm trong bảng này giống với các sản phẩm 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ó thể 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 theo id hoặc liệt kê tất cả sản phẩm, bạn nên sử dụng API phụ Sản phẩm.

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

Trường
price

Price

Giá sản phẩm. Không có 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.
creation_time

Timestamp

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

Date

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

ItemIssue

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

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

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

ClickPotential

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

string

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

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

ChannelEnum

Kênh của sản phẩm. Có thể là ONLINE hoặc LOCAL.
language_code

string

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

string

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

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.
category_l1

string

Danh mục sản phẩm (cấp 1) trong cây phân loại sản phẩm của Google.
category_l2

string

Danh mục sản phẩm (cấp 2) trong cây phân loại sản phẩm của Google.
category_l3

string

Danh mục sản phẩm (cấp 3) trong cây phân loại sản phẩm của Google.
category_l4

string

Danh mục sản phẩm (cấp 4) trong cây phân loại sản phẩm của Google.
category_l5

string

Danh mục sản phẩm (cấp 5) trong cây phân loại sản phẩm của Google.
product_type_l1

string

Loại sản phẩm (cấp 1) trong cây phân loại sản phẩm của người bán.
product_type_l2

string

Loại sản phẩm (cấp 2) trong cấu trúc phân loại sản phẩm của người bán.
product_type_l3

string

Loại sản phẩm (cấp 3) trong cấu trúc phân loại sản phẩm của người bán.
product_type_l4

string

Loại sản phẩm (cấp 4) trong cấu trúc phân loại sản phẩm của người bán.
product_type_l5

string

Loại sản phẩm (cấp 5) trong cấu trúc phân loại sản phẩm của 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.
shipping_label

string

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

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.
aggregated_reporting_context_status

AggregatedReportingContextStatus

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

int64

Thứ hạng của sản phẩm dựa trên tiềm năng nhận được lượt nhấp. Sản phẩm có click_potential_rank là 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ả ngữ 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 cho tất cả ngữ 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 đủ điều kiện cho tất cả ngữ cảnh báo cáo.

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 những 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 cần được khắc phục và giúp họ nắm được hiệu suất của sản phẩm so với tiềm năng.

Enum
CLICK_POTENTIAL_UNSPECIFIED Không xác định được mức tác động của lượt nhấp dự đoán.
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 trung bình 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.

ItemIssue

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

Trường
type

ItemIssueType

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

ItemIssueSeverity

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

ItemIssueResolution

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

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 giải quyết tự động (ví dụ: thu thập dữ liệu hình ảnh) hoặc thông qua quy trình xem xét của Google. Hiện tại, người bán không cần làm gì cả. Việc giải quyết vấn đề này có thể dẫn đến một vấn đề khác (ví dụ: nếu không thu thập dữ liệu được).

ItemIssueSeverity

Mức độ ảnh hưởng của vấn đề đến việc phân phát sản phẩm.

Trường
severity_per_reporting_context[]

IssueSeverityPerReportingContext

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

AggregatedIssueSeverity

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

Bạn có thể sử dụng trường này để lọc kết quả.

AggregatedIssueSeverity

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

Enum
AGGREGATED_ISSUE_SEVERITY_UNSPECIFIED Chưa chỉ định.
DISAPPROVED Vấn đề khiến sản phẩm bị từ chối trong ít nhất một ngữ cảnh báo cáo.
DEMOTED Vấn đề sẽ hạ cấp sản phẩm trong tất cả ngữ cảnh báo cáo mà vấn đề đó ảnh hưởng đến.
PENDING Giải pháp cho vấn đề là PENDING_PROCESSING.

IssueSeverityPerReportingContext

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

Trường
disapproved_countries[]

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 ở định dạng ISO 3166.
demoted_countries[]

string

Danh sách các quốc gia bị hạ cấp trong ngữ cảnh báo cáo, được trình bày ở định dạng ISO 3166.
reporting_context

ReportingContextEnum

Bối cảnh báo cáo mà vấn đề áp dụng.

ItemIssueType

Loại vấn đề.

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.
canonical_attribute

string

Tên thuộc tính chuẩn hoá cho các vấn đề liên quan đến thuộc tính.

RelativeDemand

Loại này không có trường nào.

Nhu cầu tương đối của một cụm sản phẩm hoặc thương hiệu trong báo cáo Sản phẩm bán chạy nhất.

RelativeDemandEnum

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

Enum
RELATIVE_DEMAND_ENUM_UNSPECIFIED Chưa chỉ định.
VERY_LOW Nhu cầu từ 0 đến 5% so với nhu cầu của cụm sản phẩm hoặc thương hiệu được xếp hạng cao nhất.
LOW Nhu cầu đạt 6-10% so với nhu cầu của cụm sản phẩm hoặc thương hiệu được xếp hạng cao nhất.
MEDIUM Nhu cầu đạt 11–20% so với nhu cầu của cụm sản phẩm hoặc thương hiệu được xếp hạng cao nhất.
HIGH Nhu cầu đạt 21–50% so với nhu cầu của 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 của cụm sản phẩm hoặc thương hiệu được xếp hạng cao nhất.

RelativeDemandChangeType

Loại này không có trường nào.

Nhu cầu tương đối của một cụm sản phẩm hoặc thương hiệu trong báo cáo Sản phẩm và thương hiệu bán chạy nhất so với khoảng thời gian trước đó.

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 so với khoảng thời gian trước.

ReportGranularity

Loại này không có trường nào.

Mức độ chi tiết của báo cáo Sản phẩm và thương hiệu bán chạy nhất. Báo cáo sản phẩm và thương hiệu bán chạy nhất được tính toán trong khung thời gian một tuần và một tháng.

ReportGranularityEnum

Báo cáo giá trị theo mức độ chi tiết.

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.

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 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.

Trường
product_performance_view

ProductPerformanceView

Các trường có thể truy vấn trong bảng product_performance_view.
non_product_performance_view

NonProductPerformanceView

Các trường có thể truy vấn trong bảng non_product_performance_view.
product_view

ProductView

Các trường có thể truy vấn trong bảng product_view.
price_competitiveness_product_view

PriceCompetitivenessProductView

Các trường có thể truy vấn trong bảng price_competitiveness_product_view.
price_insights_product_view

PriceInsightsProductView

Các trường có thể truy vấn trong bảng price_insights_product_view.
best_sellers_product_cluster_view

BestSellersProductClusterView

Các trường có thể truy vấn trong bảng best_sellers_product_cluster_view.
best_sellers_brand_view

BestSellersBrandView

Các trường có thể truy vấn trong bảng best_sellers_brand_view.
competitive_visibility_competitor_view

CompetitiveVisibilityCompetitorView

Các trường có thể truy vấn trong bảng competitive_visibility_competitor_view.
competitive_visibility_top_merchant_view

CompetitiveVisibilityTopMerchantView

Các trường có thể truy vấn trong bảng competitive_visibility_top_merchant_view.
competitive_visibility_benchmark_view

CompetitiveVisibilityBenchmarkView

Các trường có thể truy vấn trong bảng competitive_visibility_benchmark_view.

SearchRequest

Thông báo yêu cầu cho phương thức ReportService.Search.

Trường
parent

string

Bắt buộc. Mã của tài khoản thực hiện lệnh gọi. Phải là tài khoản độc lập hoặc tài khoản phụ trong MCA. Định dạng: accounts/{account}
query

string

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

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

int32

Không bắt buộc. Số ReportRows cần truy xuất trong một trang. Giá trị mặc định là 1000. Các giá trị trên 5000 sẽ được ép thành 5000.
page_token

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, hệ thống sẽ trả về trang kết quả đầu tiên. Để yêu cầu trang kết quả tiếp theo, bạn nên sử dụng giá trị thu được từ next_page_token trong phản hồi trước đó.

SearchResponse

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

Trường
results[]

ReportRow

Các hàng khớp với cụm từ tìm kiếm.
next_page_token

string

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

TrafficSource

Loại này không có trường nào.

Nguồn lưu lượng truy cập của lượt hiển thị trong báo cáo Khả năng hiển thị so với đối thủ cạnh tranh.

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 truy cập tự nhiên.
ADS Lưu lượng truy cập từ quảng cáo.
ALL Lưu lượng truy cập tự nhiên và lưu lượng truy cập từ quảng cáo.