Dimensions

এই ডকুমেন্টটি YouTube Analytics API কোন কোন মাত্রা সমর্থন করে তা সংজ্ঞায়িত করে। এই API কাস্টম YouTube Analytics রিপোর্ট তৈরি করতে রিয়েল-টাইম, লক্ষ্যযুক্ত কোয়েরিগুলিকে সমর্থন করে।

মাত্রা হল সাধারণ মানদণ্ড যা ডেটা একত্রিত করার জন্য ব্যবহৃত হয়, যেমন ব্যবহারকারীর কার্যকলাপ কখন ঘটেছে বা ব্যবহারকারীরা কোন দেশে অবস্থান করছেন।

প্রতিটি ক্যোয়ারী রিপোর্ট কোন মাত্রাগুলিকে সমর্থন করে তা চিহ্নিত করে। উদাহরণস্বরূপ, সময় অনুসারে ব্যবহারকারীর কার্যকলাপ পুনরুদ্ধার করার সময়, আপনি কোন সময়কাল ধরে ডেটা রিপোর্ট করা হবে তা নির্বাচন করেন: দিন বা মাস । যেকোনো রিপোর্টে, প্রতিটি সারির ডেটাতে মাত্রা মানের একটি অনন্য সমন্বয় থাকে।

একটি কোয়েরি রিপোর্ট পুনরুদ্ধার করতে, YouTube Analytics API এর reports.query পদ্ধতিতে কল করুন। আপনার অনুরোধে, রিপোর্টগুলিতে মেট্রিক মান গণনা করার জন্য YouTube যে মাত্রাগুলি ব্যবহার করবে তা নির্দিষ্ট করতে dimensions প্যারামিটার ব্যবহার করুন।

মূল মাত্রা

যদিও YouTube Analytics API পরিষেবার শর্তাবলীতে সংজ্ঞায়িত অবচয় নীতির অধীন, নন-কোর ডাইমেনশন (এবং নন-কোর মেট্রিক্স) নীতির অধীন নয়। এই পৃষ্ঠার সংজ্ঞাগুলিতে, যে কোনও ডাইমেনশন যা একটি কোর ডাইমেনশন তা স্পষ্টভাবে চিহ্নিত করা হয়েছে।

নিম্নলিখিত তালিকাটি API এর মূল মাত্রাগুলি সনাক্ত করে।

আরও তথ্যের জন্য, অবচয় নীতির আওতাধীন YouTube API গুলির তালিকা দেখুন।

ফিল্টার

সকল কোয়েরি রিপোর্ট ফিল্টার সমর্থন করে। ফিল্টারগুলি এমন মাত্রার মান সনাক্ত করে যা পুনরুদ্ধার করা ডেটাসেটে উপস্থিত থাকতে হবে। এইভাবে, তারা একটি API প্রতিক্রিয়াকে শুধুমাত্র একটি নির্দিষ্ট মান বা মানের সেটের সাথে মিলে যাওয়া ডেটা অন্তর্ভুক্ত করার মধ্যে সীমাবদ্ধ করে। উদাহরণস্বরূপ, সমস্ত দেশের জন্য ব্যবহারকারীর কার্যকলাপ মেট্রিক্স পুনরুদ্ধার করার পরিবর্তে, আপনি শুধুমাত্র একটি নির্দিষ্ট দেশের জন্য ডেটা পুনরুদ্ধার করতে একটি ফিল্টার ব্যবহার করতে পারেন।

একটি কোয়েরি রিপোর্ট পুনরুদ্ধারের অনুরোধে, ঐচ্ছিক filters অনুরোধ প্যারামিটারটি সেই মাত্রার মানগুলি নির্দিষ্ট করে যার জন্য আপনি ডেটা ফিল্টার করতে চান। উদাহরণস্বরূপ, ইউরোপের জন্য ব্যবহারকারীর কার্যকলাপ মেট্রিক্স পুনরুদ্ধার করতে, আপনাকে filters প্যারামিটারের মান continent==150 এ সেট করতে হবে।

গুরুত্বপূর্ণ: কন্টেন্ট মালিকের রিপোর্ট পুনরুদ্ধারের জন্য API অনুরোধগুলিতে রিপোর্টিং এন্টিটির যেকোনো একটি মাত্রা ব্যবহার করে অথবা claimedStatus এবং uploaderType মাত্রার সমর্থিত সমন্বয় ব্যবহার করে ডেটা ফিল্টার করতে হবে।

মাত্রা

নিম্নলিখিত বিভাগগুলি YouTube Analytics API-এর কোয়েরি রিপোর্টে ব্যবহৃত মাত্রাগুলি সংজ্ঞায়িত করে। অন্যথায় উল্লেখ না করা হলে, এই মাত্রাগুলি চ্যানেল এবং কন্টেন্ট মালিকের রিপোর্ট উভয় ক্ষেত্রেই ব্যবহৃত হয়। যে মাত্রাগুলি কেবল ফিল্টার হিসাবে ব্যবহার করা যেতে পারে সেগুলিও চিহ্নিত করা হয়েছে।

রিসোর্স

এই মাত্রাগুলি YouTube-এ চ্যানেল এবং কন্টেন্ট মালিকদের দ্বারা পরিচালিত রিসোর্সের সাথে মিলে যায়:

দ্রষ্টব্য: API আপনাকে video , playlist এবং channel মাত্রার জন্য একাধিক মান নির্দিষ্ট করতে দেয় যখন এগুলি ফিল্টার হিসেবে ব্যবহার করা হয়। এটি করার জন্য, filters প্যারামিটার মানটি ভিডিও, প্লেলিস্ট বা চ্যানেল আইডিগুলির একটি কমা-বিভাজিত তালিকায় সেট করুন যার জন্য API প্রতিক্রিয়া ফিল্টার করা উচিত। প্যারামিটার মানটি 500 টি পর্যন্ত আইডি নির্দিষ্ট করতে পারে।

video (core dimension)
একটি YouTube ভিডিওর আইডি। YouTube ডেটা API-তে, এটি একটি video রিসোর্সের id সম্পত্তির মান। This is a core dimension and is subject to the Deprecation Policy .
playlist
একটি YouTube প্লেলিস্টের ID। YouTube Data API-তে, এটি একটি playlist রিসোর্সের id সম্পত্তির মান।
channel (core dimension) (only used in content owner reports)
একটি YouTube চ্যানেলের আইডি। YouTube ডেটা API-তে, এটি একটি channel রিসোর্সের id সম্পত্তির মান। This is a core dimension and is subject to the Deprecation Policy .

কন্টেন্ট মালিকের রিপোর্টে channel মাত্রা প্রায়শই ব্যবহৃত হয় কারণ এই রিপোর্টগুলি সাধারণত একাধিক চ্যানেলের জন্য ডেটা একত্রিত করে।
group (filter only)
একটি YouTube Analytics গ্রুপের আইডি। আপনি YouTube Analytics API এর groups.list পদ্ধতি ব্যবহার করে এই মানটি পুনরুদ্ধার করতে পারেন। যখন আপনি group ফিল্টার ব্যবহার করেন, তখন API প্রতিক্রিয়াতে সেই গ্রুপের সমস্ত ভিডিও, প্লেলিস্ট বা চ্যানেলের ডেটা থাকে।

উদাহরণ

নিম্নলিখিত নমুনা অনুরোধগুলিতে রিপোর্টিং সত্তার মাত্রা বা ফিল্টার ব্যবহার করা হয়:

  • চ্যানেলের উদাহরণ

    • মৌলিক পরিসংখ্যান
      • শীর্ষ ১০ – একটি চ্যানেলের জন্য সর্বাধিক দেখা ভিডিও
      • শীর্ষ ১০ – একটি চ্যানেলের সর্বাধিক দেখা ভিডিওর জন্য অ্যানোটেশন ক্লিক-থ্রু রেট
      • একটি নির্দিষ্ট প্লেলিস্টের পরিসংখ্যান
      • শীর্ষ ১০ – একটি চ্যানেলের জন্য সর্বাধিক দেখা প্লেলিস্ট
    • ভৌগোলিক
      • শীর্ষ ১০ – একটি নির্দিষ্ট দেশে সর্বাধিক দেখা ভিডিও
      • শীর্ষ ১০ – ইউরোপে সর্বাধিক দেখা ভিডিও

  • কন্টেন্ট মালিকের উদাহরণ

    • মৌলিক পরিসংখ্যান
      • শীর্ষ ১০ - একজন কন্টেন্ট মালিকের জন্য সর্বাধিক দেখা ভিডিও
      • শীর্ষ ১০ - একজন কন্টেন্ট মালিকের জন্য সর্বাধিক দেখা ভিডিও
      • শীর্ষ ১০ - কন্টেন্ট মালিকের চ্যানেলের জন্য সর্বাধিক দেখা ভিডিও
      • শীর্ষ ১০ – একটি চ্যানেলের সর্বাধিক দেখা ভিডিওর জন্য অ্যানোটেশন ক্লিক-থ্রু রেট
      • শীর্ষ ১০ – একজন কন্টেন্ট মালিকের জন্য সর্বাধিক দেখা প্লেলিস্ট
    • ভৌগোলিক
      • শীর্ষ ১০ - একজন কন্টেন্ট মালিকের জন্য ইউরোপে সর্বাধিক দেখা ভিডিও
      • শীর্ষ ১০ – মার্কিন যুক্তরাষ্ট্রে সর্বাধিক শুরু হওয়া প্লেলিস্ট

