ต่อไปนี้เป็นวิธีผสานรวม 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 | 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 กับ Merchant 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 กับ Merchant 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" } } |
ชื่อตารางใช้เป็นคำนำหน้าช่องได้ เช่น คำค้นหา Merchant API ยอมรับทั้ง offer_id
และ product_performance_view.offer_id
การแสดง
มุมมองประสิทธิภาพใน Merchant Reports API มีการเปลี่ยนแปลงดังนี้
Content API | API ผู้ขาย | คำอธิบาย |
segments.program : สตริง
|
marketing_method : สตริง
|
program กลุ่มถูกแทนที่ด้วยช่อง marketing_method ใหม่ โปรดดูรายละเอียดในค่า marketing method ใหม่
|
metrics.ctr : ดับเบิล
|
clickThroughRate : ดับเบิล
|
เปลี่ยนชื่อเมตริก ctr เป็น clickThroughRate แล้ว
|
metrics.conversionValueMicros : จำนวนเต็ม
segments.currencyCode : สตริง
|
conversionValue: {
|
ระบบรวมช่องจำนวนไมโครและสกุลเงินไว้ในช่องเดียวโดยมีประเภท Price
|
metrics.orders,
|
ไม่รองรับ | 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: {
|
ระบบรวมช่องจำนวนไมโครและสกุลเงินไว้ในช่องเดียวโดยมีประเภท Price
|
productView.aggregated_destination_status : สตริง
|
aggregated_reporting_context_status : สตริง
|
ช่อง aggregated_destination_status เปลี่ยนชื่อเป็น aggregated_reporting_context_status แล้ว ค่าดังกล่าวยังไม่มีการเปลี่ยนแปลง
|
productView.item_issues: [
|
item_issues: [
|
มีการเปลี่ยนแปลงคำจำกัดความของ 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: {
|
ระบบรวมช่องจำนวนไมโครและสกุลเงินไว้ในช่องเดียวโดยมีประเภท Price
|
priceInsights.suggestedPriceMicros : จำนวนเต็ม
priceInsights.suggestedPriceCurrencyCode : สตริง
|
suggestedPrice: {
|
ระบบรวมช่องจำนวนไมโครและสกุลเงินไว้ในช่องเดียวโดยมีประเภท Price
|
priceInsights.predictedGrossProfitChangeFraction : คู่
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: {
|
ระบบรวมช่องจำนวนไมโครและสกุลเงินไว้ในช่องเดียวโดยมีประเภท Price
|
priceCompetitiveness.countryCode : สตริง
|
reportCountryCode : สตริง
|
ช่อง countryCode เปลี่ยนชื่อเป็น reportCountryCode แล้ว
|
priceCompetitiveness.benchmarkPriceMicros : จำนวนเต็ม
priceCompetitiveness.benchmarkPriceCurrencyCode : สตริง
|
benchmarkPrice: {
|
ระบบรวมช่องจำนวนไมโครและสกุลเงินไว้ในช่องเดียวโดยมีประเภท 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 แล้ว
|