আপনি রিপোর্টিং সাব-এপিআই ব্যবহার করে ইউটিউব অ্যাফিলিয়েট প্রোগ্রামে অংশগ্রহণকারী আপনার পণ্যগুলির জন্য মূল পারফরম্যান্স মেট্রিকগুলি পুনরুদ্ধার করতে পারেন। এই নির্দেশিকাটি ব্যাখ্যা করে যে কীভাবে বিভিন্ন ক্রিয়েটর, ভিডিও কন্টেন্ট, স্বতন্ত্র পণ্য এবং টার্গেটেড ক্যাম্পেইনের সাথে সম্পর্কিত ইউটিউব-নির্দিষ্ট অ্যাফিলিয়েট ডেটা, যেমন বিক্রয়, কমিশন, অর্ডার, ভিউ এবং ক্লিক, কোয়েরি করতে হয়।
আপনি মার্চেন্ট সেন্টার কোয়েরি ল্যাঙ্গুয়েজ (MCQL) ব্যবহার করে ডেডিকেটেড ইউটিউব অ্যাফিলিয়েট ভিউ থেকে মেট্রিক্স এবং ডাইমেনশন নির্বাচন করতে পারেন, যা আপনার কোয়েরিতে টেবিলের মতো কাজ করে।
পূর্বশর্ত
এই নির্দেশিকাটি ব্যবহার করার আগে নিশ্চিত করুন যে:
- এপিআই কল প্রমাণীকরণের জন্য ব্যবহৃত অ্যাকাউন্টটিতে 'পারফরম্যান্স অ্যান্ড ইনসাইটস' রোল রয়েছে, যা পারফরম্যান্স মেট্রিক্সে অ্যাক্সেস প্রদান করে।
- আপনার গুগল মার্চেন্ট সেন্টার অ্যাকাউন্টটি ইউটিউব অ্যাফিলিয়েট প্রোগ্রামে অংশগ্রহণ করে।
আলফা এন্ডপয়েন্টে কোয়েরি করুন
যেহেতু এই ফিচারটি পাবলিক আলফা পর্যায়ে রয়েছে, তাই এন্ডপয়েন্টটি ভিন্ন। ইউটিউব অ্যাফিলিয়েট পারফরম্যান্স ডেটা পেতে, আপনাকে v1alpha এন্ডপয়েন্টে POST রিকোয়েস্ট পাঠাতে হবে। রিপোর্ট সংগ্রহ করার বিষয়ে আরও তথ্যের জন্য, 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_creator_performance_view টি কোয়েরি করতে পারেন। এই ভিউটি স্বতন্ত্র ইউটিউব ক্রিয়েটরদের মেট্রিকগুলো একত্রিত করে এবং এতে ক্রিয়েটরের টাইটেল ও চ্যানেল আইডি অন্তর্ভুক্ত থাকে।
এখানে একটি 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_content_performance_view টি কোয়েরি করতে পারেন। এই ভিউটি প্রতিটি ইউটিউব ভিডিওর মেট্রিকস একত্রিত করে এবং এতে ভিডিওর শিরোনাম ও আইডি অন্তর্ভুক্ত থাকে।
১ মে থেকে ২ মে, ২০২৫-এর মধ্যে ভিউ অনুসারে শীর্ষ ৩টি ভিডিও পেতে, accounts.reports.search মেথডে নিম্নলিখিত MCQL স্টেটমেন্টটি পাস করুন:
SELECT title, video_id, gross_sales, net_sales, 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
এই কোয়েরিটি নির্দিষ্ট তারিখের পরিসরের মধ্যে মোট views সংখ্যার ভিত্তিতে র্যাঙ্ক করা শীর্ষ ৩টি ভিডিওর শিরোনাম, ভিডিও আইডি এবং মূল মেট্রিকগুলো পুনরুদ্ধার করে।
সর্বাধিক এনগেজমেন্ট সহ ট্যাগযুক্ত পণ্যগুলি দেখুন
কোন ট্যাগ করা পণ্যগুলিতে সবচেয়ে বেশি এনগেজমেন্ট এবং বিক্রি হয়েছে তা বুঝতে, আপনি 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_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 কোয়েরি করুন। এই ভিউটি একটি ক্যাম্পেইনের মধ্যে থাকা প্রতিটি ক্রিয়েটরের মেট্রিকগুলো একত্রিত করে, যার মধ্যে চ্যানেলের শিরোনাম, ভিডিওর সংখ্যা এবং ট্যাগ করা পণ্যের শিরোনাম অন্তর্ভুক্ত থাকে।
২০২৬ সালের ২৩শে এপ্রিল একটি নির্দিষ্ট ক্যাম্পেইনের জন্য ভিউ অনুসারে শীর্ষ ১০ জন ক্রিয়েটর পেতে নিম্নলিখিত MCQL SELECT স্টেটমেন্টটি ব্যবহার করুন:
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
এই কোয়েরিটি নির্দিষ্ট ক্যাম্পেইন এবং তারিখের মধ্যে মোট views সংখ্যার ভিত্তিতে র্যাঙ্ক করা শীর্ষ ১০টি পণ্যের ক্রিয়েটর চ্যানেলের শিরোনাম, পণ্যের শিরোনাম, ভিডিওর শিরোনাম, ভিডিও ইউআরএল এবং প্রধান পারফরম্যান্স মেট্রিক্স পুনরুদ্ধার করে।
গুরুত্বপূর্ণ বিবেচ্য বিষয়
- তারিখ : রিপোর্টিং পিরিয়ড নির্দিষ্ট করতে সর্বদা
WHEREক্লজ ব্যবহার করেdateঅনুযায়ী আপনার কোয়েরি ফিল্টার করুন। তারিখগুলো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.
-
- লেটেন্সি : কোয়েরির লেটেন্সি অনুরোধ করা ডেটার পরিমাণের উপর নির্ভর করে। যেসব কোয়েরিতে বড় ডেটাসেট থাকে, সেগুলোতে বেশি সময় লাগে এবং এর ফলে টাইমআউট হতে পারে।