نقل التقارير من 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/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: double clickThroughRate: double تمت إعادة تسمية مقياس 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: integer
productView.currencyCode: string 		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 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
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: int reportCategoryId: int تمت إعادة تسمية الحقل categoryId ليصبح reportCategoryId

معاينة أداء المنافسين

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

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

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