Dimensions

این سند ابعادی را که API یوتیوب آنالیتیکس پشتیبانی می‌کند، تعریف می‌کند. این API از پرس‌وجوهای هدفمند و بلادرنگ برای تولید گزارش‌های سفارشی یوتیوب آنالیتیکس پشتیبانی می‌کند.

ابعاد، معیارهای رایجی هستند که برای جمع‌آوری داده‌ها استفاده می‌شوند، مانند تاریخ وقوع فعالیت کاربر یا کشوری که کاربران در آن قرار دارند.

هر گزارش پرس‌وجو، ابعادی را که پشتیبانی می‌کند، مشخص می‌کند. برای مثال، هنگام بازیابی فعالیت کاربر بر اساس زمان، شما دوره زمانی را که داده‌ها برای آن گزارش می‌شوند انتخاب می‌کنید: روز یا ماه . در هر گزارش، هر ردیف از داده‌ها ترکیبی منحصر به فرد از مقادیر ابعاد دارد.

برای بازیابی گزارش پرس‌وجو، متد reports.query از API یوتیوب آنالیتیکس را فراخوانی کنید. در درخواست خود، از پارامتر dimensions برای تعیین ابعادی که یوتیوب برای محاسبه مقادیر معیار در گزارش‌ها استفاده خواهد کرد، استفاده کنید.

ابعاد هسته

اگرچه API یوتیوب آنالیتیکس تابع سیاست حذف تعریف‌شده در شرایط خدمات است، ابعاد غیر اصلی (و معیارهای غیر اصلی) تابع این سیاست نیستند. در تعاریف این صفحه، هر بعدی که یک بعد اصلی باشد، به صراحت به عنوان چنین بُعدی شناخته می‌شود.

لیست زیر ابعاد اصلی API را مشخص می‌کند.

برای اطلاعات بیشتر، به فهرست APIهای YouTube که مشمول سیاست منسوخ شدن هستند ، مراجعه کنید.

فیلترها

همه گزارش‌های پرس‌وجو از فیلترها پشتیبانی می‌کنند. فیلترها مقادیر بُعدی را که باید در مجموعه داده‌های بازیابی شده وجود داشته باشند، شناسایی می‌کنند. به این ترتیب، آنها پاسخ API را محدود می‌کنند تا فقط شامل داده‌هایی باشد که با یک مقدار خاص یا مجموعه‌ای از مقادیر مطابقت دارند. به عنوان مثال، به جای بازیابی معیارهای فعالیت کاربر برای همه کشورها، می‌توانید از یک فیلتر برای بازیابی داده‌ها فقط برای یک کشور خاص استفاده کنید.

در درخواست بازیابی گزارش پرس‌وجو، پارامتر اختیاری درخواست filters ، مقادیر ابعادی را که می‌خواهید داده‌ها را برای آنها فیلتر کنید، مشخص می‌کند. برای مثال، برای بازیابی معیارهای فعالیت کاربر برای اروپا، باید مقدار پارامتر filters را روی continent==150 تنظیم کنید.

مهم: درخواست‌های API برای بازیابی گزارش‌های مالک محتوا باید داده‌ها را با استفاده از یکی از ابعاد موجودیت گزارش‌دهنده یا با استفاده از ترکیبی پشتیبانی‌شده از ابعاد claimedStatus و uploaderType فیلتر کنند.

ابعاد

بخش‌های زیر ابعادی را که در گزارش‌های کوئری API یوتیوب آنالیتیکس استفاده می‌شوند، تعریف می‌کنند. مگر اینکه خلاف آن ذکر شده باشد، این ابعاد هم در گزارش‌های کانال و هم در گزارش‌های مالک محتوا استفاده می‌شوند. ابعادی که فقط می‌توانند به عنوان فیلتر استفاده شوند نیز مشخص شده‌اند.

منابع

این ابعاد مربوط به منابعی است که کانال‌ها و صاحبان محتوا در یوتیوب مدیریت می‌کنند:

توجه: API به شما امکان می‌دهد هنگام استفاده از ابعاد video ، playlist و channel به عنوان فیلتر، چندین مقدار برای آنها تعیین کنید. برای انجام این کار، مقدار پارامتر filters را روی لیستی از شناسه‌های ویدیو، لیست پخش یا کانال که با کاما از هم جدا شده‌اند و پاسخ API باید برای آنها فیلتر شود، تنظیم کنید. مقدار پارامتر می‌تواند تا ۵۰۰ شناسه را مشخص کند.

video (core dimension)
شناسه‌ی یک ویدیوی یوتیوب. در API داده‌های یوتیوب، این مقدار، ویژگی id یک منبع video است. This is a core dimension and is subject to the Deprecation Policy .
playlist
شناسه‌ی یک لیست پخش یوتیوب. در API داده‌های یوتیوب، این مقدار، مقدار ویژگی id یک منبع playlist است.
channel (core dimension) (only used in content owner reports)
شناسه یک کانال یوتیوب. در API داده یوتیوب، این مقدار ویژگی id یک منبع channel است. This is a core dimension and is subject to the Deprecation Policy .

