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}

तरीके

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

व्यू

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: 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: पूर्णांक reportCategoryId: पूर्णांक categoryId फ़ील्ड का नाम बदलकर reportCategoryId कर दिया गया है

पीछे जाएं
Migrate conversion sources management
आगे बढ़ें
Migrate local feeds partnership management