ย้ายข้อมูลการรายงานจาก 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/v1beta/{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/v1beta/{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: integer
segments.currencyCode: string 		conversionValue: {
object (Price)
} 		ระบบจะผสานจำนวนเงิน Micro และช่องสกุลเงินเข้าเป็นช่องเดียวที่มีประเภท 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)
} 		ระบบจะผสานจำนวนเงิน Micro และช่องสกุลเงินเข้าเป็นช่องเดียวที่มีประเภท 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)
} 		ระบบจะผสานจำนวนเงิน 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: string id: string รูปแบบช่องเปลี่ยนจาก channel:language:targetCountry:offerId เป็น channel~language~feedLabel~offerId
productView.priceMicros: integer
productView.currencyCode: string 		price: {
object (Price)
} 		ระบบจะผสานจำนวนเงิน Micro และช่องสกุลเงินเข้าเป็นช่องเดียวที่มีประเภท Price
priceCompetitiveness.countryCode: string reportCountryCode: string เปลี่ยนชื่อช่อง countryCode เป็น reportCountryCode
priceCompetitiveness.benchmarkPriceMicros: integer
priceCompetitiveness.benchmarkPriceCurrencyCode: string 		benchmarkPrice: {
object (Price)
} 		ระบบจะผสานจำนวนเงิน Micro และช่องสกุลเงินเข้าเป็นช่องเดียวที่มีประเภท 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 conversion sources management
ถัดไป
Migrate local feeds partnership management