Package google.shopping.merchant.reports.v1beta

Chỉ mục

ReportService

Dịch vụ giúp 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 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 page_size. Dựa vào next_page_token để xác định xem có nhiều hàng khác 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 Tổng quan về OAuth 2.0.

BestSellersBrandView

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

Báo cáo Bán chạy nhất gồm 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) để báo cáo hằng tuần,
  • Ngày đầu tiên của tháng cho báo cáo hằng tháng.

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

ReportGranularityEnum

Mức độ chi tiết của báo cáo. Việc xếp hạng có thể được thực hiện trong một tuần hoặc một tháng.

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

string

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

Bắt buộc trong mệnh đề SELECT. Bắt buộc phải có đ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 toán 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 report_category_id không được chỉ định trong truy vấn, thì thứ hạng cho tất cả các danh mục cấp cao nhất sẽ được trả về.
brand

string

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

int64

Mức độ phổ biến của thương hiệu trên Google Ads và các nền tảng tự nhiên theo 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 mức độ phổ biến trong tuần trước 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 trước hoặc tháng trước.
relative_demand_change

RelativeDemandChangeTypeEnum

Thay đổi về nhu cầu ước tính. Cho dù nó dâng lên, chìm xuống hay ở trạng thái phẳng.

BestSellersProductClusterView

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

Báo cáo Bán chạy nhất bao gồm 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 ưu đãi và biến thể đại diện cho cùng một sản phẩm, chẳng hạn như 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) để báo cáo hằng tuần,
  • Ngày đầu tiên của tháng cho báo cáo hằng tháng.

Bắt buộc trong mệnh đề SELECT. Nếu điều kiện WHERE trên report_date không được chỉ định trong truy vấn, thì báo cáo hằng tuần hoặc hằng tháng mới nhất hiện có 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. Việc xếp hạng có thể được thực hiện trong một tuần hoặc một tháng.

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

string

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

Bắt buộc trong mệnh đề SELECT. Bắt buộc phải có đ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 toán 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 report_category_id không được chỉ định trong truy vấn, thì thứ hạng cho tất cả cá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.
category_l1

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

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

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 hệ thống 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 trình bày trong hệ thống 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 trình bày trong hệ thống phân loại sản phẩm của Google.
inventory_status

InventoryStatus

Liệu cụm sản phẩm 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.
brand_inventory_status

InventoryStatus

Cho dù nguồn dữ liệu sản phẩm của bạn hiện có ít nhất một sản phẩm của thương hiệu IN_STOCK tại ít nhất một trong các quốc gia hay không, tất cả sản phẩm đều có giá trị 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.

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

int64

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 phải trả tiền theo 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 mức độ phổ biến trong tuần trước 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 trước hoặc tháng trước.
relative_demand_change

RelativeDemandChangeTypeEnum

Thay đổi về nhu cầu ước tính. Cho dù nó dâng lên, chìm xuống hay ở trạng thái phẳ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 cụ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 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ó sẵn cho truy vấn trong bảng competitive_visibility_benchmark_view.

Báo cáo Khả năng hiển thị so với đối thủ cạnh tranh với đ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 tạo hàng này.

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

string

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

Bắt buộc trong mệnh đề SELECT. Một đ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 báo cáo, đượ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. Một điều kiện trên report_category_id là bắt buộc trong mệnh đề WHERE.
traffic_source

TrafficSourceEnum

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

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

double

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 vào thời điểm bắt đầu khoảng 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 trong mệnh đề 'WHERE'.
category_benchmark_visibility_trend

double

Thay đổi về mức độ hiển thị dựa trên số lượt hiển thị tính vào 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 kết hợp những người bán có mức độ hiển thị cao nhất xấp xỉ thị trường.

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

CompetitiveVisibilityCompetitorView

Các trường có sẵn cho 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 tạo hàng này.

Một điều kiện trên date là bắt buộc 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 thuộc tính "is_your_domain" là đúng.

Bắt buộc trong mệnh đề SELECT. Không thể lọc 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 trong mệnh đề 'WHERE'.
report_country_code

