Shopping के लिए Content API से रिपोर्टिंग माइग्रेट करना

Merchant Reports API का इस्तेमाल करके, अपने प्रॉडक्ट, उनकी परफ़ॉर्मेंस, और Google पर उनके कॉम्पटिटिव एनवायरमेंट के बारे में जानें. इसके लिए, Merchant Reports API के डेटा व्यू का इस्तेमाल करें.

Merchant Reports API का इस्तेमाल करके, ये काम किए जा सकते हैं:

Merchant Reports API को, Content API for Shopping के मौजूदा वर्शन के साथ इंटिग्रेट करने का तरीका यहां बताया गया है.

अनुरोध

Merchant Center Reports API के लिए, अनुरोध यूआरएल के इस फ़ॉर्मैट का इस्तेमाल करें:

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

यहां search अनुरोधों के लिए, Content API for Shopping और Merchant Reports API की तुलना का सैंपल दिया गया है:

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}

तरीके

ReportService.Search तरीका इस्तेमाल करके, Merchant Reports API से क्वेरी की जा सकती है.

व्यू

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"
  }
}

टेबल के नाम का इस्तेमाल, फ़ील्ड के प्रीफ़िक्स के तौर पर किया जा सकता है. उदाहरण के लिए, Merchant API क्वेरी में offer_id और product_performance_view.offer_id, दोनों को स्वीकार किया जाता है.

परफ़ॉर्मेंस

Merchant Center 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,
… 		ये काम नहीं करते हैं Merchant Reports API में, 'Google पर खरीदें' की मेट्रिक काम नहीं करतीं

मार्केटिंग के तरीके की नई वैल्यू

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 Center 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 Center 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 Center के 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 Center Reports API में, सबसे ज़्यादा बिकने वाले प्रॉडक्ट और ब्रैंड के व्यू के लिए क्या बदलाव हुए हैं, इस बारे में यहां बताया गया है:

Content API Merchant API ब्यौरा
bestSellers.countryCode: स्ट्रिंग reportCountryCode: स्ट्रिंग countryCode फ़ील्ड का नाम बदलकर reportCountryCode कर दिया गया है
bestSellers.categoryId: int reportCategoryId: int categoryId फ़ील्ड का नाम बदलकर reportCategoryId कर दिया गया है

आपके जैसे दूसरे कारोबारों की परफ़ॉर्मेंस

Merchant Center 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