দ্রষ্টব্য:Content owner reports are only accessible to YouTube content partners who participate in the YouTube Partner Program .
এই পৃষ্ঠাটি প্রতিবেদনগুলিকে তালিকাভুক্ত করে যে বিষয়বস্তুর মালিকরা YouTube Analytics API দিয়ে পুনরুদ্ধার করতে পারেন৷ বিষয়বস্তুর মালিকের প্রতিবেদনে একটি নির্দিষ্ট YouTube বিষয়বস্তুর মালিকের সাথে লিঙ্ক করা চ্যানেলগুলির মেট্রিক্স থাকে৷ মেট্রিক্স হল ব্যবহারকারীর কার্যকলাপ, বিজ্ঞাপনের কার্যকারিতা বা আনুমানিক আয়ের পৃথক পরিমাপ।
ভিডিও রিপোর্টে ব্যবহারকারীর কার্যকলাপ, বিজ্ঞাপনের কার্যকারিতা, এবং একটি বিষয়বস্তুর মালিকের চ্যানেলে ভিডিওগুলির জন্য আনুমানিক আয়ের মেট্রিক্স থাকে৷
প্লেলিস্ট রিপোর্টগুলি এমন পরিসংখ্যান প্রদান করে যা বিশেষভাবে একটি প্লেলিস্টের প্রেক্ষাপটে ঘটে যাওয়া ভিডিও ভিউগুলির সাথে সম্পর্কিত৷ প্লেলিস্ট রিপোর্টগুলি ভিডিও রিপোর্ট হিসাবে একই মাত্রা এবং ফিল্টার ব্যবহার করে।
বিজ্ঞাপন পারফরম্যান্স রিপোর্টে আয় এবং বিজ্ঞাপনের কার্যক্ষমতা সম্পর্কিত মেট্রিক্স থাকে। ভিডিও প্লেব্যাকের সময় যে ধরনের বিজ্ঞাপনগুলি চলেছিল তার উপর ভিত্তি করে গ্রুপ মেট্রিক্সের জন্য তারা অ্যাড টাইপ ডাইমেনশন ব্যবহার করে। বিজ্ঞাপন পারফরম্যান্স রিপোর্ট বিভাগটি API সমর্থন করে এমন দুটি ধরনের বিজ্ঞাপনের পারফরম্যান্স মেট্রিক্স ব্যাখ্যা করে।
একটি রিপোর্ট পুনরুদ্ধার করা হচ্ছে
একটি বিষয়বস্তুর মালিকের প্রতিবেদন পুনরুদ্ধার করতে, API-এর reports.query পদ্ধতিতে কল করুন এবং API অনুরোধে ids প্যারামিটার মান সেট করুন contentOwner== OWNER_NAME , যেখানে OWNER_NAME সামগ্রীর মালিকের আইডি নির্দিষ্ট করে৷ আপনার পার্টনার ম্যানেজারকে জিজ্ঞাসা করুন যদি আপনি মূল্য সম্পর্কে অনিশ্চিত হন।
অনুমোদন
সমস্ত 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 সুযোগে অ্যাক্সেস দেয়৷
ফিল্টার
বিষয়বস্তুর মালিকের প্রতিবেদন পুনরুদ্ধার করার জন্য সমস্ত API অনুরোধগুলিকে video মাত্রা, channel মাত্রা, isCurated মাত্রা বা claimedStatus এবং uploaderType মাত্রার সমর্থিত সমন্বয় ব্যবহার করে ডেটা ফিল্টার করতে হবে। (সমর্থিত সমন্বয়গুলি uploaderType মাত্রার সংজ্ঞায় তালিকাভুক্ত করা হয়েছে।)
যে টেবিলগুলি সমর্থিত প্রতিবেদনগুলি ব্যাখ্যা করে সেগুলি ফিল্টারগুলিকে চিহ্নিত করে যা যে কোনও প্রদত্ত প্রতিবেদনের জন্য ব্যবহার করা যেতে পারে। বর্ণনায়, বন্ধনীতে দেখানো ফিল্টারগুলি ঐচ্ছিক। উদাহরণ স্বরূপ, যদি একটি প্রতিবেদনে video(,country) একটি ফিল্টারিং বিকল্প হিসেবে তালিকাভুক্ত করা হয়, তাহলে প্রতিবেদনটি হয় শুধুমাত্র একটি নির্দিষ্ট ভিডিওর জন্য ডেটা অন্তর্ভুক্ত করার জন্য বা শুধুমাত্র একটি নির্দিষ্ট দেশের একটি নির্দিষ্ট ভিডিওর জন্য ডেটা অন্তর্ভুক্ত করার জন্য ফিল্টার করা যেতে পারে।
এপিআই video , playlist এবং channel ফিল্টারগুলির জন্য একাধিক মান নির্দিষ্ট করার ক্ষমতাকেও সমর্থন করে৷ আপনি যদি এই ফিল্টারগুলির একটির জন্য একাধিক মান নির্দিষ্ট করেন, তাহলে আপনি অনুরোধের জন্য নির্দিষ্ট করা মাত্রার তালিকায় সেই ফিল্টারটিকেও যোগ করতে পারেন। ফিল্টারটি একটি নির্দিষ্ট প্রতিবেদনের জন্য সমর্থিত মাত্রা হিসাবে তালিকাভুক্ত না হলেও এটি সত্য।
একটি নির্দিষ্ট মান বা মানের সেটের জন্য API ফলাফলগুলি কীভাবে ফিল্টার করতে হয় তার সম্পূর্ণ ব্যাখ্যার জন্য filters প্যারামিটার সংজ্ঞাটি দেখুন।
রিপোর্ট টেবিল বোঝা
এই বিভাগটি টেবিলে ব্যবহৃত ফর্ম্যাটিং এবং পরিভাষা ব্যাখ্যা করে যা API সমর্থন করে এমন প্রতিবেদনগুলিকে সংজ্ঞায়িত করে৷ নীচের সারণীটি সময় মাত্রা এবং গড় ভিউ পারসেন্টেজ মেট্রিক ব্যবহার করে প্লেব্যাকের বিশদ ভিডিও প্রতিবেদনের জন্য সমর্থিত মাত্রা, মেট্রিক্স এবং ফিল্টার তালিকাভুক্ত করে।
টেবিলটিতে মাত্রার জন্য দুটি সারি, মেট্রিক্সের জন্য একটি সারি এবং ফিল্টারের জন্য তিনটি সারি রয়েছে। মাত্রা এবং ফিল্টারগুলির জন্য, প্রতিটি সারি থেকে মানগুলিকে API অনুরোধে একত্রিত করা যেতে পারে যতক্ষণ না সংমিশ্রণটি টেবিলের ব্যবহারের নিয়মগুলি অনুসরণ করে৷ সুতরাং, উদাহরণস্বরূপ, এই প্রতিবেদনের বৈধ dimensions প্যারামিটার মানগুলির মধ্যে রয়েছে:
dimensions=day
dimensions=day,liveOrOnDemand
dimensions=month,subscribedStatus,youtubeProduct
dimensions=month,youtubeProduct
যাইহোক, প্যারামিটার মান day,month অবৈধ কারণ এটি দুটি সময়-ভিত্তিক মাত্রা ব্যবহার করে, তবে অনুরোধটি 0 বা 1 ব্যবহার করতে পারে। এই ক্ষেত্রে, প্যারামিটার মান subscribedStatus,youtubeProduct আসলে একটি রিপোর্ট ফেরত দেয়, কিন্তু মেট্রিক্স একত্রিত হয় না দিন, সপ্তাহ, মাস, ইত্যাদি দ্বারা (সেই প্রতিবেদনটি ডকুমেন্টেশনে আলাদাভাবে নথিভুক্ত করা হয়েছে।)
রিপোর্ট টেবিল পরিভাষা
মাত্রা প্রয়োজন বা ঐচ্ছিক কিনা তা নির্দেশ করতে টেবিলগুলি নিম্নলিখিত পরিভাষা ব্যবহার করে:
এই শর্তাবলী মানে একটি মান প্রয়োজন:
প্রয়োজনীয়: আপনাকে অবশ্যই মান অন্তর্ভুক্ত করতে হবে।
ঠিক 1 ব্যবহার করুন: আপনাকে অবশ্যই গ্রুপ থেকে একটি মান অন্তর্ভুক্ত করতে হবে।
1 বা তার বেশি ব্যবহার করুন: আপনি গ্রুপ থেকে যেকোনো বা সমস্ত মান অন্তর্ভুক্ত করতে পারেন, তবে আপনাকে অবশ্যই অন্তত একটি অন্তর্ভুক্ত করতে হবে।
এই শর্তাবলী মানে একটি মান ঐচ্ছিক:
ঐচ্ছিক: আপনার কাছে মান অন্তর্ভুক্ত করার বিকল্প রয়েছে।
0 বা 1 ব্যবহার করুন: আপনার কাছে গ্রুপ থেকে একটি মান অন্তর্ভুক্ত করার বিকল্প রয়েছে।
0 বা তার বেশি ব্যবহার করুন: আপনার কাছে গ্রুপ থেকে যেকোনো বা সমস্ত মান অন্তর্ভুক্ত করার বিকল্প রয়েছে।
গুরুত্বপূর্ণ: বিষয়বস্তু মালিকের ভিডিও প্রতিবেদন পুনরুদ্ধার করার জন্য সমস্ত API অনুরোধগুলিকে অবশ্যই ভিডিও মাত্রা, চ্যানেলের মাত্রা, গোষ্ঠীর মাত্রা বা দাবিকৃত স্থিতি এবং আপলোডার টাইপ মাত্রার সমর্থিত সমন্বয় ব্যবহার করে ডেটা ফিল্টার করতে হবে৷ (কিছু প্রতিবেদন এই সমস্ত বিকল্পগুলিকে সমর্থন করে না৷) সমর্থিত সংমিশ্রণগুলি, যা আপলোডার টাইপ মাত্রার সংজ্ঞাতেও তালিকাভুক্ত করা হয়েছে:
uploaderType==self
claimedStatus==claimed
claimedStatus==claimed;uploaderType==self
claimedStatus==claimed;uploaderType==thirdParty
ভিডিও রিপোর্ট
মৌলিক পরিসংখ্যান
মৌলিক পরিসংখ্যান (গ্রাহকের সংখ্যা সহ)
এই প্রতিবেদনটি একটি বিষয়বস্তুর মালিকের চ্যানেলের সমস্ত ব্যবহারকারীর কর্মের সাথে সম্পর্কিত পরিসংখ্যান প্রদান করে৷ আপনি শুধুমাত্র একটি নির্দিষ্ট ভিডিও বা দেশের জন্য ডেটা ফেরত রিপোর্ট ফিল্টার করতে পারেন. এটি শুধুমাত্র দাবি করা বিষয়বস্তুর পরিসংখ্যান পুনরুদ্ধার করতেও ব্যবহার করা যেতে পারে, যার মধ্যে বিষয়বস্তুর মালিক, তৃতীয় পক্ষ বা উভয়ের দ্বারা আপলোড করা দাবি করা সামগ্রী অন্তর্ভুক্ত।
এই প্রতিবেদনটি একটি নির্দিষ্ট মার্কিন রাজ্য বা ডিস্ট্রিক্ট অফ কলম্বিয়ার পরিসংখ্যান প্রদান করে৷ মনে রাখবেন যে এই প্রতিবেদনটি শুধুমাত্র উপরে বর্ণিত দেশ-নির্দিষ্ট প্রতিবেদনে উপলব্ধ মেট্রিক্সের একটি উপসেট সমর্থন করে।
এই প্রতিবেদনটি নির্দিষ্ট সময়ের ব্যবধানের জন্য সামগ্রীর মালিকের সমস্ত চ্যানেলে ব্যবহারকারীর ক্রিয়াকলাপ সম্পর্কিত পরিসংখ্যান সরবরাহ করে। আপনি শুধুমাত্র একটি নির্দিষ্ট ভিডিও বা দেশের জন্য ডেটা ফেরত রিপোর্ট ফিল্টার করতে পারেন.
নির্দিষ্ট সময়ের জন্য মার্কিন রাজ্যে ব্যবহারকারীর কার্যকলাপ
এই প্রতিবেদনটি একটি নির্দিষ্ট মার্কিন রাজ্য বা ডিস্ট্রিক্ট অফ কলম্বিয়ার পরিসংখ্যান প্রদান করে৷ মনে রাখবেন যে এই প্রতিবেদনটি শুধুমাত্র উপরে বর্ণিত দেশ-নির্দিষ্ট প্রতিবেদনে উপলব্ধ মেট্রিক্সের একটি উপসেট সমর্থন করে।
এই প্রতিবেদনটি একটি বিষয়বস্তুর মালিকের সমস্ত চ্যানেলের জন্য দেশ অনুসারে ব্যবহারকারীর কার্যকলাপ সম্পর্কিত পরিসংখ্যান প্রদান করে৷ আপনি শুধুমাত্র একটি নির্দিষ্ট ভিডিও বা চ্যানেলের জন্য ডেটা ফেরত দিতে প্রতিবেদনটি ফিল্টার করতে পারেন।
এই প্রতিবেদনটি ইউএস রাজ্য এবং ডিস্ট্রিক্ট অফ কলম্বিয়ার জন্য ব্যবহারকারীর কার্যকলাপের পরিসংখ্যান প্রদান করে। এই রিপোর্টের জন্য, আপনাকে অবশ্যই filters প্যারামিটার মান country==US এ সেট করতে হবে।
দ্রষ্টব্য: এই প্রতিবেদনের জন্য আপনাকে maxResults প্যারামিটারটিকে 250 বা তার কম পূর্ণসংখ্যার মান সেট করতে হবে। অন্যান্য রিপোর্টের বিপরীতে, এই রিপোর্টে আপনাকে sort অনুরোধের প্যারামিটারের জন্য একটি মান নির্দিষ্ট করতে হবে।
এই প্রতিবেদনটি শহর অনুসারে ব্যবহারকারীর কার্যকলাপের পরিসংখ্যান প্রদান করে।
প্লেব্যাক বিশদ প্রতিবেদনগুলি নিম্নলিখিত দেখার বৈশিষ্ট্যগুলির সাথে সম্পর্কিত পরিসংখ্যান প্রদান করে:
একটি লাইভ ভিডিও সম্প্রচারের দৃশ্য নাকি একটি অন-ডিমান্ড ভিডিও ছিল?
দর্শক কি ভিডিওটির মালিক সেই চ্যানেলে সাবস্ক্রাইব করেছিলেন?
কোন YouTube পণ্যে ভিউ ঘটেছে?
টেকনিক্যালি, প্লেব্যাকের বিস্তারিত মাত্রা যা এই রিপোর্টগুলি সমর্থন করে সবই ঐচ্ছিক৷ আপনি যদি আপনার অনুরোধে প্লেব্যাকের বিশদ মাত্রা অন্তর্ভুক্ত না করেন, তবে প্রত্যাবর্তিত প্রতিবেদনটি প্রকৃতপক্ষে মৌলিক পরিসংখ্যান , সময়-ভিত্তিক বা ব্যবহারকারীর ভূগোল প্রতিবেদনগুলির একটির মতো হবে৷
দ্রষ্টব্য:liveOrOnDemand মাত্রা এবং ফিল্টার এভারেজভিউ পারসেন্টেজ মেট্রিকের সাথে ব্যবহার করা যাবে না। যেমন, নিচের প্রতিটি উপধারা দুটি প্রতিবেদনের তালিকা করে। একটি প্রতিবেদন liveOrOnDemand মাত্রা (এবং ফিল্টার) সমর্থন করে, অন্যটি গড় ভিউ পারসেন্টেজ মেট্রিক সমর্থন করে।
সদস্যতা স্থিতি দ্বারা ব্যবহারকারী কার্যকলাপ
এই প্রতিবেদনটি সাবস্ক্রাইব করা এবং আনসাবস্ক্রাইব করা দর্শকদের জন্য ব্যবহারকারীর কার্যকলাপ মেট্রিক্স প্রদান করে। পরিসংখ্যানগুলি সময়কাল ( দিন বা মাস ) দ্বারা গোষ্ঠীভুক্ত করা যেতে পারে এবং প্রতিবেদনটি দেশ , মহাদেশ বা উপমহাদেশ দ্বারাও ফিল্টার করা যেতে পারে।
প্রদেশের জন্য সদস্যতা স্থিতি দ্বারা ব্যবহারকারী কার্যকলাপ
এই প্রতিবেদনটি মার্কিন যুক্তরাষ্ট্রের রাজ্য বা ডিস্ট্রিক্ট অফ কলম্বিয়ার সদস্যতা নেওয়া এবং সদস্যতা ত্যাগ করা দর্শকদের জন্য ব্যবহারকারীর কার্যকলাপের মেট্রিক্স সরবরাহ করে৷ এই প্রতিবেদনটি আগের প্রতিবেদনের তুলনায় কম মেট্রিক্স সমর্থন করে।
সময়ের মাত্রা – দিন বা মাস – এই রিপোর্টগুলির জন্য ঐচ্ছিক কারণ, নির্বিশেষে, রিপোর্টটি কভার করবে এমন তারিখের পরিসর নির্দিষ্ট করতে আপনাকে startDate এবং endDate অনুরোধের প্যারামিটার ব্যবহার করতে হবে। মাত্রা, যদি উপস্থিত থাকে, তাহলে নির্দেশ করে যে আপনি রিপোর্টে ডেটা দিন, মাস ইত্যাদি দ্বারা একত্রিত করতে চান।
ঐচ্ছিক সময়ের মাত্রা এবং liveOrOnDemand পরিসংখ্যান সহ প্লেব্যাকের বিবরণ
এই প্রতিবেদনটি নির্দিষ্ট সময়ের ব্যবধানের জন্য প্লেব্যাকের বিস্তারিত পরিসংখ্যান প্রদান করে। এটি liveOrOnDemand মাত্রা (এবং ফিল্টার) সমর্থন করে।
নিম্নলিখিত রিপোর্ট আগের এক অনুরূপ. এটি গড় ভিউ পারসেন্টেজ মেট্রিকের জন্য সমর্থন যোগ করে, কিন্তু এটি একটি মাত্রা বা ফিল্টার হিসাবে liveOrOnDemand সমর্থন করে না।
liveOrOnDemand পরিসংখ্যান সহ প্রদেশ অনুসারে প্লেব্যাকের বিবরণ
এই প্রতিবেদনটি মার্কিন রাজ্য এবং ডিস্ট্রিক্ট অফ কলম্বিয়ার জন্য প্লেব্যাকের বিস্তারিত পরিসংখ্যান প্রদান করে। এটি liveOrOnDemand মাত্রা (এবং ফিল্টার) সমর্থন করে।
নিম্নলিখিত রিপোর্ট আগের এক অনুরূপ. এটি গড় ভিউ পারসেন্টেজ মেট্রিকের জন্য সমর্থন যোগ করে, কিন্তু এটি একটি মাত্রা বা ফিল্টার হিসাবে liveOrOnDemand সমর্থন করে না।
দ্রষ্টব্য: এই প্রতিবেদনের জন্য আপনাকে maxResults প্যারামিটারটিকে 25 বা তার কম পূর্ণসংখ্যার মান সেট করতে হবে। অন্যান্য রিপোর্টের বিপরীতে, এই রিপোর্টে আপনাকে sort অনুরোধের প্যারামিটারের জন্য একটি মান নির্দিষ্ট করতে হবে।
এই প্রতিবেদনটি এমবেড করা ভিডিও প্লেয়ারগুলিকে চিহ্নিত করে যা কোনও সামগ্রীর মালিকের সামগ্রীর জন্য সর্বাধিক ভিউ বা দেখার সময় তৈরি করেছে৷ এই প্রতিবেদনটি পুনরুদ্ধার করার সময়, আপনাকে অবশ্যই insightPlaybackLocationType ফিল্টারটি EMBEDDED এ সেট করতে হবে।
এই প্রতিবেদনটি দর্শকরা আপনার ভিডিও সামগ্রীতে পৌঁছানোর পদ্ধতির উপর ভিত্তি করে দেখার পরিসংখ্যানকে একত্রিত করে৷ উদাহরণস্বরূপ, এটি একটি Google অনুসন্ধান বা একটি সম্পর্কিত ভিডিওর লিঙ্ক থেকে আসা ভিউ সংখ্যা চিহ্নিত করে৷
দ্রষ্টব্য: এই প্রতিবেদনের জন্য আপনাকে maxResults প্যারামিটারটিকে 25 বা তার কম পূর্ণসংখ্যার মান সেট করতে হবে। অন্যান্য রিপোর্টের বিপরীতে, এই রিপোর্টে আপনাকে sort অনুরোধের প্যারামিটারের জন্য একটি মান নির্দিষ্ট করতে হবে।
এই প্রতিবেদনটি রেফারারের উপর ভিত্তি করে দেখার পরিসংখ্যানগুলিকে একত্রিত করে যা সামগ্রীর মালিকের সামগ্রীর জন্য সর্বাধিক ভিউ তৈরি করেছে৷ রেফারারদের ট্রাফিক সোর্স টাইপ দ্বারা শ্রেণীবদ্ধ করা হয়, এবং ইনসাইট ট্রাফিক সোর্স ডিটেইল ডাইমেনশনের সংজ্ঞা সেই ট্র্যাফিক সোর্সগুলিকে চিহ্নিত করে যার জন্য রিপোর্টটি পাওয়া যায়। উদাহরণস্বরূপ, যদি আপনি ADVERTISING এ insightTrafficSourceType ফিল্টার সেট করেন, তাহলে প্রতিবেদনটি সেই ধরনের বিজ্ঞাপনের তালিকা করবে যা সামগ্রীর মালিকের সামগ্রীর জন্য সর্বাধিক দেখা বা দেখার সময় তৈরি করেছে৷
দ্রষ্টব্য: এই প্রতিবেদনটি শুধুমাত্র নির্দিষ্ট ট্রাফিক উৎসের জন্য সমর্থিত। উদাহরণস্বরূপ, NO_LINK_EMBEDDED ট্র্যাফিক উত্সের অতিরিক্ত বিবরণ নেই এবং তাই, এই প্রতিবেদনটিকে সমর্থন করে না৷ কোন ট্র্যাফিক উত্স এই প্রতিবেদনটিকে সমর্থন করে সে সম্পর্কে বিশদ বিবরণের জন্য insightTrafficSourceType টাইপ সংজ্ঞা দেখুন৷
ডিভাইসের ধরন এবং অপারেটিং সিস্টেম
ডিভাইসের ধরন
এই প্রতিবেদনটি আপনার সামগ্রী দেখার সময় দর্শকরা যে ধরনের ডিভাইস ব্যবহার করেছিল তার উপর ভিত্তি করে দেখার পরিসংখ্যান একত্রিত করে৷ উদাহরণস্বরূপ, এটি ট্যাবলেট বা গেম কনসোলগুলিতে কতগুলি দেখা হয়েছে তা চিহ্নিত করে৷
এই প্রতিবেদনটি দর্শকদের অপারেটিং সিস্টেমের উপর ভিত্তি করে দেখার পরিসংখ্যানকে একত্রিত করে। উদাহরণস্বরূপ, এটি অ্যান্ড্রয়েড ডিভাইসে বা প্লেস্টেশনে কতবার দেখা হয়েছে তা শনাক্ত করে।
এই প্রতিবেদনটি দর্শকদের অপারেটিং সিস্টেম এবং ডিভাইসের প্রকারের উপর ভিত্তি করে দেখার পরিসংখ্যানকে একত্রিত করে৷ উদাহরণস্বরূপ, এটি অ্যান্ড্রয়েড ট্যাবলেট বা উইন্ডোজ ডেস্কটপ ডিভাইসে কতগুলি দেখা হয়েছে তা শনাক্ত করে৷
উদাহরণস্বরূপ, যদি একটি রিপোর্ট সাবস্ক্রাইবড স্ট্যাটাস ডাইমেনশন ব্যবহার করে, তাহলে এটি সাবস্ক্রাইব করা ভিউয়ের জন্য 100 শতাংশ পর্যন্ত ভিউয়ার পারসেন্টেজ ডেটা এবং আনসাবস্ক্রাইব করা ভিউয়ের জন্য 100 শতাংশ পর্যন্ত ভিউয়ার পারসেন্টেজ ডেটা যোগ করে। (প্রতিবেদনের সমস্ত দর্শকের শতকরা ক্ষেত্রগুলির মোট মান 200 শতাংশ৷)
এই প্রতিবেদনটি একটি ভিডিওর দর্শক ধরে রাখার ক্ষমতা পরিমাপ করে৷ elapsedVideoTimeRatio মাত্রা সংশ্লিষ্ট মেট্রিক মানগুলির জন্য অতিবাহিত হওয়া ভিডিওর পরিমাণ পরিমাপ করে৷ audienceWatchRatio এবং relativeRetentionPerformance মেট্রিক্স দুটি পরিমাপ প্রদান করে যা দেখায় যে ভিডিওটি তার দর্শকদের কতটা ভালোভাবে ধরে রেখেছে। প্রথমটি একটি পরম মান, যখন দ্বিতীয়টি দেখায় যে ভিডিওটি একই দৈর্ঘ্যের অন্যান্য YouTube ভিডিওগুলির তুলনায় কীভাবে কাজ করে৷
দ্রষ্টব্য: শ্রোতা ধরে রাখার প্রতিবেদনগুলি video ফিল্টারের জন্য একটি কমা দ্বারা পৃথক করা মানগুলির তালিকা নির্দিষ্ট করার ক্ষমতা সমর্থন করে না; মান একটি একক ভিডিও আইডি নির্দিষ্ট করতে হবে।
দ্রষ্টব্য: এই রিপোর্টগুলির জন্য আপনাকে 200 বা তার কম একটি পূর্ণসংখ্যার মান maxResults প্যারামিটার সেট করতে হবে। জানুয়ারী 1, 2013 এর আগে ডেটা শুধুমাত্র সেরা 10 ভিডিওর জন্য উপলব্ধ। অন্যান্য রিপোর্টের বিপরীতে, এই রিপোর্টগুলির জন্য আপনাকে sort অনুরোধের প্যারামিটারের জন্য একটি মান নির্দিষ্ট করতে হবে।
সামগ্রিকভাবে সেরা ভিডিও, দেশ অনুসারে, মহাদেশ বা উপমহাদেশ অনুসারে (<= 200টি ফলাফল)
এই প্রতিবেদনটি নির্দিষ্ট ফিল্টারিং এবং সাজানোর মানদণ্ডের উপর ভিত্তি করে বিষয়বস্তুর মালিকের শীর্ষ ভিডিওগুলির তালিকা করে৷
এই প্রতিবেদনটি একটি নির্দিষ্ট মার্কিন রাজ্য বা ডিস্ট্রিক্ট অফ কলম্বিয়ার সামগ্রীর মালিকের শীর্ষ ভিডিওগুলির তালিকা করে৷ মনে রাখবেন যে এই প্রতিবেদনটি শুধুমাত্র উপরে বর্ণিত দেশ-নির্দিষ্ট প্রতিবেদনে উপলব্ধ মেট্রিক্সের একটি উপসেট সমর্থন করে।
সাবস্ক্রাইব করা বা আনসাবস্ক্রাইব করা দর্শকদের জন্য সেরা ভিডিও (<= 200 ফলাফল)
এই প্রতিবেদনটি সাবস্ক্রাইব করা বা আনসাবস্ক্রাইব করা দর্শকদের জন্য শীর্ষ ভিডিওগুলির তালিকা করে৷ প্রতিবেদনটি দেশ , মহাদেশ বা উপমহাদেশ অনুসারে শীর্ষ ভিডিওগুলি তালিকাভুক্ত করতে ফিল্টার করা যেতে পারে৷ পূর্ববর্তী প্রতিবেদনটি আপনাকে সদস্যতা নেওয়া বা আনসাবস্ক্রাইব করা দর্শকদের জন্য একটি নির্দিষ্ট মার্কিন রাজ্যের শীর্ষ ভিডিওগুলি পুনরুদ্ধার করতে দেয়, তবে এটি এই প্রতিবেদনের চেয়ে কম মেট্রিক্স সমর্থন করে৷
এই প্রতিবেদনটি শীর্ষস্থানীয় ভিডিওগুলির তালিকা করে এবং প্লেব্যাকের বিবরণ এবং ভৌগলিক ফিল্টার সমর্থন করে৷ এই প্রতিবেদনটি আগেরটির মতই, তবে এটি কম মেট্রিক্স সমর্থন করে এবং youtubeProduct ফিল্টারের জন্য সমর্থন যোগ করে।
প্লেব্যাক বিশদ ফিল্টার সহ সেরা ভিডিও (<= 200 ফলাফল)
এই প্রতিবেদনটি বিষয়বস্তুর মালিকের শীর্ষ ভিডিওগুলির তালিকা করে, এক বা একাধিক প্লেব্যাকের বিস্তারিত মাত্রা দ্বারা ফিল্টার করে: liveOrOnDemand , subscribedStatus , এবং youtubeProduct ৷ প্রতিবেদনটি অঞ্চল অনুসারে ফিল্টারিংকেও সমর্থন করে।
প্লেলিস্ট রিপোর্টগুলিতে চ্যানেল মালিকের প্লেলিস্টের ভিডিওগুলির সাথে সম্পর্কিত ব্যবহারকারীর কার্যকলাপ সম্পর্কিত মেট্রিক্স রয়েছে৷ এই প্রতিবেদনগুলির দুটি সংস্করণ উপলব্ধ, এবং প্রতিটি উপলব্ধ প্রতিবেদনের জন্য, নিম্নলিখিত বিভাগে প্রতিটি সংস্করণের একটি বিবরণ রয়েছে:
প্রতিটি বিভাগে প্রস্তাবিত ট্যাব সংশ্লিষ্ট প্রতিবেদন পুনরুদ্ধারের জন্য পছন্দের API অনুরোধ বিন্যাস বর্ণনা করে। প্রস্তাবিত প্রতিবেদনগুলি মেট্রিক্সের একটি বর্ধিত সেট সমর্থন করে যাতে সমষ্টিগত ভিডিও মেট্রিক্স এবং ইন-প্লেলিস্ট মেট্রিক্স উভয়ই অন্তর্ভুক্ত থাকে। এই অনুরোধ বিন্যাস isCurated মাত্রা ব্যবহার করে না।
প্রতিটি বিভাগে isCurated ব্যবহার করা ট্যাব একটি পুরানো API অনুরোধ বিন্যাস বর্ণনা করে যেখানে isCurated মাত্রা প্রয়োজন। এই রিপোর্টগুলি শুধুমাত্র ইন-প্লেলিস্ট মেট্রিক্স সমর্থন করে। মনে রাখবেন যে সমস্ত রিপোর্টের জন্য isCurated ডাইমেনশন বাতিল করা হয়েছে। নীচের সতর্কীকরণ নোট অবচয় সময়সূচী ব্যাখ্যা করে।
নিম্নলিখিত সতর্কীকরণ নোট দুটি রিপোর্ট সংস্করণের মধ্যে পরিবর্তনগুলি আরও বিশদে ব্যাখ্যা করে৷
একত্রিত ভিডিও মেট্রিক্স
এই মেট্রিকগুলি ব্যবহারকারীর কার্যকলাপ এবং ইম্প্রেশন মেট্রিক্স প্রদান করে যা প্লেলিস্টের সমস্ত ভিডিওগুলির জন্য একত্রিত হয় যেগুলি প্লেলিস্টের মালিক চ্যানেলের মালিকানাধীন। অন্যান্য চ্যানেলের মালিকানাধীন ভিডিওগুলির মেট্রিক্স একত্রিতকরণে গণনা করা হয় না। ফলস্বরূপ, যদি একটি চ্যানেল এমন একটি প্লেলিস্ট তৈরি করে যাতে শুধুমাত্র অন্যান্য চ্যানেলের মালিকানাধীন ভিডিও থাকে, তাহলে সেই প্লেলিস্টের প্রতিবেদনগুলি এই মেট্রিক্সের জন্য মান প্রদান করবে না।
ইউটিউব সমর্থন করে এমন সমষ্টিগত ভিডিও মেট্রিকগুলির একটি তালিকার জন্য সমর্থিত প্লেলিস্ট মেট্রিক্স বিভাগটি দেখুন৷
ইন-প্লেলিস্ট মেট্রিক্স
এই মেট্রিক্স প্লেলিস্ট পৃষ্ঠার প্রসঙ্গে ব্যবহারকারীর কার্যকলাপ এবং ব্যস্ততা প্রতিফলিত করে। এই মেট্রিক্সগুলি প্লেলিস্টের সমস্ত ভিডিওর ভিউ অন্তর্ভুক্ত করে, কোন চ্যানেল তাদের মালিকানাধীন তা নির্বিশেষে, তবে শুধুমাত্র প্লেলিস্টের প্রেক্ষাপটে ঘটেছে এমন ভিউকে গণনা করে৷
এই প্রতিবেদনটি একটি বিষয়বস্তুর মালিকের চ্যানেলে প্লেলিস্টের ভিডিওগুলির সাথে ব্যবহারকারীদের মিথস্ক্রিয়া সম্পর্কিত পরিসংখ্যান প্রদান করে৷ রিপোর্টে কোনো প্রয়োজনীয় মাত্রা নেই।
এই প্রতিবেদনটি নির্দিষ্ট সময়ের ব্যবধানে একটি বিষয়বস্তুর মালিকের চ্যানেলের জন্য প্লেলিস্টের ভিডিওগুলির সাথে ব্যবহারকারীদের মিথস্ক্রিয়া সম্পর্কিত পরিসংখ্যান প্রদান করে৷ আপনি শুধুমাত্র একটি নির্দিষ্ট প্লেলিস্ট বা চ্যানেলের জন্য ডেটা ফেরত দিতে প্রতিবেদনটি ফিল্টার করতে পারেন।
এই প্রতিবেদনটি মার্কিন রাজ্য এবং ডিস্ট্রিক্ট অফ কলম্বিয়ার জন্য প্লেলিস্ট কার্যকলাপ পরিসংখ্যান প্রদান করে৷ এই রিপোর্টের জন্য, আপনি filters প্যারামিটার মানতে country==US অন্তর্ভুক্ত করেছেন।
দ্রষ্টব্য: এই প্রতিবেদনের জন্য আপনাকে maxResults প্যারামিটারটিকে 25 বা তার কম পূর্ণসংখ্যার মান সেট করতে হবে। অন্যান্য রিপোর্টের বিপরীতে, এই রিপোর্টে আপনাকে sort অনুরোধের প্যারামিটারের জন্য একটি মান নির্দিষ্ট করতে হবে।
এই প্রতিবেদনটি এমবেড করা ভিডিও প্লেয়ারগুলিকে চিহ্নিত করে যা একটি বিষয়বস্তুর মালিকের প্লেলিস্টগুলির জন্য সর্বাধিক ভিউ বা দেখার সময় তৈরি করেছে৷
এই প্রতিবেদনটি দর্শকরা আপনার প্লেলিস্ট সামগ্রীতে পৌঁছানোর পদ্ধতির উপর ভিত্তি করে দেখার পরিসংখ্যানকে একত্রিত করে৷ উদাহরণস্বরূপ, এটি একটি Google অনুসন্ধান বা একটি চ্যানেল পৃষ্ঠা থেকে উদ্ভূত ভিউ সংখ্যা চিহ্নিত করে৷
দ্রষ্টব্য: এই প্রতিবেদনের জন্য আপনাকে maxResults প্যারামিটারটিকে 25 বা তার কম পূর্ণসংখ্যার মান সেট করতে হবে। অন্যান্য রিপোর্টের বিপরীতে, এই রিপোর্টে আপনাকে sort অনুরোধের প্যারামিটারের জন্য একটি মান নির্দিষ্ট করতে হবে।
এই প্রতিবেদনটি রেফারারের উপর ভিত্তি করে দেখার পরিসংখ্যানকে একত্রিত করে যা সামগ্রীর মালিকের প্লেলিস্টগুলির জন্য সর্বাধিক ভিউ তৈরি করেছে৷ রেফারারদের ট্রাফিক সোর্স টাইপ দ্বারা শ্রেণীবদ্ধ করা হয়, এবং ইনসাইট ট্রাফিক সোর্স ডিটেইল ডাইমেনশনের সংজ্ঞা সেই ট্র্যাফিক সোর্সগুলিকে চিহ্নিত করে যার জন্য রিপোর্টটি পাওয়া যায়। উদাহরণস্বরূপ, যদি আপনি ADVERTISING এ insightTrafficSourceType ফিল্টার সেট করেন, রিপোর্টটি এমন বিজ্ঞাপনের প্রকারগুলিকে তালিকাভুক্ত করবে যা সামগ্রীর মালিকের প্লেলিস্টগুলির জন্য সর্বাধিক দেখা বা দেখার সময় তৈরি করেছে৷
দ্রষ্টব্য: এই প্রতিবেদনটি শুধুমাত্র নির্দিষ্ট ট্রাফিক উৎসের জন্য সমর্থিত। উদাহরণস্বরূপ, NO_LINK_EMBEDDED ট্র্যাফিক উত্সের অতিরিক্ত বিবরণ নেই এবং তাই, এই প্রতিবেদনটিকে সমর্থন করে না৷ কোন ট্র্যাফিক উত্স এই প্রতিবেদনটিকে সমর্থন করে সে সম্পর্কে বিশদ বিবরণের জন্য insightTrafficSourceType টাইপ সংজ্ঞা দেখুন৷
ডিভাইসের ধরন এবং অপারেটিং সিস্টেম
প্লেলিস্টের জন্য ডিভাইসের ধরন
এই প্রতিবেদনটি দর্শকরা আপনার প্লেলিস্ট সামগ্রী দেখার জন্য ব্যবহার করা ডিভাইসের উপর ভিত্তি করে দেখার পরিসংখ্যান একত্রিত করে৷ উদাহরণ স্বরূপ, এটি মোবাইল ডিভাইস বা গেম কনসোলগুলিতে কতগুলি ভিউ হয়েছে তা চিহ্নিত করে৷
এই প্রতিবেদনটি দর্শকদের অপারেটিং সিস্টেমের উপর ভিত্তি করে দেখার পরিসংখ্যানকে একত্রিত করে। উদাহরণস্বরূপ, এটি অ্যান্ড্রয়েড ডিভাইসে বা প্লেস্টেশনে হওয়া প্লেলিস্ট দর্শনের সংখ্যা সনাক্ত করে।
প্লেলিস্টের জন্য অপারেটিং সিস্টেম এবং ডিভাইসের ধরন
এই প্রতিবেদনটি দর্শকদের অপারেটিং সিস্টেম এবং ডিভাইসের প্রকারের উপর ভিত্তি করে দেখার পরিসংখ্যানকে একত্রিত করে৷ উদাহরণস্বরূপ, এটি অ্যান্ড্রয়েড ট্যাবলেট বা উইন্ডোজ ডেস্কটপ ডিভাইসে প্লেলিস্ট ভিউয়ের সংখ্যা চিহ্নিত করে।
উদাহরণস্বরূপ, সাবস্ক্রাইবড স্ট্যাটাস ডাইমেনশন ব্যবহার করে এমন একটি রিপোর্ট সাবস্ক্রাইব করা ভিউয়ের জন্য 100 শতাংশ পর্যন্ত ভিউয়ার পারসেন্টেজ ডেটা যোগ করে এবং আনসাবস্ক্রাইব করা ভিউয়ের জন্য ভিউয়ার পারসেন্টেজ ডেটা 100 শতাংশ পর্যন্ত যোগ করে। (প্রতিবেদনের সমস্ত দর্শকের শতকরা ক্ষেত্রগুলির মোট মান 200 শতাংশ৷)
প্লেব্যাকের বিস্তারিত মাত্রার জন্য রিপোর্টে শুধুমাত্র একটি মান (বা মানগুলির সংমিশ্রণ) জন্য দর্শকের পারসেন্টেজ ডেটা রয়েছে তা নিশ্চিত করতে আপনি ফিল্টার ব্যবহার করতে পারেন।
শীর্ষ প্লেলিস্ট
দ্রষ্টব্য: এই রিপোর্টগুলির জন্য আপনাকে 200 বা তার কম একটি পূর্ণসংখ্যার মান maxResults প্যারামিটার সেট করতে হবে। জানুয়ারী 1, 2013 এর আগে ডেটা শুধুমাত্র সেরা 10 প্লেলিস্টের জন্য উপলব্ধ। অন্যান্য রিপোর্টের বিপরীতে, এই রিপোর্টগুলির জন্য আপনাকে sort অনুরোধের প্যারামিটারের জন্য একটি মান নির্দিষ্ট করতে হবে।
এই প্রতিবেদনটি নির্দিষ্ট ফিল্টারিং এবং বাছাইয়ের মানদণ্ডের উপর ভিত্তি করে বিষয়বস্তুর মালিকের শীর্ষ প্লেলিস্টগুলিকে তালিকাভুক্ত করে৷
দ্রষ্টব্য: বিজ্ঞাপন কার্যসম্পাদন প্রতিবেদনগুলির জন্য একটি অনুমোদন টোকেন প্রয়োজন যা https://www.googleapis.com/auth/yt-analytics-monetary.readonly সুযোগে অ্যাক্সেস দেয়৷
বিজ্ঞাপনের কর্মক্ষমতা প্রতিবেদনগুলি ভিডিও প্লেব্যাকের সময় চালানো বিজ্ঞাপনগুলির জন্য ইম্প্রেশন-ভিত্তিক মেট্রিক্স প্রদান করে। এই মেট্রিক্স প্রতিটি বিজ্ঞাপন ইম্প্রেশনের জন্য হিসাব করে এবং প্রতিটি ভিডিও প্লেব্যাক একাধিক ইমপ্রেশন দিতে পারে।
এছাড়াও, কিছু ভিডিও রিপোর্ট নিম্নোক্ত প্লেব্যাক-ভিত্তিক বিজ্ঞাপন কর্মক্ষমতা মেট্রিক্স সমর্থন করে। যাইহোক, এই মেট্রিকগুলি বিজ্ঞাপনের কর্মক্ষমতা প্রতিবেদনে অন্তর্ভুক্ত করা হয় না।
