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

إليك كيفية دمج تقارير التاجر. واجهة برمجة التطبيقات مع Content API for تنفيذ حملة Shopping:

الطلبات

استخدِم تنسيق عنوان URL التالي للطلب في Merchant Reports API:

POST https://merchantapi.googleapis.com/reports/v1beta/{parent}/reports:search

إليك نموذج مقارنة بين Content API for Shopping والتاجر واجهة برمجة التطبيقات لإعداد التقارير لطلبات search:

Content API واجهة برمجة تطبيقات التاجر
عنوان URL https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/reports/search https://merchantapi.googleapis.com/reports/v1beta/{parent}/reports:search
المعرفات {merchantId} {parent}

الطُرق

يمكنك الاستعلام عن Merchant Reports API من خلال طلب ReportService.Search .

المشاهدات

في Merchant API، يتم تغيير أسماء الجداول من CammelCase إلى snake_case.

تغيّر اسم MerchantPerformanceView ليصبح الآن product_performance_view.

في ما يلي ربط بين أسماء الجداول في Content API for Shopping واجهة برمجة تطبيقات التاجر:

Content 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 واجهة برمجة تطبيقات التاجر:

Content 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 واجهة برمجة تطبيقات التاجر 
{
  "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 واجهة برمجة تطبيقات التاجر الوصف
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 واجهة برمجة تطبيقات التاجر
SHOPPING_ADS ADS
FREE_PRODUCT_LISTING ORGANIC
FREE_LOCAL_PRODUCT_LISTING ORGANIC
BUY_ON_GOOGLE_LISTING غير متاح

المنتج

في ما يلي التغييرات التي طرأت على عرض المنتج في Merchant Reports API:

Content 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 واجهة برمجة تطبيقات التاجر الوصف
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.

تنافسية الأسعار

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

Content 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 واجهة برمجة تطبيقات التاجر الوصف
bestSellers.countryCode: سلسلة reportCountryCode: سلسلة تمت إعادة تسمية حقل "countryCode" إلى "reportCountryCode".
bestSellers.categoryId: تدخُّل دفاعي reportCategoryId: تدخُّل دفاعي تمت إعادة تسمية حقل "categoryId" إلى "reportCategoryId".

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

في ما يلي التغييرات التي أجريناها على طرق عرض مستوى الظهور التنافسي في Merchant Reports API:

Content API واجهة برمجة تطبيقات التاجر الوصف
competitiveVisibility.countryCode: سلسلة reportCountryCode: سلسلة تمت إعادة تسمية حقل "countryCode" إلى "reportCountryCode".
competitiveVisibility.categoryId: عدد صحيح reportCategoryId: عدد صحيح تمت إعادة تسمية حقل "categoryId" إلى "reportCategoryId".

السابق
إدارة مصادر الإحالات الناجحة
التالي
نقل بيانات إدارة الشراكة في الخلاصات المحلية