Content API for Shopping থেকে রিপোর্টিং মাইগ্রেট করা

আপনি Merchant Reports API ব্যবহার করে আপনার প্রোডাক্ট, সেগুলির পারফর্ম্যান্স এবং Google-এ সেগুলির প্রতিযোগিতামূলক পরিবেশ সম্পর্কে জানতে পারবেন। এর জন্য আপনাকে ডেটা ভিউ দেখতে হবে।

আপনি Merchant Reports API ব্যবহার করে নিম্নলিখিত কাজগুলি করতে পারবেন:

আপনার আগে থেকে থাকা Content API for Shopping ইমপ্লিমেন্টেশনের সাথে Merchant Reports API কীভাবে ইন্টিগ্রেট করবেন তা এখানে দেওয়া হল।

অনুরোধ

Merchant Reports API-এর জন্য নিম্নলিখিত অনুরোধের URL ফর্ম্যাট ব্যবহার করুন:

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

searchটি অনুরোধের জন্য Content API for Shopping-এর সাথে Merchant Reports API-এর তুলনামূলক স্যাম্পেল এখানে দেওয়া হল:

কন্টেন্ট API Merchant API
ইউআরএল 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-এর মধ্যে টেবিলের নামের ম্যাপিং এখানে দেওয়া হল:

কন্টেন্ট 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-তে কোয়েরির একটি স্যাম্পেল তুলনা এখানে দেওয়া হল:

কন্টেন্ট 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
   

এখানে একটি নমুনা উত্তর দেওয়া হল:

কন্টেন্ট 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-তে পারফর্ম্যান্স ভিউয়ের জন্য কী কী পরিবর্তন করা হয়েছে তা এখানে দেওয়া হল:

কন্টেন্ট 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,
…
কাজ করে না Buy On Google মেট্রিক Merchant Reports API-তে কাজ করে না

নতুন মার্কেটিং পদ্ধতির ভ্যালু

segments.program এবং marketing_method ভ্যালুর মধ্যে ম্যাপিং এখানে দেওয়া হল:

কন্টেন্ট API Merchant API
SHOPPING_ADS ADS
FREE_PRODUCT_LISTING ORGANIC
FREE_LOCAL_PRODUCT_LISTING ORGANIC
BUY_ON_GOOGLE_LISTING কাজ করে না

প্রোডাক্ট

Merchant Reports API-তে প্রোডাক্ট ভিউয়ের জন্য কী কী পরিবর্তন করা হয়েছে তা এখানে দেওয়া হল:

কন্টেন্ট 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 Reports API-তে প্রাইস ইনসাইট ভিউতে কী কী পরিবর্তন করা হয়েছে তা এখানে দেওয়া হল:

কন্টেন্ট 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 Reports API-তে দামের প্রতিযোগিতামূলক ভিউতে কী কী পরিবর্তন করা হয়েছে তা এখানে দেওয়া হল:

কন্টেন্ট 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 Reports API-তে বেস্ট সেলার ভিউয়ের জন্য কী কী পরিবর্তন করা হয়েছে তা এখানে দেওয়া হল:

কন্টেন্ট API Merchant API বিবরণ
bestSellers.countryCode: স্ট্রিং reportCountryCode: স্ট্রিং countryCode ফিল্ডের নাম পরিবর্তন করে reportCountryCode করা হয়েছে
bestSellers.categoryId: ইন্টারসেপশন reportCategoryId: ইন্টারসেপশন categoryId ফিল্ডের নাম পরিবর্তন করে reportCategoryId করা হয়েছে

প্রতিযোগিতামূলক দৃশ্যমানতা

Merchant Reports API-তে কম্পিটিটিভ ভিজিবিলিটি ভিউতে কী কী পরিবর্তন করা হয়েছে তা এখানে দেওয়া হল:

কন্টেন্ট API Merchant API বিবরণ
competitiveVisibility.countryCode: স্ট্রিং reportCountryCode: স্ট্রিং countryCode ফিল্ডের নাম পরিবর্তন করে reportCountryCode করা হয়েছে
competitiveVisibility.categoryId: পূর্ণসংখ্যা reportCategoryId: পূর্ণসংখ্যা categoryId ফিল্ডের নাম পরিবর্তন করে reportCategoryId করা হয়েছে