ย้ายข้อมูลการรายงานจาก Content API for Shopping

คุณสามารถใช้ Merchant Reports API เพื่อดูข้อมูลเกี่ยวกับผลิตภัณฑ์ ประสิทธิภาพ และสภาพแวดล้อมทางการแข่งขันของผลิตภัณฑ์ใน Google ผ่านมุมมองข้อมูลที่ API นี้มีให้

คุณสามารถใช้ Merchant Reports API เพื่อทำสิ่งต่อไปนี้ได้

วิธีผสานรวม Merchant Reports API กับการติดตั้งใช้งาน Content API for Shopping ที่มีอยู่

คำขอ

ใช้รูปแบบ URL คำขอต่อไปนี้สำหรับ Merchant Reports API

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

ตัวอย่างการเปรียบเทียบ Content API for Shopping กับ Merchant Reports API สำหรับคำขอ 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
รหัสระบุ {MERCHANT_ID} {PARENT}

เมธอด

คุณสามารถค้นหา Merchant Reports API ได้โดยการเรียกใช้ ReportService.Search เมธอด

มุมมอง

ใน Merchant API ระบบจะเปลี่ยนชื่อตารางจาก CamelCase เป็น snake_case

ตอนนี้ MerchantPerformanceView เปลี่ยนเป็น product_performance_view แล้ว

การแมประหว่างชื่อตารางใน Content API for Shopping กับ 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

ใน Merchant API คุณไม่จำเป็นต้องระบุคำนำหน้าของช่อง เช่น segments.offer_id อีกต่อไป แต่ให้ใช้ชื่อช่อง offer_id แทน

ตัวอย่างการเปรียบเทียบการค้นหาใน Content API for Shopping กับ 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

ตัวอย่างการตอบกลับ

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

คุณสามารถใช้ชื่อตารางเป็นคำนำหน้าของช่องได้ เช่น ทั้ง offer_id และ product_performance_view.offer_id ได้รับการยอมรับในการค้นหา Merchant API

ประสิทธิภาพ

สิ่งที่เปลี่ยนแปลงสำหรับมุมมองประสิทธิภาพใน Merchant Reports API

Content API Merchant API คำอธิบาย
segments.program: string marketing_method: string ระบบจะแทนที่เซกเมนต์ program ด้วยช่อง marketing_method ใหม่ ดูรายละเอียดได้ที่ค่า ใหม่ marketing method
metrics.ctr: double clickThroughRate: double ระบบจะเปลี่ยนชื่อเมตริก ctr เป็น clickThroughRate
metrics.conversionValueMicros: integer
segments.currencyCode: string 		conversionValue: {
object (Price)
} 		ระบบจะผสานรวมช่อง amount micros และช่องสกุลเงินเป็นช่องเดียวที่มีประเภท Price
metrics.orders,
metrics.orderedItems,
… 		ไม่รองรับ Merchant Reports API ไม่รองรับเมตริก "ซื้อใน Google"

ค่าวิธีทางการตลาดใหม่

การแมประหว่างค่า segments.program กับ marketing_method

Content API Merchant API
SHOPPING_ADS ADS
FREE_PRODUCT_LISTING ORGANIC
FREE_LOCAL_PRODUCT_LISTING ORGANIC
BUY_ON_GOOGLE_LISTING ไม่รองรับ

ผลิตภัณฑ์

สิ่งที่เปลี่ยนแปลงสำหรับมุมมองผลิตภัณฑ์ใน Merchant Reports API

Content API Merchant API คำอธิบาย
productView.id: string id: string รูปแบบช่องจะเปลี่ยนจาก channel:language:targetCountry:offerId เป็น
channel~language~feedLabel~offerId
productView.priceMicros: integer
productView.currencyCode: string 		price: {
object (Price)
} 		ระบบจะผสานรวมช่อง amount micros และช่องสกุลเงินเป็นช่องเดียวที่มีประเภท Price
productView.aggregated_destination_status: string aggregated_reporting_context_status: string ระบบจะเปลี่ยนชื่อช่อง aggregated_destination_status เป็น aggregated_reporting_context_status แต่ค่าจะยังคงเหมือนเดิม
productView.item_issues: [
{
object (ItemIssue)
}
] 		item_issues: [
{
object (ItemIssue)
}
] 		คำจำกัดความของ ItemIssue เปลี่ยนไป
ไม่รองรับ feedLabel: string มีการเปิดตัวช่อง feedLabel