بُعد channel اغلب در گزارش‌های مالک محتوا استفاده می‌شود، زیرا این گزارش‌ها معمولاً داده‌ها را برای چندین کانال جمع‌آوری می‌کنند.
group (filter only)
شناسه یک گروه YouTube Analytics. می‌توانید این مقدار را با استفاده از متد groups.list از API YouTube Analytics بازیابی کنید. وقتی از فیلتر group استفاده می‌کنید، پاسخ API شامل داده‌هایی برای همه ویدیوها، لیست‌های پخش یا کانال‌های موجود در آن گروه است.

مثال‌ها

درخواست‌های نمونه زیر از ابعاد یا فیلترهای موجودیت گزارش‌دهنده استفاده می‌کنند:

  • نمونه‌های کانال

    • آمار پایه
      • ۱۰ ویدیوی برتر - پربازدیدترین ویدیوها برای یک کانال
      • 10 مورد برتر - نرخ کلیک حاشیه‌نویسی برای پربازدیدترین ویدیوهای یک کانال
      • آمار برای یک لیست پخش خاص
      • ۱۰ مورد برتر - پربیننده‌ترین لیست‌های پخش برای یک کانال
    • جغرافیایی
      • ۱۰ ویدیوی برتر - پربازدیدترین ویدیوها در یک کشور خاص
      • 10 ویدیوی برتر - پربازدیدترین ویدیوها در اروپا

  • نمونه‌هایی از مالک محتوا

    • آمار پایه
      • 10 مورد برتر - پربازدیدترین ویدیوها برای یک مالک محتوا
      • 10 ویدیوی برتر - پربازدیدترین ویدیوها برای یک مالک محتوا
      • ۱۰ ویدیوی برتر - پربازدیدترین ویدیوها برای کانال صاحب محتوا
      • 10 مورد برتر - نرخ کلیک حاشیه‌نویسی برای پربازدیدترین ویدیوهای یک کانال
      • 10 مورد برتر - پربیننده‌ترین لیست‌های پخش برای یک مالک محتوا
    • جغرافیایی
      • 10 ویدیوی برتر - پربیننده‌ترین ویدیوها در اروپا برای یک مالک محتوا
      • ده آهنگ برتر - بیشترین پلی‌لیست‌های شروع‌شده در ایالات متحده

مناطق جغرافیایی

این ابعاد، یک منطقه جغرافیایی مرتبط با فعالیت کاربر، عملکرد تبلیغات یا معیارهای درآمد تخمینی را مشخص می‌کنند.

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 شامل province در مقدار پارامتر dimensions می‌شود، درخواست باید با گنجاندن country==US در مقدار پارامتر filters ، داده‌ها را به ایالات متحده محدود کند.

توجه: این بُعد از مقادیر ISO 3166-2 که مناطق دورافتاده ایالات متحده را مشخص می‌کنند پشتیبانی نمی‌کند، زیرا آن مناطق نیز کدهای کشوری ISO 3166-1 خود را دارند. همچنین از تقسیمات کشورهای غیر از ایالات متحده پشتیبانی نمی‌کند.

dma
شناسه‌ی سه رقمی که نیلسن برای شناسایی منطقه‌ی بازار تعیین‌شده (DMA) مرتبط با رویدادهای مشاهده‌ای شرح داده شده در ردیف داده‌ها استفاده می‌کند.
city
شهر تخمینی مرتبط با معیارهای موجود در ردیف گزارش. داده‌های این بُعد برای تاریخ‌های شروع از ۱ ژانویه ۲۰۲۲ در دسترس است.
continent (filter only)
یک کد منطقه آماری سازمان ملل متحد (UN). این API از مقادیر زیر پشتیبانی می‌کند:
ارزش‌ها
002 آفریقا
019 قاره آمریکا (آمریکای شمالی، آمریکای لاتین، آمریکای جنوبی و کارائیب)
142 آسیا
150 اروپا
009 اقیانوسیه
این بُعد فقط می‌تواند برای فیلتر کردن داده‌ها استفاده شود. برای استفاده از این بُعد، مقدار پارامتر filters را روی continent==REGION_CODE تنظیم کنید و یک مقدار REGION_CODE از جدول را مشخص کنید.
subContinent (filter only)
یک کد منطقه‌ای آماری سازمان ملل متحد که یک زیرمنطقه جغرافیایی را مشخص می‌کند. بخش آمار سازمان ملل متحد، زیرمنطقه‌ها و همچنین کشورهایی را که با هر منطقه مرتبط هستند، فهرست می‌کند.