ভৌগোলিক এলাকা

এই মাত্রাগুলি ব্যবহারকারীর কার্যকলাপ, বিজ্ঞাপনের কর্মক্ষমতা, অথবা আনুমানিক রাজস্ব মেট্রিক্সের সাথে সম্পর্কিত একটি ভৌগোলিক অঞ্চল চিহ্নিত করে।

country (core dimension)
রিপোর্ট সারিতে মেট্রিক্সের সাথে যুক্ত দেশ। মাত্রা মান হল একটি দুই-অক্ষরের ISO-3166-1 দেশের কোড, যেমন US , CN (চীন), অথবা FR (ফ্রান্স)। দেশের কোড ZZ ব্যবহার করা হয় এমন মেট্রিক্স রিপোর্ট করতে যার জন্য YouTube সংশ্লিষ্ট দেশ সনাক্ত করতে পারেনি। This is a core dimension and is subject to the Deprecation Policy .
province
রিপোর্ট সারিতে মেট্রিক্সের সাথে যুক্ত মার্কিন যুক্তরাষ্ট্রের রাজ্য বা অঞ্চল। মাত্রা মান হল একটি ISO 3166-2 কোড যা একটি মার্কিন যুক্তরাষ্ট্রের রাজ্য বা কলম্বিয়া জেলাকে চিহ্নিত করে, যেমন US-MI (মিশিগান) বা US-TX (টেক্সাস)। প্রদেশ কোড US-ZZ ব্যবহার করা হয় এমন মেট্রিক্স রিপোর্ট করতে যার জন্য YouTube সংশ্লিষ্ট মার্কিন যুক্তরাষ্ট্রের রাজ্যকে সনাক্ত করতে পারেনি। যখন একটি API অনুরোধে dimensions প্যারামিটার মানে province অন্তর্ভুক্ত থাকে, তখন অনুরোধটিকে filters প্যারামিটার মানে country==US অন্তর্ভুক্ত করে মার্কিন যুক্তরাষ্ট্রের মধ্যে ডেটা সীমাবদ্ধ করতে হবে।

দ্রষ্টব্য: এই মাত্রাটি ISO 3166-2 মানগুলিকে সমর্থন করে না যা মার্কিন যুক্তরাষ্ট্রের বহির্মুখী অঞ্চলগুলিকে চিহ্নিত করে কারণ সেই অঞ্চলগুলির নিজস্ব ISO 3166-1 দেশের কোডও রয়েছে। এটি মার্কিন যুক্তরাষ্ট্র ছাড়া অন্য দেশের উপবিভাগগুলিকেও সমর্থন করে না।

dma
ডেটা সারিতে বর্ণিত দেখার ইভেন্টগুলির সাথে সম্পর্কিত মনোনীত বাজার এলাকা (DMA) সনাক্ত করতে Nielsen যে 3-সংখ্যার শনাক্তকারী ব্যবহার করে।
city
রিপোর্ট সারিতে মেট্রিক্সের সাথে সম্পর্কিত আনুমানিক শহর। এই মাত্রার ডেটা ১ জানুয়ারী, ২০২২ থেকে শুরু হওয়া তারিখের জন্য উপলব্ধ।
continent (filter only)
একটি জাতিসংঘের (UN) পরিসংখ্যানগত অঞ্চল কোড। API নিম্নলিখিত মানগুলিকে সমর্থন করে:
মূল্যবোধ
002 আফ্রিকা
019 আমেরিকা (উত্তর আমেরিকা, ল্যাটিন আমেরিকা, দক্ষিণ আমেরিকা এবং ক্যারিবিয়ান)
142 এশিয়া
150 ইউরোপ
009 ওশেনিয়া
এই মাত্রাটি শুধুমাত্র ডেটা ফিল্টার করার জন্য ব্যবহার করা যেতে পারে। এই মাত্রাটি ব্যবহার করার জন্য, filters প্যারামিটারের মান continent==REGION_CODE এ সেট করুন, টেবিল থেকে একটি REGION_CODE মান উল্লেখ করুন।
subContinent (filter only)
জাতিসংঘের একটি পরিসংখ্যানগত অঞ্চল কোড যা একটি ভৌগোলিক উপ-অঞ্চলকে চিহ্নিত করে। জাতিসংঘের পরিসংখ্যান বিভাগ উপ-অঞ্চলগুলির পাশাপাশি প্রতিটি অঞ্চলের সাথে সম্পর্কিত দেশগুলির তালিকা তৈরি করে।

এই মাত্রাটি শুধুমাত্র ডেটা ফিল্টার করার জন্য ব্যবহার করা যেতে পারে। এই মাত্রাটি ব্যবহার করার জন্য, filters প্যারামিটারের মান subContinent==REGION_CODE এ সেট করুন, UN তালিকা থেকে একটি REGION_CODE মান উল্লেখ করুন।

উদাহরণ

নিম্নলিখিত নমুনা অনুরোধগুলি ভৌগোলিক মাত্রা বা ফিল্টার ব্যবহার করে:

  • চ্যানেলের উদাহরণ

    • মৌলিক পরিসংখ্যান : একটি চ্যানেলের জন্য দেশ-নির্দিষ্ট ভিউ সংখ্যা (এবং আরও অনেক কিছু)
    • ভৌগোলিক
      • চ্যানেলের ভিডিওর জন্য দেশ-নির্দিষ্ট দেখার সময়ের মেট্রিক্স
      • একটি চ্যানেলের ভিডিওর জন্য দেশ-নির্দিষ্ট টীকা মেট্রিক্স
      • মার্কিন যুক্তরাষ্ট্রের রাজ্য এবং ওয়াশিংটন ডিসির জন্য প্রদেশ-নির্দিষ্ট মেট্রিক্স
      • চ্যানেলের প্লেলিস্টের জন্য দেশ-নির্দিষ্ট দেখার সময়ের মেট্রিক্স
      • শীর্ষ ১০ – মার্কিন যুক্তরাষ্ট্রে সর্বাধিক শুরু হওয়া প্লেলিস্ট
    • প্লেব্যাক লোকেশন : বিভিন্ন প্লেব্যাক লোকেশন থেকে দৈনিক ভিউ সংখ্যা এবং দেখার সময়
    • ট্র্যাফিক উৎস : একটি দেশের বিভিন্ন ট্র্যাফিক উৎস থেকে প্রাপ্ত ভিউকাউন্ট এবং দেখার সময়
    • জনসংখ্যাতাত্ত্বিক : ক্যালিফোর্নিয়ায় দর্শকদের জনসংখ্যাতাত্ত্বিক (বয়স গ্রুপ এবং লিঙ্গ)
    • সেরা ভিডিওগুলি
      • শীর্ষ ১০ – একটি নির্দিষ্ট দেশে সর্বাধিক দেখা ভিডিও
      • শীর্ষ ১০ – ইউরোপে সর্বাধিক দেখা ভিডিও

  • কন্টেন্ট মালিকের উদাহরণ

    • মৌলিক পরিসংখ্যান : সমস্ত স্ব-আপলোড করা ভিডিওর জন্য দেশ-নির্দিষ্ট ভিউ সংখ্যা (এবং আরও)
    • ভৌগোলিক
      • স্ব-আপলোড করা কন্টেন্টের জন্য দেশ-নির্দিষ্ট দেখার সময়ের মেট্রিক্স
      • স্ব-আপলোড করা সামগ্রীর জন্য দেশ-নির্দিষ্ট টীকা মেট্রিক্স
      • মার্কিন যুক্তরাষ্ট্রের রাজ্য এবং ওয়াশিংটন ডিসির জন্য প্রদেশ-নির্দিষ্ট মেট্রিক্স
      • কন্টেন্ট মালিকের প্লেলিস্টের জন্য দেশ-নির্দিষ্ট দেখার সময়ের মেট্রিক্স
      • শীর্ষ ১০ – মার্কিন যুক্তরাষ্ট্রে সর্বাধিক শুরু হওয়া প্লেলিস্ট
    • প্লেব্যাক লোকেশন : বিভিন্ন প্লেব্যাক লোকেশন থেকে দৈনিক ভিউ সংখ্যা এবং দেখার সময়
    • জনসংখ্যাতাত্ত্বিক : ক্যালিফোর্নিয়ায় দর্শকদের জনসংখ্যাতাত্ত্বিক (বয়স গ্রুপ এবং লিঙ্গ)
    • সেরা ভিডিও : সেরা ১০ – একজন কন্টেন্ট মালিকের জন্য ইউরোপে সর্বাধিক দেখা ভিডিও
    • রাজস্ব/বিজ্ঞাপনের পারফরম্যান্স : দেশ-নির্দিষ্ট রাজস্ব এবং বিজ্ঞাপনের পারফরম্যান্সের মেট্রিক্স

সময়কাল

