ย้ายข้อมูลการรายงานจาก 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: ตีดับเบิล clickThroughRate: ตีดับเบิล เปลี่ยนชื่อเมตริก ctr เป็น clickThroughRate แล้ว
metrics.conversionValueMicros: จำนวนเต็ม
segments.currencyCode: สตริง 		conversionValue: {
object (Price)
} 		ระบบจะรวมช่องจำนวนเงินแบบไมโครและช่องสกุลเงินไว้ในช่องเดียวที่มีประเภท 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: จำนวนเต็ม
productView.currencyCode: สตริง 		price: {
object (Price)
} 		ระบบจะรวมช่องจำนวนเงินแบบไมโครและช่องสกุลเงินไว้ในช่องเดียวที่มีประเภท 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: จำนวนเต็ม
productView.currencyCode: สตริง 		price: {
object (Price)
} 		ระบบจะรวมช่องจำนวนเงินแบบไมโครและช่องสกุลเงินไว้ในช่องเดียวที่มีประเภท Price
priceInsights.suggestedPriceMicros: จำนวนเต็ม
priceInsights.suggestedPriceCurrencyCode: สตริง 		suggestedPrice: {
object (Price)
} 		ระบบจะรวมช่องจำนวนเงินแบบไมโครและช่องสกุลเงินไว้ในช่องเดียวที่มีประเภท 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: จำนวนเต็ม
productView.currencyCode: สตริง 		price: {
object (Price)
} 		ระบบจะรวมช่องจำนวนเงินแบบไมโครและช่องสกุลเงินไว้ในช่องเดียวที่มีประเภท Price
priceCompetitiveness.countryCode: string reportCountryCode: string เปลี่ยนชื่อช่อง countryCode เป็น reportCountryCode แล้ว
priceCompetitiveness.benchmarkPriceMicros: จำนวนเต็ม
priceCompetitiveness.benchmarkPriceCurrencyCode: สตริง 		benchmarkPrice: {
object (Price)
} 		ระบบจะรวมช่องจำนวนเงินแบบไมโครและช่องสกุลเงินไว้ในช่องเดียวที่มีประเภท 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: จำนวนเต็ม reportCategoryId: จำนวนเต็ม เปลี่ยนชื่อช่อง categoryId เป็น reportCategoryId แล้ว

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