نقل التقارير من 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: عدد صحيح
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: string id: string يتغيّر تنسيق الحقل من channel:language:targetCountry:offerId إلى
channel~language~feedLabel~offerId
productView.priceMicros: عدد صحيح
productView.currencyCode: سلسلة 		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: عدد صحيح
priceInsights.suggestedPriceCurrencyCode: سلسلة 		suggestedPrice: {
object (Price)
} 		يتم دمج حقلَي "الفئات الصغيرة" و"العملة" في حقل واحد من النوع Price
priceInsights.predictedGrossProfitChangeFraction: double
priceInsights.predictedMonthlyGrossProfitChangeMicros: integer
priceInsights.predictedMonthlyGrossProfitChangeCurrencyCode: string 		غير متاح الحقول المتعلّقة بتغيير الأرباح الإجمالية غير متاحة في Merchant Reports API

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

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

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

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

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

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

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

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

السابق
Migrate products management
التالي
Migrate data sources management