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

व्यापारी/कंपनी की रिपोर्ट को इंटिग्रेट करने का तरीका यहां बताया गया है API इसके लिए आपके मौजूदा Content API के साथ Shopping को लागू करना.

अनुरोध

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

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

यहां Content API for Shopping की व्यापारी/कंपनी के साथ तुलना का उदाहरण दिया गया है search अनुरोधों के लिए रिपोर्ट एपीआई:

Content API मर्चेंट एपीआई
यूआरएल 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 का इस्तेमाल करें.

यहां Shopping के लिए Content API और मर्चेंट एपीआई:

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 Report 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 Report 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 Report API में, आपके जैसे दूसरे कारोबारों की परफ़ॉर्मेंस के बारे में बताने वाले व्यू में हुए बदलावों के बारे में यहां बताया गया है:

Content API मर्चेंट एपीआई ब्यौरा
competitiveVisibility.countryCode: स्ट्रिंग reportCountryCode: स्ट्रिंग countryCode फ़ील्ड का नाम बदलकर reportCountryCode किया गया
competitiveVisibility.categoryId: पूर्णांक reportCategoryId: पूर्णांक categoryId फ़ील्ड का नाम बदलकर reportCategoryId किया गया

पीछे जाएं
कन्वर्ज़न के सोर्स का मैनेजमेंट माइग्रेट करें
आगे बढ़ें
लोकल फ़ीड पार्टनरशिप मैनेजमेंट को माइग्रेट करना