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