ย้ายข้อมูลการรายงานจาก 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: สตริง marketing_method: สตริง program จะแทนที่ด้วยฟิลด์ marketing_method ใหม่ ดูรายละเอียดได้ที่ค่าmarketing methodใหม่
metrics.ctr: ตีดับเบิล clickThroughRate: ตีดับเบิล เปลี่ยนชื่อเมตริก ctr เป็น clickThroughRate
metrics.conversionValueMicros: integer
segments.currencyCode: string 		conversionValue: {
object (Price)
} 		ระบบจะผสานช่องจำนวนเงิน Micro และช่องสกุลเงินเป็นช่องเดียวที่มีPriceประเภท
metrics.orders,
metrics.orderedItems,
… 		ไม่รองรับ 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: สตริง id: สตริง รูปแบบฟิลด์เปลี่ยนจาก channel:language:targetCountry:offerId เป็น
channel~language~feedLabel~offerId
productView.priceMicros: integer
productView.currencyCode: string 		price: {
object (Price)
} 		ระบบจะผสานช่องจำนวนเงิน Micro และช่องสกุลเงินเป็นช่องเดียวที่มี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: integer
productView.currencyCode: string 		price: {
object (Price)
} 		ระบบจะผสานช่องจำนวนเงิน Micro และช่องสกุลเงินเป็นช่องเดียวที่มีPriceประเภท
priceInsights.suggestedPriceMicros: integer
priceInsights.suggestedPriceCurrencyCode: string 		suggestedPrice: {
object (Price)
} 		ระบบจะผสานช่องจำนวนเงิน Micro และช่องสกุลเงินเป็นช่องเดียวที่มี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: integer
productView.currencyCode: string 		price: {
object (Price)
} 		ระบบจะผสานช่องจำนวนเงิน Micro และช่องสกุลเงินเป็นช่องเดียวที่มีPriceประเภท
priceCompetitiveness.countryCode: สตริง reportCountryCode: สตริง เปลี่ยนชื่อฟิลด์ countryCode เป็น reportCountryCode
priceCompetitiveness.benchmarkPriceMicros: integer
priceCompetitiveness.benchmarkPriceCurrencyCode: string 		benchmarkPrice: {
object (Price)
} 		ระบบจะผสานช่องจำนวนเงิน Micro และช่องสกุลเงินเป็นช่องเดียวที่มี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 conversion sources management
ถัดไป
Migrate local feeds partnership management