এই ডকুমেন্টটিতে ইউটিউব অ্যানালিটিক্স এপিআই এবং ইউটিউব রিপোর্টিং এপিআই কীভাবে ইউটিউব অ্যানালিটিক্স ডেটা অ্যাক্সেস করার সুযোগ দেয়, তার মধ্যকার সাদৃশ্য ও পার্থক্য ব্যাখ্যা করা হয়েছে, যাতে আপনি আপনার অ্যাপ্লিকেশনের জন্য সঠিক এপিআইটি বেছে নিতে পারেন।
উভয় এপিআই-ই আপনাকে ইউটিউব অ্যানালিটিক্স ডেটা পুনরুদ্ধার করতে দেয়। এছাড়াও, উভয় এপিআই ইউটিউব চ্যানেল মালিক এবং ইউটিউব কন্টেন্ট মালিকদের সমর্থন করে, যাদের প্রত্যেকেই একটি নির্দিষ্ট সেট রিপোর্ট অ্যাক্সেস করতে পারেন:
চ্যানেল রিপোর্টে একটি নির্দিষ্ট চ্যানেলের ব্যবহারকারীর কার্যকলাপের মেট্রিকস থাকে।
কন্টেন্ট ওনার রিপোর্ট একজন নির্দিষ্ট ইউটিউব কন্টেন্ট ওনারের সাথে লিঙ্ক করা সমস্ত চ্যানেলের সামগ্রিক মেট্রিক্স প্রদান করে। উদাহরণস্বরূপ, একটি রেকর্ড লেবেল তাদের সমস্ত শিল্পীর ইউটিউব চ্যানেলের সম্মিলিত পরিসংখ্যান সম্বলিত একটি রিপোর্ট পেতে পারে। কিছু কন্টেন্ট ওনার রিপোর্টে ব্যবহারকারীর কার্যকলাপের মেট্রিক্স থাকে, আবার অন্যগুলিতে রাজস্ব এবং বিজ্ঞাপনের পারফরম্যান্স সম্পর্কিত মেট্রিক্স থাকে।
রিপোর্টিং এপিআই কিছু কন্টেন্ট মালিককে সিস্টেম-পরিচালিত বিজ্ঞাপন রাজস্ব রিপোর্ট অ্যাক্সেস করার সুযোগও দেয়। সিস্টেম-পরিচালিত রিপোর্টগুলোর ডেটা শুধুমাত্র রিপোর্টিং এপিআই ব্যবহার করেই পুনরুদ্ধার করা যায়।
সমস্ত ইউটিউব অ্যানালিটিক্স এবং ইউটিউব রিপোর্টিং এপিআই অনুরোধ অবশ্যই সেই চ্যানেল বা কন্টেন্ট মালিকের দ্বারা অনুমোদিত হতে হবে, যিনি অনুরোধকৃত ডেটার মালিক।
প্রতিবেদনের বিষয়বস্তু
এপিআইগুলো যে রিপোর্টগুলো সংগ্রহ করে, সেগুলোতে দুই ধরনের ডেটা থাকে:
ডাইমেনশন হলো ডেটা একত্রিত করার জন্য ব্যবহৃত সাধারণ মাপকাঠি, যেমন ব্যবহারকারীর কার্যকলাপ সংঘটিত হওয়ার তারিখ বা ব্যবহারকারীরা যে দেশে অবস্থান করছিলেন।
একটি রিপোর্টে, ডেটার প্রতিটি সারিতে ডাইমেনশন ভ্যালুগুলোর একটি অনন্য সমন্বয় থাকে। এই কারণে, প্রতিটি সারির ডাইমেনশন ভ্যালুগুলোর সমন্বয়টি সেই সারির প্রাইমারি কী হিসেবে কাজ করে।
মেট্রিক্স হলো ব্যবহারকারীর কার্যকলাপ, বিজ্ঞাপনের কার্যকারিতা বা আনুমানিক আয়ের স্বতন্ত্র পরিমাপ। ব্যবহারকারীর কার্যকলাপ মেট্রিক্সের মধ্যে ভিডিও দেখার সংখ্যা এবং রেটিং (পছন্দ ও অপছন্দ)-এর মতো বিষয়গুলো অন্তর্ভুক্ত থাকে।
আপনার অ্যাপ্লিকেশনের জন্য সঠিক এপিআই বেছে নিন
- ইউটিউব অ্যানালিটিক্স এপিআই
- ইউটিউব অ্যানালিটিক্স এপিআই কাস্টম ইউটিউব অ্যানালিটিক্স রিপোর্ট তৈরি করার জন্য রিয়েল-টাইম টার্গেটেড কোয়েরি সমর্থন করে। এপিআইটি ফিল্টারিং এবং সর্টিং প্যারামিটার সরবরাহ করে, তাই কলিং অ্যাপ্লিকেশনটির এই ফাংশনগুলিকে নেটিভভাবে সমর্থন করার প্রয়োজন হয় না।
প্রতিটি এপিআই অনুরোধে সেই তারিখের পরিসর নির্দিষ্ট করা থাকে, যার জন্য ডেটা ফেরত দেওয়া হবে। এই এপিআই আপনাকে সাপ্তাহিক এবং মাসিক ডেটা সেট পুনরুদ্ধার করার সুযোগও দেয়। ফলে, আহ্বানকারী অ্যাপ্লিকেশনটির পুনরুদ্ধার করা ডেটা সেট সংরক্ষণ করার বা বিভিন্ন তারিখের পরিসর জুড়ে পরিসংখ্যান একত্রিত করার প্রয়োজন হয় না। - ইউটিউব রিপোর্টিং এপিআই
- ইউটিউব রিপোর্টিং এপিআই কোনো চ্যানেল বা কন্টেন্ট মালিকের জন্য ইউটিউব অ্যানালিটিক্স ডেটা সম্বলিত বাল্ক রিপোর্ট পুনরুদ্ধার করে। এটি এমন অ্যাপ্লিকেশনগুলির জন্য ডিজাইন করা হয়েছে যা বৃহৎ ডেটাসেট ইম্পোর্ট করতে পারে এবং সেই ডেটা ফিল্টার, সর্ট ও বিশ্লেষণ করার জন্য টুল সরবরাহ করে।
প্রতিটি রিপোর্টে পূর্বনির্ধারিত কিছু ফিল্ড থাকে। আপনি এপিআই (API) ব্যবহার করে রিপোর্টিং জব শিডিউল করেন, যার প্রতিটি ইউটিউবের তৈরি করার জন্য একটি রিপোর্ট নির্দিষ্ট করে দেয়। এরপর ইউটিউব একটি দৈনিক রিপোর্ট তৈরি করে যা অ্যাসিঙ্ক্রোনাসভাবে ডাউনলোড করা যায়। প্রতিটি রিপোর্টে একটি নির্দিষ্ট ২৪-ঘণ্টার ডেটা থাকে।
এছাড়াও, ইউটিউব ক্রিয়েটর স্টুডিও -তে সংশ্লিষ্ট রিপোর্টগুলো অ্যাক্সেস করার সুযোগ থাকা কন্টেন্ট মালিকদের জন্য ইউটিউব স্বয়ংক্রিয়ভাবে একগুচ্ছ সিস্টেম-পরিচালিত রিপোর্ট তৈরি করে। এই রিপোর্টগুলো বিজ্ঞাপন থেকে আয়ের ডেটাতে প্রোগ্রাম্যাটিক অ্যাক্সেস প্রদান করে।
সমর্থিত প্রতিবেদন
নিম্নলিখিত সারণীতে এপিআই (API) ব্যবহার করে যে বিভিন্ন ধরণের রিপোর্ট পাওয়া যায় তা চিহ্নিত করা হয়েছে। ইউটিউব অ্যানালিটিক্স এপিআই (YouTube Analytics API) ব্যবহার করে নির্দিষ্ট কোয়েরি (targeted queries) করা যায়, এবং ইউটিউব রিপোর্টিং এপিআই (YouTube Reporting API) ব্যবহার করে বাল্ক রিপোর্ট (bulk reports) পাওয়া যায়।
যে ডেটা একটি এপিআই-তে পাওয়া যায়, তা অন্যটিতে নাও পাওয়া যেতে পারে। উদাহরণস্বরূপ, ইউটিউব অ্যানালিটিক্স এপিআই আপনাকে সাপ্তাহিক বা মাসিক ভিত্তিতে ব্যবহারকারীর কার্যকলাপের মেট্রিক্স পেতে দেয়, কিন্তু ইউটিউব রিপোর্টিং এপিআই-এর জন্য আপনাকে সেই ডেটা নিজে থেকেই একত্রিত করতে হয়। অন্যদিকে, ইউটিউব রিপোর্টিং এপিআই কন্টেন্ট মালিকদের জন্য অ্যাসেট রিপোর্ট সমর্থন করে, কিন্তু সেই ডেটা ইউটিউব অ্যানালিটিক্স এপিআই থেকে পাওয়া যায় না।
| প্রতিবেদনের প্রকারভেদ | |
|---|---|
| ভিডিও প্রতিবেদন | চ্যানেল ( অনুসন্ধান বা সমষ্টিগতভাবে ) এবং কন্টেন্ট মালিকদের ( অনুসন্ধান বা সমষ্টিগতভাবে ) জন্য সমর্থিত। ভিডিও রিপোর্টগুলো একটি চ্যানেলের ভিডিও বা কোনো কন্টেন্ট মালিকের ভিডিও সম্পর্কিত সমস্ত ব্যবহারকারীর কার্যকলাপের পরিসংখ্যান প্রদান করে। উদাহরণস্বরূপ, এই রিপোর্টগুলোতে আপনার ভিডিওগুলো কতবার দেখা হয়েছে, সেই সংখ্যা থাকে। ইউটিউব অ্যানালিটিক্স এপিআই-তে, কিছু কন্টেন্ট মালিকের ভিডিও রিপোর্টে আনুমানিক আয় এবং বিজ্ঞাপনের কার্যকারিতার মেট্রিকও অন্তর্ভুক্ত থাকে। |
| রিচ রিপোর্ট | চ্যানেল ( একসাথে ) এবং কন্টেন্ট মালিকদের ( একসাথে ) জন্য সমর্থিত। নির্দিষ্ট অনুসন্ধানের জন্য ভিডিও রিপোর্টে রিচ মেট্রিক্সও পাওয়া যায়। রিচ রিপোর্ট ভিডিও থাম্বনেইল ইম্প্রেশন এবং ক্লিক-থ্রু রেটের পরিসংখ্যান প্রদান করে। |
| প্লেলিস্ট রিপোর্ট | চ্যানেল ( অনুসন্ধান বা সমষ্টিগতভাবে ) এবং কন্টেন্ট মালিকদের ( অনুসন্ধান বা সমষ্টিগতভাবে ) জন্য সমর্থিত। প্লেলিস্ট রিপোর্টগুলো এমন পরিসংখ্যান প্রদান করে যা বিশেষভাবে একটি প্লেলিস্টের মধ্যে ঘটা ভিডিও ভিউয়ের সাথে সম্পর্কিত। ইউটিউব রিপোর্টিং এপিআই প্লেলিস্টের জন্য অডিয়েন্স রিটেনশন রিপোর্ট সমর্থন করে, কিন্তু ইউটিউব অ্যানালিটিক্স এপিআই অনুরূপ কোনো রিপোর্ট সমর্থন করে না। |
| বিজ্ঞাপনের কার্যকারিতা প্রতিবেদন | কন্টেন্ট মালিকদের জন্য সমর্থিত ( কোয়েরি বা বাল্ক )। বিজ্ঞাপন পারফরম্যান্স রিপোর্টগুলো ভিডিও প্লেব্যাকের সময় প্রদর্শিত বিজ্ঞাপনগুলোর জন্য ইম্প্রেশন-ভিত্তিক মেট্রিক্স প্রদান করে। এই মেট্রিক্সগুলো প্রতিটি বিজ্ঞাপন ইম্প্রেশনের হিসাব রাখে, এবং প্রতিটি ভিডিও প্লেব্যাক থেকে একাধিক ইম্প্রেশন তৈরি হতে পারে। |
| আনুমানিক রাজস্ব প্রতিবেদন | কন্টেন্ট মালিকদের জন্য সমর্থিত ( একসাথে )। আনুমানিক রাজস্ব রিপোর্টগুলো গুগল-বিক্রিত বিজ্ঞাপন উৎস এবং বিজ্ঞাপন-বহির্ভূত উৎস থেকে ভিডিওর মোট আনুমানিক রাজস্ব প্রদান করে। এই রিপোর্টগুলোতে বিজ্ঞাপনের কার্যকারিতা সম্পর্কিত কিছু মেট্রিকও থাকে। উল্লেখ্য যে, সিস্টেম-পরিচালিত রিপোর্টগুলোতে প্রকৃত রাজস্ব থাকে। |
| সম্পদ প্রতিবেদন | কন্টেন্ট মালিকদের জন্য সমর্থিত ( একসাথে )। অ্যাসেট রিপোর্টগুলো কোনো কন্টেন্ট মালিকের অ্যাসেটের সাথে সংযুক্ত ভিডিও সম্পর্কিত ব্যবহারকারীর কার্যকলাপের মেট্রিক্স প্রদান করে। কোনো ভিডিওকে একজন কন্টেন্ট মালিকের রিপোর্টে অন্তর্ভুক্ত করা হয়, যদি সেই কন্টেন্ট মালিক ভিডিওটিকে তার কোনো একটি অ্যাসেটের সাথে মিলে গেছে বলে দাবি করেন। ভিডিওটি কন্টেন্ট মালিক নিজে অথবা অন্য কোনো ইউটিউব ব্যবহারকারী আপলোড করে থাকতে পারেন। |
| সিস্টেম-পরিচালিত প্রতিবেদন | যেসব কন্টেন্ট মালিকদের ইউটিউবের ক্রিয়েটর স্টুডিও-এর রিপোর্টস মেনুতে সংশ্লিষ্ট রিপোর্টগুলো দেখার অ্যাক্সেস আছে, তাদের জন্য এটি সমর্থিত। সিস্টেম-পরিচালিত রিপোর্টগুলো অ্যাসেট এবং ভিডিও থেকে অর্জিত প্রকৃত রাজস্বের তথ্য প্রদান করে। একটি অতিরিক্ত রিপোর্টে দাবি করা ভিডিও এবং সেই ভিডিওগুলোর সাথে মিলে যাওয়া অ্যাসেটগুলোর তালিকা দেওয়া থাকে। ক্রিয়েটর স্টুডিও-র সব রিপোর্ট এপিআই-তে (API) উপলব্ধ নয়। দ্রষ্টব্য: যেসব কন্টেন্ট মালিকদের ক্রিয়েটর স্টুডিও-তে সংশ্লিষ্ট রিপোর্টগুলিতে অ্যাক্সেস আছে, ইউটিউব তাদের জন্য স্বয়ংক্রিয়ভাবে সিস্টেম-ম্যানেজড রিপোর্ট তৈরি করে। ফলে, এই রিপোর্টগুলি পাওয়ার প্রক্রিয়াটি এই তালিকার অন্য ধরনের রিপোর্টগুলির থেকে ভিন্ন। আরও তথ্যের জন্য সিস্টেম-ম্যানেজড রিপোর্ট সম্পর্কিত ডকুমেন্টেশন দেখুন। |
মূল পার্থক্য
নিম্নলিখিত সারণিতে ইউটিউব অ্যানালিটিক্স এবং রিপোর্টিং এপিআই-এর মধ্যে গুরুত্বপূর্ণ পার্থক্যগুলো তুলে ধরা হয়েছে।
| বৈশিষ্ট্য | ইউটিউব অ্যানালিটিক্স এপিআই | ইউটিউব রিপোর্টিং এপিআই |
|---|---|---|
| ডেটা পুনরুদ্ধার করার প্রক্রিয়া | প্রতিটি এপিআই অনুরোধে ফেরতযোগ্য ডাইমেনশন ও মেট্রিক্সের পাশাপাশি যে সময়কালের জন্য ডেটা ফেরত দেওয়া হবে, তাও নির্দিষ্ট করা থাকে। | অ্যাপ্লিকেশনগুলো রিপোর্টিং জবগুলোর সময়সূচী নির্ধারণ করে। প্রতিটি জবের জন্য, ইউটিউব দৈনিক রিপোর্ট তৈরি করে যা অ্যাসিঙ্ক্রোনাসভাবে ডাউনলোড করা যায়। |
| তারিখের পরিসর | কিছু এপিআই রিপোর্টে ব্যবহারকারীর কার্যকলাপ সংঘটিত হওয়ার তারিখ উল্লেখ করা থাকে। এই ধরনের কিছু রিপোর্টে ডাইমেনশনের মাধ্যমে মাস অনুযায়ী ব্যবহারকারীর কার্যকলাপের মেট্রিকগুলো একত্রিত করার সুবিধা রয়েছে। | সমস্ত এপিআই রিপোর্টে ব্যবহারকারীর কার্যকলাপ সংঘটিত হওয়ার দিনটি উল্লেখ করা থাকে। এপিআই ব্যবহারকারী অ্যাপ্লিকেশনগুলো নির্দিষ্ট বিরতিতে ডেটা একত্রিত করার জন্য বিভিন্ন ফিচার প্রয়োগ করতে পারে। |
| ডেটা ফিল্টার করা | আপনি রিপোর্ট ফিল্টার করে শুধুমাত্র সেই সারিগুলো অন্তর্ভুক্ত করতে পারেন, যেগুলোর জন্য কোনো ডাইমেনশনের একটি নির্দিষ্ট মান রয়েছে। এপিআইটি কন্টিনেন্ট এবং সাব-কন্টিনেন্টের মতো কিছু ডাইমেনশনও সমর্থন করে, যেগুলো শুধুমাত্র ফিল্টার হিসেবে ব্যবহৃত হয়। | এপিআইটি সম্পূর্ণ ডেটা সেট একসাথে ডাউনলোড করা সমর্থন করে। এটি ফিল্টারিং সমর্থন করে না বা শুধুমাত্র ফিল্টার-যোগ্য ডাইমেনশনের জন্য ডেটা ফেরত দেয় না। ক্লায়েন্ট অ্যাপ্লিকেশনটি ডাউনলোড করা ডেটা সংরক্ষণ করে এবং ডেটা ফিল্টার করার জন্য নিজস্ব বৈশিষ্ট্য প্রয়োগ করে। |
| বাছাই | প্রাপ্ত মেট্রিক মানের উপর ভিত্তি করে রিপোর্টগুলো সাজানো যায়। কিছু রিপোর্টে কেবল সীমিত সংখ্যক ফলাফল দেখা যায়। উদাহরণস্বরূপ, যে রিপোর্টটি একটি চ্যানেলের সর্বাধিক দেখা ভিডিওগুলোর তালিকা দেখায়, সেটি সর্বোচ্চ ২০০টি সারি প্রদর্শন করে। | এই এপিআই সম্পূর্ণ ডেটা সেট একসাথে ডাউনলোড করতে সমর্থন করে। ক্লায়েন্ট অ্যাপ্লিকেশনগুলো ডাউনলোড করা ডেটা সাজানোর জন্য নিজস্ব বৈশিষ্ট্য প্রয়োগ করতে পারে। |
| গণনা | এপিআই রিপোর্টগুলিতে তালিকাভুক্ত ডাইমেনশন ভ্যালু শনাক্ত করার জন্য 'ANDROID' বা 'CHANNEL'-এর মতো টেক্সট ভ্যালু থাকে। | এপিআই রিপোর্টগুলিতে পূর্ণসংখ্যা থাকে যেগুলিকে টেক্সট ভ্যালুতে ম্যাপ করা যায়। |
| কোটা | এপিআই সার্ভার প্রতিটি কোয়েরির কোটা খরচ নির্ধারণ করার জন্য তা মূল্যায়ন করে। কোটা ব্যবহার অংশে এই পদ্ধতিটি আরও বিস্তারিতভাবে ব্যাখ্যা করা হয়েছে। | কোটা ব্যবহার কোনো সমস্যা নয়, কারণ ডেটা একবারই সংগ্রহ করা হয় এবং তারপর অ্যাপ্লিকেশনটির মধ্যেই তা ফিল্টার, সর্ট ও কোয়েরি করা হয়। |
| অনন্য প্রতিবেদন |
| |
| অনন্য মাত্রা | গ্রুপ (শুধুমাত্র ফিল্টার করার জন্য মাত্রা) মহাদেশ (শুধুমাত্র ফিল্টার-ভিত্তিক মাত্রা) উপমহাদেশ (শুধুমাত্র ফিল্টার করার মাত্রা) মাস প্রতিটি প্লেলিস্টে ভিউ শুরু প্লেলিস্টে গড় সময় | টীকা_আইডি টীকা_প্রকার সম্পদ_আইডি কার্ড_আইডি কার্ডের ধরন লাইভ বা অন-ডিমান্ড সাবস্ক্রাইব করা_স্ট্যাটাস সাবটাইটেল_ভাষা |
| অনন্য মেট্রিক্স | অনন্য আপেক্ষিক ধারণ কর্মক্ষমতা প্রতিটি প্লেলিস্টে ভিউ শুরু প্লেলিস্টে গড় সময় | কার্ড_ক্লিক_রেট কার্ড_ক্লিক কার্ড_ইম্প্রেশন কার্ড_টিজার_ক্লিক_রেট কার্ড_টিজার_ক্লিক কার্ড_টিজার_ইমপ্রেশন আনুমানিক_অংশীদার_অ্যাডসেন্স_রাজস্ব আনুমানিক_অংশীদার_ডাবলক্লিক_রাজস্ব প্লেলিস্ট_সংরক্ষণ_যোগ করা হয়েছে প্লেলিস্ট_সেভস_রিমুভড |
এপিআইগুলির মধ্যে নামকরণের পার্থক্য
ডাইমেনশন এবং মেট্রিক শনাক্ত করার জন্য এই দুটি এপিআই ভিন্ন নামকরণ পদ্ধতি ব্যবহার করে। ইউটিউব অ্যানালিটিক্স এপিআই-এর নামগুলো ক্যামেলকেস (camelCase) অক্ষরে লেখা হয়, যেমন adType । ইউটিউব রিপোর্টিং এপিআই-এর নামগুলো ছোট হাতের অক্ষরে এবং আন্ডারস্কোর (underscore) ব্যবহার করে লেখা হয়, যেমন ad_type ।
নিম্নলিখিত সারণিগুলিতে সেই ভিন্ন ভিন্ন নামগুলি চিহ্নিত করা হয়েছে যা দুটি এপিআই একই মেট্রিক এবং ডাইমেনশন শনাক্ত করতে ব্যবহার করে। কিছু ক্ষেত্রে, দুটি নামের মধ্যে পার্থক্য এতটাই বেশি হয় যে, একটি নামকে ক্যামেলকেস (camelCase) থেকে আন্ডারস্কোরে (underscores) রূপান্তর করলেও পার্থক্যটা ততটুকুই থাকে না। উদাহরণস্বরূপ, ইউটিউব অ্যানালিটিক্স এপিআই-এর video ডাইমেনশনটির নাম ইউটিউব রিপোর্টিং এপিআই-তে video_id রাখা হয়েছে।