এই পৃষ্ঠাটি এমন প্রতিবেদনগুলি তালিকাভুক্ত করে যা চ্যানেলের মালিকরা YouTube Analytics API এর মাধ্যমে পুনরুদ্ধার করতে পারে৷ চ্যানেল রিপোর্টগুলি একটি নির্দিষ্ট চ্যানেলের জন্য ব্যবহারকারীর কার্যকলাপ মেট্রিক্স প্রদান করে এবং ভিডিও ভিউ, রেটিং এবং সদস্যতা সংখ্যার মতো জিনিসগুলি পরিমাপ করে৷
ভিডিও প্রতিবেদনগুলি একটি চ্যানেলের ভিডিওগুলির সাথে সম্পর্কিত সমস্ত ব্যবহারকারীর কার্যকলাপের পরিসংখ্যান প্রদান করে৷
প্লেলিস্ট রিপোর্টগুলি এমন পরিসংখ্যান প্রদান করে যা বিশেষভাবে একটি প্লেলিস্টের প্রেক্ষাপটে ঘটে যাওয়া ভিডিও ভিউগুলির সাথে সম্পর্কিত৷
বিজ্ঞাপন পারফরম্যান্স রিপোর্টে আয় এবং বিজ্ঞাপনের কার্যক্ষমতা সম্পর্কিত মেট্রিক্স থাকে। ভিডিও প্লেব্যাকের সময় যে ধরনের বিজ্ঞাপনগুলি চলেছিল তার উপর ভিত্তি করে গ্রুপ মেট্রিক্সের জন্য তারা অ্যাড টাইপ ডাইমেনশন ব্যবহার করে। বিজ্ঞাপন পারফরম্যান্স রিপোর্ট বিভাগটি API সমর্থন করে এমন দুটি ধরনের বিজ্ঞাপনের পারফরম্যান্স মেট্রিক্স ব্যাখ্যা করে।
একটি রিপোর্ট পুনরুদ্ধার করা হচ্ছে
একটি চ্যানেল রিপোর্ট পুনরুদ্ধার করতে, আপনাকে অবশ্যই আপনার API অনুরোধে ids প্যারামিটার মান নিম্নলিখিত মানগুলির মধ্যে একটিতে সেট করতে হবে:
channel==MINE – এপিআই প্রমাণীকৃত ব্যবহারকারীর YouTube চ্যানেলের জন্য ডেটা প্রদান করে।
channel== CHANNEL_ID – যে চ্যানেলের জন্য আপনি ডেটা পুনরুদ্ধার করছেন তার অনন্য চ্যানেল আইডিতেCHANNEL_ID সেট করুন। অনুরোধটি অনুমোদনকারী ব্যবহারকারীকে অবশ্যই চ্যানেলের মালিক হতে হবে।
চ্যানেল আইডি বর্তমানে একটি স্ট্রিং যা UC অক্ষর দিয়ে শুরু হয়, যদিও এর বিন্যাস পরিবর্তন সাপেক্ষে। (আপনি আপনার YouTube চ্যানেলের জন্য উন্নত অ্যাকাউন্ট সেটিংস পৃষ্ঠায় আপনার চ্যানেলের আইডি খুঁজে পেতে পারেন, অথবা আপনি YouTube Data API'schannels.list পদ্ধতি ব্যবহার করে প্রোগ্রাম্যাটিকভাবে আপনার চ্যানেলের আইডি পুনরুদ্ধার করতে পারেন।)
অনুমোদন
সমস্ত YouTube Analytics API অনুরোধ অনুমোদিত হতে হবে। অনুমোদন নির্দেশিকা ব্যাখ্যা করে কিভাবে অনুমোদন টোকেন পুনরুদ্ধার করতে OAuth 2.0 প্রোটোকল ব্যবহার করতে হয়।
YouTube Analytics API অনুরোধগুলি নিম্নলিখিত অনুমোদনের সুযোগগুলি ব্যবহার করে:
আপনার YouTube সামগ্রীর জন্য YouTube বিশ্লেষণ প্রতিবেদনগুলি দেখুন৷ এই সুযোগ ব্যবহারকারীর কার্যকলাপ মেট্রিক্সে অ্যাক্সেস প্রদান করে, যেমন ভিউ সংখ্যা এবং রেটিং গণনা।
আপনার YouTube বিষয়বস্তুর জন্য YouTube Analytics আর্থিক প্রতিবেদনগুলি দেখুন৷ এই সুযোগ ব্যবহারকারী কার্যকলাপ মেট্রিক্স এবং আনুমানিক আয় এবং বিজ্ঞাপন কর্মক্ষমতা মেট্রিক্স অ্যাক্সেস প্রদান করে.
https://www.googleapis.com/auth/youtube
আপনার YouTube অ্যাকাউন্ট পরিচালনা করুন। ইউটিউব অ্যানালিটিক্স এপিআই-এ, চ্যানেল মালিকরা ইউটিউব অ্যানালিটিক্স গ্রুপ এবং গ্রুপ আইটেমগুলি পরিচালনা করতে এই সুযোগটি ব্যবহার করে।
https://www.googleapis.com/auth/youtubepartner
YouTube এ YouTube সম্পদ এবং সংশ্লিষ্ট বিষয়বস্তু দেখুন ও পরিচালনা করুন। ইউটিউব অ্যানালিটিক্স এপিআই-এ, কন্টেন্ট মালিকরা ইউটিউব অ্যানালিটিক্স গ্রুপ এবং গ্রুপ আইটেমগুলি পরিচালনা করতে এই সুযোগটি ব্যবহার করে।
দ্রষ্টব্য: আনুমানিক আয় এবং বিজ্ঞাপন কর্মক্ষমতা মেট্রিক্স বর্তমানে চ্যানেল রিপোর্টের জন্য সমর্থিত নয়। ফলস্বরূপ, https://www.googleapis.com/auth/yt-analytics-monetary.readonly স্কোপ বর্তমানে সেই রিপোর্টগুলিতে আর্থিক ডেটা অ্যাক্সেসের অনুমতি দেয় না।
ফিল্টার
যে টেবিলগুলি সমর্থিত রিপোর্টগুলি ব্যাখ্যা করে সেইগুলি ফিল্টারগুলিকে চিহ্নিত করে যা প্রতিটি রিপোর্টের জন্য ব্যবহার করা যেতে পারে৷ সারণিতে, বন্ধনীতে দেখানো ফিল্টারগুলি ঐচ্ছিক। উদাহরণস্বরূপ, video(,country) ফিল্টারিং বিকল্পের জন্য, ভিডিও ফিল্টার প্রয়োজন, এবং দেশ ফিল্টার ঐচ্ছিক।
এপিআই video এবং playlist ফিল্টারগুলির জন্য একাধিক মান নির্দিষ্ট করার ক্ষমতাও সমর্থন করে। আপনি যদি এই ফিল্টারগুলির একটির জন্য একাধিক মান নির্দিষ্ট করেন, তাহলে আপনি অনুরোধের জন্য নির্দিষ্ট করা মাত্রার তালিকায় সেই ফিল্টারটিকেও যোগ করতে পারেন। ফিল্টারটি একটি নির্দিষ্ট প্রতিবেদনের জন্য সমর্থিত মাত্রা হিসাবে তালিকাভুক্ত না হলেও এটি সত্য।
একটি নির্দিষ্ট মান বা মানের সেটের জন্য API ফলাফলগুলি কীভাবে ফিল্টার করতে হয় তার সম্পূর্ণ ব্যাখ্যার জন্য filters প্যারামিটার সংজ্ঞাটি দেখুন।
রিপোর্ট টেবিল বোঝা
এই বিভাগটি টেবিলে ব্যবহৃত ফর্ম্যাটিং এবং পরিভাষা ব্যাখ্যা করে যা API সমর্থন করে এমন প্রতিবেদনগুলিকে সংজ্ঞায়িত করে৷ নিম্নলিখিত সারণীটি সময় মাত্রা এবং গড় ভিউ শতাংশ মেট্রিক ব্যবহার করে প্লেব্যাকের বিশদ ভিডিও প্রতিবেদনের জন্য সমর্থিত মাত্রা, মেট্রিক্স এবং ফিল্টার তালিকাভুক্ত করে।
টেবিলটিতে মাত্রার জন্য দুটি সারি, মেট্রিক্সের জন্য একটি সারি এবং ফিল্টারের জন্য তিনটি সারি রয়েছে। মাত্রা এবং ফিল্টারগুলির জন্য, প্রতিটি সারি থেকে মানগুলিকে API অনুরোধে একত্রিত করা যেতে পারে যতক্ষণ না সংমিশ্রণটি টেবিলের ব্যবহারের নিয়মগুলি অনুসরণ করে৷ সুতরাং, উদাহরণস্বরূপ, এই প্রতিবেদনের বৈধ dimensions প্যারামিটার মানগুলির মধ্যে রয়েছে:
dimensions=day
dimensions=day,subscribedStatus
dimensions=month,subscribedStatus,youtubeProduct
dimensions=month,youtubeProduct
যাইহোক, প্যারামিটার মান day,month অবৈধ কারণ এটি দুটি সময়-ভিত্তিক মাত্রা ব্যবহার করে এবং অনুরোধটি অবশ্যই 0 বা 1 ব্যবহার করতে হবে।
রিপোর্ট টেবিল পরিভাষা
মাত্রা প্রয়োজন বা ঐচ্ছিক কিনা তা নির্দেশ করতে টেবিলগুলি নিম্নলিখিত পরিভাষা ব্যবহার করে:
এই শর্তাবলী মানে একটি মান প্রয়োজন:
প্রয়োজনীয়: আপনাকে অবশ্যই মান অন্তর্ভুক্ত করতে হবে।
ঠিক 1 ব্যবহার করুন: আপনাকে অবশ্যই গ্রুপ থেকে একটি মান অন্তর্ভুক্ত করতে হবে।
1 বা তার বেশি ব্যবহার করুন: আপনি গ্রুপ থেকে যেকোনো বা সমস্ত মান অন্তর্ভুক্ত করতে পারেন, তবে আপনাকে অবশ্যই অন্তত একটি অন্তর্ভুক্ত করতে হবে।
এই শর্তাবলী মানে একটি মান ঐচ্ছিক:
ঐচ্ছিক: আপনার কাছে মান অন্তর্ভুক্ত করার বিকল্প রয়েছে।
0 বা 1 ব্যবহার করুন: আপনার কাছে গ্রুপ থেকে একটি মান অন্তর্ভুক্ত করার বিকল্প রয়েছে।
0 বা তার বেশি ব্যবহার করুন: আপনার কাছে গ্রুপ থেকে যেকোনো বা সমস্ত মান অন্তর্ভুক্ত করার বিকল্প রয়েছে।
ভিডিও রিপোর্ট
মৌলিক পরিসংখ্যান
মৌলিক ব্যবহারকারী কার্যকলাপ পরিসংখ্যান
এই প্রতিবেদনটি একটি চ্যানেলে ব্যবহারকারীদের কর্মের সাথে সম্পর্কিত পরিসংখ্যান প্রদান করে। আপনি শুধুমাত্র একটি নির্দিষ্ট ভিডিও বা দেশের জন্য ডেটা ফেরত রিপোর্ট ফিল্টার করতে পারেন.
মার্কিন যুক্তরাষ্ট্রের জন্য মৌলিক ব্যবহারকারী কার্যকলাপ পরিসংখ্যান
এই প্রতিবেদনটি একটি নির্দিষ্ট মার্কিন রাজ্য বা ডিস্ট্রিক্ট অফ কলম্বিয়ার পরিসংখ্যান প্রদান করে৷ মনে রাখবেন যে এই প্রতিবেদনটি শুধুমাত্র উপরে বর্ণিত দেশ-নির্দিষ্ট প্রতিবেদনে উপলব্ধ মেট্রিক্সের একটি উপসেট সমর্থন করে।
নির্দিষ্ট সময়ের জন্য দেশ অনুসারে ব্যবহারকারীর কার্যকলাপ
এই প্রতিবেদনটি নির্দিষ্ট সময়ের ব্যবধানের জন্য একটি চ্যানেলে ব্যবহারকারীর কর্মের সাথে সম্পর্কিত পরিসংখ্যান প্রদান করে। আপনি শুধুমাত্র একটি নির্দিষ্ট ভিডিও বা দেশের জন্য ডেটা ফেরত রিপোর্ট ফিল্টার করতে পারেন.
নির্দিষ্ট সময়ের জন্য মার্কিন রাজ্যে ব্যবহারকারীর কার্যকলাপ
এই প্রতিবেদনটি একটি নির্দিষ্ট মার্কিন রাজ্য বা ডিস্ট্রিক্ট অফ কলম্বিয়ার জন্য ব্যবহারকারীর কার্যকলাপ সম্পর্কিত পরিসংখ্যান প্রদান করে৷ মনে রাখবেন যে এই প্রতিবেদনটি শুধুমাত্র উপরে বর্ণিত দেশ-নির্দিষ্ট প্রতিবেদনে উপলব্ধ মেট্রিক্সের একটি উপসেট সমর্থন করে।
এই প্রতিবেদনটি একটি চ্যানেলের জন্য দেশ অনুসারে ব্যবহারকারীর কার্যকলাপ সম্পর্কিত পরিসংখ্যান সরবরাহ করে। আপনি শুধুমাত্র একটি নির্দিষ্ট ভিডিওর জন্য ডেটা ফেরত দিতে রিপোর্ট ফিল্টার করতে পারেন।
এই প্রতিবেদনটি ইউএস রাজ্য এবং ডিস্ট্রিক্ট অফ কলম্বিয়ার জন্য ব্যবহারকারীর কার্যকলাপের পরিসংখ্যান প্রদান করে। এই রিপোর্টের জন্য, আপনাকে অবশ্যই filters প্যারামিটার মান country==US এ সেট করতে হবে।
দ্রষ্টব্য: এই প্রতিবেদনের জন্য আপনাকে 250 বা তার কম পূর্ণসংখ্যার মান maxResults প্যারামিটার সেট করতে হবে। অন্যান্য রিপোর্টের বিপরীতে, এই রিপোর্টে আপনাকে sort অনুরোধের প্যারামিটারের জন্য একটি মান নির্দিষ্ট করতে হবে।
এই প্রতিবেদনটি শহর অনুসারে ব্যবহারকারীর কার্যকলাপের পরিসংখ্যান প্রদান করে।
এই প্রতিবেদনটি নির্ধারিত বাজার এলাকা (DMA) দ্বারা ব্যবহারকারীর কার্যকলাপ পরিসংখ্যান প্রদান করে। এই রিপোর্টের জন্য, আপনাকে অবশ্যই filters প্যারামিটার মান country==US এ সেট করতে হবে অথবা একটি নির্দিষ্ট প্রদেশে (মার্কিন রাজ্য) ফিল্টার করতে হবে।
প্লেব্যাক বিশদ প্রতিবেদনগুলি নিম্নলিখিত দেখার বৈশিষ্ট্যগুলির সাথে সম্পর্কিত পরিসংখ্যান প্রদান করে:
একটি লাইভ ভিডিও সম্প্রচারের দৃশ্য নাকি একটি অন-ডিমান্ড ভিডিও ছিল?
দর্শক কি ভিডিওটির মালিক সেই চ্যানেলে সাবস্ক্রাইব করেছিলেন?
কোন YouTube পণ্যে ভিউ ঘটেছে?
দ্রষ্টব্য:liveOrOnDemand মাত্রা এবং ফিল্টার এভারেজভিউ পারসেন্টেজ মেট্রিকের সাথে ব্যবহার করা যাবে না। যেমন, নিচের প্রতিটি উপধারা দুটি প্রতিবেদনের তালিকা করে। একটি প্রতিবেদন liveOrOnDemand মাত্রা (এবং ফিল্টার) সমর্থন করে, অন্যটি গড় ভিউ পারসেন্টেজ মেট্রিক সমর্থন করে।
সদস্যতা স্থিতি দ্বারা ব্যবহারকারী কার্যকলাপ
এই প্রতিবেদনটি সাবস্ক্রাইব করা এবং আনসাবস্ক্রাইব করা দর্শকদের জন্য ব্যবহারকারীর কার্যকলাপ মেট্রিক্স প্রদান করে। পরিসংখ্যানগুলি সময়কাল ( দিন বা মাস ) দ্বারা গোষ্ঠীভুক্ত করা যেতে পারে এবং প্রতিবেদনটি দেশ , মহাদেশ বা উপমহাদেশ দ্বারাও ফিল্টার করা যেতে পারে।
প্রদেশের জন্য সদস্যতা স্থিতি দ্বারা ব্যবহারকারী কার্যকলাপ
এই প্রতিবেদনটি মার্কিন যুক্তরাষ্ট্রের রাজ্য বা ডিস্ট্রিক্ট অফ কলম্বিয়ার সদস্যতা নেওয়া এবং সদস্যতা ত্যাগ করা দর্শকদের জন্য ব্যবহারকারীর কার্যকলাপের মেট্রিক্স সরবরাহ করে৷ এই প্রতিবেদনটি আগের প্রতিবেদনের তুলনায় কম মেট্রিক্স সমর্থন করে।
সময়ের মাত্রা – দিন বা মাস – এই রিপোর্টগুলির জন্য ঐচ্ছিক কারণ, নির্বিশেষে, রিপোর্টটি কভার করবে এমন তারিখের পরিসর নির্দিষ্ট করতে আপনাকে startDate এবং endDate অনুরোধের প্যারামিটার ব্যবহার করতে হবে। মাত্রা, যদি উপস্থিত থাকে, তাহলে নির্দেশ করে যে আপনি রিপোর্টে ডেটা দিন, মাস ইত্যাদি দ্বারা একত্রিত করতে চান।
ঐচ্ছিক সময়ের মাত্রা এবং liveOrOnDemand পরিসংখ্যান সহ প্লেব্যাকের বিবরণ
এই প্রতিবেদনটি নির্দিষ্ট সময়ের ব্যবধানের জন্য প্লেব্যাকের বিস্তারিত পরিসংখ্যান প্রদান করে। এটি liveOrOnDemand মাত্রা (এবং ফিল্টার) সমর্থন করে।
নিম্নলিখিত রিপোর্ট আগের এক অনুরূপ. এটি গড় ভিউ পারসেন্টেজ মেট্রিকের জন্য সমর্থন যোগ করে, কিন্তু এটি একটি মাত্রা বা ফিল্টার হিসাবে liveOrOnDemand সমর্থন করে না।
liveOrOnDemand পরিসংখ্যান সহ প্রদেশ অনুসারে প্লেব্যাকের বিবরণ
এই প্রতিবেদনটি মার্কিন রাজ্য এবং ডিস্ট্রিক্ট অফ কলম্বিয়ার জন্য প্লেব্যাকের বিস্তারিত পরিসংখ্যান প্রদান করে। এটি liveOrOnDemand মাত্রা (এবং ফিল্টার) সমর্থন করে।
নিম্নলিখিত রিপোর্ট আগের এক অনুরূপ. এটি গড় ভিউ পারসেন্টেজ মেট্রিকের জন্য সমর্থন যোগ করে, তবে এটি একটি মাত্রা বা ফিল্টার হিসাবে liveOrOnDemand সমর্থন করে না।
দ্রষ্টব্য: এই প্রতিবেদনের জন্য আপনাকে maxResults প্যারামিটারটিকে 25 বা তার কম পূর্ণসংখ্যার মান সেট করতে হবে। অন্যান্য রিপোর্টের মত নয়, এই রিপোর্টে আপনাকে sort অনুরোধের প্যারামিটারের জন্য একটি মান নির্দিষ্ট করতে হবে।
এই প্রতিবেদনটি এমবেড করা ভিডিও প্লেয়ারগুলিকে চিহ্নিত করে যা একটি চ্যানেলের ভিডিওগুলির জন্য সর্বাধিক ভিউ বা দেখার সময় তৈরি করেছে৷
এই প্রতিবেদনটি দর্শকরা আপনার ভিডিও সামগ্রীতে পৌঁছানোর পদ্ধতির উপর ভিত্তি করে দেখার পরিসংখ্যানকে একত্রিত করে৷ উদাহরণস্বরূপ, এটি একটি Google অনুসন্ধান বা একটি সম্পর্কিত ভিডিওর লিঙ্ক থেকে আসা ভিউ সংখ্যা চিহ্নিত করে৷
দ্রষ্টব্য: এই প্রতিবেদনের জন্য আপনাকে maxResults প্যারামিটারটিকে 25 বা তার কম পূর্ণসংখ্যার মান সেট করতে হবে। অন্যান্য রিপোর্টের মত নয়, এই রিপোর্টে আপনাকে sort অনুরোধের প্যারামিটারের জন্য একটি মান নির্দিষ্ট করতে হবে।
এই প্রতিবেদনটি চ্যানেলের বিষয়বস্তুর জন্য সবচেয়ে বেশি ভিউ জেনারেট করেছে এমন রেফারারের উপর ভিত্তি করে দেখার পরিসংখ্যান একত্রিত করে। রেফারারদের ট্রাফিক সোর্স টাইপ দ্বারা শ্রেণীবদ্ধ করা হয়, এবং ইনসাইট ট্রাফিক সোর্স ডিটেইল ডাইমেনশনের সংজ্ঞা সেই ট্র্যাফিক সোর্সগুলিকে চিহ্নিত করে যার জন্য রিপোর্টটি পাওয়া যায়। উদাহরণ স্বরূপ, আপনি যদি ইনসাইট ট্রাফিক সোর্স টাইপ ফিল্টারটিকে ADVERTISING সেট করেন, তাহলে প্রতিবেদনটি সেই ধরনের বিজ্ঞাপনের তালিকা করবে যা চ্যানেলের সামগ্রীর জন্য সর্বাধিক দেখা বা দেখার সময় তৈরি করেছে৷
দ্রষ্টব্য: এই প্রতিবেদনটি শুধুমাত্র নির্দিষ্ট ট্রাফিক উৎসের জন্য সমর্থিত। VIDEO_REMIXES , NOTIFICATION , END_SCREEN , CAMPAIGN_CARD , VIDEO_REMIXES , এবং NO_LINK_EMBEDDED ট্রাফিক সোর্স হল কিছু অসমর্থিত।
ডিভাইসের ধরন এবং অপারেটিং সিস্টেম
ডিভাইসের ধরন
এই প্রতিবেদনটি দর্শকরা আপনার ভিডিও সামগ্রীতে পৌঁছানোর পদ্ধতির উপর ভিত্তি করে দেখার পরিসংখ্যানকে একত্রিত করে৷ উদাহরণ স্বরূপ, এটি মোবাইল ডিভাইস বা গেম কনসোলগুলিতে কতগুলি ভিউ হয়েছে তা চিহ্নিত করে৷
এই প্রতিবেদনটি দর্শকদের অপারেটিং সিস্টেমের উপর ভিত্তি করে দেখার পরিসংখ্যানকে একত্রিত করে। উদাহরণস্বরূপ, এটি অ্যান্ড্রয়েড ডিভাইসে বা প্লেস্টেশনে কতবার দেখা হয়েছে তা শনাক্ত করে।
এই প্রতিবেদনটি দর্শকদের অপারেটিং সিস্টেম এবং ডিভাইসের প্রকারের উপর ভিত্তি করে দেখার পরিসংখ্যানকে একত্রিত করে৷ উদাহরণস্বরূপ, এটি অ্যান্ড্রয়েড ট্যাবলেট বা উইন্ডোজ ডেস্কটপ ডিভাইসে কতগুলি দেখা হয়েছে তা শনাক্ত করে৷
উদাহরণস্বরূপ, সাবস্ক্রাইবড স্ট্যাটাস ডাইমেনশন ব্যবহার করে এমন একটি রিপোর্ট সাবস্ক্রাইব করা ভিউয়ের জন্য 100 শতাংশ পর্যন্ত ভিউয়ার পারসেন্টেজ ডেটা যোগ করে এবং আনসাবস্ক্রাইব করা ভিউয়ের জন্য ভিউয়ার পারসেন্টেজ ডেটা 100 শতাংশ পর্যন্ত যোগ করে। (প্রতিবেদনের সমস্ত দর্শকের শতকরা ক্ষেত্রগুলির মোট মান 200 শতাংশ৷)
প্লেব্যাকের বিস্তারিত মাত্রার জন্য রিপোর্টে শুধুমাত্র একটি মান (বা মানগুলির সংমিশ্রণ) জন্য দর্শকের পারসেন্টেজ ডেটা রয়েছে তা নিশ্চিত করতে আপনি ফিল্টার ব্যবহার করতে পারেন।
ব্যস্ততা এবং বিষয়বস্তু শেয়ারিং
এই প্রতিবেদনটি বিভিন্ন সামাজিক প্ল্যাটফর্মে চ্যানেলের ভিডিওগুলি কত ঘন ঘন শেয়ার করা হয়েছে তা দেখানো পরিসংখ্যান প্রদান করে।
এই প্রতিবেদনটি একটি ভিডিওর দর্শক ধরে রাখার ক্ষমতা পরিমাপ করে এবং একটি ভিডিওর নির্দিষ্ট অংশ কতবার দেখা হয়েছে তাও দেখায়৷ elapsedVideoTimeRatio অনুপাতের মাত্রা সংশ্লিষ্ট মেট্রিক মানগুলির জন্য অতিবাহিত হওয়া ভিডিওর পরিমাণ পরিমাপ করে৷ মেট্রিক্স দুটি বিভাগে বিভক্ত করা যেতে পারে:
শ্রোতা ধরে রাখা
এই মেট্রিকগুলি দেখায় যে ভিডিওটি তার দর্শকদের কতটা ভালোভাবে ধরে রেখেছে।
audienceWatchRatio হল এমন একটি অনুপাত যা ভিডিওটির মোট দেখার সংখ্যার সাথে ভিডিওর একটি অংশ কতবার দেখা হয়েছে তার তুলনা করে।
relativeRetentionPerformance দেখায় যে একই দৈর্ঘ্যের অন্যান্য YouTube ভিডিওর তুলনায় একটি ভিডিও প্লেব্যাকের সময় দর্শকদের কতটা ভালোভাবে ধরে রাখে।
দানাদার ঘড়ি পরিসংখ্যান
এই মেট্রিকগুলি একটি ভিডিওর নির্দিষ্ট অংশ কতবার দেখা হয়েছে সে সম্পর্কে তথ্য প্রদান করে।
startedWatching নির্দেশ করে যে ভিডিওর একটি নির্দিষ্ট অংশের সময় দর্শকরা কত ঘন ঘন একটি ভিডিও দেখতে শুরু করেছে৷
stoppedWatching নির্দেশ করে যে কত ঘন ঘন দর্শকরা ভিডিওর একটি নির্দিষ্ট অংশে ভিডিও দেখা বন্ধ করে দেয়।
দ্রষ্টব্য: এই প্রতিবেদনটি video ফিল্টারের জন্য একটি কমা দ্বারা পৃথক করা মানগুলির তালিকা নির্দিষ্ট করার ক্ষমতা সমর্থন করে না; মান একটি একক ভিডিও আইডি নির্দিষ্ট করতে হবে।
এই প্রতিবেদনটি একক লাইভ-স্ট্রিম করা ভিডিওর জন্য একটি নির্দিষ্ট অবস্থানে সমকালীন দর্শকদের দেখায়। ফিল্টার ভিডিওটি নির্দিষ্ট করে। অবস্থানের মাত্রা সাধারণত এক মিনিটের প্রতিনিধিত্ব করে।
দ্রষ্টব্য: এই রিপোর্টগুলির জন্য আপনাকে 200 বা তার কম একটি পূর্ণসংখ্যার মান maxResults প্যারামিটার সেট করতে হবে। জানুয়ারী 1, 2013 এর আগে ডেটা শুধুমাত্র সেরা 10 ভিডিওর জন্য উপলব্ধ। অন্যান্য রিপোর্টের বিপরীতে, এই রিপোর্টগুলির জন্য আপনাকে sort অনুরোধের প্যারামিটারের জন্য একটি মান নির্দিষ্ট করতে হবে।
ঐচ্ছিক আঞ্চলিক ফিল্টার সহ সেরা ভিডিও (<= 200 ফলাফল)
এই প্রতিবেদনে চ্যানেলের শীর্ষ ভিডিওগুলির তালিকা রয়েছে৷ প্রতিবেদনটি দেশ , মহাদেশ বা উপমহাদেশ অনুসারে শীর্ষ ভিডিওগুলি তালিকাভুক্ত করতে ফিল্টার করা যেতে পারে৷
এই প্রতিবেদনে একটি নির্দিষ্ট মার্কিন রাজ্য বা ডিস্ট্রিক্ট অফ কলম্বিয়ার চ্যানেলের শীর্ষ ভিডিওগুলির তালিকা রয়েছে৷ মনে রাখবেন যে এই প্রতিবেদনটি শুধুমাত্র উপরে বর্ণিত দেশ-নির্দিষ্ট প্রতিবেদনে উপলব্ধ মেট্রিক্সের একটি উপসেট সমর্থন করে।
সাবস্ক্রাইব করা বা আনসাবস্ক্রাইব করা দর্শকদের জন্য সেরা ভিডিও (<= 200 ফলাফল)
এই প্রতিবেদনটি সাবস্ক্রাইব করা বা আনসাবস্ক্রাইব করা দর্শকদের জন্য চ্যানেলের শীর্ষ ভিডিওগুলির তালিকা করে৷ প্রতিবেদনটি দেশ , মহাদেশ বা উপমহাদেশ অনুসারে শীর্ষ ভিডিওগুলি তালিকাভুক্ত করতে ফিল্টার করা যেতে পারে৷ পূর্ববর্তী প্রতিবেদনটি আপনাকে সদস্যতা নেওয়া বা আনসাবস্ক্রাইব করা দর্শকদের জন্য একটি নির্দিষ্ট মার্কিন রাজ্যের শীর্ষ ভিডিওগুলি পুনরুদ্ধার করতে দেয়, তবে এটি এই প্রতিবেদনের চেয়ে কম মেট্রিক্স সমর্থন করে৷
এই প্রতিবেদনটি চ্যানেলের শীর্ষ ভিডিওগুলির তালিকা করে এবং প্লেব্যাকের বিবরণ এবং ভৌগলিক ফিল্টারগুলিকে সমর্থন করে৷ এই প্রতিবেদনটি আগেরটির মতই, তবে এটি কম মেট্রিক্স সমর্থন করে এবং youtubeProduct ফিল্টারের জন্য সমর্থন যোগ করে।
প্লেব্যাক বিশদ ফিল্টার সহ সেরা ভিডিও (<= 200 ফলাফল)
এই প্রতিবেদনে চ্যানেলের শীর্ষ ভিডিওগুলির তালিকা করা হয়েছে, যে কোনো বা সমস্ত প্লেব্যাকের বিস্তারিত মাত্রা দ্বারা ফিল্টার করা হয়েছে: liveOrOnDemand , subscribedStatus , এবং youtubeProduct ৷ পূর্ববর্তী প্রতিবেদনের বিপরীতে, এটি একটি liveOrOnDemand ফিল্টার সমর্থন করে এবং গড় ভিউ পারসেন্টেজ মেট্রিক সমর্থন করে না।
প্লেলিস্ট রিপোর্টগুলিতে চ্যানেল মালিকের প্লেলিস্টের ভিডিওগুলির সাথে সম্পর্কিত ব্যবহারকারীর কার্যকলাপ সম্পর্কিত মেট্রিক্স রয়েছে৷ এই প্রতিবেদনগুলির দুটি সংস্করণ উপলব্ধ, এবং প্রতিটি উপলব্ধ প্রতিবেদনের জন্য, নিম্নলিখিত বিভাগে প্রতিটি সংস্করণের একটি বিবরণ রয়েছে:
প্রতিটি বিভাগে প্রস্তাবিত ট্যাব সংশ্লিষ্ট প্রতিবেদন পুনরুদ্ধারের জন্য পছন্দের API অনুরোধ বিন্যাস বর্ণনা করে। প্রস্তাবিত প্রতিবেদনগুলি মেট্রিক্সের একটি বর্ধিত সেট সমর্থন করে যাতে সমষ্টিগত ভিডিও মেট্রিক্স এবং ইন-প্লেলিস্ট মেট্রিক্স উভয়ই অন্তর্ভুক্ত থাকে। এই অনুরোধ বিন্যাস isCurated মাত্রা ব্যবহার করে না।
প্রতিটি বিভাগে isCurated ব্যবহার করা ট্যাব একটি পুরানো API অনুরোধ বিন্যাস বর্ণনা করে যেখানে isCurated মাত্রা প্রয়োজন। এই রিপোর্টগুলি শুধুমাত্র ইন-প্লেলিস্ট মেট্রিক্স সমর্থন করে। মনে রাখবেন যে isCurated ডাইমেনশনটি সমস্ত রিপোর্টের জন্য বাতিল করা হয়েছে। নীচের সতর্কীকরণ নোট অবচয় সময়সূচী ব্যাখ্যা করে।
নিম্নলিখিত সতর্কীকরণ নোট দুটি রিপোর্ট সংস্করণের মধ্যে পরিবর্তনগুলি আরও বিশদে ব্যাখ্যা করে৷
একত্রিত ভিডিও মেট্রিক্স
এই মেট্রিকগুলি ব্যবহারকারীর কার্যকলাপ এবং ইম্প্রেশন মেট্রিক্স প্রদান করে যা প্লেলিস্টের সমস্ত ভিডিওগুলির জন্য একত্রিত হয় যেগুলি প্লেলিস্টের মালিক চ্যানেলের মালিকানাধীন। অন্যান্য চ্যানেলের মালিকানাধীন ভিডিওগুলির মেট্রিক্স একত্রিতকরণে গণনা করা হয় না। ফলস্বরূপ, যদি একটি চ্যানেল এমন একটি প্লেলিস্ট তৈরি করে যাতে শুধুমাত্র অন্যান্য চ্যানেলের মালিকানাধীন ভিডিওগুলি থাকে, সেই প্লেলিস্টগুলির প্রতিবেদনগুলি এই মেট্রিক্সগুলির জন্য মান প্রদান করবে না৷
ইউটিউব সমর্থন করে এমন সমষ্টিগত ভিডিও মেট্রিকগুলির একটি তালিকার জন্য সমর্থিত প্লেলিস্ট মেট্রিক্স বিভাগটি দেখুন৷
ইন-প্লেলিস্ট মেট্রিক্স
এই মেট্রিক্স প্লেলিস্ট পৃষ্ঠার প্রসঙ্গে ব্যবহারকারীর কার্যকলাপ এবং ব্যস্ততা প্রতিফলিত করে। এই মেট্রিক্সগুলি প্লেলিস্টের সমস্ত ভিডিওর ভিউ অন্তর্ভুক্ত করে, কোন চ্যানেল তাদের মালিকানাধীন তা নির্বিশেষে, তবে শুধুমাত্র প্লেলিস্টের প্রেক্ষাপটে ঘটেছে এমন ভিউকে গণনা করে৷
এই প্রতিবেদনটি চ্যানেলের প্লেলিস্টের ভিডিওগুলির সাথে ব্যবহারকারীদের মিথস্ক্রিয়া সম্পর্কিত পরিসংখ্যান প্রদান করে৷ আপনি শুধুমাত্র একটি নির্দিষ্ট প্লেলিস্টের জন্য ডেটা ফেরত দিতে প্রতিবেদনটি ফিল্টার করতে পারেন।
এই প্রতিবেদনটি চ্যানেলের প্লেলিস্টের ভিডিওগুলির সাথে ব্যবহারকারীদের মিথস্ক্রিয়া সম্পর্কিত পরিসংখ্যান প্রদান করে৷ আপনি শুধুমাত্র একটি নির্দিষ্ট প্লেলিস্টের জন্য ডেটা ফেরত দিতে প্রতিবেদনটি ফিল্টার করতে পারেন।
এই প্রতিবেদনটি মার্কিন রাজ্য এবং ডিস্ট্রিক্ট অফ কলম্বিয়ার জন্য প্লেলিস্ট কার্যকলাপ পরিসংখ্যান প্রদান করে৷ এই প্রতিবেদনের জন্য, শুধুমাত্র মার্কিন যুক্তরাষ্ট্রের জন্য ডেটা ফেরত দিতে আপনাকে অবশ্যই ফলাফল ফিল্টার করতে হবে।
দ্রষ্টব্য: এই প্রতিবেদনের জন্য আপনাকে maxResults প্যারামিটারটিকে 25 বা তার কম পূর্ণসংখ্যার মান সেট করতে হবে। অন্যান্য রিপোর্টের মত নয়, এই রিপোর্টে আপনাকে sort অনুরোধের প্যারামিটারের জন্য একটি মান নির্দিষ্ট করতে হবে।
এই প্রতিবেদনটি এমবেড করা ভিডিও প্লেয়ারগুলিকে চিহ্নিত করে যা চ্যানেলের প্লেলিস্টে ভিডিওগুলির জন্য সর্বাধিক ভিউ বা দেখার সময় তৈরি করেছে৷
এই প্রতিবেদনটি দর্শকরা কীভাবে আপনার প্লেলিস্ট সামগ্রীতে পৌঁছেছে তার উপর ভিত্তি করে দেখার পরিসংখ্যান একত্রিত করে৷ উদাহরণস্বরূপ, এটি একটি Google অনুসন্ধান থেকে উদ্ভূত ভিউ সংখ্যা চিহ্নিত করে।
দ্রষ্টব্য: এই প্রতিবেদনের জন্য আপনাকে maxResults প্যারামিটারটিকে 25 বা তার কম পূর্ণসংখ্যার মান সেট করতে হবে। অন্যান্য রিপোর্টের মত নয়, এই রিপোর্টে আপনাকে sort অনুরোধের প্যারামিটারের জন্য একটি মান নির্দিষ্ট করতে হবে।
এই প্রতিবেদনটি চ্যানেলের প্লেলিস্টের ভিডিওগুলির জন্য সর্বাধিক ভিউ তৈরি করেছে এমন রেফারারের উপর ভিত্তি করে দেখার পরিসংখ্যান একত্রিত করে৷ রেফারারদের ট্রাফিক সোর্স টাইপ দ্বারা শ্রেণীবদ্ধ করা হয়, এবং ইনসাইট ট্রাফিক সোর্স ডিটেইল ডাইমেনশনের সংজ্ঞা সেই ট্র্যাফিক সোর্সগুলিকে চিহ্নিত করে যার জন্য রিপোর্টটি পাওয়া যায়।
উদাহরণ স্বরূপ, আপনি যদি ইনসাইট ট্রাফিক সোর্স টাইপ ফিল্টারটিকে ADVERTISING সেট করেন, তাহলে প্রতিবেদনটি সেই ধরনের বিজ্ঞাপনের তালিকা করবে যা চ্যানেলের প্লেলিস্টের জন্য সর্বাধিক দেখা বা দেখার সময় তৈরি করেছে৷
দ্রষ্টব্য: এই প্রতিবেদনটি শুধুমাত্র নির্দিষ্ট ট্রাফিক উৎসের জন্য সমর্থিত। VIDEO_REMIXES , NOTIFICATION , END_SCREEN , CAMPAIGN_CARD , VIDEO_REMIXES , এবং NO_LINK_EMBEDDED ট্রাফিক সোর্স হল কিছু অসমর্থিত।
ডিভাইসের ধরন এবং অপারেটিং সিস্টেম
ডিভাইসের ধরন
আপনার প্লেলিস্টের ভিডিওগুলিতে দর্শকরা কীভাবে পৌঁছেছে তার উপর ভিত্তি করে এই প্রতিবেদনটি দেখার পরিসংখ্যান একত্রিত করে৷ উদাহরণ স্বরূপ, এটি মোবাইল ডিভাইস বা গেম কনসোলগুলিতে কতগুলি ভিউ হয়েছে তা চিহ্নিত করে৷
এই প্রতিবেদনটি দর্শকদের অপারেটিং সিস্টেমের উপর ভিত্তি করে দেখার পরিসংখ্যানকে একত্রিত করে। উদাহরণস্বরূপ, এটি অ্যান্ড্রয়েড ডিভাইসে বা প্লেস্টেশনে কতবার দেখা হয়েছে তা শনাক্ত করে।
এই প্রতিবেদনটি দর্শকদের অপারেটিং সিস্টেম এবং ডিভাইসের প্রকারের উপর ভিত্তি করে দেখার পরিসংখ্যানকে একত্রিত করে৷ উদাহরণস্বরূপ, এটি Android ট্যাবলেট বা উইন্ডোজ ডেস্কটপ ডিভাইসে কতবার দেখা হয়েছে তা শনাক্ত করে।
উদাহরণস্বরূপ, সাবস্ক্রাইবড স্ট্যাটাস ডাইমেনশন ব্যবহার করে এমন একটি রিপোর্ট সাবস্ক্রাইব করা ভিউয়ের জন্য 100 শতাংশ পর্যন্ত ভিউয়ার পারসেন্টেজ ডেটা যোগ করে এবং আনসাবস্ক্রাইব করা ভিউয়ের জন্য ভিউয়ার পারসেন্টেজ ডেটা 100 শতাংশ পর্যন্ত যোগ করে। (প্রতিবেদনের সমস্ত দর্শকের শতকরা ক্ষেত্রগুলির মোট মান 200 শতাংশ৷)
দ্রষ্টব্য: এই রিপোর্টগুলির জন্য আপনাকে 200 বা তার কম একটি পূর্ণসংখ্যার মান maxResults প্যারামিটার সেট করতে হবে। জানুয়ারী 1, 2013 এর আগে ডেটা শুধুমাত্র সেরা 10 প্লেলিস্টের জন্য উপলব্ধ। অন্যান্য রিপোর্টের বিপরীতে, এই রিপোর্টগুলির জন্য আপনাকে sort অনুরোধের প্যারামিটারের জন্য একটি মান নির্দিষ্ট করতে হবে।
এই প্রতিবেদনটি নির্দিষ্ট ফিল্টারিং এবং বাছাইয়ের মানদণ্ডের উপর ভিত্তি করে চ্যানেলের শীর্ষ প্লেলিস্টের তালিকা করে।
দ্রষ্টব্য: বিজ্ঞাপন কার্যসম্পাদন প্রতিবেদনগুলির জন্য একটি অনুমোদন টোকেন প্রয়োজন যা https://www.googleapis.com/auth/yt-analytics-monetary.readonly সুযোগে অ্যাক্সেস দেয়৷
বিজ্ঞাপনের কর্মক্ষমতা প্রতিবেদনগুলি ভিডিও প্লেব্যাকের সময় চলা বিজ্ঞাপনগুলির জন্য ইম্প্রেশন-ভিত্তিক মেট্রিক্স প্রদান করে। এই মেট্রিক্স প্রতিটি বিজ্ঞাপন ইম্প্রেশনের জন্য হিসাব করে এবং প্রতিটি ভিডিও প্লেব্যাক একাধিক ইমপ্রেশন দিতে পারে।
এছাড়াও, কিছু ভিডিও রিপোর্ট নিম্নোক্ত প্লেব্যাক-ভিত্তিক বিজ্ঞাপন কর্মক্ষমতা মেট্রিক্স সমর্থন করে। যাইহোক, এই মেট্রিকগুলি বিজ্ঞাপনের কর্মক্ষমতা প্রতিবেদনে অন্তর্ভুক্ত করা হয় না।