نقل التقارير من Content API for Shopping

يمكنك استخدام Merchant Reports API للتعرّف على منتجاتك وأدائها وبيئة المنافسة على Google من خلال عرض البيانات الذي توفّره.

يمكنك استخدام Merchant Reports API لإجراء ما يلي:

  • قياس أداء منتجاتك: في Merchant API، أصبح MerchantPerformanceView الآن product_performance_view.
  • فلترة منتجاتك حسب حقول معيّنة: باستخدام Merchant API، يمكنك الفلترة استنادًا إلى جميع الحقول المتاحة، باستثناء item_issues.
  • تحسين أسعار المنتجات: باستخدام Merchant API، يتم دمج حقلَي "وحدات Micro" و"العملة" في حقل واحد من النوع Price.
  • فهم السوق: باستخدام Merchant 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: string marketing_method: string تم استبدال القسم program بالحقل الجديد marketing_method. اطّلِع على قيم marketing method الجديدة للحصول على التفاصيل.
metrics.ctr: مضاعفة clickThroughRate: مضاعفة تمت إعادة تسمية المقياس ctr ليصبح clickThroughRate
metrics.conversionValueMicros: integer
segments.currencyCode: string 		conversionValue: {
object (Price)
} 		يتم دمج حقلَي "المبلغ بالوحدات الصغيرة" و"العملة" في حقل واحد من النوع Price
metrics.orders,
metrics.orderedItems,
… 		غير متاح مقاييس "الشراء على Google" غير متاحة في Merchant Reports API

قيم طريقة التسويق الجديدة

في ما يلي عملية الربط بين قيمتَي 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)
} 		يتم دمج حقلَي "المبلغ بالوحدات الصغيرة" و"العملة" في حقل واحد من النوع 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: عدد صحيح
productView.currencyCode: سلسلة 		price: {
object (Price)
} 		يتم دمج حقلَي "المبلغ بالوحدات الصغيرة" و"العملة" في حقل واحد من النوع Price
priceInsights.suggestedPriceMicros: integer
priceInsights.suggestedPriceCurrencyCode: string 		suggestedPrice: {
object (Price)
} 		يتم دمج حقلَي "المبلغ بالوحدات الصغيرة" و"العملة" في حقل واحد من النوع Price
priceInsights.predictedGrossProfitChangeFraction: double
priceInsights.predictedMonthlyGrossProfitChangeMicros: integer
priceInsights.predictedMonthlyGrossProfitChangeCurrencyCode: string 		غير متاح لا تتوفّر الحقول ذات الصلة بتغيير إجمالي الأرباح في Merchant Reports API

مكانة السعر في المنافسة

في ما يلي التغييرات التي طرأت على طريقة عرض "مكانة السعر في المنافسة" في واجهة برمجة التطبيقات Merchant Reports:

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)
} 		يتم دمج حقلَي "المبلغ بالوحدات الصغيرة" و"العملة" في حقل واحد من النوع Price
priceCompetitiveness.countryCode: string reportCountryCode: string تمت إعادة تسمية الحقل countryCode ليصبح reportCountryCode.
priceCompetitiveness.benchmarkPriceMicros: integer
priceCompetitiveness.benchmarkPriceCurrencyCode: string 		benchmarkPrice: {
object (Price)
} 		يتم دمج حقلَي "المبلغ بالوحدات الصغيرة" و"العملة" في حقل واحد من النوع Price

الأكثر مبيعًا

في ما يلي التغييرات التي أجريناها على طرق عرض المنتجات الأكثر مبيعًا في Merchant Reports API:

Content API Merchant API الوصف
bestSellers.countryCode: string reportCountryCode: string تمت إعادة تسمية الحقل countryCode ليصبح reportCountryCode.
‫bestSellers.categoryId: عدد صحيح ‫reportCategoryId: عدد صحيح تمت إعادة تسمية الحقل 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