این بُعد فقط می‌تواند برای فیلتر کردن داده‌ها استفاده شود. برای استفاده از این بُعد، مقدار پارامتر filters را روی subContinent==REGION_CODE تنظیم کنید و یک مقدار REGION_CODE از لیست UN مشخص کنید.

مثال‌ها

درخواست‌های نمونه زیر از ابعاد یا فیلترهای جغرافیایی استفاده می‌کنند:

  • نمونه‌های کانال

    • آمار پایه : تعداد بازدیدهای خاص کشور (و موارد دیگر) برای یک کانال
    • جغرافیایی
      • معیارهای زمان تماشای ویدیوهای یک کانال در هر کشور
      • معیارهای حاشیه‌نویسی مختص هر کشور برای ویدیوهای یک کانال
      • معیارهای خاص استان برای ایالت‌های آمریکا و واشنگتن دی سی
      • معیارهای زمان تماشای خاص کشور برای لیست‌های پخش یک کانال
      • ده آهنگ برتر - بیشترین پلی‌لیست‌های شروع‌شده در ایالات متحده
    • مکان پخش : تعداد بازدیدهای روزانه و زمان تماشا از مکان‌های پخش مختلف
    • منبع ترافیک : تعداد بازدیدها و زمان تماشا از منابع ترافیکی مختلف در یک کشور
    • جمعیت‌شناسی : آمار بینندگان در کالیفرنیا (گروه سنی و جنسیت)
    • ویدیوهای برتر
      • ۱۰ ویدیوی برتر - پربازدیدترین ویدیوها در یک کشور خاص
      • 10 ویدیوی برتر - پربازدیدترین ویدیوها در اروپا

  • نمونه‌هایی از مالک محتوا

    • آمار پایه : تعداد بازدیدهای مختص هر کشور (و موارد دیگر) برای همه ویدیوهای آپلود شده توسط خود کاربر
    • جغرافیایی
      • معیارهای زمان تماشای خاص کشور برای محتوای آپلود شده توسط خود کاربر
      • معیارهای حاشیه‌نویسی مختص هر کشور برای محتوای خودبارگذاری‌شده
      • معیارهای خاص استان برای ایالت‌های آمریکا و واشنگتن دی سی
      • معیارهای زمان تماشای خاص کشور برای لیست‌های پخش صاحب محتوا
      • ده آهنگ برتر - بیشترین پلی‌لیست‌های شروع‌شده در ایالات متحده
    • مکان پخش : تعداد بازدیدهای روزانه و زمان تماشا از مکان‌های پخش مختلف
    • جمعیت‌شناسی : آمار بینندگان در کالیفرنیا (گروه سنی و جنسیت)
    • ویدیوهای برتر : 10 ویدیوی برتر - پربیننده‌ترین ویدیوها در اروپا برای یک مالک محتوا
    • درآمد/عملکرد تبلیغات : معیارهای درآمد و عملکرد تبلیغات مختص هر کشور

دوره‌های زمانی

این ابعاد نشان می‌دهند که یک گزارش باید داده‌ها را بر اساس یک دوره زمانی، مانند روز، هفته یا ماه، جمع‌آوری کند. پارامترهای درخواست startDate و endDate دوره زمانی را که گزارش شامل داده‌ها می‌شود، مشخص می‌کنند. توجه داشته باشید که گزارش در واقع داده‌ها را تا آخرین روزی که تمام معیارهای مشخص شده در درخواست در زمان انجام پرس و جو در دسترس هستند، برمی‌گرداند. در گزارش‌ها، تاریخ‌ها با فرمت YYYY-MM-DD فهرست می‌شوند.

مهم: همه تاریخ‌ها به بازه زمانی اشاره دارند که از ساعت ۱۲:۰۰ بامداد به وقت اقیانوس آرام (UTC-7 یا UTC-8) شروع شده و در ساعت ۱۱:۵۹ شب به وقت اقیانوس آرام در روز، ماه و سال مشخص شده پایان می‌یابد. در نتیجه، تاریخ‌هایی که ساعت‌ها برای صرفه‌جویی در نور روز به جلو تنظیم می‌شوند، یک دوره ۲۳ ساعته و تاریخ‌هایی که ساعت‌ها به عقب تنظیم می‌شوند، یک دوره ۲۵ ساعته را نشان می‌دهند.

