মার্চেন্ট API পারফরম্যান্স রিপোর্ট অফার করে, উদাহরণস্বরূপ 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": "4,440"
}
}
]
}
বিভাগ
পারফরম্যান্স রিপোর্টে সেগমেন্টেশনের জন্য আপনি সেগমেন্ট ফিল্ড ব্যবহার করতে পারেন। উদাহরণস্বরূপ, 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"
}
}
]
}
মার্চেন্ট সেন্টারের কাস্টম রিপোর্টের মতো, আপনি মার্চেন্ট রিপোর্ট API ব্যবহার করে একই কোয়েরিতে একাধিক সেগমেন্ট নির্দিষ্ট করতে পারেন।
এখানে একটি নমুনা কোয়েরি দেওয়া হল যা ৩০ দিনের মধ্যে আপনার অ্যাকাউন্টের সমস্ত পণ্যের ক্লিকের ফলাফল ফেরত দেয়, যা 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 টেবিলের ক্ষেত্রগুলি দেখুন।