এই মাত্রাগুলি নির্দেশ করে যে একটি প্রতিবেদনে একটি সময়কালের উপর ভিত্তি করে ডেটা একত্রিত করা উচিত, যেমন একটি দিন, একটি সপ্তাহ, বা একটি মাস। startDate এবং endDate অনুরোধ প্যারামিটারগুলি প্রতিবেদনে ডেটা অন্তর্ভুক্ত করার সময়কাল নির্দিষ্ট করে। মনে রাখবেন যে প্রতিবেদনটি আসলে শেষ দিন পর্যন্ত ডেটা ফেরত দেয় যার জন্য অনুরোধে উল্লেখিত সমস্ত মেট্রিক্স কোয়েরি করার সময় উপলব্ধ থাকে। প্রতিবেদনে, তারিখগুলি YYYY-MM-DD ফর্ম্যাটে তালিকাভুক্ত করা হয়।

গুরুত্বপূর্ণ: সমস্ত তারিখ নির্দিষ্ট দিন, মাস এবং বছরে প্রশান্ত মহাসাগরীয় সময় রাত ১২:০০ টা থেকে শুরু হয়ে রাত ১১:৫৯ টায় শেষ হওয়া সময়কালকে নির্দেশ করে। ফলস্বরূপ, ডেলাইট সেভিংস টাইমের জন্য ঘড়ির কাঁটা সামনের দিকে সামঞ্জস্য করা তারিখগুলি ২৩ ঘন্টার সময়কালকে প্রতিনিধিত্ব করে এবং ঘড়ির কাঁটা পিছনের দিকে সামঞ্জস্য করা তারিখগুলি ২৫ ঘন্টার সময়কালকে প্রতিনিধিত্ব করে।

মাসের মাত্রা বলতে নির্দিষ্ট মাস এবং বছরের প্রথম দিনে প্রশান্ত মহাসাগরীয় সময় (UTC-7 বা UTC-8) রাত ১২:০০ টা থেকে শুরু হওয়া সময়কালকে বোঝায়।

day (core dimension)
যখন আপনি এই মাত্রাটি ব্যবহার করেন, তখন প্রতিবেদনের ডেটা দৈনিক ভিত্তিতে একত্রিত হয় এবং প্রতিটি সারিতে একদিনের ডেটা থাকে। আপনি ডেটা আরও বিভাজন করার জন্য অন্যান্য মাত্রা ব্যবহার করতে পারেন। উদাহরণস্বরূপ, একটি ট্র্যাফিক সোর্স রিপোর্ট ব্যবহারকারীরা আপনার ভিডিওগুলিতে কীভাবে পৌঁছায় তার উপর ভিত্তি করে দৈনিক দেখার পরিসংখ্যান একত্রিত করতে পারে। This is a core dimension and is subject to the Deprecation Policy .
month (core dimension)
প্রতিবেদনে থাকা তথ্য ক্যালেন্ডার মাসের ভিত্তিতে একত্রিত করা হয়েছে। দৈনিক প্রতিবেদনের মতো, আপনি অন্যান্য ফিল্টার ব্যবহার করে তথ্য আরও ভাগ করতে পারেন। প্রতিবেদনে, তারিখগুলি YYYY-MM ফর্ম্যাটে তালিকাভুক্ত করা হয়েছে।

দ্রষ্টব্য: যদি আপনার API কোয়েরি month মাত্রা ব্যবহার করে, তাহলে start-date এবং end-date উভয় প্যারামিটারই মাসের প্রথম দিনে সেট করতে হবে। This is a core dimension and is subject to the Deprecation Policy .

উদাহরণ

নিম্নলিখিত নমুনা অনুরোধগুলিতে টেম্পোরাল ডাইমেনশন বা ফিল্টার ব্যবহার করা হয়:

  • চ্যানেলের উদাহরণ

    • সময় ভিত্তিক
      • একটি চ্যানেলের ভিডিওর দৈনিক দেখার সময়ের মেট্রিক্স
      • একটি চ্যানেলের ভিডিওর জন্য দৈনিক অ্যানোটেশন মেট্রিক্স
      • একটি চ্যানেলের দৈনিক প্লেলিস্ট ভিউ
    • প্লেব্যাক লোকেশন : বিভিন্ন প্লেব্যাক লোকেশন থেকে দৈনিক ভিউ সংখ্যা এবং দেখার সময়
    • ট্র্যাফিক উৎস : বিভিন্ন ট্র্যাফিক উৎস থেকে দৈনিক ভিউ সংখ্যা এবং দেখার সময়
    • ডিভাইস/ওএস
      • অ্যান্ড্রয়েড অপারেটিং সিস্টেমের জন্য দৈনিক ডিভাইসের ধরণের মেট্রিক্স
      • মোবাইল ডিভাইসের জন্য দৈনিক অপারেটিং সিস্টেমের মেট্রিক্স
      • দৈনিক অপারেটিং সিস্টেম এবং ডিভাইসের ধরণের মেট্রিক্স

  • কন্টেন্ট মালিকের উদাহরণ

    • সময় ভিত্তিক
      • স্ব-আপলোড করা কন্টেন্টের জন্য দৈনিক দেখার সময়ের মেট্রিক্স
      • দাবি করা কন্টেন্টের জন্য টীকা মেট্রিক্স
      • একজন কন্টেন্ট মালিকের দৈনিক প্লেলিস্ট ভিউ
    • প্লেব্যাক লোকেশন : বিভিন্ন প্লেব্যাক লোকেশন থেকে দৈনিক ভিউ সংখ্যা এবং দেখার সময়
    • ট্র্যাফিক উৎস : বিভিন্ন ট্র্যাফিক উৎস থেকে দৈনিক ভিউ সংখ্যা এবং দেখার সময়
    • ডিভাইস/ওএস
      • দাবি করা ভিডিওর জন্য দৈনিক ডিভাইসের ধরণের মেট্রিক্স
      • মোবাইল ডিভাইসে দেখা দাবি করা ভিডিওর দৈনিক অপারেটিং সিস্টেম মেট্রিক্স
      • দৈনিক অপারেটিং সিস্টেম এবং ডিভাইসের ধরণের মেট্রিক্স
    • আয়/বিজ্ঞাপনের পারফরম্যান্স : দৈনিক আয় এবং বিজ্ঞাপনের পারফরম্যান্সের মেট্রিক্স

প্লেব্যাকের অবস্থান

এই মাত্রাগুলি সেই পৃষ্ঠা বা অ্যাপ্লিকেশন সম্পর্কে অন্তর্দৃষ্টি প্রদান করে যেখানে ব্যবহারকারীর কার্যকলাপ ঘটেছে।

insightPlaybackLocationType
প্রতিবেদনে থাকা ডেটা কোন ধরণের পৃষ্ঠা বা অ্যাপ্লিকেশনে ভিডিও প্লেব্যাক করা হয়েছে তার উপর ভিত্তি করে একত্রিত করা হয়েছে। এই মাত্রার সম্ভাব্য মানগুলি হল:

  • BROWSE – এই ডেটা ইউটিউবের হোম পেজ বা হোম স্ক্রিনে, ব্যবহারকারীর সাবস্ক্রিপশন ফিডে, অথবা অন্য কোনও ইউটিউব ব্রাউজিং ফিচারে সংঘটিত ভিউ বর্ণনা করে।

  • CHANNEL - ডেটা চ্যানেল পৃষ্ঠায় ঘটে যাওয়া ভিউ বর্ণনা করে।

  • EMBEDDED - ডেটা অন্য কোনও ওয়েবসাইট বা অ্যাপ্লিকেশনে দেখা ভিউ বর্ণনা করে যেখানে ভিডিওটি <iframe> অথবা <object> এম্বেড ব্যবহার করে এম্বেড করা হয়েছিল।

  • EXTERNAL_APP – ডেটা এমন একটি তৃতীয় পক্ষের অ্যাপ্লিকেশনে দেখা ভিউ বর্ণনা করে যেখানে ভিডিওটি <iframe> অথবা <object> এম্বেড ছাড়া অন্য কোনও পদ্ধতি ব্যবহার করে চালানো হয়েছিল। উদাহরণস্বরূপ, YouTube Android Player API ব্যবহার করে এমন অ্যাপ্লিকেশনগুলিতে প্লেব্যাকগুলি এই মান ব্যবহার করে শ্রেণীবদ্ধ করা হবে।

  • MOBILE - এই ডেটা YouTube-এর মোবাইল ওয়েবসাইটে বা অনুমোদিত YouTube API ক্লায়েন্টে, মোবাইল ডিভাইস সহ, দেখা হয়েছে এমন ভিউ বর্ণনা করে।

    ১০ সেপ্টেম্বর, ২০১৩ থেকে, YouTube Analytics রিপোর্টে প্লেব্যাকগুলিকে আর MOBILE প্লেব্যাক হিসাবে শ্রেণীবদ্ধ করা হয়নি। লিগ্যাসি ডেটা এখনও সেই বিভাগের অধীনে থাকায় মূল্যটি প্রতিবেদনে থাকতে পারে। তবে, সেই তারিখের পরে, মোবাইল প্লেব্যাকগুলিকে WATCH , EMBEDDED , অথবা EXTERNAL_APP প্লেব্যাক হিসাবে শ্রেণীবদ্ধ করা হয়, যেখানে প্লেব্যাকগুলি ঘটে তার ধরণের উপর নির্ভর করে।

  • SEARCH - ডেটাটি ইউটিউব অনুসন্ধান ফলাফল পৃষ্ঠায় সরাসরি সংঘটিত ভিউগুলির বর্ণনা দেয়।

  • WATCH – এই ডেটা ভিডিওর ইউটিউব ওয়াচ পেজে বা ইউটিউব অ্যান্ড্রয়েড অ্যাপের মতো অফিসিয়াল ইউটিউব অ্যাপ্লিকেশনে দেখা ভিউ বর্ণনা করে।

  • YT_OTHER – ডেটা এমন ভিউ বর্ণনা করে যা অন্যথায় শ্রেণীবদ্ধ করা হয়নি।

