শপিং বাস্তবায়নের জন্য আপনি কীভাবে আপনার বিদ্যমান সামগ্রী 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: { | পরিমাণ মাইক্রো এবং মুদ্রা ক্ষেত্র Price প্রকারের সাথে একটি ক্ষেত্রে একত্রিত হয় |
metrics.orders, | সমর্থিত নয় | 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: { | পরিমাণ মাইক্রো এবং মুদ্রা ক্ষেত্র Price প্রকারের সাথে একটি ক্ষেত্রে একত্রিত হয় |
productView.aggregated_destination_status : স্ট্রিং | aggregated_reporting_context_status : স্ট্রিং | aggregated_destination_status ক্ষেত্রটির নাম পরিবর্তন করে aggregated_reporting_context_status করা হয়েছে, মান পরিবর্তন হয়নি |
productView.item_issues: [ | item_issues: [ | ItemIssue সংজ্ঞা পরিবর্তিত হয়েছে |
সমর্থিত নয় | feedLabel : স্ট্রিং | feedLabel ক্ষেত্র চালু করা হয়েছে |
মূল্য অন্তর্দৃষ্টি
মার্চেন্ট রিপোর্ট এপিআই-এ দামের ইনসাইট ভিউয়ের জন্য কী পরিবর্তন করা হয়েছে তা এখানে রয়েছে:
বিষয়বস্তু API | বণিক API | বর্ণনা |
productView.id : স্ট্রিং | id : স্ট্রিং | ক্ষেত্রের বিন্যাস channel:language:targetCountry:offerId থেকে channel~language~feedLabel~offerId |
productView.priceMicros : পূর্ণসংখ্যাproductView.currencyCode : স্ট্রিং | price: { | পরিমাণ মাইক্রো এবং মুদ্রা ক্ষেত্র Price প্রকারের সাথে একটি ক্ষেত্রে একত্রিত হয় |
priceInsights.suggestedPriceMicros : পূর্ণসংখ্যাpriceInsights.suggestedPriceCurrencyCode : স্ট্রিং | suggestedPrice: { | পরিমাণ মাইক্রো এবং মুদ্রা ক্ষেত্র 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: { | পরিমাণ মাইক্রো এবং মুদ্রা ক্ষেত্র Price প্রকারের সাথে একটি ক্ষেত্রে একত্রিত হয় |
priceCompetitiveness.countryCode : স্ট্রিং | reportCountryCode : স্ট্রিং | countryCode ক্ষেত্রের নাম পরিবর্তন করে reportCountryCode করা হয়েছে |
priceCompetitiveness.benchmarkPriceMicros : পূর্ণসংখ্যাpriceCompetitiveness.benchmarkPriceCurrencyCode : স্ট্রিং | benchmarkPrice: { | পরিমাণ মাইক্রো এবং মুদ্রা ক্ষেত্র 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 করা হয়েছে |