YouTube Analytics API আপনাকে YouTube Analytics ডেটা সহ কাস্টম রিপোর্ট তৈরি করতে দেয়। API-তে চ্যানেল ও কন্টেন্টের মালিকদের জন্য রিপোর্ট কাজ করে। রিপোর্ট ফিল্ডকে ডাইমেনশন বা মেট্রিক হিসেবে চিহ্নিত করা হয়:
ডাইমেনশন হল সাধারণ মাপকাঠি যা ডেটা একত্রিত করতে ব্যবহার করা হয়, যেমন যে তারিখে কোনও অ্যাকশন নেওয়া হয়েছে বা ব্যবহারকারী যে দেশে অবস্থান করছেন।
রিপোর্টে, ডেটার প্রতিটি সারিতে ডাইমেনশন ভ্যালুর অনন্য কম্বিনেশন থাকে। তাই, কোনও রিপোর্টের জন্য আপনি যে ডাইমেনশন বেছে নেন, তার উপর নির্ভর করে YouTube কীভাবে সেই রিপোর্টের মেট্রিকের ভ্যালু গণনা করে।
মেট্রিক হল ব্যবহারকারীর অ্যাক্টিভিটি, বিজ্ঞাপনের পারফর্ম্যান্স বা আনুমানিক উপার্জন সম্পর্কিত স্বতন্ত্র পরিমাপ। ব্যবহারকারীর অ্যাক্টিভিটি মেট্রিকের মধ্যে ভিডিও ভিউয়ের সংখ্যা ও রেটিংয়ের (লাইক ও ডিসলাইক) মতো বিষয় অন্তর্ভুক্ত থাকে।
Analytics API ফিল্টারিং এবং সাজানোর প্যারামিটার প্রদান করে, তাই কলিং অ্যাপ্লিকেশনকে নেটিভভাবে সেই ফাংশনগুলিকে সমর্থন করতে হবে না। এছাড়াও, API-এর মাধ্যমে আপনি YouTube Analytics গ্রুপের জন্য ডেটা রিট্রিভ করতে পারবেন, যেখানে গ্রুপ হল সর্বাধিক ৫০০টি ভিডিও, প্লেলিস্ট, চ্যানেল বা অ্যাসেটের কাস্টম সংগ্রহ।
রিপোর্ট প্যারামিটার বেছে নেওয়া
আপনি যখন API-এর
reports.query পদ্ধতি ব্যবহার করে কোনও রিপোর্টের অনুরোধ করেন, তখন API
অনুরোধে পাঁচটি প্যারামিটার থাকে যা নির্ধারণ করে যে রিপোর্টের মানগুলি কীভাবে
গণনা করা হবে:
startDateএবংendDateপ্যারামিটার রিপোর্টে কোন সময়সীমার ডেটা থাকবে তা নির্দিষ্ট করে। API রেসপন্সে আসলে শেষ দিন পর্যন্ত ডেটা থাকে, যার জন্য কোয়েরি করার সময় কোয়েরিতে সব মেট্রিক উপলভ্য থাকে।metricsপ্যারামিটারটি রিপোর্টে অন্তর্ভুক্ত করা হবে এমন পরিমাপ নির্দিষ্ট করে। চ্যানেল রিপোর্টে, মেট্রিক ব্যবহারকারীর অ্যাক্টিভিটি পরিমাপ করে এবং এতে ভিউ ও লাইক-এর মতো ভ্যালু অন্তর্ভুক্ত থাকে। কিছু মেট্রিক বিজ্ঞাপনের পারফর্ম্যান্স বা আনুমানিক উপার্জনও পরিমাপ করে।dimensionsপ্যারামিটার থেকে বোঝা যায় যে মেট্রিক কীভাবে গ্রুপ করা হবে।filtersপ্যারামিটার থেকে জানা যায় যে কীভাবে রিপোর্টের ডেটা ফিল্টার করা হবে। যেমন, কোনও চ্যানেলের সমস্ত ডেটা দেখানোর পরিবর্তে, রিপোর্ট ফিল্টার করে শুধু নির্দিষ্ট দেশ, ভিডিও বা ভিডিওর গ্রুপের মেট্রিক দেখানো যেতে পারে।মনে রাখবেন: API আপনাকে ভিডিও, প্লেলিস্ট এবং চ্যানেল ফিল্টারের জন্য একাধিক মান নির্দিষ্ট করতে দেয়। আপনি যদি তা করেন, তাহলে আপনি সেই ফিল্টারটি ডাইমেনশনের তালিকাতেও অন্তর্ভুক্ত করতে পারেন যাতে রিটার্ন করা মেট্রিকগুলিও ভিডিও, প্লেলিস্ট বা চ্যানেল দ্বারা গ্রুপ করা হয়।
স্যাম্পেল রিপোর্টিং বিকল্প
উদাহরণস্বরূপ, ধরা যাক কোনও চ্যানেলের মালিক ভিডিও ডিভাইস টাইপ রিপোর্ট পেতে চান যাতে তিনি জানতে পারেন যে চ্যানেলের ভিডিও মোবাইল ডিভাইস, গেম কনসোল, টিভি ইত্যাদিতে কতবার দেখা হয়েছে।
চ্যানেলের মালিক
startDateপ্যারামিটারকে2015-06-01এবংendDateপ্যারামিটারকে2015-07-31হিসেবে সেট করেন। এইসব ভ্যালুর উপর ভিত্তি করে, রিপোর্টে দুই মাসের ডেটা থাকবে।ডিভাইসের ধরন সংক্রান্ত রিপোর্টে ভিউ এবং estimatedMinutesWatched মেট্রিক কাজ করে, তাই চ্যানেলের মালিক
metricsপ্যারামিটারviews,estimatedMinutesWatched-এ সেট করেন।dimensionsপ্যারামিটারের জন্য, চ্যানেল মালিকের কাছে একাধিক বিকল্প আছে। এর মধ্যে দুটি নিম্নলিখিত তালিকায় দেখানো হয়েছে এবং তৃতীয়টি এই বিভাগের পরেfiltersপ্যারামিটারের মানের ব্যাখ্যায় আলোচনা করা হয়েছে।প্যারামিটারের মান
deviceTypeসেট করার অর্থ হল, রিপোর্ট যে সময়সীমা কভার করে সেই সময়সীমার জন্য ভিউ কাউন্ট ও দেখার সময় ডিভাইসের ধরন অনুযায়ী গ্রুপ করা হবে। তাই, এই ভ্যালুর সাহায্যে, রিপোর্টের ডেটা এই ধরনের প্রশ্নের উত্তর দেবে:১ জুন, ২০১৫ থেকে ৩১ জুলাই, ২০১৫-এর মধ্যে মোবাইল ডিভাইসে চ্যানেলের ভিডিও কতবার দেখা হয়েছে?
১ জুন, ২০১৫ থেকে ৩১ জুলাই, ২০১৫-এর মধ্যে গেম কনসোলে চ্যানেলের ভিডিও কতবার দেখা হয়েছে?
রিপোর্টে প্রতিটি ডিভাইসের ধরন অনুযায়ী মোট ভিউ ও দেখার সময় দেখানো হবে।
প্যারামিটারের মান
day,deviceTypeসেট করার অর্থ হল, রিপোর্টিংয়ের সময়সীমার মধ্যে প্রতিদিন ডিভাইসের ধরন অনুযায়ী ভিউ কাউন্ট ও দেখার সময় গণনা করা হবে। তাই, এই ভ্যালুর সাহায্যে, রিপোর্টের ডেটা এই ধরনের প্রশ্নের উত্তর দেবে:১ জুন, ২০১৫-তে মোবাইল ডিভাইসে চ্যানেলের ভিডিও কতবার দেখা হয়েছে?
১৪ জুলাই, ২০১৫-তে টেলিভিশনে চ্যানেলের ভিডিও কতবার দেখা হয়েছে?
সবশেষে,
filtersপ্যারামিটার চ্যানেলের মালিককে নির্দিষ্ট ফিল্টার ভ্যালুর সাথে ম্যাচ করা ডেটা অন্তর্ভুক্ত করার জন্য রিপোর্ট সীমাবদ্ধ করার অনুমতি দেয়। রিপোর্টে এত বেশি ফিল্টারিং বিকল্প আছে যে সবকটি ব্যাখ্যা করা সম্ভব নয়, তাই এই উদাহরণগুলি আপনার তৈরি করা রিপোর্টের একটি ভগ্নাংশ মাত্র।চ্যানেলের মালিক অনুরোধ ফিল্টার করে শুধু Android অপারেটিং সিস্টেমের জন্য ভ্যালু ফেরত দিতে পারেন। (রিপোর্টিংয়ের সময়সীমার মধ্যে Android মোবাইল ডিভাইসে কতগুলি ভিউ হয়েছে?)
চ্যানেলের মালিক অনুরোধ ফিল্টার করে শুধু নির্দিষ্ট দেশের জন্য ভ্যালু ফেরত দিতে পারেন। (রিপোর্টিং সময়সীমার মধ্যে প্রতিদিন কানাডায় কতবার ভিডিও দেখা হয়েছে?)
চ্যানেলের মালিক অনুরোধ ফিল্টার করে শুধুমাত্র নির্দিষ্ট ভিডিওর জন্য ভ্যালু ফেরত দিতে পারেন। তবে, ভিডিও ফিল্টার কমা দিয়ে আলাদা করা ভ্যালুর তালিকা সমর্থন করে, তাই রিপোর্টে আসলে অনেক ভিডিওর ডেটা থাকতে পারে।
এছাড়াও, ভিডিও ফিল্টার একাধিক ভ্যালু নির্দিষ্ট করলে, ভিডিও ডাইমেনশন হিসেবেও নির্দিষ্ট করা যেতে পারে। এর অর্থ হল,
dimensionsপ্যারামিটারdeviceType,videoএবংday,deviceType,videoভ্যালুর সাথেও কাজ করে।- চ্যানেলের মালিক যদি ডাইমেনশনের তালিকায় ভিডিও অন্তর্ভুক্ত করেন, তাহলে মেট্রিক প্রতিটি ভিডিওর জন্য আলাদা আলাদা মান নির্দিষ্ট করে। (১ জুন ২০১৫-তে গেম কনসোলে XYZ ভিডিওটি কতবার দেখা হয়েছে?)
- চ্যানেলের মালিক যদি ডাইমেনশনের তালিকায় ভিডিও অন্তর্ভুক্ত না করেন, তাহলে মেট্রিকগুলি নির্দিষ্ট করা সমস্ত ভিডিওর মোট মান নির্দিষ্ট করে। (১ জুন ২০১৫-তে গেম কনসোলে ABC, DEF এবং XYZ ভিডিও কতবার দেখা হয়েছে?)
ডেটা কতখানি পুরনো ও লেটেন্সি
YouTube Analytics API টার্গেট করা কোয়েরির সাথে কাজ করলেও, এর সাথে সম্পর্কিত
অ্যানালিটিক্স ডেটা রিয়েল-টাইম নয়। ডেটা প্রসেসিংয়ের ক্ষেত্রে সাধারণত ৪৮ থেকে ৭২ ঘণ্টার
লেটেন্সি থাকে। তাই, API রেসপন্সে সাম্প্রতিকতম দিনের ডেটা থাকে না এবং আপনার রিপোর্টের endDate-এ শুধুমাত্র সেই শেষ দিন পর্যন্ত ডেটা অন্তর্ভুক্ত থাকে যার জন্য অনুরোধ করা সমস্ত মেট্রিক সম্পূর্ণভাবে প্রসেস করা হয়েছে।
ডেটা লেটেন্সির কারণে, API-এর মাধ্যমে পাওয়া ডেটা এবং YouTube Studio-তে দেখানো রিয়েল-টাইম মেট্রিক্সের মধ্যে
আপনি পার্থক্য লক্ষ্য করতে পারেন। আপনার
অ্যাপ্লিকেশনের যদি স্বতন্ত্র ভিডিওর জন্য রিয়েল-টাইম পরিসংখ্যানের প্রয়োজন হয়, যেমন বর্তমান
ভিউ, লাইক বা কমেন্টের সংখ্যা, তাহলে YouTube Analytics API-এর পরিবর্তে
YouTube Data API-এর videos.list
পদ্ধতি ব্যবহার করুন।
রিপোর্ট ফিরিয়ে আনা হচ্ছে
রিপোর্ট পেতে, API-এর reports.query পদ্ধতিতে অনুমোদিত GET অনুরোধ পাঠান,
যে রিপোর্ট পেতে চান সেটি নির্দিষ্ট করে প্যারামিটার উল্লেখ করুন।
API-তে কাজ করে এমন রিপোর্টের তালিকা পেতে, চ্যানেল রিপোর্ট এবং
কন্টেন্টের মালিকের রিপোর্ট
সংক্রান্ত ডকুমেন্টেশন দেখুন। প্রতিটি রিপোর্ট
সংজ্ঞা সেই ভ্যালু শনাক্ত করে যা রিপোর্ট metrics,
dimensions এবং filters প্যারামিটারের জন্য অনুমোদন করে।
পেশাদার পদ্ধতি
YouTube Analytics API ব্যবহার করে এমন অ্যাপ্লিকেশনকে সবসময় এইসব পদ্ধতি অনুসরণ করতে হবে:
- রিপোর্টের কলামের ক্রম নির্ধারণ করতে উত্তরের হেডার সারি ব্যবহার করুন। যেমন, ভিউ প্রথম মেট্রিক হিসেবে দেখানো হবে বলে ধরে নেবেন না, কারণ এটি রিপোর্টের বিবরণে প্রথম মেট্রিক হিসেবে তালিকাভুক্ত করা হয়েছে। পরিবর্তে, কোন কলামে সেই ডেটা আছে তা নির্ধারণ করতে, রেসপন্সের হেডার সারি ব্যবহার করুন।
- YouTube Analytics API রেসপন্সে শনাক্ত করা রিসোর্সের জন্য অতিরিক্ত মেটাডেটা পেতে YouTube Data API ব্যবহার করুন। YouTube API Services ডেভেলপার নীতি (III.E.4.b থেকে III.E.4.d বিভাগ) অনুযায়ী, API ক্লায়েন্টকে ৩০ দিন পরে সেই API থেকে সেভ করা রিসোর্স মেটাডেটা মুছে ফেলতে বা রিফ্রেশ করতে হবে।
মেট্রিক ও মুছে ফেলা আইটেম একত্রিত করুন
YouTube Analytics API রেসপন্সে মুছে ফেলা আইটেমের জন্য মেট্রিক ব্রেকডাউন থাকে না। যেমন, কোনও চ্যানেলের মালিক ভিডিও মুছে দিলে, সেই ভিডিওটি আর API রেসপন্সে তালিকাভুক্ত করা হবে না যা ভিডিও-বাই-ভিডিও ভিত্তিতে মেট্রিক রিটার্ন করে। তবে, রিসোর্সের সেটের জন্য সামগ্রিক মেট্রিক্সের রিপোর্টে এখনও মুছে ফেলা আইটেমের সাথে সম্পর্কিত মেট্রিক্স অন্তর্ভুক্ত থাকে।
যেমন, ধরুন কোনও চ্যানেলের মালিক দুটি রিপোর্ট পেয়েছেন। প্রথম রিপোর্টে একটি নির্দিষ্ট সময়সীমার মধ্যে চ্যানেলের সব ভিডিওর মোট দৈনিক ভিউ তালিকাভুক্ত করা হয়। দ্বিতীয় রিপোর্টে একই সময়সীমার মধ্যে প্রতিটি ভিডিওর দৈনিক মোট ভিউয়ের তালিকা থাকে।
এই ক্ষেত্রে, প্রথম রিপোর্টে দেখানো সংখ্যার মধ্যে সেইসব ভিডিওর ভিউও অন্তর্ভুক্ত থাকবে যেগুলি পরে মুছে ফেলা হয়েছে, কারণ প্রথম রিপোর্টে দৈনিক মোট ভিউ দেখানো হয়। তবে, দ্বিতীয় রিপোর্টে মুছে ফেলা আইটেমের সাথে যুক্ত ভিউ অন্তর্ভুক্ত থাকবে না কারণ দ্বিতীয় রিপোর্টে প্রতিটি ভিডিওর ভিউ আলাদাভাবে দেখানো হয়। এর ফলে, রিপোর্টের সময়সীমার মধ্যে চ্যানেল কোনও ভিডিও মুছে দিলে, প্রথম রিপোর্টে দেখানো মোট দৈনিক ভিউয়ের সংখ্যা দ্বিতীয় রিপোর্টে দেখানো দৈনিক, ভিডিও-নির্দিষ্ট ভিউয়ের সংখ্যার যোগফলের চেয়ে বেশি হতে পারে।
ডেটা অ্যানোনিমাইজেশন
মেট্রিক নির্দিষ্ট থ্রেশহোল্ড পূরণ করতে না পারলে, কিছু YouTube Analytics ডেটা সীমিত করা হয়। বিভিন্ন ধরনের রিপোর্টের ক্ষেত্রে এটি ঘটতে পারে। বাস্তবে, এর অর্থ হল, কোনও রিপোর্টে আপনার সমস্ত (বা কোনও) ডেটা নাও থাকতে পারে যদি:
একটি নির্দিষ্ট সময়সীমার মধ্যে কোনও ভিডিও বা চ্যানেলে সীমিত ট্রাফিক থাকলে,
অথবা
আপনি ট্রাফিক সোর্স বা দেশের মতো এমন কোনও ফিল্টার বা ডাইমেনশন বেছে নিয়েছেন, যার ভ্যালু নির্দিষ্ট থ্রেশহোল্ড পূরণ করে না।
ডেটা সীমিত করা হলে, কীভাবে বিভিন্ন রিপোর্টে ডেটা এগ্রিগেট করা হয়, তার উপর নির্ভর করে সেইসব রিপোর্টে দেখানো মোট পরিমাণ আলাদা আলাদা হতে পারে।
যেমন, ধরুন কোনও চ্যানেলের মালিক দুটি রিপোর্ট পেয়েছেন। প্রথম রিপোর্টে কোনও নির্দিষ্ট ভিডিওর মোট ভিউয়ের তালিকা থাকে এবং দ্বিতীয় রিপোর্টে প্রতিটি দেশের ভিত্তিতে সেই ভিডিওর মোট ভিউয়ের তালিকা থাকে। একটি নির্দিষ্ট সময়সীমার মধ্যে, মনে করুন যে ভিডিওটি মোট ১০০০ বার দেখা হয়েছে, যার মধ্যে মার্কিন যুক্তরাষ্ট্রে ৫০০ বার দেখা হয়েছে, কানাডাতে ৪৯৮ বার ও ফ্রান্সে দুই বার দেখা হয়েছে।
এই উদাহরণে, প্রথম রিপোর্টে দেখানো হবে যে ভিডিওটি ১০০০ বার দেখা হয়েছে। দ্বিতীয় রিপোর্টে শুধু এটি দেখানো হবে যে ভিডিওটি ৫০০ বার মার্কিন যুক্তরাষ্ট্রে ও ৪৯৮ বার কানাডায় দেখা হয়েছে। এর অর্থ হল যে দুটি রিপোর্টের মোট ভিউ কাউন্টের মধ্যে পার্থক্য রয়েছে। মনে রাখবেন যে, দ্বিতীয় রিপোর্টে এমন কোনও ইঙ্গিত থাকবে না যে অন্য দুটি ভিউও আছে (অথবা ফ্রান্সে ভিডিওটি কোনও ভিউ পেয়েছে)।
সীমিত ডেটার ধরন
YouTube Analytics রিপোর্টে নিম্নলিখিত ডেটা সীমিত হতে পারে:
- বয়স এবং লিঙ্গগত পরিচয়ের মতো ডেমোগ্রাফি সংক্রান্ত ডেটা।
- ভৌগোলিক ডেটা, যার মধ্যে দর্শক যেসব দেশ বা অঞ্চলে বসবাস করেন, সেইসব দেশ বা অঞ্চলের সাথে সম্পর্কিত মেট্রিক বা ডাইমেশন অন্তর্ভুক্ত থাকে, যেমন তাদের দেশ বা অঞ্চল। তবে মনে রাখবেন, রিপোর্টে উপার্জনের মেট্রিকের ক্ষেত্রে ভৌগোলিক থ্রেশহোল্ড প্রযোজ্য হয় না।
- নির্দিষ্ট ট্রাফিক সোর্স সম্পর্কিত মেট্রিক, যেমন সার্চ করা শব্দ বা এক্সটার্নাল URL যার মাধ্যমে আপনার ভিডিওতে ভিউ এসেছে। যেমন, যেসব সার্চ করা শব্দ এবং URL-এর মাধ্যমে খুব কম সংখ্যক ভিউ পাওয়া যায়, সেগুলি রিপোর্টে দেখানো হবে না। তবে, যেসব সার্চ করা শব্দ এবং URL-এর মাধ্যমে আপনার কন্টেন্টে অনেক দর্শক আসেন, সেগুলি আপনি দেখতে পাবেন।
YouTube Analytics রিপোর্টে সীমিত ডেটা সম্পর্কে আরও তথ্য পেতে, YouTube সহায়তা কেন্দ্র দেখুন।
কোটার ব্যবহার
আপনার করা প্রতিটি API অনুরোধ আপনার API ব্যবহারের কোটার একটি ইউনিট হিসেবে গণনা করা হয়। Google Cloud কনসোলের কোটা প্যানেলে কোটার সীমা দেখা যায়।