insightPlaybackLocationDetail
প্লেয়ারটি যে পৃষ্ঠায় অবস্থিত তার উপর ভিত্তি করে ডেটা একত্রিত করা হয়। মনে রাখবেন যে এই প্রতিবেদনটি শুধুমাত্র এমবেডেড প্লেয়ারে দেখা ভিউগুলির জন্য সমর্থিত, এবং এটি নির্দিষ্ট ভিডিওর জন্য সর্বাধিক ভিউ তৈরি করা এমবেডেড প্লেয়ারগুলিকে সনাক্ত করে। সুতরাং, এটি শীর্ষ এমবেডেড প্লেয়ারগুলির সাথে সম্পর্কিত URL বা অ্যাপ্লিকেশনগুলি সনাক্ত করে প্লেব্যাক অবস্থান প্রতিবেদনের তুলনায় আরও সূক্ষ্ম দৃশ্য প্রদান করে।

উদাহরণ

নিম্নলিখিত নমুনা অনুরোধগুলি প্লেব্যাক অবস্থানের মাত্রা ব্যবহার করে:

  • চ্যানেলের উদাহরণ

    • প্লেব্যাকের অবস্থান
      • বিভিন্ন প্লেব্যাক লোকেশন থেকে ভিউকাউন্ট এবং দেখার সময়
      • বিভিন্ন প্লেব্যাক লোকেশন থেকে দৈনিক ভিউ সংখ্যা এবং দেখার সময়
      • শীর্ষ ১০ - তৃতীয় পক্ষের সাইট যা একটি এমবেডেড ভিডিওর জন্য সর্বাধিক ভিউ তৈরি করে
      • বিভিন্ন প্লেব্যাক অবস্থান থেকে প্লেলিস্টের ভিউ গণনা এবং দেখার সময়
      • বিভিন্ন প্লেব্যাক অবস্থান থেকে দৈনিক প্লেলিস্ট দেখার সংখ্যা এবং দেখার সময়

  • কন্টেন্ট মালিকের উদাহরণ

    • প্লেব্যাকের অবস্থান
      • বিভিন্ন প্লেব্যাক লোকেশন থেকে ভিউকাউন্ট এবং দেখার সময়
      • বিভিন্ন প্লেব্যাক লোকেশন থেকে দৈনিক ভিউ সংখ্যা এবং দেখার সময়
      • শীর্ষ ১০ - তৃতীয় পক্ষের সাইট যা একটি এমবেডেড ভিডিওর জন্য সর্বাধিক ভিউ তৈরি করে
      • বিভিন্ন প্লেব্যাক অবস্থান থেকে প্লেলিস্টের ভিউ গণনা এবং দেখার সময়
      • বিভিন্ন প্লেব্যাক অবস্থান থেকে দৈনিক প্লেলিস্ট দেখার সংখ্যা এবং দেখার সময়

প্লেব্যাকের বিবরণ

creatorContentType
এই মাত্রাটি ডেটা সারিতে ব্যবহারকারীর কার্যকলাপ মেট্রিক্সের সাথে সম্পর্কিত কন্টেন্টের ধরণ শনাক্ত করে। এই মাত্রার ডেটা ১ জানুয়ারী, ২০১৯ থেকে শুরু হওয়া তারিখের জন্য উপলব্ধ।

নিম্নলিখিত টেবিলে মাত্রার মানগুলি তালিকাভুক্ত করা হয়েছে:
মূল্যবোধ
LIVE_STREAM দেখা কন্টেন্টটি ছিল একটি ইউটিউব লাইভস্ট্রিম ।
SHORTS দেখা কন্টেন্টটি ছিল একটি YouTube শর্ট ।
STORY দেখা কন্টেন্টটি ছিল একটি YouTube স্টোরি ।
VIDEO_ON_DEMAND দেখা কন্টেন্টটি ছিল একটি YouTube ভিডিও যা অন্য মাত্রার মানের মধ্যে পড়ে না।
UNSPECIFIED দেখা কন্টেন্টের কন্টেন্টের ধরণ অজানা।
liveOrOnDemand
এই মাত্রাটি নির্দেশ করে যে ডেটা সারিতে থাকা ব্যবহারকারীর কার্যকলাপের মেট্রিক্সগুলি কোনও লাইভ সম্প্রচারের ভিউয়ের সাথে সম্পর্কিত কিনা। এই মাত্রার ডেটা ১ এপ্রিল, ২০১৪ থেকে শুরু হওয়া তারিখগুলির জন্য উপলব্ধ।

নিম্নলিখিত টেবিলে মাত্রার মানগুলি তালিকাভুক্ত করা হয়েছে:
মূল্যবোধ
LIVE সারির ডেটা লাইভ সম্প্রচারের সময় ঘটে যাওয়া ব্যবহারকারীর কার্যকলাপ বর্ণনা করে।
ON_DEMAND সারির ডেটা ব্যবহারকারীর এমন কার্যকলাপ বর্ণনা করে যা সরাসরি সম্প্রচারের সময় ঘটেনি।
subscribedStatus
এই মাত্রাটি নির্দেশ করে যে ডেটা সারিতে থাকা ব্যবহারকারীর কার্যকলাপের মেট্রিক্স ভিডিও বা প্লেলিস্টের চ্যানেলে সাবস্ক্রাইব করা দর্শকদের সাথে সম্পর্কিত কিনা। সম্ভাব্য মানগুলি হল SUBSCRIBED এবং UNSUBSCRIBED ।

মনে রাখবেন যে ব্যবহারকারীর কার্যকলাপ সংঘটিত হওয়ার সময় মাত্রার মান সঠিক। উদাহরণস্বরূপ, ধরুন একজন ব্যবহারকারী একটি চ্যানেলে সাবস্ক্রাইব করেননি এবং সেই চ্যানেলের একটি ভিডিও দেখেন, তারপর চ্যানেলটিতে সাবস্ক্রাইব করেন এবং একই দিনে অন্য একটি ভিডিও দেখেন। চ্যানেলের রিপোর্ট নির্দেশ করে যে একটি ভিউয়ের একটি subscribedStatus মান SUBSCRIBED এবং একটি ভিউয়ের একটি subscribedStatus মান UNSUBSCRIBED ।
youtubeProduct
এই মাত্রাটি সেই YouTube পরিষেবাটি শনাক্ত করে যেখানে ব্যবহারকারীর কার্যকলাপ ঘটেছে। এই মাত্রার ডেটা ১৮ জুলাই, ২০১৫ তারিখের হিসাবে উপলব্ধ।

নিম্নলিখিত টেবিলে মাত্রার মানগুলি তালিকাভুক্ত করা হয়েছে:
মূল্যবোধ
CORE যে ব্যবহারকারীর কার্যকলাপ বিশেষ YouTube অ্যাপ্লিকেশনগুলির (YouTube Gaming, YouTube Kids, অথবা YouTube Music) মধ্যে ঘটেনি। ব্যতিক্রম: ১ মার্চ, ২০২১ এর আগে YouTube Music-এ ঘটে যাওয়া ব্যবহারকারীর কার্যকলাপ CORE তে অন্তর্ভুক্ত।
GAMING ব্যবহারকারীর কার্যকলাপটি YouTube গেমিং-এ ঘটেছে।
KIDS ব্যবহারকারীর কার্যকলাপটি YouTube Kids-এ ঘটেছে।
MUSIC ১ মার্চ, ২০২১ তারিখে বা তার পরে YouTube Music-এ ব্যবহারকারীর কার্যকলাপ ঘটেছে। ১ মার্চ, ২০২১-এর আগের ডেটা CORE তে অন্তর্ভুক্ত করা হয়েছে। রিয়েল-টাইম ডেটা রেকর্ড করা হয় না।
UNKNOWN ব্যবহারকারীর কার্যকলাপটি ১৮ জুলাই, ২০১৫ এর আগে সংঘটিত হয়েছিল।

ট্রাফিক উৎস

