মার্চেন্ট এপিআই পারফরম্যান্স রিপোর্ট প্রদান করে, যেমন product_performance_view । এই পৃষ্ঠায় পারফরম্যান্স রিপোর্টের কাঠামো ব্যাখ্যা করা হয়েছে।
মেট্রিক্স
আপনি যে মেট্রিকগুলো (যেমন, clicks এবং impressions ) ফেরত পেতে চান, সেগুলোর জন্য কোয়েরি করতে পারেন। পারফরম্যান্স ডেটার জন্য রিপোর্টস সার্ভিসে কোয়েরি করতে হলে আপনাকে অবশ্যই তারিখের পরিসরের উপর একটি ফিল্টার যোগ করতে হবে।
এখানে একটি নমুনা কোয়েরি দেওয়া হলো, যা নির্দিষ্ট তারিখের পরিসরের মধ্যে মোট ক্লিকের সংখ্যাসহ একটিমাত্র সারি ফেরত দেয়:
SELECT clicks
FROM product_performance_view
WHERE date BETWEEN '2023-12-01' AND '2023-12-21'
আপনি যে ডেটা ফেরত পেতে চান তা অবশ্যই নির্দিষ্ট করে দিতে হবে। ওয়াইল্ডকার্ড (উদাহরণস্বরূপ, SELECT * ) ব্যবহার করলে একটি ত্রুটি দেখা দেবে।
নিম্নলিখিত নমুনা প্রতিক্রিয়া থেকে দেখা যায় যে, বণিকটি ১লা ডিসেম্বর, ২০২৩ থেকে ২১শে ডিসেম্বর, ২০২৩-এর মধ্যে সমস্ত পণ্য এবং সমস্ত বিপণন পদ্ধতি জুড়ে মোট ৪,৪৪০টি ক্লিক পেয়েছে।
{
"results": [
{
"productPerformanceView": {
"clicks": "4440"
}
}
]
}
সেগমেন্ট
পারফরম্যান্স রিপোর্টে বিভাজনের জন্য আপনি সেগমেন্ট ফিল্ড ব্যবহার করতে পারেন। উদাহরণস্বরূপ, marketing_method লিখে কোয়েরি করলে এমন একটি রিপোর্ট পাওয়া যায়, যেখানে প্রতিটি মার্কেটিং মেথডের জন্য একটি করে সারি এবং SELECT ক্লজে সেই মার্কেটিং মেথডের জন্য আপনার নির্দিষ্ট করা মেট্রিকগুলো থাকে।
সেগমেন্ট ফিল্ডগুলো প্রোডাক্ট অ্যাট্রিবিউট (যেমন, offer_id , brand , এবং category ) অথবা ইভেন্ট অ্যাট্রিবিউট (যেমন, date এবং marketing_method ) হতে পারে।
সেগমেন্ট ফিল্ডগুলো SQL-এর GROUP BY এর মতোই কাজ করে। সেগমেন্ট ফিল্ডগুলো SELECT ক্লজে প্রতিটি সেগমেন্ট অনুযায়ী নির্বাচিত মেট্রিকগুলোকে বিভক্ত করে গ্রুপ তৈরি করে।
এখানে একটি নমুনা কোয়েরি দেওয়া হলো যা একটি নির্দিষ্ট তারিখের পরিসরের শর্ত সাপেক্ষে, clicks অনুযায়ী দৈনিক ক্লিকের সংখ্যাকে অবরোহী ক্রমে ফেরত দেয়। শুধুমাত্র সেই সারিগুলোই ফেরত দেওয়া হয়, যেখানে অনুরোধ করা অন্তত একটি মেট্রিকের মান অশূন্য।
SELECT
date,
clicks
FROM product_performance_view
WHERE date BETWEEN '2023-12-01' AND '2023-12-03'
ORDER BY clicks DESC
নিম্নলিখিত নমুনা প্রতিক্রিয়া থেকে দেখা যায় যে, ২০২৩ সালের ১লা ডিসেম্বর তারিখে মার্চেন্টের সমস্ত পণ্য জুড়ে, সমস্ত বিপণন পদ্ধতি ব্যবহার করে ১,৫৪৬টি ক্লিক হয়েছিল এবং ২০২৩ সালের ২রা ডিসেম্বর তারিখে সমস্ত পণ্য জুড়ে, সমস্ত বিপণন পদ্ধতি ব্যবহার করে ৮২৯টি ক্লিক হয়েছিল। ২০২৩ সালের ৩রা ডিসেম্বর তারিখে মার্চেন্টের কোনো ক্লিক হয়নি, তাই সেই তারিখের জন্য কোনো তথ্য ফেরত দেওয়া হয়নি।
{
"results": [
{
"productPerformanceView": {
"date": {
"year": 2023,
"month": 12,
"day": 1
},
"clicks": "1546"
}
},
{
"productPerformanceView": {
"date": {
"year": 2023,
"month": 12,
"day": 2
},
"clicks": "829"
}
}
]
}
মার্চেন্ট সেন্টারের কাস্টম রিপোর্টের মতোই, মার্চেন্ট রিপোর্টস এপিআই ব্যবহার করে আপনি একই কোয়েরিতে একাধিক সেগমেন্ট নির্দিষ্ট করতে পারেন।
এখানে একটি নমুনা কোয়েরি দেওয়া হলো যা আপনার অ্যাকাউন্টের সমস্ত পণ্যের জন্য ৩০ দিনের সময়কালে প্রাপ্ত ক্লিকগুলো, marketing_method এবং offer_id অনুযায়ী ভাগ করে, ফেরত দেয়:
SELECT marketing_method, offer_id, clicks
FROM product_performance_view
WHERE date BETWEEN '2023-11-01' AND '2023-11-30'
এই কোয়েরির প্রতিক্রিয়ায় offer_id এবং marketing_method এর প্রতিটি সমন্বয়ের জন্য একটি করে সারি থাকে, যেখানে সেই সমন্বয়ের জন্য ক্লিকের সংখ্যা উল্লেখ করা থাকে:
{
"results": [
{
"productPerformanceView": {
"marketingMethod": "ADS",
"offerId": "12345",
"clicks": "38"
}
},
{
"productPerformanceView": {
"marketingMethod": "ADS",
"offerId": "12346",
"clicks": "125"
}
},
{
"productPerformanceView": {
"marketingMethod": "ORGANIC",
"offerId": "12346",
"clicks": "23"
}
},
{
"productPerformanceView": {
"marketingMethod": "ADS",
"offerId": "12347",
"clicks": "8"
}
},
{
"productPerformanceView": {
"marketingMethod": "ORGANIC",
"offerId": "12347",
"clicks": "3"
}
}
]
}
বিভাগ এবং পণ্যের ধরণ
মার্চেন্ট সেন্টার কোয়েরি ল্যাঙ্গুয়েজ আপনার ইনভেন্টরিকে সংগঠিত করার জন্য সংজ্ঞায়িত করতে পারেন এমন দুই ধরনের অ্যাট্রিবিউটের মাধ্যমে মেট্রিকগুলোকে বিভক্ত করা সমর্থন করে:
- বিভাগের স্তর
- গুগলের পণ্য শ্রেণিবিন্যাস থেকে বিভাগসমূহ। যদি কোনো বিভাগ প্রদান করা না হয়, গুগল আপনার পণ্যের জন্য স্বয়ংক্রিয়ভাবে একটি বিভাগ নির্ধারণ করে দিতে পারে, অথবা প্রদত্ত বিভাগটিকে আরও পরিমার্জন করতে পারে।
- পণ্যের প্রকারের স্তর
- আপনার শ্রেণিবিন্যাসের উপর ভিত্তি করে আপনি যে পণ্যের প্রকারভেদগুলো নির্ধারণ করেন । ক্যাটাগরি লেভেলের মতো, এখানে সমর্থিত মানের কোনো পূর্বনির্ধারিত সেট নেই।
ক্যাটাগরি এবং প্রোডাক্ট টাইপ উভয় অ্যাট্রিবিউটই একাধিক স্তরবিশিষ্ট একটি ক্রমবিন্যাসে সাজানো থাকে। প্রোডাক্ট স্পেসিফিকেশনে প্রতিটি স্তরকে > চিহ্ন দিয়ে আলাদা করা হয়, কিন্তু রিপোর্টে আপনি এই ক্রমবিন্যাসের প্রতিটি স্তর আলাদাভাবে নির্বাচন করেন।
উদাহরণস্বরূপ, নিম্নলিখিত পণ্যের প্রকার স্তর সহ একটি পণ্য বিবেচনা করুন:
Home & Garden > Kitchen & Dining > Kitchen Appliances > Refrigerators
রিপোর্টগুলো প্রতিটি স্তরকে তার নিজস্ব ক্ষেত্রে ফেরত দেয়:
| সেগমেন্ট | মূল্য |
|---|---|
product_type_l1 | Home & Garden |
product_type_l2 | Kitchen & Dining |
product_type_l3 | Kitchen Appliances |
product_type_l4 | Refrigerators |
মুদ্রা এবং মূল্য মেট্রিক্স
প্রাইস মেট্রিক, যেমন conversion_value , Price টাইপ ব্যবহার করে উপস্থাপন করা হয়। যদি মেট্রিকটি একাধিক মুদ্রায় উপলব্ধ থাকে, তাহলে প্রতিটি মুদ্রার মান একটি পৃথক সারিতে ফেরত দেওয়া হয়। উদাহরণস্বরূপ, নিম্নলিখিত কোয়েরিটি:
SELECT conversion_value
FROM product_performance_view
WHERE date = '2023-11-01'
নিম্নলিখিত ফলাফলগুলি ফেরত দেয়:
{
"results": [
{
"productPerformanceView": {
"conversionValue": {
"amountMicros": "150000000",
"currencyCode": "USD"
}
}
},
{
"productPerformanceView": {
"conversionValue": {
"amountMicros": "70000000",
"currencyCode": "CAD"
}
}
}
]
}
যদি আপনি একটি কোয়েরিতে প্রাইস এবং নন-প্রাইস উভয় মেট্রিকের জন্য অনুরোধ করেন, তাহলে প্রাইস মেট্রিকগুলো নন-প্রাইস মেট্রিক থেকে আলাদা ফলাফল সারিতে ফেরত দেওয়া হয়, প্রতিটি কারেন্সি কোডের জন্য একটি করে ফলাফল সারি। উদাহরণস্বরূপ, নিম্নলিখিত কোয়েরিটি:
SELECT conversions, conversion_value
FROM product_performance_view
WHERE date = '2020-11-01'
নিম্নলিখিত প্রতিক্রিয়া প্রদান করে:
{
"results": [
{
"productPerformanceView": {
"conversions": "27",
"conversionValue": {
"amountMicros": "0",
"currencyCode": ""
}
}
},
{
"productPerformanceView": {
"conversions": "0",
"conversionValue": {
"amountMicros": "150000000",
"currencyCode": "USD"
}
}
},
{
"productPerformanceView": {
"conversions": "0",
"conversionValue": {
"amountMicros": "70000000",
"currencyCode": "CAD"
}
}
}
]
}
আপনার নির্বাচিত সমস্ত ফিল্ডই রেসপন্সে ফেরত আসে, এমনকি যদি সেগুলোর মান ডিফল্ট মান বা শূন্যও থাকে।
কোয়েরির জন্য উপলব্ধ ফিল্ডগুলো সম্পর্কে আরও তথ্যের জন্য, productPerformanceView টেবিলের ফিল্ডসমূহ দেখুন।