بُعد ماه به دوره زمانی اشاره دارد که از ساعت ۱۲:۰۰ بامداد به وقت اقیانوس آرام (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> پخش شده است. به عنوان مثال، پخش‌ها در برنامه‌هایی که از API پخش‌کننده اندروید یوتیوب استفاده می‌کنند، با استفاده از این مقدار طبقه‌بندی می‌شوند.

  • MOBILE - داده‌ها، بازدیدهایی را که در وب‌سایت موبایل یوتیوب یا کلاینت‌های تأیید شده‌ی API یوتیوب، از جمله دستگاه‌های تلفن همراه، رخ داده است، توصیف می‌کند.

    از ۱۰ سپتامبر ۲۰۱۳، پخش‌ها دیگر در گزارش‌های YouTube Analytics به عنوان پخش‌های MOBILE طبقه‌بندی نمی‌شوند. این مقدار ممکن است در گزارش‌ها باقی بماند زیرا داده‌های قدیمی هنوز در آن دسته قرار می‌گیرند. با این حال، پس از آن تاریخ، پخش‌های موبایل بسته به نوع برنامه‌ای که پخش در آن رخ می‌دهد، به عنوان پخش‌های WATCH ، EMBEDDED یا EXTERNAL_APP طبقه‌بندی می‌شوند.

  • SEARCH - داده‌ها، بازدیدهایی را که مستقیماً در صفحه نتایج جستجوی یوتیوب رخ داده‌اند، توصیف می‌کنند.

  • WATCH - داده‌ها، بازدیدهایی را توصیف می‌کنند که در صفحه تماشای ویدیو در یوتیوب یا در یک برنامه رسمی یوتیوب، مانند برنامه اندروید یوتیوب، رخ داده‌اند.

  • YT_OTHER – داده‌ها، نماهایی را توصیف می‌کنند که در غیر این صورت طبقه‌بندی نشده‌اند.

insightPlaybackLocationDetail
داده‌ها بر اساس صفحه‌ای که پخش‌کننده در آن قرار دارد، جمع‌آوری می‌شوند. توجه داشته باشید که این گزارش فقط برای بازدیدهایی که در پخش‌کننده‌های جاسازی‌شده رخ داده است، پشتیبانی می‌شود و پخش‌کننده‌های جاسازی‌شده‌ای را که بیشترین بازدید را برای یک ویدیوی مشخص ایجاد کرده‌اند، شناسایی می‌کند. بنابراین، با شناسایی URLها یا برنامه‌های مرتبط با پخش‌کننده‌های جاسازی‌شده برتر، نمای دقیق‌تری نسبت به گزارش مکان پخش ارائه می‌دهد.

مثال‌ها

درخواست‌های نمونه زیر از ابعاد مکان پخش استفاده می‌کنند:

  • نمونه‌های کانال

    • محل پخش
      • تعداد بازدیدها و زمان تماشا از مکان‌های پخش مختلف
      • تعداد بازدیدهای روزانه و زمان تماشا از مکان‌های پخش مختلف
      • 10 سایت برتر - سایت‌های شخص ثالث که بیشترین بازدید را برای یک ویدیوی جاسازی شده ایجاد می‌کنند
      • تعداد دفعات مشاهده لیست پخش و زمان تماشا از مکان‌های پخش مختلف
      • تعداد بازدیدهای روزانه از لیست پخش و زمان تماشا از مکان‌های پخش مختلف

  • نمونه‌هایی از مالک محتوا

    • محل پخش
      • تعداد بازدیدها و زمان تماشا از مکان‌های پخش مختلف
      • تعداد بازدیدهای روزانه و زمان تماشا از مکان‌های پخش مختلف
      • 10 سایت برتر - سایت‌های شخص ثالث که بیشترین بازدید را برای یک ویدیوی جاسازی شده ایجاد می‌کنند
      • تعداد دفعات مشاهده لیست پخش و زمان تماشا از مکان‌های پخش مختلف
      • تعداد بازدیدهای روزانه از لیست پخش و زمان تماشا از مکان‌های پخش مختلف

جزئیات پخش

creatorContentType
این بُعد، نوع محتوای مرتبط با معیارهای فعالیت کاربر در ردیف داده‌ها را مشخص می‌کند. داده‌های این بُعد برای تاریخ‌های شروع از ۱ ژانویه ۲۰۱۹ در دسترس است.

جدول زیر مقادیر ابعاد را فهرست می‌کند:
ارزش‌ها
LIVE_STREAM محتوای مشاهده شده یک پخش زنده یوتیوب بود.
SHORTS محتوای مشاهده شده یک ویدیوی کوتاه یوتیوب بود.
STORY محتوای مشاهده شده یک استوری یوتیوب بود.
VIDEO_ON_DEMAND محتوای مشاهده شده یک ویدیوی یوتیوب بود که تحت هیچ یک از مقادیر ابعاد دیگر قرار نمی‌گرفت.
UNSPECIFIED نوع محتوای مشاهده شده ناشناخته است.
liveOrOnDemand
این بُعد نشان می‌دهد که آیا معیارهای فعالیت کاربر در ردیف داده‌ها با بازدیدهای یک پخش زنده مرتبط هستند یا خیر. داده‌های این بُعد برای تاریخ‌های شروع از ۱ آوریل ۲۰۱۴ در دسترس است.

جدول زیر مقادیر ابعاد را فهرست می‌کند:
ارزش‌ها
LIVE داده‌های این ردیف، فعالیت کاربر را که در طول پخش زنده رخ داده است، توصیف می‌کند.
ON_DEMAND داده‌های این ردیف، فعالیت کاربری را توصیف می‌کند که در طول پخش زنده رخ نداده است.
subscribedStatus
این بُعد نشان می‌دهد که آیا معیارهای فعالیت کاربر در ردیف داده‌ها با بینندگانی که در کانال ویدیو یا لیست پخش مشترک شده‌اند، مرتبط است یا خیر. مقادیر ممکن عبارتند از SUBSCRIBED و UNSUBSCRIBED .

توجه داشته باشید که مقدار بُعد (dimention) در زمان وقوع فعالیت کاربر دقیق است. برای مثال، فرض کنید کاربری در کانالی مشترک نشده است و یکی از ویدیوهای آن کانال را تماشا می‌کند، سپس در کانال مشترک می‌شود و ویدیوی دیگری را تماشا می‌کند، همه در همان روز. گزارش کانال نشان می‌دهد که یک نما دارای مقدار subscribedStatus برابر با SUBSCRIBED و یک نما دارای مقدار subscribedStatus برابر با UNSUBSCRIBED است.
youtubeProduct
این بُعد، سرویس یوتیوبی را که فعالیت کاربر در آن رخ داده است، شناسایی می‌کند. داده‌های این بُعد از ۱۸ ژوئیه ۲۰۱۵ در دسترس است.

جدول زیر مقادیر ابعاد را فهرست می‌کند:
ارزش‌ها
CORE فعالیت کاربری که در یکی از برنامه‌های تخصصی یوتیوب (یوتیوب گیمینگ، یوتیوب کودکان یا یوتیوب موزیک) رخ نداده است. استثنا: فعالیت کاربری که قبل از ۱ مارس ۲۰۲۱ در یوتیوب موزیک رخ داده است، در CORE لحاظ می‌شود.
GAMING فعالیت کاربر در YouTube Gaming رخ داده است.
KIDS فعالیت کاربر در YouTube Kids رخ داده است.
MUSIC فعالیت کاربر در یوتیوب موزیک در تاریخ ۱ مارس ۲۰۲۱ یا پس از آن رخ داده است. داده‌های قبل از ۱ مارس ۲۰۲۱ در CORE گنجانده شده‌اند. داده‌های لحظه‌ای ثبت نمی‌شوند.
UNKNOWN فعالیت کاربر قبل از ۱۸ ژوئیه ۲۰۱۵ رخ داده است.

منابع ترافیک

insightTrafficSourceType
داده‌های موجود در گزارش بر اساس نوع ارجاع‌دهنده جمع‌آوری می‌شوند، که نحوه‌ی دسترسی کاربران به ویدیو را توصیف می‌کند. مقادیر ممکن برای این بُعد عبارتند از:
  • ADVERTISING - بیننده از طریق یک تبلیغ به ویدیو هدایت شده است. اگر بر اساس این منبع ترافیک فیلتر کنید، فیلد insightTrafficSourceDetail نوع تبلیغ را مشخص می‌کند.
  • ANNOTATION - بینندگان با کلیک روی حاشیه‌نویسی در ویدیوی دیگری به ویدیو دسترسی پیدا کردند.
  • CAMPAIGN_CARD – بازدیدها از ویدیوهای آپلود شده توسط کاربر که ادعا شده توسط صاحب محتوا برای تبلیغ محتوای مشاهده شده استفاده شده است، سرچشمه می‌گیرند. این منبع ترافیک فقط برای گزارش‌های صاحب محتوا پشتیبانی می‌شود.
  • END_SCREEN – نماها از صفحه انتهایی ویدیوی دیگری ارجاع داده شده‌اند.
  • EXT_URL – بازدیدهای ویدیو از طریق لینکی در وب‌سایت دیگری ارجاع داده شده‌اند. اگر بر اساس این منبع ترافیک فیلتر کنید، فیلد insightTrafficSourceDetail صفحه وب را شناسایی می‌کند. این منبع ترافیک شامل ارجاعات از نتایج جستجوی گوگل نیز می‌شود.
  • HASHTAGS - بازدیدها از صفحات هشتگ VOD یا صفحات محوری هشتگ Shorts سرچشمه گرفته‌اند.
  • LIVE_REDIRECT - بازدیدهای ویدیو از Live Redirects ارجاع داده شده‌اند.
  • NO_LINK_EMBEDDED – ویدیو هنگام مشاهده در وب‌سایت دیگری جاسازی شده است.
  • NO_LINK_OTHER – یوتیوب هیچ ارجاع‌دهنده‌ای برای ترافیک شناسایی نکرده است. این دسته شامل ترافیک مستقیم به یک ویدیو و همچنین ترافیک در برنامه‌های تلفن همراه می‌شود.
  • NOTIFICATION - بازدیدهای ویدیو از طریق ایمیل یا اعلانی از یوتیوب ارجاع داده شده‌اند.
  • PLAYLIST - بازدیدهای ویدیو در حین پخش ویدیو به عنوان بخشی از لیست پخش رخ داده است. این شامل ترافیکی است که از صفحه لیست پخش می‌آید.
  • PRODUCT_PAGE - بازدیدهای ویدیو از یک صفحه محصول ارجاع داده شده‌اند.
  • PROMOTED – بازدیدهای ویدیو از یک تبلیغ رایگان یوتیوب، مانند صفحه «ویدیوهای ویژه» یوتیوب، ارجاع داده شده‌اند.
  • RELATED_VIDEO – بازدیدهای ویدیو از یک لیست ویدیوی مرتبط در صفحه تماشای ویدیوی دیگر ارجاع داده شده‌اند. اگر بر اساس این منبع ترافیک فیلتر کنید، فیلد insightTrafficSourceDetail شناسه ویدیوی آن ویدیو را مشخص می‌کند.
  • SHORTS - بیننده با کشیدن عمودی انگشت از ویدیوی قبلی در تجربه تماشای شورتس، به آن ارجاع داده شد.
  • SOUND_PAGE – بازدیدها از صفحات محوری صدای Shorts سرچشمه می‌گیرند.
  • SUBSCRIBER - بازدیدهای ویدیو از فیدهای صفحه اصلی یوتیوب یا از ویژگی‌های اشتراک یوتیوب ارجاع داده شده‌اند. اگر بر اساس این منبع ترافیک فیلتر کنید، فیلد insightTrafficSourceDetail موارد فید صفحه اصلی یا صفحه دیگری را که بازدیدها از آن ارجاع داده شده‌اند، مشخص می‌کند.
  • YT_CHANNEL – تعداد بازدیدهای ویدیو در صفحه یک کانال. اگر بر اساس این منبع ترافیک فیلتر کنید، فیلد insightTrafficSourceDetail شناسه کانال را برای آن کانال مشخص می‌کند.
  • YT_OTHER_PAGE – بازدیدهای ویدیو از لینکی غیر از نتیجه جستجو یا لینک ویدیوی مرتبط که در صفحه یوتیوب ظاهر شده است، ارجاع داده شده‌اند. اگر بر اساس این منبع ترافیک فیلتر کنید، فیلد insightTrafficSourceDetail صفحه را شناسایی می‌کند.
  • YT_SEARCH – بازدیدهای ویدیو از نتایج جستجوی یوتیوب ارجاع داده شده‌اند. اگر بر اساس این منبع ترافیک فیلتر کنید، فیلد insightTrafficSourceDetail عبارت جستجو را مشخص می‌کند.
  • VIDEO_REMIXES – بازدیدهای ویدیو از لینک ویدیوی ریمیکس شده در پخش‌کننده‌ی Shorts ارجاع داده شده‌اند. اگر بر اساس این منبع ترافیک فیلتر کنید، فیلد insightTrafficSourceDetail ویدیویی را که بیننده از آن ارجاع داده شده است، مشخص می‌کند.
insightTrafficSourceDetail
داده‌های موجود در گزارش بر اساس ارجاع‌دهندگانی که بیشترین بازدید را برای یک ویدیوی مشخص و یک نوع منبع ترافیک مشخص ایجاد کرده‌اند، جمع‌آوری می‌شوند. لیست زیر منابع ترافیکی را که این گزارش برای آنها در دسترس است، مشخص می‌کند. برای هر منبع ترافیک، این لیست اطلاعاتی را که بُعد insightTrafficSourceDetail ارائه می‌دهد، مشخص می‌کند.
  • ADVERTISING - نوع تبلیغاتی که منجر به بازدیدها شده است. مقادیر ممکن عبارتند از:
    • تبلیغ تعاملی کلیکی برای پخش
    • تبلیغ نامزدی
    • تبلیغات جستجوی گوگل
    • تبلیغ ویدیویی صفحه اصلی
    • قابل رد شدن در جریان رزرو شده
    • TrueView در جستجو و نمایش
    • TrueView در حال پخش
    • تبلیغات یوتیوب بدون دسته‌بندی
    • دیوار ویدیویی
  • CAMPAIGN_CARD - ویدیوی ادعایی که بینندگان را به ویدیوی شناسایی شده در گزارش هدایت کرد.
  • END_SCREEN - ویدیویی که بینندگان را به ویدیوی مشخص شده در گزارش هدایت کرده است.
  • EXT_URL – وب‌سایتی که بینندگان را به ویدیو ارجاع داده است.
  • HASHTAGS - هشتگی که منجر به بازدیدها شده است.
  • NOTIFICATION – ایمیل یا اعلانی که ترافیک را ارجاع داده است.
  • RELATED_VIDEO - ویدیوی مرتبطی که بینندگان را به ویدیوی پوشش داده شده در گزارش هدایت کرد.
  • SOUND_PAGE – ویدیویی که منجر به بازدید شده است.
  • SUBSCRIBER - مورد فید صفحه اصلی یا ویژگی اشتراک یوتیوب که بینندگان را به ویدیوی پوشش داده شده در گزارش هدایت کرده است. مقادیر معتبر عبارتند از:
    • activity - بازدید از موارد موجود در فیدهای اشتراک صفحه اصلی که ناشی از فعالیت کانال‌های غیر آپلود و غیر اجتماعی است، از جمله لایک‌ها، موارد دلخواه، پست‌های بولتن و افزودن به لیست پخش.
    • blogged - بازدید از موارد موجود در فیدهای اشتراک صفحه اصلی که از لینک‌های وبلاگ‌های برتر حاصل شده‌اند.
    • mychannel - تعداد بازدیدها از موارد موجود در فیدهای دیگر که در صفحه اصلی فهرست شده‌اند، مانند «لایک‌ها»، «سابقه تماشا» و «تماشای بعدی».
    • podcasts – بازدیدهایی که از موارد موجود در صفحه مقصد پادکست‌ها سرچشمه می‌گیرند.
    • sdig – بازدیدهای ناشی از ایمیل‌های به‌روزرسانی اشتراک.
    • uploaded – تعداد بازدید از موارد uploaded در فیدهای اشتراک صفحه اصلی.
    • / – سایر بازدیدها از صفحه اصلی یوتیوب.
    • /my_subscriptions – بازدیدهایی که از صفحات اشتراک‌های من کاربران در یوتیوب سرچشمه می‌گیرند.
  • YT_CHANNEL – صفحه کانالی که بینندگان ویدیو را در آن تماشا کرده‌اند.
  • YT_OTHER_PAGE – صفحه یوتیوبی که بینندگان از طریق آن به ویدیو ارجاع داده شده‌اند.
  • 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 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)