insightTrafficSourceType
রিপোর্টে থাকা ডেটা রেফারারের ধরণের উপর ভিত্তি করে একত্রিত করা হয়েছে, যা ব্যবহারকারীরা কীভাবে ভিডিওটিতে পৌঁছেছেন তা বর্ণনা করে। এই মাত্রার সম্ভাব্য মানগুলি হল:
  • ADVERTISING - একটি বিজ্ঞাপন দর্শককে ভিডিওটিতে রেফার করেছিল। যদি আপনি এই ট্র্যাফিক উৎসের উপর ভিত্তি করে ফিল্টার করেন, তাহলে insightTrafficSourceDetail ক্ষেত্রটি বিজ্ঞাপনের ধরণ সনাক্ত করে।
  • ANNOTATION - দর্শকরা অন্য ভিডিওর একটি টীকাতে ক্লিক করে ভিডিওটিতে পৌঁছেছেন।
  • CAMPAIGN_CARD – দাবি করা, ব্যবহারকারীর আপলোড করা ভিডিও থেকে প্রাপ্ত ভিউ যা কন্টেন্ট মালিক দেখা কন্টেন্ট প্রচারের জন্য ব্যবহার করেছিলেন। এই ট্র্যাফিক উৎসটি শুধুমাত্র কন্টেন্ট মালিকের রিপোর্টের জন্য সমর্থিত।
  • END_SCREEN – অন্য একটি ভিডিওর শেষ স্ক্রিন থেকে ভিউগুলি উল্লেখ করা হয়েছে।
  • EXT_URL – ভিডিও ভিউ অন্য ওয়েবসাইটের একটি লিঙ্ক থেকে রেফার করা হয়েছে। যদি আপনি এই ট্র্যাফিক সোর্সের উপর ভিত্তি করে ফিল্টার করেন, তাহলে insightTrafficSourceDetail ফিল্ডটি ওয়েব পৃষ্ঠাটিকে শনাক্ত করে। এই ট্র্যাফিক সোর্সে Google অনুসন্ধান ফলাফল থেকে রেফারেল অন্তর্ভুক্ত থাকে।
  • HASHTAGS - ভিওডি হ্যাশট্যাগ পৃষ্ঠা বা শর্টস হ্যাশট্যাগ পিভট পৃষ্ঠা থেকে প্রাপ্ত ভিউ।
  • LIVE_REDIRECT - ভিডিও ভিউগুলি লাইভ রিডাইরেক্টস থেকে রেফার করা হয়েছে।
  • NO_LINK_EMBEDDED – ভিডিওটি দেখার সময় অন্য ওয়েবসাইটে এম্বেড করা হয়েছিল।
  • NO_LINK_OTHER – YouTube ট্র্যাফিকের জন্য কোনও রেফারারকে শনাক্ত করেনি। এই বিভাগে একটি ভিডিওতে সরাসরি ট্র্যাফিকের পাশাপাশি মোবাইল অ্যাপগুলিতে ট্র্যাফিক অন্তর্ভুক্ত রয়েছে।
  • NOTIFICATION - ভিডিও ভিউগুলি YouTube থেকে একটি ইমেল বা বিজ্ঞপ্তি থেকে উল্লেখ করা হয়েছিল।
  • PLAYLIST - প্লেলিস্টের অংশ হিসেবে ভিডিওটি চালানোর সময় ভিডিওটি দেখা হয়েছে। এতে প্লেলিস্ট পৃষ্ঠা থেকে আসা ট্র্যাফিক অন্তর্ভুক্ত রয়েছে।
  • PRODUCT_PAGE - ভিডিও ভিউগুলি একটি পণ্য পৃষ্ঠা থেকে উল্লেখ করা হয়েছে।
  • PROMOTED - ভিডিও ভিউগুলি একটি অবৈতনিক YouTube প্রচার থেকে উল্লেখ করা হয়েছিল, যেমন YouTube "স্পটলাইট ভিডিও" পৃষ্ঠা।
  • RELATED_VIDEO – ভিডিও ভিউ অন্য একটি ভিডিও দেখার পৃষ্ঠায় সম্পর্কিত ভিডিও তালিকা থেকে উল্লেখ করা হয়েছে। যদি আপনি এই ট্র্যাফিক উৎসের উপর ভিত্তি করে ফিল্টার করেন, তাহলে insightTrafficSourceDetail ক্ষেত্রটি সেই ভিডিওর ভিডিও আইডি নির্দিষ্ট করে।
  • SHORTS - শর্টস দেখার অভিজ্ঞতায় পূর্ববর্তী ভিডিও থেকে উল্লম্বভাবে সোয়াইপ করে দর্শককে রেফার করা হত।
  • SOUND_PAGE – Shorts সাউন্ড পিভট পৃষ্ঠাগুলি থেকে প্রাপ্ত ভিউ।
  • SUBSCRIBER – ভিডিও ভিউগুলি YouTube হোমপেজের ফিড বা YouTube সাবস্ক্রিপশন বৈশিষ্ট্য থেকে রেফার করা হয়েছে। যদি আপনি এই ট্র্যাফিক উৎসের উপর ভিত্তি করে ফিল্টার করেন, তাহলে insightTrafficSourceDetail ক্ষেত্রটি হোমপেজ ফিড আইটেম বা অন্য কোন পৃষ্ঠা থেকে ভিউগুলি রেফার করা হয়েছে তা নির্দিষ্ট করে।
  • YT_CHANNEL – একটি চ্যানেল পৃষ্ঠায় ভিডিও দেখা হয়েছে। যদি আপনি এই ট্র্যাফিক উৎসের উপর ভিত্তি করে ফিল্টার করেন, তাহলে insightTrafficSourceDetail ক্ষেত্রটি সেই চ্যানেলের চ্যানেল আইডি নির্দিষ্ট করে।
  • YT_OTHER_PAGE – ভিডিও ভিউগুলি কোনও অনুসন্ধান ফলাফল বা YouTube পৃষ্ঠায় প্রদর্শিত সম্পর্কিত ভিডিও লিঙ্ক ব্যতীত অন্য কোনও লিঙ্ক থেকে উল্লেখ করা হয়েছিল। আপনি যদি এই ট্র্যাফিক উৎসের উপর ভিত্তি করে ফিল্টার করেন, তাহলে insightTrafficSourceDetail ক্ষেত্রটি পৃষ্ঠাটিকে সনাক্ত করে।
  • YT_SEARCH – ভিডিও ভিউগুলি YouTube অনুসন্ধান ফলাফল থেকে উল্লেখ করা হয়েছে। যদি আপনি এই ট্র্যাফিক উৎসের উপর ভিত্তি করে ফিল্টার করেন, তাহলে insightTrafficSourceDetail ক্ষেত্রটি অনুসন্ধান শব্দটি নির্দিষ্ট করে।
  • VIDEO_REMIXES – Shorts প্লেয়ারের রিমিক্স করা ভিডিও লিঙ্ক থেকে ভিডিও ভিউ রেফার করা হয়েছে। যদি আপনি এই ট্রাফিক সোর্সের উপর ভিত্তি করে ফিল্টার করেন, তাহলে insightTrafficSourceDetail ফিল্ডটি সেই ভিডিওটি নির্দিষ্ট করে যেখান থেকে দর্শককে রেফার করা হয়েছে।
