আপনি রিপোর্টস এপিআই (Reports API) ব্যবহার করে ইউটিউব অ্যাফিলিয়েট প্রোগ্রামে অংশগ্রহণকারী আপনার পণ্যগুলির জন্য মূল পারফরম্যান্স মেট্রিকগুলি পুনরুদ্ধার করতে পারেন। এই নির্দেশিকাটি ব্যাখ্যা করে যে কীভাবে বিভিন্ন ক্রিয়েটর, ভিডিও কন্টেন্ট এবং স্বতন্ত্র পণ্যের সাথে সম্পর্কিত ইউটিউব-নির্দিষ্ট অ্যাফিলিয়েট ডেটা, যেমন বিক্রয়, কমিশন, অর্ডার, ভিউ এবং ক্লিক, কোয়েরি করতে হয়।
আপনি MCQL ব্যবহার করে নির্দিষ্ট ইউটিউব অ্যাফিলিয়েট 'ভিউ' থেকে মেট্রিক এবং ডাইমেনশন নির্বাচন করতে পারেন, যা আপনার কোয়েরিতে টেবিলের মতো কাজ করে।
পূর্বশর্ত
এই নির্দেশিকাটি ব্যবহার করার আগে নিশ্চিত করুন যে:
- এপিআই কল প্রমাণীকরণের জন্য ব্যবহৃত অ্যাকাউন্টটিতে 'পারফরম্যান্স অ্যান্ড ইনসাইটস' রোল রয়েছে, যা পারফরম্যান্স মেট্রিক্সে অ্যাক্সেস প্রদান করে।
- আপনার গুগল মার্চেন্ট সেন্টার অ্যাকাউন্টটি ইউটিউব অ্যাফিলিয়েট প্রোগ্রামে অংশগ্রহণ করে।
আলফা এন্ডপয়েন্টে কোয়েরি করুন
উল্লেখ্য যে, যেহেতু এটি পাবলিক আলফা পর্যায়ে রয়েছে, তাই এন্ডপয়েন্টটি ভিন্ন। ইউটিউব অ্যাফিলিয়েট পারফরম্যান্স ডেটা পেতে, আপনাকে v1alpha এন্ডপয়েন্টে POST রিকোয়েস্ট পাঠাতে হবে। নিচে একটি নমুনা রিকোয়েস্ট দেওয়া হলো:
HTTP
POST https://merchantapi.googleapis.com/reports/v1alpha/accounts/{ACCOUNT_ID}/reports:search
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' \
--compressed
নির্মাতার পারফরম্যান্স দেখুন
কোন ইউটিউব ক্রিয়েটররা সবচেয়ে বেশি এনগেজমেন্ট এবং সেলস আনছেন তা বোঝার জন্য, আপনি youtube_creator_performance_view টি কোয়েরি করতে পারেন। এই ভিউটি স্বতন্ত্র ইউটিউব ক্রিয়েটরদের মেট্রিকগুলো একত্রিত করে এবং এতে ক্রিয়েটরের টাইটেল ও চ্যানেল আইডি অন্তর্ভুক্ত থাকে।
এখানে একটি MCQL SELECT স্টেটমেন্টের উদাহরণ দেওয়া হলো, যা ব্যবহার করে আপনি ২০২৫ সালের ১লা মে থেকে ২রা মে-এর মধ্যে বিক্রয়ের ভিত্তিতে সেরা ৩ জন পারফর্মিং ক্রিয়েটরকে খুঁজে বের করতে পারবেন।
SELECT
title,
channel_id,
sales,
commissions,
orders,
clicks,
views
FROM youtube_creator_performance_view
WHERE date BETWEEN '2025-05-01' AND '2025-05-02'
ORDER BY sales DESC LIMIT 3
এই কোয়েরিটি নির্দিষ্ট তারিখের পরিসরের মধ্যে বিক্রয় মেট্রিক অনুসারে র্যাঙ্ক করা শীর্ষ ৩ জন ক্রিয়েটরের ক্রিয়েটর টাইটেল, চ্যানেল আইডি এবং মূল পারফরম্যান্স মেট্রিকগুলো সংগ্রহ করে।
বিষয়বস্তু অনুসারে পারফরম্যান্স দেখুন
কোন নির্দিষ্ট ইউটিউব ভিডিওগুলো সবচেয়ে ভালো পারফর্ম করছে তা দেখতে, আপনি youtube_content_performance_view টি কোয়েরি করতে পারেন। এই ভিউটি প্রতিটি ইউটিউব ভিডিওর মেট্রিকস একত্রিত করে এবং এতে ভিডিওর শিরোনাম ও আইডি অন্তর্ভুক্ত থাকে।
১ মে থেকে ২ মে, ২০২৫-এর মধ্যে ভিউ অনুসারে শীর্ষ ৩টি ভিডিও পেতে, accounts.reports.search মেথডে নিম্নলিখিত মার্চেন্ট সেন্টার কোয়েরি ল্যাঙ্গুয়েজ স্টেটমেন্টটি পাস করুন:
SELECT
title,
video_id,
views,
clicks,
sales
FROM youtube_content_performance_view
WHERE date BETWEEN '2025-05-01' AND '2025-05-02'
ORDER BY views DESC LIMIT 3
এই কোয়েরিটি নির্দিষ্ট তারিখের পরিসরের মধ্যে মোট views সংখ্যার ভিত্তিতে র্যাঙ্ক করা শীর্ষ ৩টি ভিডিওর শিরোনাম, ভিডিও আইডি এবং মূল মেট্রিকগুলো পুনরুদ্ধার করে।
গুরুত্বপূর্ণ বিবেচ্য বিষয়
- তারিখ: রিপোর্টিং পিরিয়ড নির্দিষ্ট করতে সর্বদা
WHEREক্লজ ব্যবহার করেdateঅনুযায়ী আপনার কোয়েরি ফিল্টার করুন। তারিখYYYY-MM-DDফরম্যাটে থাকে। - লেটেন্সি: কোয়েরির লেটেন্সি অনুরোধ করা ডেটার পরিমাণের উপর নির্ভর করবে। বড় আকারের কোয়েরি সম্পন্ন হতে বেশি সময় লাগবে এবং এর ফলে টাইমআউট হতে পারে।