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

ต่อไปนี้คือวิธีที่คุณสามารถผสานรวมรายงานผู้ขาย API กับ Content API ที่มีอยู่สำหรับ การใช้งาน Shopping

คำขอ

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

POST https://merchantapi.googleapis.com/reports/v1beta/{parent}/reports:search

ตัวอย่างการเปรียบเทียบ Content API for Shopping กับผู้ขายมีดังนี้ Reports API สำหรับคำขอ search:

Content API API ผู้ขาย
URL https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/reports/search https://merchantapi.googleapis.com/reports/v1beta/{parent}/reports:search
รหัสระบุ {merchantId} {parent}

เมธอด

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

ยอดดู

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

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

การแมประหว่างชื่อตารางใน Content API for Shopping กับ API ผู้ขาย:

Content API 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 และ API ผู้ขาย:

Content API 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 API ผู้ขาย 
{
  "segments":{
    "offerId":"abc"
  },
  "metrics":{
    "clicks":"123"
  }
}

{
  "productPerformanceView" : {
    "offerId": "abc",
    "clicks": "123"
  }
}

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

ประสิทธิภาพ

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

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

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

การแมประหว่างค่า segments.program ถึง marketing_method มีดังนี้

Content API API ผู้ขาย
SHOPPING_ADS ADS
FREE_PRODUCT_LISTING ORGANIC
FREE_LOCAL_PRODUCT_LISTING ORGANIC
BUY_ON_GOOGLE_LISTING ไม่รองรับ

ผลิตภัณฑ์

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

Content API 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 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: 2 เท่า วันที่
priceInsights.predictedMonthlyGrossProfitChangeMicros: จำนวนเต็ม วันที่
priceInsights.predictedMonthlyGrossProfitChangeCurrencyCode: สตริง 		ไม่รองรับ Merchant Reports API ไม่รองรับช่องที่เกี่ยวข้องกับการเปลี่ยนแปลงกำไรขั้นต้น

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

สิ่งที่เปลี่ยนแปลงในมุมมองความสามารถในการแข่งขันด้านราคาในรายงานผู้ขายมีดังนี้ API:

Content API 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: จำนวนเต็ม วันที่
priceCompetitiveness.benchmarkPriceCurrencyCode: สตริง 		benchmarkPrice: {
object (Price)
} 		ช่องจำนวนเงินระดับไมโครและสกุลเงินรวมเป็นช่องเดียวที่มีประเภท Price

สินค้าขายดี

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

Content API API ผู้ขาย คำอธิบาย
bestSellers.countryCode: สตริง reportCountryCode: สตริง ช่อง countryCode เปลี่ยนชื่อเป็น reportCountryCode แล้ว
bestSellers.categoryId: int reportCategoryId: int ช่อง categoryId เปลี่ยนชื่อเป็น reportCategoryId แล้ว

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

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

Content API API ผู้ขาย คำอธิบาย
competitiveVisibility.countryCode: สตริง reportCountryCode: สตริง ช่อง countryCode เปลี่ยนชื่อเป็น reportCountryCode แล้ว
competitiveVisibility.categoryId: จำนวนเต็ม reportCategoryId: จำนวนเต็ม ช่อง categoryId เปลี่ยนชื่อเป็น reportCategoryId แล้ว

ก่อนหน้า
ย้ายข้อมูลการจัดการแหล่งที่มาของ Conversion
ถัดไป
ย้ายข้อมูลการจัดการพาร์ทเนอร์ทางธุรกิจสำหรับฟีดในร้าน