insightTrafficSourceDetail
রিপোর্টে থাকা ডেটা একটি নির্দিষ্ট ভিডিওর জন্য সবচেয়ে বেশি ভিউ তৈরি করা রেফারার এবং একটি নির্দিষ্ট ট্র্যাফিক সোর্সের ধরণের উপর ভিত্তি করে একত্রিত করা হয়েছে। নিম্নলিখিত তালিকাটি সেই ট্র্যাফিক সোর্সগুলিকে চিহ্নিত করে যার জন্য এই রিপোর্টটি উপলব্ধ। প্রতিটি ট্র্যাফিক সোর্সের জন্য, তালিকাটি insightTrafficSourceDetail মাত্রা প্রদান করে এমন তথ্য সনাক্ত করে।
  • ADVERTISING - যে ধরণের বিজ্ঞাপন ভিউ তৈরি করেছে। সম্ভাব্য মানগুলি হল:
    • ক্লিক-টু-প্লে এনগেজমেন্ট বিজ্ঞাপন
    • বাগদানের বিজ্ঞাপন
    • গুগল সার্চ বিজ্ঞাপন
    • হোমপেজ ভিডিও বিজ্ঞাপন
    • সংরক্ষিত স্কিপেবল ইন-স্ট্রিম
    • TrueView ইন-সার্চ এবং ইন-ডিসপ্লে
    • ট্রুভিউ ইন-স্ট্রিম
    • অশ্রেণীবদ্ধ YouTube বিজ্ঞাপন
    • ভিডিও ওয়াল
  • CAMPAIGN_CARD – দাবি করা ভিডিও যা দর্শকদের প্রতিবেদনে চিহ্নিত ভিডিওটিতে নিয়ে গেছে।
  • END_SCREEN – যে ভিডিওটি দর্শকদের প্রতিবেদনে চিহ্নিত ভিডিওতে নিয়ে গেছে।
  • EXT_URL – যে ওয়েবসাইটটি দর্শকদের ভিডিওটি দেখার জন্য রেফার করেছিল।
  • HASHTAGS – যে হ্যাশট্যাগটি ভিউয়ের দিকে পরিচালিত করেছিল।
  • NOTIFICATION - যে ইমেল বা বিজ্ঞপ্তি ট্র্যাফিককে রেফার করেছে।
  • RELATED_VIDEO – প্রতিবেদনে বর্ণিত ভিডিওটিতে দর্শকদের নিয়ে যাওয়া সম্পর্কিত ভিডিও।
  • SOUND_PAGE – যে ভিডিওটি ভিউয়ের দিকে পরিচালিত করেছে।
  • SUBSCRIBER – হোমপেজ ফিড আইটেম বা YouTube সাবস্ক্রিপশন বৈশিষ্ট্য যা দর্শকদের প্রতিবেদনে অন্তর্ভুক্ত ভিডিওতে নিয়ে যায়। বৈধ মানগুলি হল:
    • activity – হোমপেজ সাবস্ক্রিপশন ফিডের আইটেমগুলি থেকে দেখা যা আপলোড না করা এবং অ-সামাজিক চ্যানেল কার্যকলাপের ফলে তৈরি হয়, যার মধ্যে লাইক, ফেভারিট, বুলেটিন পোস্ট এবং প্লেলিস্ট সংযোজন অন্তর্ভুক্ত।
    • blogged - হোমপেজ সাবস্ক্রিপশন ফিডের আইটেমগুলি থেকে প্রাপ্ত ভিউ যা শীর্ষ ব্লগগুলির লিঙ্কগুলির মাধ্যমে এসেছে।
    • mychannel – হোমপেজে তালিকাভুক্ত অন্যান্য ফিডের আইটেম থেকে দেখা, যেমন "লাইক", "ওয়াচ হিস্ট্রি" এবং "পরে দেখুন"।
    • podcasts – পডকাস্টের গন্তব্য পৃষ্ঠার আইটেমগুলি থেকে প্রাপ্ত ভিউ।
    • sdig – সাবস্ক্রিপশন আপডেট ইমেল থেকে আসা ভিউ।
    • uploaded - হোমপেজ সাবস্ক্রিপশন ফিডে uploaded আইটেম থেকে প্রাপ্ত ভিউ।
    • / – YouTube হোমপেজ থেকে আসা অন্যান্য ভিউ।
    • /my_subscriptions – ইউটিউবে ব্যবহারকারীদের আমার সাবস্ক্রিপশন পৃষ্ঠা থেকে প্রাপ্ত ভিউ।
  • YT_CHANNEL – চ্যানেল পৃষ্ঠা যেখানে দর্শকরা ভিডিওটি দেখেছেন।
  • YT_OTHER_PAGE – যে YouTube পৃষ্ঠা থেকে দর্শকদের ভিডিওটি দেখানো হয়েছিল।
  • YT_SEARCH – যে সার্চ শব্দটি দর্শকদের ভিডিওতে নিয়ে যায়।
  • VIDEO_REMIXES – যে ভিডিওটি ভিউয়ের দিকে পরিচালিত করেছে।

উদাহরণ

নিম্নলিখিত নমুনা অনুরোধগুলি ট্র্যাফিক উৎসের মাত্রা ব্যবহার করে:

  • চ্যানেলের উদাহরণ

    • ট্রাফিক উৎস
      • একটি দেশের বিভিন্ন ট্রাফিক উৎস থেকে দেখা সংখ্যা এবং দেখার সময়
      • বিভিন্ন ট্রাফিক উৎস থেকে দৈনিক ভিউ গণনা এবং দেখার সময়
      • সেরা ১০ - ইউটিউব অনুসন্ধান শব্দ যা একটি ভিডিওর জন্য সর্বাধিক ট্র্যাফিক তৈরি করে
      • সেরা ১০ - গুগল সার্চ শব্দ যা একটি ভিডিওর জন্য সবচেয়ে বেশি ট্র্যাফিক তৈরি করে
      • একটি দেশের বিভিন্ন ট্র্যাফিক উৎস থেকে প্লেলিস্টের ভিউ গণনা এবং দেখার সময়
      • বিভিন্ন ট্র্যাফিক উৎস থেকে দৈনিক প্লেলিস্ট দেখার সংখ্যা এবং দেখার সময়

  • কন্টেন্ট মালিকের উদাহরণ

    • ট্রাফিক উৎস
      • বিভিন্ন ট্রাফিক উৎস থেকে দেখা সংখ্যা এবং দেখার সময়
      • বিভিন্ন ট্রাফিক উৎস থেকে দৈনিক ভিউ গণনা এবং দেখার সময়
      • সেরা ১০ - ইউটিউব অনুসন্ধান শব্দ যা একটি ভিডিওর জন্য সর্বাধিক ট্র্যাফিক তৈরি করে
      • সেরা ১০ - গুগল সার্চ শব্দ যা একটি ভিডিওর জন্য সবচেয়ে বেশি ট্র্যাফিক তৈরি করে
      • একটি দেশের বিভিন্ন ট্র্যাফিক উৎস থেকে প্লেলিস্টের ভিউ গণনা এবং দেখার সময়
      • বিভিন্ন ট্র্যাফিক উৎস থেকে দৈনিক প্লেলিস্ট দেখার সংখ্যা এবং দেখার সময়

ডিভাইস

deviceType
এই মাত্রাটি সেই ডিভাইসের ভৌত ফর্ম ফ্যাক্টর সনাক্ত করে যেখানে ভিউটি ঘটেছে। নিম্নলিখিত তালিকাটি সেই ডিভাইসের ধরণগুলি সনাক্ত করে যার জন্য API ডেটা ফেরত দেয়। আপনি একটি অপারেটিং সিস্টেম রিপোর্টকে শুধুমাত্র একটি নির্দিষ্ট ধরণের ডিভাইসের জন্য ডেটা ধারণ করার জন্য সীমাবদ্ধ করার জন্য deviceType মাত্রাটিকে একটি ফিল্টার হিসাবে ব্যবহার করতে পারেন।
  • DESKTOP
  • GAME_CONSOLE
  • MOBILE
  • TABLET
  • TV
  • AUTOMOTIVE
  • WEARABLE
  • UNKNOWN_PLATFORM
operatingSystem
এই মাত্রাটি সেই ডিভাইসের সফ্টওয়্যার সিস্টেমকে চিহ্নিত করে যেখানে ভিউটি ঘটেছে। নিম্নলিখিত তালিকাটি সেই অপারেটিং সিস্টেমগুলিকে চিহ্নিত করে যার জন্য API ডেটা ফেরত দেয়। আপনি operatingSystem একটি ফিল্টার হিসাবেও ব্যবহার করতে পারেন যাতে একটি ডিভাইস টাইপ রিপোর্টে শুধুমাত্র একটি নির্দিষ্ট অপারেটিং সিস্টেমের জন্য ডেটা থাকে।
  • ANDROID
  • BADA
  • BLACKBERRY
  • CHROMECAST
  • DOCOMO
  • FIREFOX
  • HIPTOP
  • IOS
  • KAIOS
  • LINUX
  • MACINTOSH
  • MEEGO
  • NINTENDO_3DS
  • OTHER
  • PLAYSTATION
  • PLAYSTATION_VITA
  • REALMEDIA
  • SMART_TV
  • SYMBIAN
  • TIZEN
  • VIDAA
  • WEBOS
  • WII
  • WINDOWS
  • WINDOWS_MOBILE
  • XBOX

উদাহরণ

নিম্নলিখিত নমুনা অনুরোধগুলি ডিভাইসের মাত্রা ব্যবহার করে:

  • চ্যানেলের উদাহরণ

    • ডিভাইস/ওএস
      • অ্যান্ড্রয়েড অপারেটিং সিস্টেমের জন্য দৈনিক ডিভাইসের ধরণের মেট্রিক্স
      • মোবাইল ডিভাইসের জন্য দৈনিক অপারেটিং সিস্টেমের মেট্রিক্স
      • দৈনিক অপারেটিং সিস্টেম এবং ডিভাইসের ধরণের মেট্রিক্স
      • অ্যান্ড্রয়েড অপারেটিং সিস্টেমে প্লেলিস্ট ভিউয়ের জন্য দৈনিক ডিভাইস টাইপ মেট্রিক্স
      • মোবাইল ডিভাইসে প্লেলিস্ট ভিউয়ের দৈনিক অপারেটিং সিস্টেম মেট্রিক্স

  • কন্টেন্ট মালিকের উদাহরণ

    • ডিভাইস/ওএস
      • দাবি করা ভিডিওর জন্য দৈনিক ডিভাইসের ধরণের মেট্রিক্স
      • মোবাইল ডিভাইসে দেখা দাবি করা ভিডিওর দৈনিক অপারেটিং সিস্টেম মেট্রিক্স
      • দৈনিক অপারেটিং সিস্টেম এবং ডিভাইসের ধরণের মেট্রিক্স
      • অ্যান্ড্রয়েড অপারেটিং সিস্টেমে প্লেলিস্ট ভিউয়ের জন্য দৈনিক ডিভাইস টাইপ মেট্রিক্স
      • মোবাইল ডিভাইসে প্লেলিস্ট ভিউয়ের দৈনিক অপারেটিং সিস্টেম মেট্রিক্স

জনসংখ্যা

