YouTube Analytics API আপনাকে YouTube Analytics ডেটা সহ কাস্টম রিপোর্ট তৈরি করতে সক্ষম করে৷ API চ্যানেল এবং বিষয়বস্তু মালিকদের জন্য রিপোর্ট সমর্থন করে. রিপোর্ট ক্ষেত্রগুলি হয় মাত্রা বা মেট্রিক্স হিসাবে চিহ্নিত করা হয়:
মাত্রাগুলি হল সাধারণ মানদণ্ড যা ডেটা একত্রিত করতে ব্যবহৃত হয়, যেমন তারিখ যে তারিখে একটি অ্যাকশন ঘটেছে বা ব্যবহারকারীরা যে দেশে অবস্থিত ছিল।
একটি প্রতিবেদনে, ডেটার প্রতিটি সারিতে মাত্রা মানগুলির একটি অনন্য সমন্বয় রয়েছে। যেমন, একটি প্রতিবেদনের জন্য আপনি যে মাত্রাগুলি চয়ন করেন তা নির্ধারণ করে যে YouTube কীভাবে সেই প্রতিবেদনে মেট্রিক্সের মানগুলি গণনা করে৷
- মেট্রিক্স হল ব্যবহারকারীর কার্যকলাপ, বিজ্ঞাপনের পারফরম্যান্স বা আনুমানিক আয় সম্পর্কিত পৃথক পরিমাপ। ব্যবহারকারীর ক্রিয়াকলাপ মেট্রিক্সে ভিডিও দেখার সংখ্যা এবং রেটিং (পছন্দ এবং অপছন্দ) এর মতো বিষয়গুলি অন্তর্ভুক্ত থাকে।
অ্যানালিটিক্স এপিআই ফিল্টারিং এবং বাছাই করার পরামিতি প্রদান করে, তাই কলিং অ্যাপ্লিকেশনটিকে সেই ফাংশনগুলিকে স্থানীয়ভাবে সমর্থন করার প্রয়োজন নেই৷ এপিআই আপনাকে YouTube অ্যানালিটিক্স গোষ্ঠীগুলির জন্য ডেটা পুনরুদ্ধার করার অনুমতি দেয়, যেখানে একটি গ্রুপ হল 500টি ভিডিও, প্লেলিস্ট, চ্যানেল বা সম্পদের একটি কাস্টম সংগ্রহ।
প্রতিবেদনের পরামিতি নির্বাচন করা হচ্ছে
যখন আপনি একটি প্রতিবেদনের অনুরোধ করেন, API-এর reports.query পদ্ধতি ব্যবহার করে, API অনুরোধে পাঁচটি প্যারামিটার থাকে যা নির্ধারণ করে যে কীভাবে প্রতিবেদনের মানগুলি গণনা করা হবে:
startDateএবংendDateপরামিতি নির্দিষ্ট সময়কালের জন্য রিপোর্টে ডেটা থাকবে। API প্রতিক্রিয়া প্রকৃতপক্ষে নির্দিষ্ট শেষ দিন পর্যন্ত ডেটা ধারণ করে যার জন্য কোয়েরির সমস্ত মেট্রিক কোয়েরির সময় উপলব্ধ থাকে।metricsপ্যারামিটার রিপোর্টে অন্তর্ভুক্ত করা হবে যে পরিমাপ নির্দিষ্ট করে. চ্যানেল রিপোর্টে, মেট্রিক্স ব্যবহারকারীর কার্যকলাপ পরিমাপ করে এবং ভিউ এবং লাইকের মত মানগুলি অন্তর্ভুক্ত করে। কিছু মেট্রিক্স বিজ্ঞাপনের কার্যক্ষমতা বা আনুমানিক আয়ও পরিমাপ করে।dimensionsপ্যারামিটার ব্যাখ্যা করে কিভাবে মেট্রিকগুলিকে গোষ্ঠীবদ্ধ করা হবে।filtersপ্যারামিটার ব্যাখ্যা করে কিভাবে রিপোর্ট ডেটা ফিল্টার করা হবে। সুতরাং, উদাহরণস্বরূপ, একটি চ্যানেলের জন্য সমস্ত ডেটা ফেরত দেওয়ার পরিবর্তে, একটি প্রতিবেদন শুধুমাত্র একটি নির্দিষ্ট দেশ, ভিডিও বা ভিডিওগুলির গ্রুপের জন্য মেট্রিক্স ধারণ করার জন্য ফিল্টার করা যেতে পারে।দ্রষ্টব্য: API আপনাকে ভিডিও , প্লেলিস্ট এবং চ্যানেল ফিল্টারগুলির জন্য একাধিক মান নির্দিষ্ট করতে দেয়৷ আপনি যদি তা করেন, তাহলে আপনি সেই ফিল্টারটিকে মাত্রার তালিকায় অন্তর্ভুক্ত করতে পারেন যাতে প্রত্যাবর্তিত মেট্রিকগুলিকে ভিডিও, প্লেলিস্ট বা চ্যানেল দ্বারা গোষ্ঠীবদ্ধ করা হয়।
নমুনা রিপোর্টিং বিকল্প
উদাহরণ স্বরূপ, ধরুন একজন চ্যানেলের মালিক মোবাইল ডিভাইস, গেম কনসোল, টিভি ইত্যাদিতে চ্যানেলের ভিডিও কতবার দেখা হয়েছে তা নির্ধারণ করতে একটি ভিডিও ডিভাইস টাইপ রিপোর্ট পুনরুদ্ধার করতে চায়৷
চ্যানেলের মালিক
startDateপ্যারামিটার2015-06-01এবংendDateপ্যারামিটার2015-07-31এ সেট করে। এই মানগুলির উপর ভিত্তি করে, প্রতিবেদনে দুই মাসের সময়ের জন্য ডেটা থাকবে।ডিভাইস টাইপ রিপোর্ট ভিউ এবং আনুমানিক মিনিট দেখা মেট্রিক্স সমর্থন করে, তাই চ্যানেলের মালিক
metricsপ্যারামিটারটিকেviews,estimatedMinutesWatchedসেট করে।dimensionsপরামিতি জন্য, চ্যানেল মালিকের বিকল্প একটি সংখ্যা আছে. তাদের মধ্যে দুটি নিম্নলিখিত তালিকায় দেখানো হয়েছে, এবং তৃতীয়টি এই বিভাগে পরেfiltersপ্যারামিটারের মানের ব্যাখ্যায় আলোচনা করা হয়েছে।প্যারামিটারের মানটিকে
deviceTypeএ সেট করার মানে হল যে রিপোর্টে কভার করা পুরো সময়কালের জন্য ভিডিওর ধরন অনুসারে দেখার সংখ্যা এবং দেখার সময় গণনাগুলিকে গোষ্ঠীভুক্ত করা হবে। সুতরাং, এই মান সহ, প্রতিবেদনের ডেটা এই ধরনের প্রশ্নের উত্তর দেবে:- চ্যানেলের ভিডিওগুলি 1 জুন, 2015 এবং 31 জুলাই, 2015 এর মধ্যে মোবাইল ডিভাইসে কতবার দেখা হয়েছে?
- 1 জুন, 2015 এবং 31 জুলাই, 2015 এর মধ্যে চ্যানেলের ভিডিওগুলি গেম কনসোলে কতবার দেখা হয়েছে?
রিপোর্টে আসলে প্রতিটি ডিভাইসের জন্য মোট ভিউ এবং দেখার সময়ের গণনা থাকবে।
day,deviceTypeমানে হল যে রিপোর্টিং সময়কালে প্রতিটি দিনের জন্য ডিভাইসের ধরন দ্বারা ভিউ সংখ্যা এবং দেখার সময় গণনা করা হবে। সুতরাং, এই মান সহ, প্রতিবেদনের ডেটা এই ধরনের প্রশ্নের উত্তর দেবে:- 1 জুন, 2015 এ চ্যানেলের ভিডিও মোবাইল ডিভাইসে কতবার দেখা হয়েছে?
- 14 জুলাই, 2015-এ চ্যানেলের ভিডিওগুলি টেলিভিশনে কতবার দেখা হয়েছিল?
অবশেষে,
filtersপ্যারামিটার চ্যানেলের মালিককে শুধুমাত্র নির্দিষ্ট ফিল্টার মানগুলির সাথে মিলে যাওয়া ডেটা অন্তর্ভুক্ত করার জন্য প্রতিবেদনে সীমাবদ্ধ করার অনুমতি দেয়। প্রতিবেদনটি তাদের সকলকে ব্যাখ্যা করার জন্য অনেকগুলি ফিল্টারিং বিকল্পকে সমর্থন করে, তাই এই উদাহরণগুলি আপনার তৈরি করা প্রতিবেদনগুলির শুধুমাত্র একটি ভগ্নাংশকে উপস্থাপন করে।চ্যানেল মালিক শুধুমাত্র Android অপারেটিং সিস্টেমের জন্য মান ফেরত দেওয়ার অনুরোধ ফিল্টার করতে পারে। (প্রতিবেদনের সময়কালে অ্যান্ড্রয়েড মোবাইল ডিভাইসে কতবার দেখা হয়েছে?)
চ্যানেল মালিক শুধুমাত্র একটি নির্দিষ্ট দেশের জন্য মান ফেরত দেওয়ার অনুরোধ ফিল্টার করতে পারে। (প্রতিবেদন সময়ের প্রতিটি দিনে কানাডায় কতবার ভিডিও দেখা হয়েছে?)
চ্যানেলের মালিক শুধুমাত্র নির্দিষ্ট ভিডিওর জন্য মান ফেরত দেওয়ার অনুরোধ ফিল্টার করতে পারে। যাইহোক, ভিডিও ফিল্টার মানগুলির একটি কমা দ্বারা পৃথক করা তালিকা সমর্থন করে, তাই প্রতিবেদনে আসলে অনেক ভিডিওর ডেটা থাকতে পারে।
উপরন্তু, যদি ভিডিও ফিল্টার একাধিক মান নির্দিষ্ট করে, তাহলে ভিডিওকে একটি মাত্রা হিসাবেও নির্দিষ্ট করা যেতে পারে। এর মানে হল যে
dimensionsপ্যারামিটারdeviceType,videoএবংday,deviceType,videoমানগুলিকে সমর্থন করে।- চ্যানেল মালিক যদি মাত্রার তালিকায় ভিডিও অন্তর্ভুক্ত করে, তাহলে মেট্রিক্স প্রতিটি ভিডিওর জন্য পৃথক মান নির্দিষ্ট করে। (1 জুন, 2015-এ XYZ ভিডিওটি গেম কনসোলে কতবার দেখা হয়েছিল?)
- চ্যানেলের মালিক যদি মাত্রার তালিকায় ভিডিও অন্তর্ভুক্ত না করে, তাহলে মেট্রিক্স নির্দিষ্ট করা সমস্ত ভিডিও কভার করে মোট মান নির্দিষ্ট করে। (1 জুন, 2015-এ ABC, DEF, এবং XYZ ভিডিওগুলি একটি গেম কনসোলে কতবার দেখা হয়েছিল?)
রিপোর্ট পুনরুদ্ধার করা হচ্ছে
একটি প্রতিবেদন পুনরুদ্ধার করতে, API-এর reports.query পদ্ধতিতে একটি অনুমোদিত GET অনুরোধ পাঠান, যে প্যারামিটারগুলি আপনি যে রিপোর্টটি পুনরুদ্ধার করতে চান তা সংজ্ঞায়িত করে।
API সমর্থন করে এমন প্রতিবেদনের তালিকার জন্য চ্যানেলের প্রতিবেদন এবং বিষয়বস্তুর মালিকের প্রতিবেদনের ডকুমেন্টেশন দেখুন। প্রতিটি রিপোর্টের সংজ্ঞা সেই মানগুলিকে চিহ্নিত করে যা রিপোর্টটি metrics , dimensions এবং filters প্যারামিটারের জন্য অনুমতি দেয়।
সেরা অনুশীলন
যে অ্যাপ্লিকেশনগুলি YouTube Analytics API ব্যবহার করে তাদের সর্বদা এই অনুশীলনগুলি অনুসরণ করা উচিত:
- রিপোর্টের কলামের ক্রম নির্ধারণ করতে একটি প্রতিক্রিয়ার শিরোনাম সারি ব্যবহার করুন। উদাহরণ স্বরূপ, অনুমান করবেন না যে ভিউগুলি একটি প্রতিক্রিয়ায় প্রত্যাবর্তিত প্রথম মেট্রিক হবে কারণ এটি একটি প্রতিবেদনের বিবরণে তালিকাভুক্ত প্রথম মেট্রিক। পরিবর্তে, কোন কলামে সেই ডেটা রয়েছে তা নির্ধারণ করতে প্রতিক্রিয়ার শিরোনাম সারি ব্যবহার করুন।
- YouTube Analytics API প্রতিক্রিয়াগুলিতে চিহ্নিত সংস্থানগুলির জন্য অতিরিক্ত মেটাডেটা পুনরুদ্ধার করতে YouTube ডেটা API ব্যবহার করুন৷ YouTube API পরিষেবা বিকাশকারী নীতিগুলিতে উল্লিখিত হিসাবে (বিভাগ III.E.4.b থেকে III.E.4.d), API ক্লায়েন্টদের অবশ্যই 30 দিনের পরে সেই API থেকে সঞ্চিত সংস্থান মেটাডেটা মুছতে হবে বা রিফ্রেশ করতে হবে।
একত্রিত মেট্রিক্স এবং মুছে ফেলা আইটেম
YouTube Analytics API প্রতিক্রিয়াগুলিতে মুছে ফেলা আইটেমগুলির জন্য মেট্রিক ব্রেকডাউন থাকে না। উদাহরণস্বরূপ, যদি একজন চ্যানেলের মালিক একটি ভিডিও মুছে ফেলে, তাহলে সেই ভিডিওটি আর একটি API প্রতিক্রিয়াতে তালিকাভুক্ত হবে না যা ভিডিও-বাই-ভিডিও ভিত্তিতে মেট্রিক্স প্রদান করে। যাইহোক, প্রতিবেদনে যে সংস্থানগুলির একটি সেটের জন্য সমষ্টিগত মেট্রিক্স এখনও মুছে ফেলা আইটেমগুলির সাথে সম্পর্কিত মেট্রিকগুলিকে অন্তর্ভুক্ত করে।
উদাহরণস্বরূপ, ধরুন একজন চ্যানেলের মালিক দুটি প্রতিবেদন পুনরুদ্ধার করেছেন। প্রথম প্রতিবেদনটি একটি নির্দিষ্ট সময়ের মধ্যে চ্যানেলের সমস্ত ভিডিওর জন্য মোট দৈনিক ভিউ তালিকাভুক্ত করে। দ্বিতীয় প্রতিবেদনটি একই সময়ের মধ্যে ভিডিও-বাই-ভিডিও ভিত্তিতে মোট দৈনিক ভিউ তালিকাভুক্ত করে।
এই ক্ষেত্রে, প্রথম রিপোর্টের সংখ্যাগুলি ভিডিওগুলির ভিউ অন্তর্ভুক্ত করবে যেগুলি পরে মুছে ফেলা হয়েছিল কারণ প্রথম রিপোর্টে দৈনিক সমষ্টি রয়েছে৷ যাইহোক, দ্বিতীয় প্রতিবেদনে মুছে ফেলা আইটেমগুলির সাথে সম্পর্কিত ভিউ অন্তর্ভুক্ত করা হবে না কারণ দ্বিতীয় প্রতিবেদনটি ভিডিও-বাই-ভিডিও ভিত্তিতে ভিউ তালিকাভুক্ত করে। ফলস্বরূপ, যদি প্রতিবেদনটি কভার করা সময়ের মধ্যে চ্যানেল ভিডিওগুলি মুছে ফেলে, তাহলে প্রথম প্রতিবেদনে রিপোর্ট করা মোট দৈনিক ভিউকাউন্ট দ্বিতীয় প্রতিবেদনে দৈনিক, ভিডিও-নির্দিষ্ট ভিউকাউন্টের যোগফলের চেয়ে বেশি হতে পারে।
ডেটা বেনামীকরণ
কিছু YouTube Analytics ডেটা সীমিত থাকে যখন মেট্রিক্স একটি নির্দিষ্ট থ্রেশহোল্ড পূরণ করে না। এটি বিভিন্ন প্রতিবেদনে ঘটতে পারে। বাস্তবে, এর মানে হল যে একটি রিপোর্টে আপনার সমস্ত ডেটা (বা যেকোনো) নাও থাকতে পারে যদি:
একটি নির্দিষ্ট সময়ের মধ্যে একটি ভিডিও বা চ্যানেলে সীমিত ট্রাফিক আছে,
বা
আপনি একটি ফিল্টার বা মাত্রা নির্বাচন করেছেন, যেমন ট্রাফিক উৎস বা দেশ, যার মান একটি নির্দিষ্ট থ্রেশহোল্ড পূরণ করে না।
যে ক্ষেত্রে ডেটা সীমিত, সেই রিপোর্টগুলি কীভাবে ডেটা একত্রিত করে তার উপর নির্ভর করে বিভিন্ন রিপোর্টে রিপোর্ট করা মোটের মধ্যে পার্থক্য থাকতে পারে।
উদাহরণস্বরূপ, ধরুন একজন চ্যানেলের মালিক দুটি প্রতিবেদন পুনরুদ্ধার করেছেন। প্রথম প্রতিবেদনটি একটি নির্দিষ্ট ভিডিওর জন্য মোট ভিউ তালিকাভুক্ত করে, এবং দ্বিতীয় প্রতিবেদনটি দেশ অনুসারে সেই ভিডিওটির জন্য মোট ভিউ তালিকাভুক্ত করে৷ নির্দিষ্ট সময়ের মধ্যে, অনুমান করুন যে ভিডিওটি 1000 বার দেখা হয়েছে, যেখানে মার্কিন যুক্তরাষ্ট্রে 500 বার দেখা হয়েছে, কানাডায় 498টি এবং ফ্রান্সে দুটি ঘটেছে৷
এই উদাহরণে, প্রথম রিপোর্টটি নির্দেশ করবে যে ভিডিওটি 1000 বার দেখা হয়েছে৷ দ্বিতীয় প্রতিবেদনটি শুধুমাত্র নির্দেশ করবে যে ভিডিওটি মার্কিন যুক্তরাষ্ট্রে 500 বার এবং কানাডায় 498 বার দেখা হয়েছে৷ যেমন, দুটি রিপোর্টে মোট ভিউ সংখ্যার মধ্যে পার্থক্য থাকবে। মনে রাখবেন যে দ্বিতীয় প্রতিবেদনে এমন কোন ইঙ্গিত থাকবে না যে দুটি অন্য মতামতও ঘটেছে (বা ফ্রান্সে কোন মতামত ঘটেছে)।
প্রকৃত থ্রেশহোল্ড যেখানে ডেটা সীমিত তা প্রকাশিত হয় না এবং YouTube-এর বিবেচনার ভিত্তিতে পরিবর্তন হতে পারে।
সীমিত ডেটা প্রকার
YouTube অ্যানালিটিক্স রিপোর্টে নিম্নলিখিত ডেটা সীমিত হতে পারে:
- জনসংখ্যার তথ্য, যেমন বয়স এবং লিঙ্গ।
- ভৌগলিক ডেটা, মেট্রিক্স বা মাত্রা সহ দেশ বা অঞ্চল যেখানে দর্শকদের অবস্থান ছিল, যেমন তাদের দেশ বা অঞ্চল। উল্লেখ্য, যাইহোক, প্রতিবেদনগুলি রাজস্ব মেট্রিক্সে ভূগোল থ্রেশহোল্ড প্রয়োগ করে না।
- নির্দিষ্ট ট্রাফিক উৎসের সাথে সম্পর্কিত মেট্রিক্স, যেমন সার্চের পদ বা বাহ্যিক ইউআরএল যা আপনার ভিডিওর ভিউ দেখায়। উদাহরণ স্বরূপ, খুব কম সংখ্যক ভিউ নিয়ে যাওয়া সার্চ টার্ম এবং ইউআরএল রিপোর্টে দেখা যাবে না, যদিও আপনি এখনও এমন শব্দ এবং ইউআরএল দেখতে পাবেন যা আপনার কন্টেন্টে অনেক দর্শককে চালিত করে।
YouTube বিশ্লেষণ প্রতিবেদনে সীমিত ডেটা সম্পর্কে আরও তথ্যের জন্য YouTube সহায়তা কেন্দ্র দেখুন।
কোটা ব্যবহার
প্রতিটি API অনুরোধ যা আপনি আপনার API ব্যবহারের কোটার এক ইউনিট হিসাবে গণনা করেন। কোটা সীমা Google API কনসোলের কোটা প্যানেলে দৃশ্যমান।