string

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

Bắt buộc trong mệnh đề SELECT. Một đ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 báo cáo, đượ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. Một điều kiện trên report_category_id là bắt buộc trong mệnh đề WHERE.
traffic_source

TrafficSourceEnum

Nguồn lưu lượng truy cập của các 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à cao nhất.

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

double

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 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 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 trong mệnh đề 'WHERE'.
higher_position_rate

double

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 trong mệnh đề 'WHERE'.
relative_visibility

double

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 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ẻ của đối thủ 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 cho danh mục sản phẩm và quốc gia đã chọn.

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

CompetitiveVisibilityTopMerchantView

Các trường có sẵn cho 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 tạo hàng này.

Không thể chọn trong mệnh đề SELECT. Một điều kiện trên date là bắt buộc 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 thuộc tính "is_your_domain" là đúng.

Bắt buộc trong mệnh đề SELECT. Không thể lọc 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 trong mệnh đề 'WHERE'.
report_country_code

string

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

Bắt buộc trong mệnh đề SELECT. Một đ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 báo cáo, đượ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. Một điều kiện trên report_category_id là bắt buộc trong mệnh đề WHERE.
traffic_source

TrafficSourceEnum

Nguồn lưu lượng truy cập của các 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 người bán 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à cao nhất.

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

double

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 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 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 trong mệnh đề 'WHERE'.
higher_position_rate

double

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 trong mệnh đề 'WHERE'.

MarketingMethod

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

Phương thức tiếp thị được 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ị 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 non_product_performance_view.

Dữ liệu về hiệu suất của hình ảnh và đường liên kết của 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à phương diện theo mà các chỉ số hiệu suất được phân đoạn (ví dụ: date).

Bạn không thể chọn trường phân đoạn trong truy vấn nếu chưa 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 áp dụng chỉ số theo múi giờ của người bán. Phân đoạn.

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

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

int64

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

int64

Số lần hình ảnh và đường liên kết 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ố.
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 của cửa hàng trực tuyến dẫn đến những trang không liên quan đến sản phẩm. Chỉ số.

PriceCompetitivenessProductView

Các trường có sẵn cho 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

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

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

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

string

Mã nhận dạng của 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 hệ thống 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 hệ thống 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 hệ thống 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 hệ thống 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 hệ thống 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 hệ thống phân loại sản phẩm của riêng người bá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 riêng người bá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 riêng người bá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 riêng người bá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 riêng người bán.

PriceInsightsProductView

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

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

Hiệu quả dự đoán của việc áp dụng đề xuất giá, được chia theo 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 product_view.

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

string

Mã nhận dạng của 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 hệ thống 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 hệ thống 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 hệ thống 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 hệ thống 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 hệ thống 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 hệ thống phân loại sản phẩm của riêng người bá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 riêng người bá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 riêng người bá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 riêng người bá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 riêng người bán.
predicted_impressions_change_fraction

double

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

double

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

double

Thay đổi được dự đoán của số lượt chuyển đổi dưới dạng một phần sau khi áp dụng giá được đề xuất so với giá đang áp dụng hiện tại. Ví dụ: 0, 05 cho biết số lượt chuyển đổi tăng thêm 5%.

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ẽ hưởng lợi nhiều nhất khi bạn thay đổi giá. Điểm xếp hạng này có 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 và giá đề xuất. Các đề xuất về giá có hiệu quả về HIGH được dự đoán sẽ giúp hiệu suất tăng cao nhất.

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

ProductPerformanceView

Các trường có sẵn cho 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á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 phương diện sản phẩm như offer_id 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 trường phân đoạn trong truy vấn nếu chưa 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 áp dụng chỉ số theo múi giờ của người bán. Phân đoạn.

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

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

Price

Giá trị của lượt chuyển đổi 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 pháp tiếp thị áp dụng các chỉ số. Phân đoạn.
customer_country_code

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ả lại.
offer_id

string

Mã nhận dạng của 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 hệ thống 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 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 cách phân loại sản phẩm riêng của người bán. Phân đoạn.
product_type_l2

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

