Merchant 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": "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"
}
}
]
}
Merchant Center-এ কাস্টম রিপোর্টের মতো, আপনি Merchant Reports 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"
}
}
]
}
বিভাগ ও প্রোডাক্টের ধরন
Merchant Center কোয়েরি ভাষা অ্যাট্রিবিউটের দুটি গ্রুপ অনুযায়ী মেট্রিক ভাগ করার সুবিধা দেয়। আপনার ইনভেনটরি সাজানোর জন্য আপনি এই দুটি গ্রুপকে সংজ্ঞায়িত করতে পারেন:
- বিভাগের লেভেল
- Google-এর প্রোডাক্ট ট্যাক্সোনমি থেকে নেওয়া বিভাগ। আপনি কোনও বিভাগ উল্লেখ না করলে, Google অটোমেটিক আপনার প্রোডাক্টের জন্য বিভাগ অ্যাসাইন করতে পারে অথবা আপনার উল্লেখ করা বিভাগ আরও নির্দিষ্ট করতে পারে।
- প্রোডাক্টের ধরনের লেভেল
- প্রোডাক্টের ধরন যা আপনার শ্রেণিবিভাগের উপর ভিত্তি করে অ্যাসাইন করেন। বিভাগের লেভেলের মতো, সাপোর্ট করা ভ্যালুর কোনও প্রি-ডিফাইন করা সেট নেই।
বিভাগ ও প্রোডাক্টের ধরন সংক্রান্ত অ্যাট্রিবিউট, দুটিই একাধিক লেভেল সহ একটি অনুক্রমে
সাজানো থাকে। প্রোডাক্ট
স্পেসিফিকেশন প্রতিটি
লেভেলকে > অক্ষর দিয়ে আলাদা করে, তবে আপনি রিপোর্টে হায়ারার্কির প্রতিটি লেভেল
আলাদাভাবে বেছে নেন।
যেমন, নিম্নলিখিত প্রোডাক্ট টাইপ লেভেল সহ কোনও প্রোডাক্টের কথা বিবেচনা করুন:
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 টেবিলের ফিল্ড দেখুন।