Di chuyển tính năng báo cáo từ Content API for Shopping

Dưới đây là cách bạn có thể tích hợp Merchant Reports API (API Báo cáo của người bán) với hoạt động triển khai Content API for Shopping hiện tại.

Yêu cầu

Hãy sử dụng định dạng URL yêu cầu sau đây cho API Báo cáo của người bán:

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

Dưới đây là dữ liệu so sánh mẫu giữa Content API for Shopping với API Báo cáo của người bán cho các yêu cầu search:

Content API API Merchant Center
URL https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/reports/search https://merchantapi.googleapis.com/reports/v1beta/{parent}/reports:search
Giá trị nhận dạng {merchantId} {parent}

Phương thức

Bạn có thể truy vấn API Báo cáo của người bán bằng cách gọi phương thức ReportService.Search.

Số lượt xem

Trong API Merchant, tên bảng được đổi từ CammelCase thành snake_case.

MerchantPerformanceView đổi tên thành product_performance_view

Dưới đây là mối liên kết giữa các tên bảng trong Content API for Shopping và Merchant API:

Content API API Merchant Center
MerchantPerformanceView product_performance_view
ProductView product_view
PriceCompetitivenesProductView price_competitiveness_product_view
PriceInsightsProductView price_insights_product_view
BestSellersBrandView best_sellers_brand_view
BestSellersProductClusterView best_sellers_product_cluster_view
CompetitiveVisibilityCompetitorView competitive_visibility_competitor_view
CompetitiveVisibilityTopMerchantView competitive_visibility_top_merchant_view
CompetitiveVisibilityBenchmarkView competitive_visibility_benchmark_view

Trong API Merchant, việc chỉ định tiền tố trường, ví dụ: segments.offer_id không còn là bắt buộc. Thay vào đó, bạn chỉ cần sử dụng tên trường offer_id.

Dưới đây là thông tin so sánh mẫu về các truy vấn trong Content API for Shopping và Merchant API:

Content API API Merchant Center 
   SELECT
     segments.offer_id,
     metrics.clicks
   FROM MerchantPerformanceView
   WHERE segments.date DURING LAST_7_DAYS
   
   SELECT
     offer_id,
     clicks
   FROM product_performance_view
   WHERE date DURING LAST_7_DAYS

Dưới đây là câu trả lời mẫu:

Content API API Merchant Center 
{
  "segments":{
    "offerId":"abc"
  },
  "metrics":{
    "clicks":"123"
  }
}

{
  "productPerformanceView" : {
    "offerId": "abc",
    "clicks": "123"
  }
}

Tên bảng có thể được dùng làm tiền tố của trường. Ví dụ: cả offer_id và product_performance_view.offer_id đều được chấp nhận trong truy vấn API Merchant.

Hiệu suất

Dưới đây là những thay đổi đối với chế độ xem hiệu suất trong API Báo cáo của người bán:

Content API API Merchant Center Nội dung mô tả
segments.program: chuỗi marketing_method: chuỗi Phân đoạn program được thay thế bằng trường marketing_method mới. Hãy xem phần Giá trị marketing method mới để biết thông tin chi tiết.
metrics.ctr: gấp đôi clickThroughRate: gấp đôi Đổi tên chỉ số ctr thành clickThroughRate
metrics.conversionValueMicros: số nguyên
segments.currencyCode: chuỗi 		conversionValue: {
object (Price)
} 		Trường đơn vị tiền tệ và trường đơn vị tiền tệ được hợp nhất vào một trường thuộc loại Price
metrics.orders,
metrics.orderedItems,
… 		Không thể làm Các chỉ số của chương trình Mua trên Google không được hỗ trợ trong API Báo cáo của người bán

Các giá trị mới của phương thức tiếp thị

Dưới đây là mối liên kết giữa các giá trị segments.program và marketing_method:

Content API API Merchant Center
SHOPPING_ADS ADS
FREE_PRODUCT_LISTING ORGANIC
FREE_LOCAL_PRODUCT_LISTING ORGANIC
BUY_ON_GOOGLE_LISTING Không thể làm

Sản phẩm

Dưới đây là những thay đổi đối với chế độ xem sản phẩm trong API Báo cáo của người bán:

Content API API Merchant Center Nội dung mô tả
productView.id: chuỗi id: chuỗi Định dạng trường thay đổi từ channel:language:targetCountry:offerId thành
channel~language~feedLabel~offerId
productView.priceMicros: số nguyên
productView.currencyCode: chuỗi 		price: {
object (Price)
} 		Trường đơn vị tiền tệ và trường đơn vị tiền tệ được hợp nhất vào một trường thuộc loại Price
productView.aggregated_destination_status: chuỗi aggregated_reporting_context_status: chuỗi Trường aggregated_destination_status được đổi tên thành aggregated_reporting_context_status, các giá trị không thay đổi
productView.item_issues: [
{
object (ItemIssue)
}
] 		item_issues: [
{
object (ItemIssue)
}
] 		Định nghĩa ItemIssue đã thay đổi
Không thể làm feedLabel: chuỗi Ra mắt trường feedLabel

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

Dưới đây là những điểm thay đổi đối với chế độ xem thông tin chi tiết về giá trong API Báo cáo của người bán:

Content API API Merchant Center Nội dung mô tả
productView.id: chuỗi id: chuỗi Định dạng trường sẽ thay đổi từ channel:language:targetCountry:offerId thành channel~language~feedLabel~offerId
productView.priceMicros: số nguyên
productView.currencyCode: chuỗi 		price: {
object (Price)
} 		Trường đơn vị tiền tệ và trường đơn vị tiền tệ được hợp nhất vào một trường thuộc loại Price
priceInsights.suggestedPriceMicros: số nguyên
priceInsights.suggestedPriceCurrencyCode: chuỗi 		suggestedPrice: {
object (Price)
} 		Trường đơn vị tiền tệ và trường đơn vị tiền tệ được hợp nhất vào một trường thuộc loại Price
priceInsights.predictedGrossProfitChangeFraction: kép
priceInsights.predictedMonthlyGrossProfitChangeMicros: số nguyên
priceInsights.predictedMonthlyGrossProfitChangeCurrencyCode: chuỗi 		Không thể làm API Báo cáo của người bán không hỗ trợ các trường liên quan đến thay đổi về lợi nhuận gộp

Tính cạnh tranh về giá

Dưới đây là những điểm thay đổi đối với chế độ xem sức cạnh tranh về giá trong API Báo cáo của người bán:

Content API API Merchant Center Nội dung mô tả
productView.id: chuỗi id: chuỗi Định dạng trường sẽ thay đổi từ channel:language:targetCountry:offerId thành channel~language~feedLabel~offerId
productView.priceMicros: số nguyên
productView.currencyCode: chuỗi 		price: {
object (Price)
} 		Trường đơn vị tiền tệ và trường đơn vị tiền tệ được hợp nhất vào một trường thuộc loại Price
priceCompetitiveness.countryCode: chuỗi reportCountryCode: chuỗi Trường countryCode được đổi tên thành reportCountryCode
priceCompetitiveness.benchmarkPriceMicros: số nguyên
priceCompetitiveness.benchmarkPriceCurrencyCode: chuỗi 		benchmarkPrice: {
object (Price)
} 		Trường đơn vị tiền tệ và trường đơn vị tiền tệ được hợp nhất vào một trường thuộc loại Price

Bán chạy nhất

Sau đây là những thay đổi đối với chế độ xem sản phẩm bán chạy nhất trong API Báo cáo của người bán:

Content API API Merchant Center Nội dung mô tả
bestSellers.countryCode: chuỗi reportCountryCode: chuỗi Trường countryCode được đổi tên thành reportCountryCode
bestSellers.categoryId: số nguyên reportCategoryId: số nguyên Trường categoryId được đổi tên thành reportCategoryId

Mức độ hiển thị cạnh tranh

Sau đây là những điểm thay đổi đối với chế độ xem khả năng hiển thị so với đối thủ cạnh tranh trong API Báo cáo của người bán:

Content API API Merchant Center Nội dung mô tả
competitiveVisibility.countryCode: chuỗi reportCountryCode: chuỗi Trường countryCode được đổi tên thành reportCountryCode
competitiveVisibility.categoryId: số nguyên reportCategoryId: số nguyên Trường categoryId được đổi tên thành reportCategoryId

Trước
Di chuyển hoạt động quản lý các nguồn chuyển đổi
Tiếp
Di chuyển hoạt động quản lý đối tác nguồn cấp dữ liệu địa phương