Nhãn tuỳ chỉnh 4 cho 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 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 giá trị đóng góp đó. 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ó sẵn cho truy vấn trong bảng product_view.

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 API phụ của Sản phẩm, nhưng không phải tất cả các thuộc tính sản phẩm trong API phụ của 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 duy nhất muộn nhất vào ngày 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 cụm từ tìm kiếm của yêu cầu.

Trường
price

Price

Giá sản phẩm. Vắng mặt 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 mà người bán đã tạo sản phẩm tính bằng giây trong dấu thời gian.
expiration_date

Date

Ngày hết hạn cho 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.

Bạn không thể sử 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ụ: 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 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. Những phương thức API của Merchant hoạt động trên các 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ã nhận dạng của 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 hệ thống 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 hệ thống 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 hệ thống 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 hệ thống 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 hệ thống 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 hệ thống phân loại sản phẩm của riêng người bá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 riêng người bá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 riêng người bá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 riêng người bá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 riêng 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 tạo lượt nhấp. Sản phẩm có click_potential_rank 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 về 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Ờ 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 đối với mọi ngữ cảnh báo cáo.
PENDING Trạng thái của sản phẩm đang chờ xử lý trong tất cả cá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 mọi 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 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, đồng thời giúp họ hiểu được hiệu suất sản phẩm so với tiềm năng.

Enum
CLICK_POTENTIAL_UNSPECIFIED Tác động của số lượt nhấp được 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 các 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 các 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ự so với 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 tự động giải quyết (ví dụ: thu thập thông tin 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 phải làm gì cả. Việc giải quyết có thể dẫn đến một vấn đề khác (ví dụ: khi thu thập dữ liệu không thành công).

ItemIssueSeverity

Vấn đề ảnh hưởng như thế nào đế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 ngữ cảnh báo cáo.
aggregated_severity

AggregatedIssueSeverity

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

Bạn có thể 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 đề từ chối sản phẩm trong ít nhất một bối cảnh báo cáo.
DEMOTED Vấn đề giảm hạng sản phẩm trong mọi bối cảnh báo cáo mà nó ảnh hưởng đến.
PENDING Độ phân giải của vấn đề là PENDING_PROCESSING.

IssueSeverityPerReportingContext

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

Trường
disapproved_countries[]

string

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

string

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

ReportingContextEnum

Ngữ cảnh báo cáo có vấn đề.

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 cho các vấn đề riêng của một thuộc tính.

RelativeDemand

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

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 thương hiệu và 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 bằng 0-5% 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 bằng 6-10% 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 bằng 11-20% 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 bằng 21-50% 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 bằng 51-100% 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.

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 so với 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.

Mức độ chi tiết của báo cáo thương hiệu và sản phẩm bán chạy nhất. Báo cáo thương hiệu và sản phẩm 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

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 trong khung thời gian một tuần.
MONTHLY Báo cáo được tính toán trong khung thời gian 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 đã đ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ó sẵn cho truy vấn trong bảng product_performance_view.
non_product_performance_view

NonProductPerformanceView

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

ProductView

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

PriceCompetitivenessProductView

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

PriceInsightsProductView

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

BestSellersProductClusterView

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

BestSellersBrandView

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

CompetitiveVisibilityCompetitorView

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

CompetitiveVisibilityTopMerchantView

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

CompetitiveVisibilityBenchmarkView

Các trường có sẵn cho 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 cuộc gọi. Phải là một tài khoản độc lập hoặc tài khoản phụ của MCA. Định dạng: accounts/{account}
query

string

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

Để biết chi tiết về cách tạo truy vấ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 mục Các trường có sẵn.
page_size

int32

Không bắt buộc. Số lượng ReportRows cần truy xuất trong một trang. Giá trị mặc định là 1000. Giá trị trên 5000 bị chuyển đổi 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ị nhận đượ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

Hàng phù hợ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ị bỏ qua, thì không có trang tiếp theo nào.

TrafficSource

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

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 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 nhờ quảng cáo.