انتقال گزارش‌دهی از Content API for Shopping

می‌توانید از Merchant Reports API برای کسب اطلاعات درباره محصولاتتان، عملکرد آن‌ها، و محیط رقابتی آن‌ها در Google ازطریق نمای داده‌ای که ارائه می‌دهد استفاده کنید.

می‌توانید از Merchant Reports API برای انجام کارهای زیر استفاده کنید:

  • سنجش عملکرد محصولات: در Merchant API،‏ MerchantPerformanceView اکنون product_performance_view است.
  • محصولاتتان را براساس فیلدهای خاص فیلتر کنید: با Merchant API، می‌توانید براساس همه فیلدهای دردسترس فیلتر کنید، به‌جز item_issues.
  • بهبود قیمت‌گذاری محصول: با Merchant API، فیلدهای مقدار میکرو و واحد پول در یک فیلد با نوع Price ادغام می‌شوند.
  • درک بازار: با Merchant API، می‌توانید داده‌های مربوط به محصولات و نمانام‌های پرفروش، حد قیمت‌های رقابتی، پیشنهادهای قیمت فروش، و اطلاعات مربوط به چشم‌انداز رقابتی صنعت خود را دریافت کنید.
  • کاوش چشم‌انداز رقابتی: می‌توانید گزارشی دریافت کنید تا چشم‌انداز رقابتی خود را در سطح دسته محصول درک کنید و برای بهبود رؤیت‌پذیری خود اقدام کنید.

در اینجا نحوه ادغام Merchant Reports API با پیاده‌سازی Content API for Shopping موجودتان آورده شده است.

درخواست‌ها

از قالب نشانی وب درخواست زیر برای Merchant Reports API استفاده کنید:

POST https://merchantapi.googleapis.com/reports/v1/{PARENT}/reports:search

در اینجا نمونه‌ای از مقایسه Content API for Shopping با Merchant Reports API برای search درخواست آورده شده است:

میانای برنامه‌سازی کاربردی محتوا میانای برنامه‌سازی کاربردی فروشنده
نشانی وب https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/reports/search https://merchantapi.googleapis.com/reports/v1/{PARENT}/reports:search
شناسه‌ها {MERCHANT_ID} {PARENT}

روش‌ها

می‌توانید با فراخوانی روش ReportService.Search از Merchant Reports API پُرسمان کنید.

بازدیدها

در Merchant API، نام جدول‌ها از CamelCase به snake_case تغییر کرده است.

‫MerchantPerformanceView اکنون product_performance_view است.

در اینجا نگاشتی بین نام‌های جدول در Content API for Shopping و 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 آورده شده است:

میانای برنامه‌سازی کاربردی محتوا میانای برنامه‌سازی کاربردی فروشنده 
   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

در اینجا یک پاسخ نمونه آورده شده است:

میانای برنامه‌سازی کاربردی محتوا میانای برنامه‌سازی کاربردی فروشنده 
{
  "segments":{
    "offerId":"abc"
  },
  "metrics":{
    "clicks":"123"
  }
}
 
{
  "productPerformanceView" : {
    "offerId": "abc",
    "clicks": "123"
  }
}

نام جدول می‌تواند به‌عنوان پیشوند فیلد استفاده شود. برای مثال، هم offer_id و هم product_performance_view.offer_id در پُرسمان Merchant API پذیرفته می‌شوند.

عملکرد

آنچه برای نمای عملکرد در Merchant Reports 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 آمده است:

میانای برنامه‌سازی کاربردی محتوا میانای برنامه‌سازی کاربردی فروشنده
SHOPPING_ADS ADS
FREE_PRODUCT_LISTING ORGANIC
FREE_LOCAL_PRODUCT_LISTING ORGANIC
BUY_ON_GOOGLE_LISTING پشتیبانی نمی‌شود

محصول

آنچه برای نمای محصول در Merchant Reports 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 آورده شده است:

میانای برنامه‌سازی کاربردی محتوا میانای برنامه‌سازی کاربردی فروشنده شرح
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 آورده شده است:

میانای برنامه‌سازی کاربردی محتوا میانای برنامه‌سازی کاربردی فروشنده شرح
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 تغییر کرده است:

میانای برنامه‌سازی کاربردی محتوا میانای برنامه‌سازی کاربردی فروشنده شرح
bestSellers.countryCode: رشته reportCountryCode: رشته نام فیلد countryCode به reportCountryCode تغییر کرد
bestSellers.categoryId: قطع توپ reportCategoryId: قطع توپ نام فیلد categoryId به reportCategoryId تغییر کرد

رؤیت‌پذیری رقابتی

آنچه برای نماهای رؤیت‌پذیری رقابتی در Merchant Reports API تغییر کرده است:

میانای برنامه‌سازی کاربردی محتوا میانای برنامه‌سازی کاربردی فروشنده شرح
competitiveVisibility.countryCode: رشته reportCountryCode: رشته نام فیلد countryCode به reportCountryCode تغییر کرد
competitiveVisibility.categoryId: عدد صحیح reportCategoryId: عدد صحیح نام فیلد categoryId به reportCategoryId تغییر کرد

قبلی
Migrate products management
بعدی
Migrate data sources management