این بُعد، سرویسی را که برای اشتراک‌گذاری ویدیوها استفاده شده است، مشخص می‌کند. ویدیوها را می‌توان با استفاده از دکمه‌ی «اشتراک‌گذاری» در یوتیوب (یا از طریق پخش‌کننده‌ی یوتیوب) به اشتراک گذاشت. 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
سلام5 HI5
پیامک اچ‌تی‌سی 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 (Одноклассники) 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 نشان می‌دهد که داده‌های گزارش مربوطه، داده‌های ماندگاری را پس از سپری شدن ۴۰ درصد از ویدیو نشان می‌دهند.

این API برای هر ویدیو ۱۰۰ نقطه داده با مقادیر نسبت از 0.01 تا 1.0 برمی‌گرداند. زمان‌هایی که داده‌ها در طول پخش ویدیو اندازه‌گیری می‌شوند، برای هر ویدیو به طور مساوی فاصله دارند. این بدان معناست که برای یک ویدیوی دو دقیقه‌ای، فاصله بین نقاط داده ۱.۲ ثانیه است. با این حال، برای یک ویدیوی دو ساعته، فاصله بین نقاط داده ۷۲ ثانیه است. مقدار بُعد، انتهای انحصاری فاصله را نشان می‌دهد.
audienceType (filter only)
مقدار بُعد، نوع ترافیک مرتبط با داده‌های گزارش را مشخص می‌کند. مقادیر پشتیبانی‌شده عبارتند از ORGANIC ، AD_INSTREAM و AD_INDISPLAY . برای توضیحات مربوط به این نوع منابع ترافیک، به مرکز راهنمای YouTube مراجعه کنید.

