Merchant API পারফরম্যান্স রিপোর্ট অফার করে, উদাহরণস্বরূপ product_performance_view । এই পৃষ্ঠাটি কর্মক্ষমতা প্রতিবেদনের গঠন ব্যাখ্যা করে।
মেট্রিক্স
আপনি মেট্রিক্সের জন্য প্রশ্ন করতে পারেন (উদাহরণস্বরূপ, clicks এবং impressions ) যা আপনি ফেরত দিতে চান। পারফরম্যান্স ডেটার জন্য রিপোর্ট পরিষেবাকে জিজ্ঞাসা করতে আপনাকে অবশ্যই তারিখের পরিসরে একটি ফিল্টার যোগ করতে হবে৷
এখানে একটি নমুনা ক্যোয়ারী রয়েছে যা নির্দিষ্ট তারিখ সীমার মধ্যে ক্লিকের মোট সংখ্যা সহ একটি একক সারি প্রদান করে:
SELECT clicks
FROM product_performance_view
WHERE date BETWEEN '2023-12-01' AND '2023-12-21'
আপনি যে ডেটা ফেরত দিতে চান তা অবশ্যই উল্লেখ করতে হবে। ওয়াইল্ডকার্ড (উদাহরণস্বরূপ, SELECT * ) একটি ত্রুটি প্রদান করে।
নিম্নলিখিত নমুনা প্রতিক্রিয়া দেখায় যে মার্চেন্ট 1লা ডিসেম্বর, 2023 এবং 21শে ডিসেম্বর, 2023 এর মধ্যে সমস্ত পণ্য জুড়ে, সমস্ত বিপণন পদ্ধতিতে মোট 4,440টি ক্লিক করেছে৷
{
"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
নিম্নলিখিত নমুনা প্রতিক্রিয়া দেখায় যে মার্চেন্ট 1লা ডিসেম্বর, 2023 তারিখে সমস্ত পণ্য জুড়ে, সমস্ত বিপণন পদ্ধতিতে 1,546টি ক্লিক করেছিল এবং 2রা ডিসেম্বর, 2023 তারিখে সমস্ত পণ্য, সমস্ত বিপণন পদ্ধতিতে 829টি ক্লিক করেছিল৷ বণিকের কোন ক্লিক ছিল না 3রা ডিসেম্বর, 2023, তাই সেই তারিখের জন্য কিছুই ফেরত দেওয়া হয় না।
{
"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 দ্বারা বিভক্ত, 30-দিনের সময়কালে আপনার অ্যাকাউন্টের সমস্ত পণ্যের জন্য ক্লিকগুলি ফেরত দেয়:
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"
}
}
]
}
বিভাগ এবং পণ্যের ধরন
বণিক কেন্দ্রের ক্যোয়ারী ল্যাঙ্গুয়েজ মেট্রিক্সকে দুটি গ্রুপের বৈশিষ্ট্য দ্বারা বিভক্ত করা সমর্থন করে যা আপনি আপনার ইনভেন্টরি সংগঠিত করতে সংজ্ঞায়িত করতে পারেন:
- ক্যাটাগরি লেভেল
- 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"
}
}
}
]
}
আপনার নির্বাচন করা সমস্ত ক্ষেত্র প্রতিক্রিয়াতে ফিরে আসে, এমনকি যদি তাদের মান এখনও ডিফল্ট মান বা শূন্য হয়।