জনসংখ্যাতাত্ত্বিক মাত্রা আপনাকে আপনার দর্শকদের বয়সসীমা এবং লিঙ্গ বন্টন বুঝতে সাহায্য করে। YouTube সহায়তা কেন্দ্রে YouTube Analytics রিপোর্টে জনসংখ্যাতাত্ত্বিক ডেটা সম্পর্কে অতিরিক্ত তথ্য রয়েছে।

ageGroup (core dimension)
এই মাত্রাটি রিপোর্ট ডেটার সাথে যুক্ত লগ-ইন করা ব্যবহারকারীদের বয়স গোষ্ঠী চিহ্নিত করে। API নিম্নলিখিত বয়স গোষ্ঠী ব্যবহার করে:
  • age13-17
  • age18-24
  • age25-34
  • age35-44
  • age45-54
  • age55-64
  • age65-
This is a core dimension and is subject to the Deprecation Policy .
gender (core dimension)
এই মাত্রাটি রিপোর্ট ডেটার সাথে যুক্ত লগ-ইন করা ব্যবহারকারীদের লিঙ্গ শনাক্ত করে। বৈধ মানগুলি হল female , male এবং user_specified । This is a core dimension and is subject to the Deprecation Policy .

উদাহরণ

নিম্নলিখিত নমুনা অনুরোধগুলি জনসংখ্যাতাত্ত্বিক মাত্রা ব্যবহার করে:

  • চ্যানেলের উদাহরণ

    • জনসংখ্যাতাত্ত্বিক
      • ক্যালিফোর্নিয়ার দর্শকদের জনসংখ্যা (বয়স এবং লিঙ্গ)
      • ক্যালিফোর্নিয়ায় প্লেলিস্ট দর্শকদের জনসংখ্যা (বয়স গ্রুপ এবং লিঙ্গ)

  • কন্টেন্ট মালিকের উদাহরণ

    • জনসংখ্যাতাত্ত্বিক
      • ক্যালিফোর্নিয়ার দর্শকদের জনসংখ্যা (বয়স এবং লিঙ্গ)
      • ক্যালিফোর্নিয়ায় প্লেলিস্ট দর্শকদের জনসংখ্যা (বয়স গ্রুপ এবং লিঙ্গ)

সম্পৃক্ততা এবং কন্টেন্ট শেয়ারিং

sharingService (core dimension)
এই মাত্রাটি ভিডিও শেয়ার করার জন্য ব্যবহৃত পরিষেবাটিকে চিহ্নিত করে। "শেয়ার" বোতাম ব্যবহার করে YouTube-এ (অথবা YouTube প্লেয়ারের মাধ্যমে) ভিডিও শেয়ার করা যেতে পারে। This is a core dimension and is subject to the Deprecation Policy .

নিম্নলিখিত সারণীতে বৈধ মাত্রার মানগুলি তালিকাভুক্ত করা হয়েছে:
শেয়ারিং পরিষেবা API মান
আমেবা AMEBA
অ্যান্ড্রয়েড ইমেল ANDROID_EMAIL
অ্যান্ড্রয়েড মেসেঞ্জার ANDROID_MESSENGER
অ্যান্ড্রয়েড মেসেজিং ANDROID_MMS
ব্ল্যাকবেরি মেসেঞ্জার BBM
ব্লগার BLOGGER
ক্লিপবোর্ডে কপি করুন COPY_PASTE
সাইওয়ার্ল্ড CYWORLD
ডিগ DIGG
ড্রপবক্স DROPBOX
এম্বেড করুন EMBED
ইমেইল MAIL
ফেসবুক FACEBOOK
ফেসবুক মেসেঞ্জার FACEBOOK_MESSENGER
ফেসবুক পেজ FACEBOOK_PAGES
ফোটকা FOTKA
জিমেইল GMAIL
গু GOO
গুগল+ GOOGLEPLUS
এসএমএস করুন GO_SMS
গ্রুপমি GROUPME
হ্যাঙ্গআউট HANGOUTS
হাই৫ HI5
HTC টেক্সট মেসেজ HTC_MMS
গুগল ইনবক্স INBOX
iOS সিস্টেম অ্যাক্টিভিটি ডায়ালগ IOS_SYSTEM_ACTIVITY_DIALOG
কাকাও গল্প KAKAO_STORY
কাকাও (কাকাও টক) KAKAO
কিক KIK
LGE ইমেল LGE_EMAIL
লাইন LINE
লিঙ্কডইন LINKEDIN
লাইভজার্নাল LIVEJOURNAL
মেনিমে MENEAME
মিক্সি MIXI
মটোরোলা মেসেজিং MOTOROLA_MESSAGING
মাইস্পেস MYSPACE
নাভার NAVER
কাছাকাছি শেয়ার NEARBY_SHARE
নুজিজ NUJIJ
ওডনোক্লাসনিকি (Одноклассники) ODNOKLASSNIKI
অন্যান্য OTHER
পিন্টারেস্ট PINTEREST
রাকুটেন (楽天市場) RAKUTEN
রেডিট REDDIT
স্কাইপ SKYPE
স্কাইরক SKYBLOG
সনি কথোপকথন SONY_CONVERSATIONS
স্টাম্বলআপন STUMBLEUPON
টেলিগ্রাম TELEGRAM
টেক্সট মেসেজ TEXT_MESSAGE
টুয়েন্টি TUENTI
টাম্বলার। TUMBLR
টুইটার TWITTER
অজানা UNKNOWN
ভেরাইজন বার্তা VERIZON_MMS
ভাইবার VIBER
VKontakte (ВКонтакте) VKONTAKTE
উইচ্যাট WECHAT
ওয়েইবো WEIBO
হোয়াটসঅ্যাপ WHATS_APP
উইকপ WYKOP
ইয়াহু! জাপান YAHOO
ইউটিউব গেমিং YOUTUBE_GAMING
ইউটিউব কিডস YOUTUBE_KIDS
ইউটিউব মিউজিক YOUTUBE_MUSIC
ইউটিউব টিভি YOUTUBE_TV

আরও তথ্যের জন্য সহায়তা ডক্স দেখুন।

উদাহরণ

নিম্নলিখিত নমুনা অনুরোধগুলি সামাজিক মাত্রা ব্যবহার করে:

  • চ্যানেলের উদাহরণ

    • সামাজিক : শেয়ারিং মেট্রিক্স, যেখানে ভিডিও শেয়ার করা হয়েছে সেই পরিষেবা অনুসারে একত্রিত

  • কন্টেন্ট মালিকের উদাহরণ

    • সামাজিক : শেয়ারিং মেট্রিক্স, যেখানে ভিডিও শেয়ার করা হয়েছে সেই পরিষেবা অনুসারে একত্রিত

দর্শক ধরে রাখা

elapsedVideoTimeRatio
এই মাত্রাটি ভিডিওর শেষ অংশের সাথে ভিডিওর দৈর্ঘ্যের অনুপাত নির্দিষ্ট করে। সময়ের সাথে সাথে দর্শক ধরে রাখার মাত্রা এবং মেট্রিক্স ব্যবহার করা হয় এবং elapsedVideoTimeRatio মাত্রা হল সময়ের পরিমাপ। উদাহরণস্বরূপ, 0.4 মান নির্দেশ করে যে সংশ্লিষ্ট প্রতিবেদনের ডেটা ভিডিওর 40 শতাংশ সময় অতিবাহিত হওয়ার পরে ধরে রাখার ডেটা দেখায়।

API প্রতিটি ভিডিওর জন্য ১০০টি ডেটা পয়েন্ট প্রদান করে যার অনুপাতের মান 0.01 থেকে 1.0 পর্যন্ত। ভিডিও প্লেব্যাকের সময় ডেটা পরিমাপের সময় প্রতিটি ভিডিওর জন্য সমান ব্যবধানে ভাগ করা হয়। এর অর্থ হল দুই মিনিটের ভিডিওর জন্য, ডেটা পয়েন্টের মধ্যে ব্যবধান ১.২ সেকেন্ড। তবে, দুই ঘন্টার ভিডিওর জন্য, ডেটা পয়েন্টের মধ্যে ব্যবধান ৭২ সেকেন্ড। মাত্রার মান ব্যবধানের একচেটিয়া সমাপ্তি নির্দেশ করে।
audienceType (filter only)
মাত্রার মান রিপোর্ট ডেটার সাথে সম্পর্কিত ট্র্যাফিকের ধরণ চিহ্নিত করে। সমর্থিত মানগুলি হল ORGANIC , AD_INSTREAM , এবং AD_INDISPLAY । এই ট্র্যাফিক উৎসের ধরণগুলির ব্যাখ্যার জন্য YouTube সহায়তা কেন্দ্র দেখুন।

মনে রাখবেন যে audienceType ফিল্টারের ডেটা ২৫শে সেপ্টেম্বর, ২০১৩ তারিখ থেকে পাওয়া যাচ্ছে। API সেইসব কোয়েরির ডেটা ফেরত দেয় না যারা আগের তারিখ থেকে ডেটা পুনরুদ্ধার করার জন্য ফিল্টার ব্যবহার করে। যেসব কোয়েরি ফিল্টার ব্যবহার করে না সেগুলি ১ জুলাই, ২০০৮ এর পরের যেকোনো তারিখের জন্য কাজ করে।

