نقل التقارير من 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 الحالية.

الطلبات

استخدِم تنسيق عنوان 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، تم تغيير أسماء الجداول من CammelCase إلى 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: سلسلة 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:

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: سلسلة 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 Merchant 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: عدد مزدوج
priceInsights.predictedMonthlyGrossProfitChangeMicros: عدد صحيح
priceInsights.predictedMonthlyGrossProfitChangeCurrencyCode: سلسلة 		غير متاح الحقول المتعلّقة بتغيير إجمالي الأرباح غير متاحة في Merchant Reports API

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

في ما يلي التغييرات التي طرأت على عرض "مكانة السعر في المنافسة" في Merchant Reports API:

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

مستوى الظهور التنافسي

في ما يلي التغييرات التي تم إجراؤها على مشاهدات التنافسية حسب الظهور في Merchant Reports API:

Content API Merchant API الوصف
competitiveVisibility.countryCode: سلسلة reportCountryCode: سلسلة تمت إعادة تسمية الحقل countryCode ليصبح reportCountryCode.
competitiveVisibility.categoryId: عدد صحيح reportCategoryId: عدد صحيح تمت إعادة تسمية الحقل categoryId ليصبح reportCategoryId.

السابق
Migrate conversion sources management
التالي
Migrate local feeds partnership management