ข้อมูลเชิงลึกด้านราคา

สิ่งที่เปลี่ยนแปลงสำหรับมุมมองข้อมูลเชิงลึกด้านราคาใน Merchant Reports API

Content API Merchant API คำอธิบาย
productView.id: string id: string รูปแบบช่องจะเปลี่ยนจาก channel:language:targetCountry:offerId เป็น channel~language~feedLabel~offerId
productView.priceMicros: integer
productView.currencyCode: string 		price: {
object (Price)
} 		ระบบจะผสานรวมช่อง amount micros และช่องสกุลเงินเป็นช่องเดียวที่มีประเภท Price
priceInsights.suggestedPriceMicros: integer
priceInsights.suggestedPriceCurrencyCode: string 		suggestedPrice: {
object (Price)
} 		ระบบจะผสานรวมช่อง amount micros และช่องสกุลเงินเป็นช่องเดียวที่มีประเภท Price
priceInsights.predictedGrossProfitChangeFraction: double
priceInsights.predictedMonthlyGrossProfitChangeMicros: integer
priceInsights.predictedMonthlyGrossProfitChangeCurrencyCode: string 		ไม่รองรับ Merchant Reports API ไม่รองรับช่องที่เกี่ยวข้องกับการเปลี่ยนแปลงกำไรขั้นต้น

ความสามารถในการแข่งขันด้านราคา

สิ่งที่เปลี่ยนแปลงสำหรับมุมมองความสามารถในการแข่งขันด้านราคาใน Merchant Reports API

Content API Merchant API คำอธิบาย
productView.id: string id: string รูปแบบช่องจะเปลี่ยนจาก channel:language:targetCountry:offerId เป็น channel~language~feedLabel~offerId
productView.priceMicros: integer
productView.currencyCode: string 		price: {
object (Price)
} 		ระบบจะผสานรวมช่อง amount micros และช่องสกุลเงินเป็นช่องเดียวที่มีประเภท Price
priceCompetitiveness.countryCode: string reportCountryCode: string ระบบจะเปลี่ยนชื่อช่อง countryCode เป็น reportCountryCode
priceCompetitiveness.benchmarkPriceMicros: integer
priceCompetitiveness.benchmarkPriceCurrencyCode: string 		benchmarkPrice: {
object (Price)
} 		ระบบจะผสานรวมช่อง amount micros และช่องสกุลเงินเป็นช่องเดียวที่มีประเภท Price

สินค้าขายดี

สิ่งที่เปลี่ยนแปลงสำหรับมุมมองสินค้าขายดีใน Merchant Reports API

Content API Merchant API คำอธิบาย
bestSellers.countryCode: string reportCountryCode: string ระบบจะเปลี่ยนชื่อช่อง countryCode เป็น reportCountryCode
bestSellers.categoryId: int reportCategoryId: int ระบบจะเปลี่ยนชื่อช่อง categoryId เป็น reportCategoryId

การแสดงผลเทียบกับคู่แข่ง

สิ่งที่เปลี่ยนแปลงสำหรับมุมมองการแสดงผลเทียบกับคู่แข่งใน Merchant Reports API

Content API Merchant API คำอธิบาย
competitiveVisibility.countryCode: string reportCountryCode: string ระบบจะเปลี่ยนชื่อช่อง countryCode เป็น reportCountryCode
competitiveVisibility.categoryId: integer reportCategoryId: integer ระบบจะเปลี่ยนชื่อช่อง categoryId เป็น reportCategoryId

ก่อนหน้า
Migrate products management
ถัดไป
Migrate data sources management