কেনাকাটার জন্য সামগ্রী API থেকে রিপোর্টিং স্থানান্তর করুন৷

শপিং বাস্তবায়নের জন্য আপনি কীভাবে আপনার বিদ্যমান সামগ্রী API-এর সাথে বণিক প্রতিবেদন API-কে একীভূত করতে পারেন তা এখানে।

অনুরোধ

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

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

এখানে search অনুরোধের জন্য বণিক প্রতিবেদন API-এর সাথে কেনাকাটার জন্য সামগ্রী API-এর একটি নমুনা তুলনা করা হল:

বিষয়বস্তু API বণিক API
URL https://shoppingcontent.googleapis.com/content/v2.1/ {MERCHANT_ID} /reports/search https://merchantapi.googleapis.com/reports/v1beta/ {PARENT} /reports:search
শনাক্তকারী {MERCHANT_ID} {PARENT}

পদ্ধতি

আপনি ReportService.Search পদ্ধতিতে কল করে মার্চেন্ট রিপোর্ট এপিআই জিজ্ঞাসা করতে পারেন।

ভিউ

Merchant API-এ, টেবিলের নাম CammelCase থেকে snake_case এ পরিবর্তিত হয়।

MerchantPerformanceView এখন product_performance_view

এখানে কেনাকাটার জন্য সামগ্রী API এবং মার্চেন্ট API-এ টেবিলের নামের মধ্যে একটি ম্যাপিং রয়েছে:

বিষয়বস্তু API বণিক 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

মার্চেন্ট এপিআই-এ, একটি ফিল্ড প্রিফিক্স উল্লেখ করা, উদাহরণস্বরূপ, segments.offer_id আর প্রয়োজন নেই। পরিবর্তে, শুধুমাত্র ক্ষেত্রের নাম, offer_id ব্যবহার করুন।

শপিং এবং মার্চেন্ট এপিআই-এর জন্য কন্টেন্ট এপিআই-এর প্রশ্নের নমুনা তুলনা করা হল:

বিষয়বস্তু API বণিক 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 বণিক API
{
  "segments":{
    "offerId":"abc"
  },
  "metrics":{
    "clicks":"123"
  }
}
{
  "productPerformanceView" : {
    "offerId": "abc",
    "clicks": "123"
  }
}

টেবিলের নামটি একটি ক্ষেত্রের উপসর্গ হিসাবে ব্যবহার করা যেতে পারে। যেমন, offer_id এবং product_performance_view.offer_id উভয়ই মার্চেন্ট API ক্যোয়ারীতে গৃহীত হয়।

কর্মক্ষমতা

মার্চেন্ট রিপোর্ট এপিআই-এ পারফরম্যান্স ভিউয়ের জন্য কী পরিবর্তন করা হয়েছে তা এখানে:

বিষয়বস্তু API বণিক 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 মেট্রিক্স মার্চেন্ট রিপোর্ট API-এ সমর্থিত নয়

নতুন বিপণন পদ্ধতি মান

এখানে segments.program এবং marketing_method মানগুলির মধ্যে ম্যাপিং রয়েছে:

বিষয়বস্তু API বণিক API
SHOPPING_ADS ADS
FREE_PRODUCT_LISTING ORGANIC
FREE_LOCAL_PRODUCT_LISTING ORGANIC
BUY_ON_GOOGLE_LISTING সমর্থিত নয়

পণ্য

বণিক প্রতিবেদন API-এ পণ্য দেখার জন্য কী পরিবর্তন করা হয়েছে তা এখানে:

বিষয়বস্তু API বণিক 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 ক্ষেত্র চালু করা হয়েছে

মূল্য অন্তর্দৃষ্টি

মার্চেন্ট রিপোর্ট এপিআই-এ দামের ইনসাইট ভিউয়ের জন্য কী পরিবর্তন করা হয়েছে তা এখানে রয়েছে:

বিষয়বস্তু API বণিক 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 : স্ট্রিং
সমর্থিত নয় স্থূল লাভের পরিবর্তন সম্পর্কিত ক্ষেত্রগুলি মার্চেন্ট রিপোর্ট API-এ সমর্থিত নয়৷

মূল্য প্রতিযোগিতা

মার্চেন্ট রিপোর্ট এপিআই-এ মূল্য প্রতিযোগিতার দৃশ্যের জন্য কী পরিবর্তন করা হয়েছে তা এখানে:

বিষয়বস্তু API বণিক 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 প্রকারের সাথে একটি ক্ষেত্রে একত্রিত হয়

সেরা বিক্রেতা

মার্চেন্ট রিপোর্ট এপিআই-এ সেরা বিক্রেতার ভিউগুলির জন্য কী পরিবর্তন করা হয়েছে তা এখানে রয়েছে:

বিষয়বস্তু API বণিক API বর্ণনা
bestSellers.countryCode : স্ট্রিং reportCountryCode : স্ট্রিং countryCode ক্ষেত্রের নাম পরিবর্তন করে reportCountryCode করা হয়েছে
bestSellers.categoryId : int reportCategoryId : int categoryId ক্ষেত্রের নাম পরিবর্তন করে reportCategoryId করা হয়েছে

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

মার্চেন্ট রিপোর্ট API-এ প্রতিযোগিতামূলক দৃশ্যমানতার জন্য কী পরিবর্তন করা হয়েছে তা এখানে:

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