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

Bạn có thể sử dụng Merchant Reports API để tìm hiểu về các 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 thông qua chế độ xem dữ liệu mà API này cung cấp.

Bạn có thể sử dụng Merchant Reports API để làm những việc sau:

  • Đo lường hiệu suất của sản phẩm: Trong Merchant API, MerchantPerformanceView hiện là product_performance_view.
  • Lọc sản phẩm theo các trường cụ thể: Với Merchant API, bạn có thể lọc dựa trên tất cả các trường có sẵn, ngoại trừ item_issues.
  • Cải thiện giá sản phẩm: Với Merchant API, các trường lượng vi mô và đơn vị tiền tệ được hợp nhất thành một trường có kiểu Price.
  • Hiểu rõ thị trường: Với Merchant API, bạn có thể nhận được dữ liệu về các sản phẩm và thương hiệu bán chạy nhất, các điểm giá cạnh tranh, đề xuất giá ưu đãi và thông tin về tình hình cạnh tranh trong ngành của bạn.
  • Khám phá tình hình cạnh tranh: Bạn có thể nhận báo cáo để hiểu rõ tình hình cạnh tranh ở cấp danh mục sản phẩm và làm những việc cần thiết để cải thiện khả năng hiển thị của mình.

Sau đây là cách bạn có thể tích hợp Merchant Reports API với cách triển khai Content API for Shopping hiện có.

Yêu cầu

Sử dụng định dạng URL yêu cầu sau cho Merchant Reports API:

POST https://merchantapi.googleapis.com/reports/v1/{PARENT}/reports:search

Dưới đây là một ví dụ so sánh Content API for Shopping với Merchant Reports API cho các yêu cầu search:

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

Phương thức

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

Số lượt xem

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

MerchantPerformanceView hiện là product_performance_view.

Dưới đây là mối quan hệ giữa tên bảng trong Content API for Shopping và Merchant API:

Content API Merchant API
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 Merchant API, bạn không cần chỉ định tiền tố trường nữa, ví dụ: segments.offer_id. Thay vào đó, bạn chỉ cần sử dụng tên trường offer_id.

Dưới đây là một ví dụ so sánh các truy vấn trong Content API for Shopping và Merchant API:

Content API Merchant API 
   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à một phản hồi mẫu:

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

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

Hiệu suất

Dưới đây là những thay đổi đối với chế độ xem hiệu suất trong Merchant Reports API:

Content API Merchant API Mô tả
segments.program: string marketing_method: string Phân khúc program được thay thế bằng trường marketing_method mới. Hãy xem các giá trị mới marketing method để biết thông tin chi tiết.
metrics.ctr: double clickThroughRate: double Chỉ số ctr được đổi tên thành clickThroughRate
metrics.conversionValueMicros: integer
segments.currencyCode: string 		conversionValue: {
object (Price)
} 		Các trường lượng vi mô và đơn vị tiền tệ được hợp nhất thành một trường có kiểu Price
metrics.orders,
metrics.orderedItems,
… 		Không được hỗ trợ Merchant Reports API không hỗ trợ các chỉ số của chương trình Mua trên Google

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

Dưới đây là mối quan hệ giữa các giá trị segments.program và marketing_method:

Content API Merchant API
SHOPPING_ADS ADS
FREE_PRODUCT_LISTING ORGANIC
FREE_LOCAL_PRODUCT_LISTING ORGANIC
BUY_ON_GOOGLE_LISTING Không được hỗ trợ

Sản phẩm

Dưới đây là những thay đổi đối với chế độ xem sản phẩm trong Merchant Reports API:

Content API Merchant API Mô tả
productView.id: string id: string Định dạng trường thay đổi từ channel:language:targetCountry:offerId thành
channel~language~feedLabel~offerId
productView.priceMicros: integer
productView.currencyCode: string 		price: {
object (Price)
} 		Các trường lượng vi mô và đơn vị tiền tệ được hợp nhất thành một trường có kiểu Price
productView.aggregated_destination_status: string aggregated_reporting_context_status: string 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 được hỗ trợ feedLabel: string Giới thiệu trường feedLabel

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

Dưới đây là những thay đổi đối với chế độ xem thông tin chi tiết về giá trong Merchant Reports API:

Content API Merchant API Mô tả
productView.id: string id: string Định dạng trường thay đổi từ channel:language:targetCountry:offerId thành channel~language~feedLabel~offerId
productView.priceMicros: integer
productView.currencyCode: string 		price: {
object (Price)
} 		Các trường lượng vi mô và đơn vị tiền tệ được hợp nhất thành một trường có kiểu Price
priceInsights.suggestedPriceMicros: integer
priceInsights.suggestedPriceCurrencyCode: string 		suggestedPrice: {
object (Price)
} 		Các trường lượng vi mô và đơn vị tiền tệ được hợp nhất thành một trường có kiểu Price
priceInsights.predictedGrossProfitChangeFraction: double
priceInsights.predictedMonthlyGrossProfitChangeMicros: integer
priceInsights.predictedMonthlyGrossProfitChangeCurrencyCode: string 		Không được hỗ trợ Merchant Reports API không được hỗ trợ các trường liên quan đến thay đổi lợi nhuận gộp

Sức cạnh tranh về giá

Dưới đây là những thay đổi đối với chế độ xem sức cạnh tranh về giá trong Merchant Reports API:

Content API Merchant API Mô tả
productView.id: string id: string Định dạng trường thay đổi từ channel:language:targetCountry:offerId thành channel~language~feedLabel~offerId
productView.priceMicros: integer
productView.currencyCode: string 		price: {
object (Price)
} 		Các trường lượng vi mô và đơn vị tiền tệ được hợp nhất thành một trường có kiểu Price
priceCompetitiveness.countryCode: string reportCountryCode: string Trường countryCode được đổi tên thành reportCountryCode
priceCompetitiveness.benchmarkPriceMicros: integer
priceCompetitiveness.benchmarkPriceCurrencyCode: string 		benchmarkPrice: {
object (Price)
} 		Các trường lượng vi mô và đơn vị tiền tệ được hợp nhất thành một trường có kiểu Price

Bán chạy nhất

Dưới đây là những thay đổi đối với chế độ xem sản phẩm bán chạy nhất trong Merchant Reports API:

Content API Merchant API Mô tả
bestSellers.countryCode: string reportCountryCode: string Trường countryCode được đổi tên thành reportCountryCode
bestSellers.categoryId: int reportCategoryId: int Trường categoryId được đổi tên thành reportCategoryId

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

Dưới đây là những thay đổi đối với chế độ xem mức độ hiển thị cạnh tranh trong Merchant Reports API:

Content API Merchant API Mô tả
competitiveVisibility.countryCode: string reportCountryCode: string Trường countryCode được đổi tên thành reportCountryCode
competitiveVisibility.categoryId: integer reportCategoryId: integer Trường categoryId được đổi tên thành reportCategoryId

Trước
Migrate conversion sources management
Tiếp
Migrate local feeds partnership management