উদাহরণ

নিম্নলিখিত নমুনা অনুরোধগুলিতে দর্শক ধরে রাখার মাত্রা ব্যবহার করা হয়েছে:

  • চ্যানেলের উদাহরণ

  • কন্টেন্ট মালিকের উদাহরণ

সরাসরি সম্প্রচার

livestreamPosition
এই মাত্রাটি একটি লাইভ ভিডিও স্ট্রিম চলাকালীন একটি নির্দিষ্ট মিনিট নির্দিষ্ট করে। রিপোর্টের মেট্রিক্সগুলি নির্দেশ করে যে সেই সময়ে কতজন ব্যবহারকারী লাইভ স্ট্রিমটি দেখছিলেন।

সদস্যপদ বাতিলকরণ

membershipsCancellationSurveyReason
রিপোর্টিং সময়কালে নির্দিষ্ট চ্যানেলের জন্য তাদের চ্যানেল সদস্যতা বাতিল করা YouTube ব্যবহারকারীদের দ্বারা সম্পন্ন সমীক্ষার সংখ্যা। নিম্নলিখিত সারণীতে বৈধ মাত্রার মান তালিকাভুক্ত করা হয়েছে:
API মান ব্যাখ্যা
UNKNOWN ব্যবহারকারী জরিপটি সম্পূর্ণ করেননি।
DISLIKE_PERKS ব্যবহারকারী সদস্যপদটির সুবিধাগুলি পছন্দ করেননি।
PERKS_NOT_DELIVERED ব্যবহারকারী বলেছেন যে প্রতিশ্রুত সদস্যপদ সুবিধাগুলি সরবরাহ করা হয়নি।
CANNOT_ACCESS_PERKS ব্যবহারকারী সুবিধাগুলি অ্যাক্সেস করতে সক্ষম হননি।
NO_LONGER_INTERESTED ব্যবহারকারী আর চ্যানেল মেম্বারশিপে আগ্রহী নন।
FEEL_UNAPPRECIATED চ্যানেল সদস্য হিসেবে ব্যবহারকারী নিজেকে অপ্রিয় বোধ করেছেন।
FINANCIAL_REASONS ব্যবহারকারী আর্থিক কারণে বাতিল করেছেন।
JOIN_LIMITED_TIME ব্যবহারকারী শুধুমাত্র সীমিত সময়ের জন্য যোগদান করতে চেয়েছিলেন।
OTHER ব্যবহারকারীর বাতিল করার আরেকটি কারণ ছিল।

বিজ্ঞাপনের পারফর্ম্যান্স

adType
বিজ্ঞাপনের পারফর্ম্যান্স রিপোর্টে adType ডাইমেনশন ব্যবহার করা হয় এবং ভিডিও প্লেব্যাকের সময় যে ধরণের বিজ্ঞাপন দেখানো হয়েছিল তার উপর ভিত্তি করে অনুরোধ করা মেট্রিক্স একত্রিত করে। নিম্নলিখিত তালিকাটি সম্ভাব্য ডাইমেনশন মানগুলি ব্যাখ্যা করে। YouTube বিজ্ঞাপন ফর্ম্যাট সম্পর্কে আরও তথ্যের জন্য YouTube সহায়তা কেন্দ্র দেখুন।

  • auctionBumperInstream – নিলামের মাধ্যমে স্থাপিত, স্কিপ করা যায় না এমন ভিডিও বিজ্ঞাপন, সর্বোচ্চ ৬ সেকেন্ডের, যা ভিডিও দেখার আগে অবশ্যই দেখা উচিত।

  • auctionDisplay – একটি সমৃদ্ধ মিডিয়া বা চিত্র বিজ্ঞাপন যা ভিডিও প্লেয়ারের নীচে ওভারলে হিসাবে, ভিডিও দেখার পৃষ্ঠায় 300x250 বিজ্ঞাপন ইউনিট হিসাবে, অথবা উভয়ের সংমিশ্রণ হিসাবে প্রদর্শিত হয়। ওভারলেটি চলাকালীন, নির্দিষ্ট সময়ের জন্য প্রদর্শিত হওয়ার পরে এটি স্বয়ংক্রিয়ভাবে বন্ধ হয়ে যায় এবং ব্যবহারকারী ওভারলেটিও বন্ধ করতে পারেন। যদি একটি ওভারলে এবং একটি ব্যানার একসাথে দেখানো হয়, তবে প্রতিটি বিজ্ঞাপনকে একটি পৃথক ছাপ হিসাবে গণনা করা হয়।

  • auctionInstream – মূল ভিডিওর আগে, চলাকালীন বা পরে চলা অ-স্কিপযোগ্য ভিডিও বিজ্ঞাপন।

  • auctionTrueviewInslate – দর্শক একটি ভিডিওর আগে প্রদর্শিত বিভিন্ন পছন্দের তালিকা থেকে বেশ কয়েকটি ভিডিও বিজ্ঞাপনের মধ্যে একটি বেছে নেয়। See the TrueView documentation for more information.

  • auctionTrueviewInstream – মূল ভিডিওর আগে বা চলাকালীন সময়ে চালানো যায় এমন স্কিপেবল ভিডিও বিজ্ঞাপন। আরও তথ্যের জন্য TrueView ডকুমেন্টেশন দেখুন।

  • auctionUnknown – এমন একটি বিজ্ঞাপন যা AdWords নিলামের মাধ্যমে কেনা হয়েছে কিন্তু অন্য কোনও বিজ্ঞাপনের ধরণে শ্রেণীবদ্ধ করা হয়নি।

  • reservedBumperInstream – স্কিপ করা যায় না এমন ভিডিও বিজ্ঞাপন, যা রিজার্ভ ভিত্তিতে বিক্রি করা হয়, সর্বোচ্চ ৬ সেকেন্ডের, যা ভিডিও দেখার আগে অবশ্যই দেখা উচিত।

  • reservedClickToPlay – একটি ভিডিও বিজ্ঞাপন যা ব্যবহারকারীকে প্লেব্যাক শুরু করতে ক্লিক করতে হবে। ক্লিক-টু-প্লে বিজ্ঞাপন ইউনিট প্রদর্শিত হওয়ার সাথে সাথেই একটি বিজ্ঞাপনের ছাপ রেকর্ড করা হয়, ব্যবহারকারী প্লেব্যাক শুরু করুক বা না করুক। এগুলি একটি সংরক্ষিত ভিত্তিতে বিক্রি করা হয়।

  • reservedDisplay – A rich media or image ad that appears either as an overlay on the bottom of the video player, as a 300x250 ad unit on the video watch page, or as a combination of both. When the overlay runs, it automatically closes after displaying for a certain amount of time, and the user can close the overlay as well. If an overlay and a banner are shown together, each ad is counted as a separate impression.

  • reservedInstream – Non-skippable video ads that are inserted before, during, or after the main video.

  • reservedInstreamSelect

  • reservedMasthead – A large ad, which can include video and graphic elements, that appears on the homepage.

  • reservedUnknown – An ad that was sold on a reserved basis that could not be classified into one of the other ad types.

  • unknown – YouTube could not classify this ad type.

উদাহরণ

The following sample reports retrieve ad performance or revenue metrics:

  • Channel examples

    • Revenue/Ads
      • Channel revenue and ad performance metrics
      • Daily revenue and ad performance metrics
      • Country-specific revenue and ad performance metrics
      • Top 10 – Videos with the highest revenue
      • Ad performance metrics for different ad types

  • Content owner examples

    • Revenue/Ads
      • Revenue and ad performance metrics for claimed content
      • Daily revenue and ad performance metrics
      • Country-specific revenue and ad performance metrics
      • Top 10 – Videos with the highest revenue
      • Ad performance metrics for different ad types

Content owner dimensions

The following dimensions are only supported for content owner reports.

Important: API requests to retrieve content owner reports must filter data using one of the following dimensions:
  • video
  • channel
  • A supported combination of the claimedStatus and uploaderType dimensions as defined below.
claimedStatus (only used in content owner reports)
This dimension lets you indicate that an API response should only contain metrics for claimed content. The only valid value for this dimension is claimed . If the filters parameter restricts the query to claimedStatus==claimed , the API will only retrieve data for claimed content. The table in the definition of the uploaderType dimension provides more detail about how to use this dimension.
uploaderType (core dimension) (only used in content owner reports)
This dimension lets you indicate whether an API response should contain metrics for content uploaded by the specified content owner and/or content uploaded by third parties, such as user-uploaded videos. Valid values are self and thirdParty . This is a core dimension and is subject to the Deprecation Policy .

The table below shows the supported combinations for the claimedStatus and uploaderType dimensions, which are both used in the filters parameter:

claimedStatus value uploaderType value বিবরণ
[Not set] self Retrieves YouTube Analytics data for claimed and unclaimed content uploaded by the content owner.
claimed [Not set] Retrieves data for claimed content uploaded by the content owner or by a third party.
claimedself Retrieves data for claimed content uploaded by the content owner.
claimedthirdParty Retrieves data for claimed content uploaded by a third party.

উদাহরণ

Many of the sample API requests for content owner reports use a supported combination of the claimedStatus and uploaderType dimensions to filter data.