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

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

คุณใช้ 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: สตริง marketing_method: สตริง program จะแทนที่ด้วยฟิลด์ marketing_method ใหม่ ดูรายละเอียดได้ที่ค่าmarketing methodใหม่
metrics.ctr: ตีดับเบิล clickThroughRate: ตีดับเบิล เปลี่ยนชื่อเมตริก ctr เป็น clickThroughRate
metrics.conversionValueMicros: จำนวนเต็ม
segments.currencyCode: สตริง 		conversionValue: {
object (Price)
} 		ระบบจะผสานช่องจำนวนเงินแบบไมโครและช่องสกุลเงินเป็นช่องเดียวที่มีประเภท Price
metrics.orders,
metrics.orderedItems,
… 		ไม่รองรับ ระบบไม่รองรับเมตริกซื้อใน Google ใน Merchant Reports API

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

ต่อไปนี้คือการแมประหว่างค่า 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: สตริง id: สตริง รูปแบบฟิลด์จะเปลี่ยนจาก channel:language:targetCountry:offerId เป็น
channel~language~feedLabel~offerId
productView.priceMicros: จำนวนเต็ม
productView.currencyCode: สตริง 		price: {
object (Price)
} 		ระบบจะผสานช่องจำนวนเงินแบบไมโครและช่องสกุลเงินเป็นช่องเดียวที่มีประเภท Price
productView.aggregated_destination_status: สตริง aggregated_reporting_context_status: สตริง ฟิลด์ aggregated_destination_status เปลี่ยนชื่อเป็น aggregated_reporting_context_status แต่ค่าไม่ได้เปลี่ยนแปลง
productView.item_issues: [
{
object (ItemIssue)
}
] 		item_issues: [
{
object (ItemIssue)
}
] 		คำจำกัดความของ ItemIssue มีการเปลี่ยนแปลง
ไม่รองรับ feedLabel: สตริง เปิดตัวฟิลด์ feedLabel

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

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

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

ขายดีที่สุด

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

Content API Merchant API คำอธิบาย
bestSellers.countryCode: สตริง reportCountryCode: สตริง เปลี่ยนชื่อฟิลด์ countryCode เป็น reportCountryCode
bestSellers.categoryId: int reportCategoryId: int เปลี่ยนชื่อฟิลด์ categoryId เป็น reportCategoryId

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

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

Content API Merchant API คำอธิบาย
competitiveVisibility.countryCode: สตริง reportCountryCode: สตริง เปลี่ยนชื่อฟิลด์ countryCode เป็น reportCountryCode
competitiveVisibility.categoryId: จำนวนเต็ม reportCategoryId: จำนวนเต็ม เปลี่ยนชื่อฟิลด์ categoryId เป็น reportCategoryId

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