আপনি রিপোর্টিং সাব-API ব্যবহার করে Youtube অ্যাফিলিয়েট প্রোগ্রামে অংশগ্রহণকারী আপনার প্রোডাক্টের জন্য গুরুত্বপূর্ণ পারফর্ম্যান্স মেট্রিক রিট্রিভ করতে পারবেন। এই নির্দেশিকা থেকে আপনি জানতে পারবেন যে কীভাবে YouTube-নির্দিষ্ট অ্যাফিলিয়েট ডেটা কোয়েরি করতে হয়, যেমন বিভিন্ন ক্রিয়েটর, ভিডিও কন্টেন্ট, স্বতন্ত্র প্রোডাক্ট, প্রোডাক্ট বিভাগ এবং টার্গেট করা ক্যাম্পেনের সাথে সম্পর্কিত সেল, কমিশন, অর্ডার, ভিউ এবং ক্লিক।
YouTube অ্যাফিলিয়েট প্রোগ্রাম API এবং সংশ্লিষ্ট ডেটা ব্যবহারের ক্ষেত্রে আপনাকে YouTube Shopping ডেভেলপার নীতি মেনে চলতে হবে।
আপনি Merchant Center কোয়েরি ভাষা (MCQL) ব্যবহার করে নির্দিষ্ট YouTube অ্যাফিলিয়েট ভিউ থেকে মেট্রিক ও ডাইমেনশন বেছে নিতে পারবেন, যা আপনার কোয়েরিতে টেবিলের মতো কাজ করে।
পূর্বশর্ত
এই নির্দেশিকা ব্যবহার করার আগে, নিশ্চিত করুন যে:
- API কলকে যাচাই করার জন্য ব্যবহৃত অ্যাকাউন্টের পারফর্ম্যান্স ও ইনসাইট ভূমিকা আছে যা পারফর্ম্যান্স মেট্রিক অ্যাক্সেস করার অনুমতি দেয়।
- আপনার Google Merchant Center অ্যাকাউন্ট YouTube অ্যাফিলিয়েট প্রোগ্রামে অংশগ্রহণ করে।
আলফা এন্ডপয়েন্ট কোয়েরি করুন
এই ফিচারটি পাবলিক আলফা ভার্সনে থাকার কারণে, এন্ডপয়েন্ট আলাদা হয়। YouTube অ্যাফিলিয়েট পারফর্ম্যান্স ডেটা
পেতে, আপনাকে v1alpha এন্ডপয়েন্টে
পোস্ট রিকোয়েস্ট পাঠাতে হবে। রিপোর্ট ফিরিয়ে আনা সম্পর্কে আরও তথ্য পেতে, accounts.reports.search দেখুন।
এখানে অনুরোধের নমুনা দেওয়া হল:
HTTP
POST https://merchantapi.googleapis.com/reports/v1alpha/accounts/{ACCOUNT_ID}/reports:search
{
"query": "SELECT title, channel_id, gross_sales, net_sales, commissions, orders, clicks, views FROM youtube_creator_performance_view WHERE date >= '2025-05-01' AND date < '2025-05-02' ORDER BY gross_sales DESC LIMIT 3"
}
cURL
curl -X POST \
'https://merchantapi.googleapis.com/reports/v1alpha/accounts/{ACCOUNT_ID}/reports:search?key={YOUR_API_KEY}' \
--header 'Authorization: Bearer {YOUR_ACCESS_TOKEN}' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
"query": "SELECT title, channel_id, gross_sales, net_sales, commissions, orders, clicks, views FROM youtube_creator_performance_view WHERE date >= '\''2025-05-01'\'' AND date < '\''2025-05-02'\'' ORDER BY gross_sales DESC LIMIT 3"
}' \
--compressed
ক্রিয়েটর অনুযায়ী পারফর্ম্যান্স দেখা
কোন YouTube ক্রিয়েটর সবচেয়ে বেশি এনগেজমেন্ট ও বিক্রি বাড়াচ্ছেন তা বুঝতে, আপনি youtube_creator_performance_view-এ
কোয়েরি করতে পারেন।
এই ভিউ স্বতন্ত্র YouTube ক্রিয়েটরদের মেট্রিক একত্রিত করে এবং এতে
ক্রিয়েটরের নাম ও চ্যানেল আইডি অন্তর্ভুক্ত থাকে।
এখানে একটি MCQL SELECT স্টেটমেন্টের উদাহরণ দেওয়া হল যা আপনি
১ মে থেকে ২ মে, ২০২৫-এর মধ্যে বিক্রির ভিত্তিতে সেরা পারফর্ম করা ৩ জন ক্রিয়েটরকে পেতে ব্যবহার করতে পারেন:
SELECT title, channel_id, gross_sales, net_sales, commissions, orders, clicks, views FROM youtube_creator_performance_view WHERE date >= '2025-05-01' AND date < '2025-05-02' ORDER BY gross_sales DESC LIMIT 3
এই কোয়েরি নির্দিষ্ট তারিখের রেঞ্জের মধ্যে মোট বিক্রির মেট্রিক অনুযায়ী র্যাঙ্ক করা সেরা ৩ জন ক্রিয়েটরের ক্রিয়েটর টাইটেল, চ্যানেল আইডি ও মূল পারফর্ম্যান্স মেট্রিক ফেচ করে।
কন্টেন্ট অনুযায়ী পারফর্ম্যান্স দেখুন
কোন নির্দিষ্ট YouTube ভিডিও সবচেয়ে ভালো পারফর্ম করছে তা দেখতে, আপনি
youtube_content_performance_view
কোয়েরি করতে পারেন।
এই ভিউতে প্রতিটি YouTube ভিডিওর মেট্রিক একত্রিত করা হয় এবং এতে ভিডিওর নাম ও আইডি
অন্তর্ভুক্ত থাকে। মার্কেটপ্লেসের জন্য, এগুলি অন্তর্ভুক্ত করুন:
account_id স্বতন্ত্র সাব-সেলার
অ্যাকাউন্ট অনুযায়ী পারফর্ম্যান্সের ব্রেকডাউন। সাব-সেলার ও মার্কেটপ্লেস প্ল্যাটফর্মের
দ্বারা ফান্ড করা কমিশনের পরিমাণ দেখতে, seller_commissions ও
platform_commissions অন্তর্ভুক্ত করুন।
১ মে থেকে ২ মে, ২০২৫-এর মধ্যে ভিউয়ের ভিত্তিতে সেরা ৩টি ভিডিওর তথ্য পেতে,
accounts.reports.search
মেথডে নিম্নলিখিত MCQL স্টেটমেন্ট
পাস করুন:
SELECT title, video_id, account_id, gross_sales, net_sales, commissions, seller_commissions, platform_commissions, orders, clicks, views FROM youtube_content_performance_view WHERE date >= '2025-05-01' AND date < '2025-05-02' ORDER BY views DESC LIMIT 3
এই কোয়েরি ভিডিওর নাম, ভিডিও আইডি, সাব-সেলার অ্যাকাউন্ট আইডি
(account_id), মোট কমিশন (commissions),
সেলার-ফান্ডেড কমিশন (seller_commissions),
প্ল্যাটফর্ম-ফান্ডেড কমিশন (platform_commissions) এবং নির্দিষ্ট তারিখের রেঞ্জে
views-এর মোট সংখ্যার ভিত্তিতে র্যাঙ্ক করা সেরা ৩টি ভিডিওর অন্যান্য
গুরুত্বপূর্ণ মেট্রিক ফিরিয়ে আনে। মনে রাখবেন: ফলাফল ফিল্টার করতে
আপনি MCQL WHERE ক্লজে
account_id ব্যবহার করতে পারবেন না।
সবচেয়ে বেশি ইন্টার্যাকশন হয়েছে এমন ট্যাগ করা প্রোডাক্ট দেখুন
কোন ট্যাগ করা প্রোডাক্টে সবচেয়ে বেশি এনগেজমেন্ট ও বিক্রি হয়েছে তা বুঝতে,
আপনি
youtube_product_tagged_stats_view কোয়েরি করতে পারেন।
এই ভিউতে আলাদা আলাদা ট্যাগ করা প্রোডাক্টের মেট্রিক একত্রিত করা হয়, যার মধ্যে
সেগুলির নাম ও অফার আইডি অন্তর্ভুক্ত থাকে।
এখানে MCQL SELECT স্টেটমেন্টের একটি উদাহরণ দেওয়া হল যা আপনি
২০ ও ২১ জানুয়ারি, ২০২৬-এর মধ্যে ভিউয়ের ভিত্তিতে সেরা ১০টি প্রোডাক্ট পেতে ব্যবহার করতে পারেন:
SELECT title, offer_id, tagged_creator_count, tagged_video_count, gross_sales, net_sales, commissions, views, clicks, impressions, orders, conversion_rate FROM youtube_product_tagged_stats_view WHERE date >= '2026-01-20' AND date < '2026-01-21' ORDER BY views DESC LIMIT 10
এই কোয়েরি নির্দিষ্ট তারিখের রেঞ্জে মোট views-এর সংখ্যার ভিত্তিতে র্যাঙ্ক করা সেরা ১০টি প্রোডাক্টের
নাম, ট্যাগ করা ভিডিওর সংখ্যা এবং মূল মেট্রিক
উদ্ধার করে।
ট্যাগ করা প্রোডাক্টের বিভাগ অনুযায়ী পারফর্ম্যান্স দেখুন
কোন ট্যাগ করা প্রোডাক্ট বিভাগ সবচেয়ে বেশি এনগেজমেন্ট
ও বিক্রি বাড়ায় তা বুঝতে, youtube_product_category_tagged_stats_view কোয়েরি করুন।
এই ভিউ প্রোডাক্ট ট্যাক্সোনমিতে প্রোডাক্ট ক্যাটেগরি (product_type) অনুযায়ী মেট্রিক একত্রিত করে, যার মধ্যে প্রতিটি ক্যাটেগরিতে প্রোডাক্ট ট্যাগ করা
আলাদা আলাদা ক্রিয়েটর ও ভিডিওর সংখ্যাও
অন্তর্ভুক্ত।
১ সেপ্টেম্বর, ২০২৬-এ মোট বিক্রির ভিত্তিতে র্যাঙ্ক করা সেরা ১০টি ট্যাগ করা প্রোডাক্ট
ক্যাটাগরি পেতে, নিম্নলিখিত MCQL SELECT স্টেটমেন্ট ব্যবহার করুন:
SELECT product_type, tagged_creator_count, tagged_video_count, gross_sales, net_sales, commissions, views, clicks, impressions, orders, conversion_rate FROM youtube_product_category_tagged_stats_view WHERE date = '2026-09-01' ORDER BY gross_sales DESC LIMIT 10
এই কোয়েরি প্রোডাক্টের বিভাগ (product_type),
ট্যাগ করা ক্রিয়েটরের সংখ্যা, ট্যাগ করা ভিডিওর সংখ্যা এবং নির্দিষ্ট তারিখে gross_sales-এর মাধ্যমে র্যাঙ্ক করা সেরা ১০টি প্রোডাক্টের বিভাগের
জন্য পারফর্ম্যান্সের মূল মেট্রিক
উদ্ধার করে।
সবচেয়ে বেশি বিক্রি হওয়া প্রোডাক্ট দেখুন
কোন প্রোডাক্টের বিক্রি সবচেয়ে বেশি তা বুঝতে, আপনি
youtube_product_sold_stats_view কোয়েরি করতে পারেন।
এখানে একটি MCQL SELECT স্টেটমেন্টের উদাহরণ দেওয়া হল যা আপনি ২০ এবং ২১ জানুয়ারি, ২০২৬-এর মধ্যে
মোট বিক্রির ভিত্তিতে র্যাঙ্ক করা সেরা ১০টি প্রোডাক্টের তালিকা পেতে ব্যবহার করতে পারেন:
SELECT title, offer_id, gross_sales, net_sales, commissions, orders FROM youtube_product_sold_stats_view WHERE date >= '2026-01-20' AND date < '2026-01-21' ORDER BY gross_sales DESC LIMIT 10
এই কোয়েরি নির্দিষ্ট তারিখের রেঞ্জে মোট বিক্রির ভিত্তিতে অর্ডার করা সেরা ১০টি প্রোডাক্টের বিক্রির ডেটা, কমিশন ও মূল মেট্রিক খুঁজে বের করে।
সব ক্যাম্পেন জুড়ে পারফর্ম্যান্স দেখা
আপনার অ্যাফিলিয়েট ক্যাম্পেন সামগ্রিকভাবে কেমন পারফর্ম করছে তা বুঝতে, এই কোয়েরি
করুন:
youtube_campaigns_stats_view
এই ভিউতে ক্যাম্পেনের নাম, শুরু ও শেষ হওয়ার তারিখ, অ্যাক্টিভ ক্রিয়েটরের সংখ্যা এবং বিক্রি ও
এনগেজমেন্ট মেট্রিক সহ সব ক্যাম্পেন জুড়ে মেট্রিক
একত্রিত করা হয়।
২৩ এপ্রিল, ২০২৬-এ অর্ডার অনুযায়ী সেরা ১০টি
ক্যাম্পেন পেতে নিম্নলিখিত MCQL SELECT স্টেটমেন্ট ব্যবহার করুন:
SELECT campaign_id, campaign_name, start_date, end_date, active_creators, gross_sales, net_sales, commissions, views, clicks, impressions, orders, conversion_rate FROM youtube_campaigns_stats_view WHERE date = '2026-04-23' ORDER BY orders DESC LIMIT 10
এই কোয়েরি ক্যাম্পেন আইডি, ক্যাম্পেনের নাম, তারিখের রেঞ্জ, অ্যাক্টিভ
ক্রিয়েটরের সংখ্যা এবং সেরা ১০টি ক্যাম্পেনের জন্য মূল পারফর্ম্যান্স মেট্রিক ফিরিয়ে আনে
যা নির্দিষ্ট তারিখে মোট orders-এর সংখ্যা অনুযায়ী র্যাঙ্ক করা হয়।
ক্রিয়েটর অনুযায়ী ক্যাম্পেনের পারফর্ম্যান্স দেখুন
নির্দিষ্ট ক্যাম্পেনে অংশগ্রহণকারী স্বতন্ত্র ক্রিয়েটরদের পারফর্ম্যান্স বিশ্লেষণ করতে, youtube_individual_campaign_stats_view কোয়েরি করুন।
এই ভিউতে ক্যাম্পেনের মধ্যে ক্রিয়েটর পিছু মেট্রিক একত্রিত করা হয়, যার মধ্যে
চ্যানেলের নাম, ভিডিওর সংখ্যা এবং ট্যাগ করা প্রোডাক্টের নাম অন্তর্ভুক্ত থাকে।
SELECT MCQL স্টেটমেন্ট ব্যবহার করে ২৩ এপ্রিল, ২০২৬-এ নির্দিষ্ট ক্যাম্পেনের জন্য ভিউয়ের ভিত্তিতে সেরা ১০ জন ক্রিয়েটরের তালিকা পান:
SELECT channel_title, video_count, product_titles, gross_sales, net_sales, commissions, views, clicks, impressions, orders, conversion_rate FROM youtube_individual_campaign_stats_view WHERE date = '2026-04-23' AND campaign_id = 'YOUR_CAMPAIGN_ID' ORDER BY views DESC LIMIT 10
এই কোয়েরি ক্রিয়েটর চ্যানেলের নাম, ভিডিওর সংখ্যা, প্রোডাক্টের নাম এবং নির্দিষ্ট ক্যাম্পেন ও তারিখের মধ্যে মোট ভিউয়ের ভিত্তিতে র্যাঙ্ক করা সেরা ১০ জন ক্রিয়েটরের মূল পারফর্ম্যান্স মেট্রিক খুঁজে পায়।
ভিডিও অনুযায়ী ক্যাম্পেনের পারফর্ম্যান্স দেখা
কোনও ক্যাম্পেনে নির্দিষ্ট ক্রিয়েটরের ভিডিও কেমন পারফর্ম করছে তা দেখতে, youtube_campaign_videos_stats_view
কোয়েরি করুন।
এই ভিউতে কোনও ক্রিয়েটরের ক্যাম্পেনের
ভিডিও-লেভেল পারফর্ম্যান্স মেট্রিক দেখানো হয়, এর মধ্যে ভিডিওর নাম, ভিডিও ফর্ম্যাট ও ট্যাগ করা প্রোডাক্ট অন্তর্ভুক্ত।
২০ মে, ২০২৬-এ নির্দিষ্ট ক্রিয়েটর ও ক্যাম্পেনের জন্য ভিউয়ের ভিত্তিতে সেরা ১০টি ভিডিওর তালিকা পেতে
নিম্নলিখিত MCQL SELECT স্টেটমেন্ট ব্যবহার করুন:
SELECT video_title, content_type, product_titles, gross_sales, net_sales, commissions, views, clicks, impressions, orders, conversion_rate FROM youtube_campaign_videos_stats_view WHERE date = '2026-05-20' AND campaign_id = 'YOUR_CAMPAIGN_ID' AND channel_id = 'YOUR_CHANNEL_ID' ORDER BY views DESC LIMIT 10
এই কোয়েরি নির্দিষ্ট ক্রিয়েটর চ্যানেল, ক্যাম্পেন ও তারিখের জন্য মোট views-এর সংখ্যার ভিত্তিতে র্যাঙ্ক করা সেরা ১০টি ভিডিওর জন্য ভিডিওর নাম, ভিডিওর ফর্ম্যাট (content_type), ট্যাগ করা প্রোডাক্টের নাম ও পারফর্ম্যান্সের মূল মেট্রিক খুঁজে বের করে।
প্রোডাক্ট অনুযায়ী ক্যাম্পেন পারফর্ম্যান্স দেখুন
কোনও ক্যাম্পেনে স্বতন্ত্র প্রোডাক্ট কীভাবে পারফর্ম করছে তা বুঝতে,
youtube_campaign_products_stats_view
কোয়েরি করুন।
এই ভিউ ক্যাম্পেনের মধ্যে প্রোডাক্ট-লেভেল পারফর্ম্যান্স মেট্রিক প্রদান করে,
যার মধ্যে প্রোডাক্টের নাম, সংশ্লিষ্ট ভিডিওর বিবরণ এবং সেলস মেট্রিক অন্তর্ভুক্ত।
২০ জুন, ২০২৬-এ নির্দিষ্ট ক্যাম্পেনের জন্য ভিউয়ের ভিত্তিতে সেরা ১০টি প্রোডাক্ট
পেতে নিম্নলিখিত MCQL SELECT স্টেটমেন্ট ব্যবহার করুন:
SELECT channel_title, product_title, video_title, video_url, gross_sales, net_sales, commissions, views, clicks, impressions, orders, conversion_rate FROM youtube_campaign_products_stats_view WHERE date = '2026-06-20' AND campaign_id = 'YOUR_CAMPAIGN_ID' ORDER BY views DESC LIMIT 10
এই কোয়েরি ক্রিয়েটর চ্যানেলের নাম, প্রোডাক্টের নাম, ভিডিওর
নাম, ভিডিওর URL এবং নির্দিষ্ট
ক্যাম্পেন ও তারিখের মধ্যে views-এর মোট সংখ্যার
দ্বারা র্যাঙ্ক করা সেরা ১০টি প্রোডাক্টের মূল পারফর্ম্যান্স মেট্রিক ফিরিয়ে আনে।
গুরুত্বপূর্ণ বিবেচনা
- তারিখ: রিপোর্টিংয়ের সময়সীমা নির্দিষ্ট করতে, সবসময়
dateWHEREক্লজ ব্যবহার করে আপনার কোয়েরি ফিল্টার করুন। তারিখYYYY-MM-DDফর্ম্যাটে আছে। - প্রয়োজনীয় ফিল্টার: কিছু ক্যাম্পেন ভিউয়ের জন্য
WHEREক্লজে অতিরিক্ত ফিল্টার প্রয়োজন:youtube_individual_campaign_stats_view:campaign_idএবংdate।youtube_campaign_videos_stats_view:campaign_id,channel_idএবংdate।youtube_campaign_products_stats_view:campaign_idওdate।
- লেটেন্সি: কোয়েরির লেটেন্সি, অনুরোধ করা ডেটার ভলিউমের উপর নির্ভর করে। যেসব কোয়েরি বড় ডেটা সেট কভার করে সেগুলি সম্পূর্ণ হতে বেশি সময় লাগে এবং টাইম-আউট হয়ে যেতে পারে।