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

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

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

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

अनुरोध

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

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

search के अनुरोधों के लिए, Shopping के लिए Content API और 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 कहा जाता है.

Shopping के लिए Content API और 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 इस्तेमाल करें.

Shopping के लिए Content API और 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: double clickThroughRate: double 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: integer reportCategoryId: integer categoryId फ़ील्ड का नाम बदलकर reportCategoryId कर दिया गया है

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