Dimensions

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

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

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

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

ابعاد هسته

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

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

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

فیلترها

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

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

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

ابعاد

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

منابع

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

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

video (core dimension)
شناسه یک ویدیوی YouTube. در YouTube Data API، این مقدار ویژگی id یک منبع video است. This is a core dimension and is subject to the Deprecation Policy .
playlist
شناسه یک لیست پخش YouTube. در YouTube Data API، این مقدار ویژگی id منبع playlist است.
channel (core dimension) (only used in content owner reports)
شناسه یک کانال YouTube. در YouTube Data 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 مورد برتر - پربیننده ترین ویدیوها برای صاحب محتوا
      • 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
شناسه 3 رقمی که Nielsen برای شناسایی منطقه بازار تعیین شده (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 فیلم برتر - پربازدیدترین ویدیوها در یک کشور خاص
      • 10 فیلم برتر - پربازدیدترین ویدیو در اروپا
  • نمونه های صاحب محتوا

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

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

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

مهم: همه تاریخ‌ها مربوط به دوره زمانی است که از ساعت 12:00 صبح به وقت اقیانوس آرام (UTC-7 یا UTC-8) شروع می‌شود و در روز، ماه و سال مشخص شده در ساعت 11:59 به وقت اقیانوس آرام پایان می‌یابد. در نتیجه، تاریخ‌هایی که ساعت‌ها برای ساعت تابستانی به جلو تنظیم می‌شوند، یک دوره 23 ساعته را نشان می‌دهند و تاریخ‌هایی که ساعت‌ها به عقب تنظیم می‌شوند، نشان‌دهنده یک دوره 25 ساعته هستند.

بعد ماه به دوره زمانی اشاره دارد که از ساعت 12:00 صبح به وقت اقیانوس آرام (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 - داده ها نماهایی را توصیف می کنند که در صفحه اصلی یا صفحه اصلی YouTube، در فید اشتراک کاربر، یا در یکی دیگر از ویژگی های مرور YouTube رخ داده است.

  • CHANNEL - داده ها بازدیدهایی را که در صفحه کانال رخ داده اند را توصیف می کند.

  • EMBEDDED - داده ها بازدیدهایی را توصیف می کنند که در وب سایت یا برنامه دیگری که در آن ویدیو با استفاده از جاسازی <iframe> یا <object> جاسازی شده است، رخ داده است.

  • EXTERNAL_APP - داده ها نماهایی را توصیف می کنند که در یک برنامه شخص ثالث رخ داده است که در آن ویدیو با استفاده از روشی غیر از جاسازی <iframe> یا <object> پخش شده است. برای مثال، بازپخش در برنامه‌هایی که از YouTube Android Player API استفاده می‌کنند، با استفاده از این مقدار طبقه‌بندی می‌شوند.

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

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

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

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

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

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

نمونه ها

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

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

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

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

جزئیات پخش

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

جدول زیر مقادیر ابعاد را فهرست می کند:
ارزش ها
LIVE_STREAM محتوای مشاهده شده پخش زنده YouTube بود.
SHORTS محتوای مشاهده شده یک YouTube Short بود.
STORY محتوای مشاهده شده یک داستان YouTube بود.
VIDEO_ON_DEMAND محتوای مشاهده شده یک ویدیوی YouTube بود که تحت یکی از مقادیر ابعاد دیگر قرار نمی گیرد.
UNSPECIFIED نوع محتوای محتوای مشاهده شده ناشناخته است.
liveOrOnDemand
این بعد نشان می دهد که آیا معیارهای فعالیت کاربر در ردیف داده با بازدیدهای پخش زنده مرتبط است یا خیر. داده‌های این بعد برای تاریخ‌هایی که از 1 آوریل 2014 شروع می‌شوند در دسترس است.

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

توجه داشته باشید که مقدار بعد از زمانی که فعالیت کاربر رخ می دهد دقیق است. به عنوان مثال، فرض کنید کاربری مشترک کانالی نشده است و یکی از ویدیوهای آن کانال را تماشا می کند، سپس در کانال مشترک شده و ویدیوی دیگری را در همان روز تماشا می کند. گزارش کانال نشان می دهد که یک بازدید دارای مقدار subscribedStatus SUBSCRIBED و یک بازدید دارای مقدار subscribedStatus UNSUBSCRIBED است.
youtubeProduct
این بعد سرویس YouTube را که فعالیت کاربر در آن انجام شده است مشخص می کند. داده‌های این بعد از 18 جولای 2015 در دسترس است.

جدول زیر مقادیر ابعاد را فهرست می کند:
ارزش ها
CORE فعالیت کاربری که در یکی از برنامه‌های ویژه YouTube (بازی‌های YouTube، YouTube Kids یا YouTube Music) رخ نداده است. استثنا: فعالیت کاربر که قبل از ۱ مارس ۲۰۲۱ در YouTube Music رخ داده است، در CORE گنجانده شده است.
GAMING فعالیت کاربر در بازی YouTube رخ داده است.
KIDS فعالیت کاربر در YouTube Kids انجام شد.
MUSIC فعالیت کاربر در YouTube Music در تاریخ 1 مارس 2021 یا پس از آن انجام شده است. داده‌های قبل از 1 مارس 2021 در CORE گنجانده شده است. داده های زمان واقعی ثبت نمی شود.
UNKNOWN فعالیت کاربر قبل از 18 جولای 2015 رخ داده است.

منابع ترافیک

insightTrafficSourceType
داده‌های موجود در گزارش بر اساس نوع ارجاع‌دهنده جمع‌آوری می‌شوند که نحوه دسترسی کاربران به ویدیو را توضیح می‌دهد. مقادیر ممکن برای این بعد عبارتند از:
  • ADVERTISING - بیننده توسط یک تبلیغ به ویدیو ارجاع داده شد. اگر بر اساس این منبع ترافیک فیلتر کنید، قسمت insightTrafficSourceDetail نوع تبلیغ را مشخص می کند.
  • ANNOTATION - بینندگان با کلیک بر روی حاشیه نویسی در ویدیوی دیگر به ویدیو رسیدند.
  • CAMPAIGN_CARD - بازدیدها از ویدیوهای ادعا شده و بارگذاری شده توسط کاربر که مالک محتوا برای تبلیغ محتوای مشاهده شده استفاده کرده است، نشات می گیرد. این منبع ترافیک فقط برای گزارش های مالک محتوا پشتیبانی می شود.
  • END_SCREEN - بازدیدها از صفحه پایانی یک ویدیو دیگر ارجاع داده شدند.
  • EXT_URL - بازدیدهای ویدیو از پیوندی در وب سایت دیگری ارجاع شده است. اگر بر اساس این منبع ترافیک فیلتر کنید، قسمت insightTrafficSourceDetail صفحه وب را مشخص می کند. این منبع ترافیک شامل ارجاعات از نتایج جستجوی Google است.
  • HASHTAGS - بازدیدها از صفحات هشتگ VOD یا صفحات محوری هشتگ Shorts نشات گرفته اند.
  • LIVE_REDIRECT - بازدیدهای ویدیو از تغییر مسیرهای زنده ارجاع شده است.
  • NO_LINK_EMBEDDED - این ویدیو هنگام مشاهده در وب سایت دیگری جاسازی شده است.
  • NO_LINK_OTHER - YouTube ارجاعی برای ترافیک شناسایی نکرد. این دسته شامل ترافیک مستقیم به یک ویدیو و همچنین ترافیک برنامه های تلفن همراه است.
  • NOTIFICATION - بازدیدهای ویدیو از طریق ایمیل یا اعلان از YouTube ارجاع شده است.
  • PLAYLIST - بازدیدهای ویدیو در حالی اتفاق می‌افتند که ویدیو به عنوان بخشی از فهرست پخش پخش می‌شد. این شامل ترافیکی است که از صفحه لیست پخش می آید.
  • PRODUCT_PAGE - بازدیدهای ویدیو از یک صفحه محصول ارجاع شده است.
  • PROMOTED - بازدیدهای ویدیو از یک تبلیغ بدون پرداخت YouTube، مانند صفحه YouTube "Spotlight Videos" ارجاع شده است.
  • RELATED_VIDEO - بازدیدهای ویدیو از یک فهرست ویدیوی مرتبط در صفحه تماشای ویدیوی دیگر ارجاع شده است. اگر بر اساس این منبع ترافیک فیلتر کنید، فیلد insightTrafficSourceDetail شناسه ویدیو را برای آن ویدیو مشخص می کند.
  • SHORTS - بیننده با کشیدن انگشت به صورت عمودی از ویدیوی قبلی در تجربه مشاهده 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 در جستجو و در نمایش
    • TrueView در جریان
    • تبلیغات یوتیوب دسته بندی نشده
    • دیوار تصویری
  • CAMPAIGN_CARD - ویدیوی ادعا شده که بینندگان را به ویدیوی مشخص شده در گزارش هدایت کرد.
  • END_SCREEN - ویدیویی که بینندگان را به ویدیوی مشخص شده در گزارش هدایت می‌کند.
  • EXT_URL – وب سایتی که بینندگان را به ویدیو ارجاع می دهد.
  • HASHTAGS – هشتگی که منجر به بازدید شد.
  • NOTIFICATION - ایمیل یا اعلانی که ترافیک را ارجاع می دهد.
  • RELATED_VIDEO - ویدیوی مرتبطی که بینندگان را به ویدیوی تحت پوشش گزارش هدایت کرد.
  • SOUND_PAGE - ویدیویی که منجر به بازدید شد.
  • SUBSCRIBER - مورد فید صفحه اصلی یا ویژگی اشتراک YouTube که بینندگان را به ویدیوی تحت پوشش گزارش هدایت می کند. مقادیر معتبر عبارتند از:
    • activity – بازدید از موارد موجود در فیدهای اشتراک صفحه اصلی که ناشی از فعالیت کانال غیرآپلودی و غیراجتماعی، از جمله لایک‌ها، موارد دلخواه، پست‌های بولتن، و افزوده‌های فهرست پخش است.
    • blogged - بازدید از موارد موجود در فیدهای اشتراک صفحه اصلی که از پیوندهای وبلاگ های برتر حاصل شده است.
    • mychannel – بازدید از موارد موجود در سایر فیدهای فهرست شده در صفحه اصلی، مانند «پسندیدن»، «سابقه تماشا» و «تماشا در فرصتی دیگر».
    • podcasts - بازدیدهایی که از موارد موجود در صفحه مقصد پادکست نشات می‌گیرند.
    • sdig - نماهایی که از ایمیل های به روز رسانی اشتراک نشات می گیرند.
    • uploaded – بازدید از موارد uploaded در فیدهای اشتراک صفحه اصلی.
    • / – بازدیدهای دیگر از صفحه اصلی YouTube.
    • /my_subscriptions – بازدیدهایی که از صفحات اشتراک‌های من کاربران در YouTube نشات می‌گیرند.
  • YT_CHANNEL - صفحه کانالی که بینندگان ویدیو را تماشا کردند.
  • YT_OTHER_PAGE - صفحه YouTube که بینندگان از آن به ویدیو ارجاع داده شدند.
  • YT_SEARCH - عبارت جستجویی که بینندگان را به ویدیو هدایت می کند.
  • VIDEO_REMIXES – ویدیویی که منجر به بازدید شد.

نمونه ها

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

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

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

    • منبع ترافیک
      • تعداد بازدید و زمان تماشا از منابع مختلف ترافیک
      • تعداد مشاهده روزانه و زمان تماشا از منابع مختلف ترافیک
      • 10 مورد برتر - عبارات جستجوی YouTube که بیشترین ترافیک را برای یک ویدیو ایجاد می کنند
      • 10 مورد برتر – عبارات جستجوی گوگل که بیشترین ترافیک را برای یک ویدیو ایجاد می کنند
      • تعداد مشاهده لیست پخش و زمان تماشا از منابع مختلف ترافیک در یک کشور
      • تعداد مشاهده لیست پخش روزانه و زمان تماشا از منابع مختلف ترافیک

دستگاه ها

deviceType
این بعد فاکتور شکل فیزیکی دستگاهی را که نما روی آن رخ داده است مشخص می کند. لیست زیر انواع دستگاه هایی را که API داده ها را برای آنها برمی گرداند، مشخص می کند. همچنین می توانید از بعد deviceType به عنوان یک فیلتر برای محدود کردن گزارش سیستم عامل به گونه ای استفاده کنید که فقط حاوی داده های نوع خاصی از دستگاه باشد.
  • DESKTOP
  • GAME_CONSOLE
  • MOBILE
  • TABLET
  • TV
  • 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

نمونه ها

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

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

    • دستگاه / سیستم عامل
      • معیارهای روزانه نوع دستگاه برای سیستم عامل اندروید
      • معیارهای سیستم عامل روزانه برای دستگاه های تلفن همراه
      • سیستم عامل روزانه و معیارهای نوع دستگاه
      • معیارهای روزانه نوع دستگاه برای مشاهده لیست پخش در سیستم عامل Android
      • معیارهای سیستم عامل روزانه برای نمایش لیست پخش در دستگاه های تلفن همراه
  • نمونه های صاحب محتوا

    • دستگاه / سیستم عامل
      • معیارهای روزانه نوع دستگاه برای ویدیوهای ادعا شده
      • معیارهای سیستم عامل روزانه برای ویدیوهای ادعا شده مشاهده شده در دستگاه های تلفن همراه
      • سیستم عامل روزانه و معیارهای نوع دستگاه
      • معیارهای روزانه نوع دستگاه برای نمایش لیست پخش در سیستم عامل Android
      • معیارهای سیستم عامل روزانه برای نمایش لیست پخش در دستگاه های تلفن همراه

جمعیت شناسی

ابعاد جمعیتی به شما کمک می کند تا محدوده سنی و توزیع جنسیتی مخاطبان خود را درک کنید. مرکز راهنمایی 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 CYWORLD
دیگ DIGG
دراپ باکس DROPBOX
جاسازی کنید EMBED
ایمیل MAIL
فیس بوک FACEBOOK
فیس بوک مسنجر FACEBOOK_MESSENGER
صفحات فیس بوک FACEBOOK_PAGES
فتکا FOTKA
جیمیل GMAIL
خوب GOO
+Google GOOGLEPLUS
برو اس ام اس GO_SMS
GroupMe GROUPME
Hangouts HANGOUTS
سلام5 HI5
پیامک HTC HTC_MMS
صندوق ورودی گوگل INBOX
گفتگوی فعالیت سیستم iOS IOS_SYSTEM_ACTIVITY_DIALOG
داستان کاکائو KAKAO_STORY
کاکائو (گفتگوی کاکائو) KAKAO
کیک KIK
ایمیل LGE LGE_EMAIL
خط LINE
لینکدین LINKEDIN
LiveJournal LIVEJOURNAL
منیم MENEAME
میکسی MIXI
پیام رسان موتورولا MOTOROLA_MESSAGING
مای اسپیس MYSPACE
ناور NAVER
اشتراک گذاری نزدیک NEARBY_SHARE
نوجیج NUJIJ
Odnoklassniki (Одноклассники) ODNOKLASSNIKI
دیگر OTHER
پینترست PINTEREST
راکوتن (楽天市場) RAKUTEN
reddit REDDIT
اسکایپ SKYPE
اسکای راک SKYBLOG
مکالمات سونی SONY_CONVERSATIONS
StumbleUpon STUMBLEUPON
تلگرام TELEGRAM
پیامک TEXT_MESSAGE
تونتی TUENTI
وبلاگ Tumblr TUMBLR
توییتر TWITTER
ناشناس UNKNOWN
پیام های Verizon VERIZON_MMS
وایبر VIBER
VKontakte (ВКонтакте) VKONTAKTE
وی چت WECHAT
Weibo WEIBO
واتس اپ WHATS_APP
وایکوپ WYKOP
یاهو ژاپن YAHOO
بازی YouTube YOUTUBE_GAMING
YouTube Kids YOUTUBE_KIDS
YouTube Music YOUTUBE_MUSIC
YouTube TV YOUTUBE_TV

برای اطلاعات بیشتر به اسناد راهنما مراجعه کنید.

نمونه ها

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

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

    • اجتماعی : معیارهای اشتراک گذاری، جمع آوری شده بر اساس سرویسی که ویدیوها در آن به اشتراک گذاشته شده است
  • نمونه های صاحب محتوا

    • اجتماعی : معیارهای اشتراک گذاری، جمع آوری شده بر اساس سرویسی که ویدیوها در آن به اشتراک گذاشته شده است

حفظ مخاطب

elapsedVideoTimeRatio
این بعد نسبت قسمت سپری شده از ویدیو را به طول ویدیو مشخص می کند. ابعاد و معیارهای حفظ برای اندازه گیری میزان حفظ مخاطب در طول زمان استفاده می شود و elapsedVideoTimeRatio VideoTimeRatio اندازه گیری زمان است. برای مثال، مقدار 0.4 نشان می‌دهد که داده‌های گزارش مربوطه، داده‌های نگهداری را پس از سپری شدن 40 درصد از ویدیو نشان می‌دهد.

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

توجه داشته باشید که داده‌های فیلتر audienceType از 25 سپتامبر 2013 در دسترس است. API داده‌هایی را برای جستارهایی که از فیلتر برای بازیابی داده‌های تاریخ‌های قبلی استفاده می‌کنند، برنمی‌گرداند. جستارهایی که از فیلتر استفاده نمی کنند برای هیچ تاریخی بعد از 1 ژوئیه 2008 کار می کنند.

نمونه ها

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

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

  • نمونه های صاحب محتوا

پخش زنده

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 – تبلیغات ویدیویی غیرقابل رد شدن، از طریق مزایده، حداکثر تا 6 ثانیه که باید قبل از مشاهده یک ویدیو تماشا شوند.

  • auctionDisplay - یک تبلیغ رسانه ای یا تصویری غنی که یا به عنوان یک پوشش در پایین پخش کننده ویدیو، به عنوان یک واحد تبلیغاتی 300x250 در صفحه تماشای ویدیو، یا به صورت ترکیبی از هر دو ظاهر می شود. هنگامی که روکش اجرا می شود، پس از نمایش برای مدت زمان مشخصی به طور خودکار بسته می شود و کاربر می تواند روکش را نیز ببندد. اگر یک همپوشانی و یک بنر با هم نشان داده شوند، هر تبلیغ به عنوان یک نمایش جداگانه حساب می شود.

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

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

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

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

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

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

  • reservedDisplay – یک تبلیغ رسانه ای یا تصویری غنی که یا به عنوان یک پوشش در پایین پخش کننده ویدیو، به عنوان یک واحد تبلیغ 300x250 در صفحه تماشای ویدیو، یا به صورت ترکیبی از هر دو ظاهر می شود. هنگامی که روکش اجرا می شود، پس از نمایش برای مدت زمان مشخصی به طور خودکار بسته می شود و کاربر می تواند روکش را نیز ببندد. اگر یک همپوشانی و یک بنر با هم نشان داده شوند، هر تبلیغ به عنوان یک نمایش جداگانه حساب می شود.

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

  • reservedInstreamSelect

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

  • reservedUnknown – آگهی‌ای که به‌صورت رزروی فروخته شده است و نمی‌توان آن را در یکی از انواع آگهی‌های دیگر طبقه‌بندی کرد.

  • unknown - YouTube نمی تواند این نوع تبلیغات را طبقه بندی کند.

نمونه ها

گزارش های نمونه زیر عملکرد AD یا معیارهای درآمد را بازیابی می کند:

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

    • درآمد/تبلیغات
      • درآمد کانال و معیارهای عملکرد AD
      • درآمد روزانه و معیارهای عملکرد AD
      • معیارهای مربوط به درآمد و عملکرد تبلیغاتی کشور
      • 10 - فیلم های برتر با بالاترین درآمد
      • معیارهای عملکرد تبلیغاتی برای انواع مختلف تبلیغات
  • نمونه های صاحب محتوا

    • درآمد/تبلیغات
      • معیارهای درآمد و عملکرد AD برای محتوای ادعا شده
      • درآمد روزانه و معیارهای عملکرد AD
      • معیارهای مربوط به درآمد و عملکرد تبلیغاتی کشور
      • 10 - فیلم های برتر با بالاترین درآمد
      • معیارهای عملکرد تبلیغاتی برای انواع مختلف تبلیغات

لیست های پخش

isCurated (filter only)
این فیلتر نشان می دهد که درخواست در حال بازیابی داده ها در مورد نماهای ویدیویی است که در زمینه لیست پخش رخ داده است.

نمونه ها

تمام درخواست های نمونه که گزارش های لیست پخش را بازیابی می کنند ، از فیلتر isCurated استفاده می کنند.

ابعاد صاحب محتوا

ابعاد زیر فقط برای گزارش های صاحب محتوا پشتیبانی می شود.

مهم: درخواست API برای بازیابی گزارش های صاحب محتوا باید داده ها را با استفاده از یکی از ابعاد زیر فیلتر کند:
  • video
  • channel
  • ترکیبی پشتیبانی شده از ابعاد claimedStatus و uploaderType همانطور که در زیر تعریف شده است.
claimedStatus (only used in content owner reports)
این بعد به شما امکان می دهد نشان دهید که پاسخ API فقط باید دارای معیارهایی برای محتوای ادعا شده باشد. تنها مقدار معتبر برای این بعد claimed می شود. اگر پارامتر filters پرس و جو را به claimedStatus==claimed ، API فقط داده ها را برای محتوای ادعا شده بازیابی می کند. جدول تعریف ابعاد uploaderType جزئیات بیشتری در مورد نحوه استفاده از این بعد ارائه می دهد.
uploaderType (core dimension) (only used in content owner reports)
این ابعاد به شما امکان می دهد که آیا پاسخ API باید حاوی معیارهایی برای محتوای بارگذاری شده توسط صاحب محتوای مشخص شده و/یا محتوای بارگذاری شده توسط اشخاص ثالث ، مانند فیلم های بارگیری شده توسط کاربر باشد. مقادیر معتبر self و thirdParty هستند. این یک بعد اصلی است و منوط به سیاست استهلاک است.

در جدول زیر ترکیبات پشتیبانی شده برای ابعاد claimedStatus و uploaderType ، که هر دو در پارامتر filters استفاده می شوند ، نشان می دهد:

ارزش claimedStatus مقدار uploaderType توضیحات
[تنظیم نشده] self داده های تجزیه و تحلیل YouTube را برای محتوای ادعا شده و ناشناخته بارگذاری شده توسط صاحب محتوا بازیابی می کند.
claimed [تنظیم نشده] داده ها را برای محتوای ادعا شده بارگذاری شده توسط صاحب محتوا یا شخص ثالث بازیابی می کند.
claimedself داده ها را برای محتوای ادعا شده بارگذاری شده توسط صاحب محتوا بازیابی می کند.
claimedthirdParty داده ها را برای محتوای ادعا شده بارگذاری شده توسط شخص ثالث بازیابی می کند.

نمونه ها

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