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

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

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

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

अनुरोध

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

POST https://merchantapi.googleapis.com/reports/v1/{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/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"
  }
}

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

परफ़ॉर्मेंस

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: integer
segments.currencyCode: string 		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 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: डबल
priceInsights.predictedMonthlyGrossProfitChangeMicros: पूर्णांक
priceInsights.predictedMonthlyGrossProfitChangeCurrencyCode: स्ट्रिंग 		ये काम नहीं करते हैं 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: पूर्णांक reportCategoryId: पूर्णांक categoryId फ़ील्ड का नाम बदलकर reportCategoryId कर दिया गया है

पीछे जाएं
Migrate products management
आगे बढ़ें
Migrate data sources management