توجه داشته باشید که داده‌های مربوط به فیلتر audienceType از تاریخ ۲۵ سپتامبر ۲۰۱۳ در دسترس هستند. این API داده‌های مربوط به کوئری‌هایی که از این فیلتر برای بازیابی داده‌ها از تاریخ‌های قبل‌تر استفاده می‌کنند را برنمی‌گرداند. کوئری‌هایی که از این فیلتر استفاده نمی‌کنند، برای هر تاریخی پس از ۱ جولای ۲۰۰۸ کار می‌کنند.

مثال‌ها

درخواست‌های نمونه زیر از ابعاد حفظ مخاطب استفاده می‌کنند:

  • نمونه‌های کانال

  • نمونه‌هایی از مالک محتوا

پخش زنده

livestreamPosition
این بُعد، یک دقیقه خاص را در طول پخش زنده ویدیو مشخص می‌کند. معیارهای گزارش نشان می‌دهد که در آن زمان چند کاربر در حال تماشای پخش زنده بوده‌اند.

لغو عضویت

membershipsCancellationSurveyReason
تعداد نظرسنجی‌های تکمیل‌شده توسط کاربران یوتیوب که عضویت خود را در کانال مشخص‌شده در طول دوره گزارش لغو کرده‌اند. جدول زیر مقادیر معتبر ابعاد را فهرست می‌کند:
مقدار API توضیح
UNKNOWN کاربر نظرسنجی را تکمیل نکرد.
DISLIKE_PERKS کاربر از مزایای عضویت خوشش نیامد.
PERKS_NOT_DELIVERED کاربر گفت که مزایای عضویت وعده داده شده ارائه نشده است.
CANNOT_ACCESS_PERKS کاربر نتوانست به مزایا دسترسی پیدا کند.
NO_LONGER_INTERESTED کاربر دیگر علاقه‌ای به عضویت در کانال ندارد.
FEEL_UNAPPRECIATED کاربر به عنوان عضوی از کانال احساس می‌کرد که مورد قدردانی قرار نگرفته است.
FINANCIAL_REASONS کاربر به دلایل مالی لغو کرد.
JOIN_LIMITED_TIME کاربر فقط قصد داشت برای مدت محدودی عضو شود.
OTHER کاربر دلیل دیگری برای لغو داشت.

عملکرد تبلیغات

adType
بُعد adType در گزارش‌های عملکرد تبلیغات استفاده می‌شود و معیارهای درخواستی را بر اساس انواع تبلیغاتی که در طول پخش ویدیو اجرا می‌شوند، جمع‌آوری می‌کند. لیست زیر مقادیر بُعد ممکن را توضیح می‌دهد. برای اطلاعات بیشتر در مورد قالب‌های تبلیغات یوتیوب، به مرکز راهنمای یوتیوب مراجعه کنید.

  • auctionBumperInstream – تبلیغات ویدیویی غیرقابل رد کردن، که از طریق حراج قرار می‌گیرند، تا ۶ ثانیه طول دارند و قبل از مشاهده ویدیو باید تماشا شوند.

  • auctionDisplay – یک تبلیغ غنی رسانه‌ای یا تصویری که یا به صورت یک لایه رویی در پایین پخش‌کننده ویدیو، یا به صورت یک واحد تبلیغاتی ۳۰۰x۲۵۰ در صفحه تماشای ویدیو، یا به صورت ترکیبی از هر دو ظاهر می‌شود. وقتی لایه رویی اجرا می‌شود، پس از مدت زمان مشخصی به طور خودکار بسته می‌شود و کاربر می‌تواند لایه رویی را نیز ببندد. اگر یک لایه رویی و یک بنر با هم نمایش داده شوند، هر تبلیغ به عنوان یک نمایش جداگانه محاسبه می‌شود.

  • auctionInstream – تبلیغات ویدیویی غیرقابل رد شدن که قبل، حین یا بعد از ویدیوی اصلی اجرا می‌شوند.

  • auctionTrueviewInslate – بیننده یکی از چندین تبلیغ ویدیویی را از بین گزینه‌های نمایش داده شده قبل از یک ویدیو انتخاب می‌کند. See the TrueView documentation for more information.

  • auctionTrueviewInstream – تبلیغات ویدیویی قابل رد شدن که قبل یا در حین ویدیوی اصلی اجرا می‌شوند. برای اطلاعات بیشتر به مستندات TrueView مراجعه کنید.

  • auctionUnknown – تبلیغی که از طریق مزایده‌ی ادوردز خریداری شده اما در هیچ یک از انواع دیگر تبلیغات طبقه‌بندی نشده است.

  • reservedBumperInstream – تبلیغات ویدیویی غیرقابل رد کردن، که به صورت رزرو شده فروخته می‌شوند، تا ۶ ثانیه که قبل از مشاهده ویدیو باید تماشا شوند.

  • reservedClickToPlay – یک تبلیغ ویدیویی که کاربر برای شروع پخش باید روی آن کلیک کند. هر زمان که واحد تبلیغ click-to-play نمایش داده شود، صرف نظر از اینکه کاربر پخش را شروع کند یا خیر، یک نمایش تبلیغ ثبت می‌شود. این تبلیغات به صورت رزرو شده فروخته می‌شوند.

  • reservedDisplay – یک تبلیغ غنی رسانه‌ای یا تصویری که یا به صورت یک لایه رویی در پایین پخش‌کننده ویدیو، یا به صورت یک واحد تبلیغاتی ۳۰۰x۲۵۰ در صفحه تماشای ویدیو، یا به صورت ترکیبی از هر دو ظاهر می‌شود. وقتی لایه رویی اجرا می‌شود، پس از مدت زمان مشخصی به طور خودکار بسته می‌شود و کاربر می‌تواند لایه رویی را نیز ببندد. اگر یک لایه رویی و یک بنر با هم نمایش داده شوند، هر تبلیغ به عنوان یک نمایش جداگانه محاسبه می‌شود.

  • reservedInstream – تبلیغات ویدیویی غیرقابل رد شدن که قبل، حین یا بعد از ویدیوی اصلی درج می‌شوند.

  • reservedInstreamSelect

  • reservedMasthead – یک تبلیغ بزرگ که می‌تواند شامل ویدیو و عناصر گرافیکی باشد و در صفحه اصلی ظاهر می‌شود.

  • 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.