Dimensions

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

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

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

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

ابعاد اصلی

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

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

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

فیلترها

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

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

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

ابعاد

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

منابع

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

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

ویدیو (بُعد اصلی)
شناسه ویدیو YouTube. در YouTube Data API، این مقدار ویژگی id منبع video است. This is a core dimension and is subject to the Deprecation Policy.
فهرست پخش
شناسه فهرست پخش YouTube. در YouTube Data API، این مقدار ویژگی id منبع playlist است.
کانال (بُعد اصلی) (فقط در گزارش‌های مالک محتوا استفاده می‌شود)
شناسه کانال YouTube. در YouTube Data API، این مقدار ویژگی id منبع channel است. This is a core dimension and is subject to the Deprecation Policy.

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

مثال‌ها

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

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

    • آمار پایه
      • ۱۰ ویدیو برتر – پربازدیدترین ویدیوهای یک کانال
      • ۱۰ مورد برتر – نرخ کلیک‌گذری یادداشت برای پربازدیدترین ویدیوهای کانال
      • آمار مربوط به یک فهرست پخش خاص
      • ۱۰ فهرست پخش برتر – فهرست‌های پخش پربازدید برای یک کانال
    • جغرافیایی
      • ۱۰ ویدیو برتر – پربازدیدترین ویدیوها در یک کشور خاص
      • ۱۰ ویدیو برتر – پربازدیدترین ویدیوها در اروپا

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

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

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

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

کشور (بُعد اصلی)
کشور مرتبط با سنجه‌ها در ردیف گزارش. مقدار بُعد یک کد کشور دوحرفی ISO-3166-1 است، مانند US، CN (چین)، یا FR (فرانسه). کد کشور ZZ برای گزارش سنجه‌هایی استفاده می‌شود که YouTube نتوانسته است کشور مرتبط با آن‌ها را شناسایی کند. This is a core dimension and is subject to the Deprecation Policy.
استان
ایالت یا قلمرو ایالات متحده مرتبط با سنجه‌ها در ردیف گزارش. مقدار بُعد یک کد ISO 3166-2 است که ایالت ایالات متحده یا ناحیه کلمبیا را شناسایی می‌کند، مانند US-MI (میشیگان) یا US-TX (تگزاس). کد استان US-ZZ برای گزارش سنجه‌هایی استفاده می‌شود که YouTube نتوانسته است ایالت مربوطه در ایالات متحده را برای آن‌ها شناسایی کند. وقتی درخواست API شامل province در مقدار پارامتر dimensions باشد، درخواست باید با گنجاندن country==US در مقدار پارامتر filters، داده‌ها را به ایالات متحده محدود کند.

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

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

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

مثال‌ها

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

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

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

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

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

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

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

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

بُعد ماه به دوره زمانی‌ای اشاره دارد که از ساعت ۱۲:۰۰ بامداد به‌وقت اقیانوس آرام (UTC-7 یا UTC-8) در اولین روز ماه و سال مشخص‌شده شروع می‌شود.

روز (بُعد اصلی)
وقتی از این بُعد استفاده می‌کنید، داده‌های گزارش به‌صورت روزانه جمع‌آوری می‌شود و هر ردیف حاوی داده‌های یک روز است. می‌توانید از ابعاد دیگر برای تفکیک بیشتر داده‌ها استفاده کنید. برای مثال، گزارش منبع ترافیک می‌تواند آمار بازدید روزانه را براساس روشی که کاربران به ویدیوهای شما می‌رسند، جمع‌آوری کند. This is a core dimension and is subject to the Deprecation Policy.
ماه (بُعد اصلی)
داده‌های موجود در گزارش براساس ماه تقویمی جمع‌آوری شده است. همانند گزارش‌های روزانه، می‌توانید از فیلترهای دیگر برای بخش‌بندی بیشتر داده‌ها استفاده کنید. در گزارش، تاریخ‌ها در قالب YYYY-MM فهرست شده‌اند.

توجه: اگر پُرسمان API شما از بُعد month استفاده می‌کند، پارامترهای start-date و end-date باید روی اولین روز ماه تنظیم شوند. This is a core dimension and is subject to the Deprecation Policy.

مثال‌ها

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

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

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

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

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

مکان‌های بازپخش

این ابعاد اطلاعات آماری درباره صفحه یا برنامه‌ای که فعالیت کاربر در آن رخ داده است ارائه می‌دهند.

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

  • BROWSE – این داده‌ها بازدیدهایی را توصیف می‌کنند که در صفحه اصلی YouTube یا صفحه اصلی دستگاه، در فید اشتراک کاربر، یا در ویژگی مرور دیگری در YouTube انجام شده‌اند.

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

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

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

  • IMMERSIVE_LIVE_FEED – این داده‌ها بازدیدهایی را توصیف می‌کند که در فید زنده عمودی انجام شده است.

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

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

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

  • SHORTS_FEED – این داده‌ها بازدیدهایی را توصیف می‌کنند که در فید «کوته‌ویدیوهای YouTube» انجام شده‌اند.

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

  • YT_OTHER – این داده‌ها بازدیدهایی را توصیف می‌کنند که در دسته‌بندی‌های دیگر قرار نمی‌گیرند.

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

مثال‌ها

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

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

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

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

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

جزئیات بازپخش

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

جدول زیر مقادیر بُعد را فهرست می‌کند:
مقدار شرح
LIVE_STREAM محتوای مشاهده‌شده یک جاری‌سازی زنده YouTube بود.
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 Gaming انجام شده است.
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 غیرپولی، مانند صفحه «ویدیوهای Spotlight» YouTube، ارجاع داده شده‌اند.
  • RELATED_VIDEO – بازدیدهای ویدیو از فهرست ویدیوهای مرتبط در صفحه تماشای ویدیو دیگری ارجاع داده شده‌اند. اگر براساس این منبع ترافیک فیلتر کنید، فیلد insightTrafficSourceDetail شناسه ویدیو را برای آن ویدیو مشخص می‌کند.
  • SHORTS – بیننده با تند کشیدن عمودی از ویدیو قبلی در تجربه مشاهده «کوته‌ویدیوها» ارجاع داده شده است.
  • SOUND_PAGE – بازدیدهایی که از صفحات انتقالی صدای «کوته‌ویدیوها» منشأ گرفته‌اند.
  • SUBSCRIBER – بازدیدهای ویدیو از فیدهای صفحه اصلی YouTube یا از ویژگی‌های اشتراک YouTube ارجاع داده شده‌اند. اگر براساس این منبع ترافیک فیلتر کنید، فیلد insightTrafficSourceDetail موارد فید صفحه اصلی یا صفحه دیگری را که بازدیدها از آن ارجاع داده شده‌اند مشخص می‌کند.
  • YT_CHANNEL – بازدیدهای ویدیو در صفحه کانال رخ داده است. اگر براساس این منبع ترافیک فیلتر کنید، فیلد insightTrafficSourceDetail شناسه کانال را برای آن کانال مشخص می‌کند.
  • YT_OTHER_PAGE – بازدیدهای ویدیو از پیوندی غیراز نتیجه جستجو یا پیوند ویدیو مرتبط که در صفحه YouTube ظاهر شده است ارجاع داده شده‌اند. اگر براساس این منبع ترافیک فیلتر کنید، فیلد insightTrafficSourceDetail صفحه را شناسایی می‌کند.
  • YT_SEARCH – بازدیدهای ویدیو از نتایج جستجوی YouTube ارجاع داده شده‌اند. اگر براساس این منبع ترافیک فیلتر کنید، فیلد insightTrafficSourceDetail عبارت جستجو را مشخص می‌کند.
  • VIDEO_REMIXES – بازدیدهای ویدیو از پیوند ویدیو ریمیکس‌شده در پخش‌کننده «کوته‌ویدیوها» ارجاع داده شده‌اند. اگر براساس این منبع ترافیک فیلتر کنید، فیلد insightTrafficSourceDetail ویدیویی را که بیننده از آن ارجاع داده شده است مشخص می‌کند.
  • WATCH_WITH – بازدیدهای ویدیو از یک جریان «تفسیر محتواساز» / «تماشا با» ارجاع داده شده‌اند. اگر براساس این منبع ترافیک فیلتر کنید، فیلد insightTrafficSourceDetail ویدیویی را که بیننده از آن ارجاع داده شده است مشخص می‌کند.
insightTrafficSourceDetail
داده‌های گزارش براساس ارجاع‌دهندگانی که بیشترین بازدید را برای یک ویدیو خاص و یک نوع منبع ترافیک خاص ایجاد کرده‌اند، جمع‌آوری می‌شود. فهرست زیر منابع ترافیکی را که این گزارش برای آن‌ها دردسترس است مشخص می‌کند. برای هر منبع ترافیک، این فهرست اطلاعاتی را که بُعد insightTrafficSourceDetail ارائه می‌دهد شناسایی می‌کند.
  • ADVERTISING – نوع تبلیغی که منجر به بازدیدها شده است. مقادیر ممکن عبارت‌اند از:
    • آگهی تعاملی پخش‌باکلیک
    • آگهی درجه تعامل
    • آگهی‌های «جستجوی Google»
    • تبلیغ ویدئوی صفحهٔ اصلی
    • درون جاری‌سازی ردشدنی رزروشده
    • TrueView در حالت جستجو و در حالت نمایش
    • 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 – بازدیدهایی که از صفحه اشتراک‌های من کاربران در YouTube منشأ می‌گیرند.
  • YT_CHANNEL – صفحه کانالی که بینندگان ویدیو را در آن تماشا کرده‌اند.
  • YT_OTHER_PAGE – صفحه YouTube که بینندگان از آن به ویدیو ارجاع داده شده‌اند.
  • YT_SEARCH – عبارت جستجویی که بینندگان را به ویدیو هدایت کرده است.
  • VIDEO_REMIXES – ویدیویی که منجر به بازدیدها شده است.
  • WATCH_WITH – ویدیویی که منجر به بازدیدها شده است.

مثال‌ها

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

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

    • منبع ترافیک
      • تعداد بازدید و زمان تماشا از منابع ترافیک مختلف در یک کشور
      • تعداد بازدید روزانه و زمان تماشا از منابع ترافیک مختلف
      • ۱۰ عبارت جستجوی برتر YouTube که بیشترین ترافیک را برای ویدیو ایجاد می‌کنند
      • ۱۰ عبارت برتر – عبارت‌های جستجوی Google که بیشترین ترافیک را برای ویدیو ایجاد می‌کنند
      • تعداد بازدیدهای فهرست پخش و زمان تماشا از منابع ترافیک مختلف در یک کشور
      • تعداد بازدید روزانه فهرست پخش و زمان تماشا از منابع ترافیک مختلف

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

    • منبع ترافیک
      • تعداد بازدید و زمان تماشا از منابع ترافیک مختلف
      • تعداد بازدید روزانه و زمان تماشا از منابع ترافیک مختلف
      • ۱۰ عبارت جستجوی برتر YouTube که بیشترین ترافیک را برای ویدیو ایجاد می‌کنند
      • ۱۰ عبارت برتر – عبارت‌های جستجوی Google که بیشترین ترافیک را برای ویدیو ایجاد می‌کنند
      • تعداد بازدیدهای فهرست پخش و زمان تماشا از منابع ترافیک مختلف در یک کشور
      • تعداد بازدید روزانه فهرست پخش و زمان تماشا از منابع ترافیک مختلف

دستگاه‌ها

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

مثال‌ها

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

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

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

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

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

جمعیت‌شناسی

ابعاد جمعیت‌شناسی به شما کمک می‌کند تا محدوده سنی و توزیع جنسیتی مخاطبان خود را درک کنید. مرکز راهنمایی YouTube حاوی اطلاعات تکمیلی درباره داده‌های جمعیت‌شناختی در گزارش‌های YouTube Analytics است.

ageGroup (بُعد اصلی)
این بُعد گروه سنی کاربران واردشده به سیستم را که با داده‌های گزارش مرتبط هستند شناسایی می‌کند و شامل کاربرانی می‌شود که YouTube تخمین می‌زند زیر ۱۸ سال سن دارند. این 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.
جنسیت (بُعد اصلی)
این بُعد جنسیت کاربران واردشده به سیستم را که با داده‌های گزارش مرتبط هستند شناسایی می‌کند. مقادیر معتبر female، male، و user_specified است. This is a core dimension and is subject to the Deprecation Policy.

مثال‌ها

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

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

    • جمعیت‌شناختی
      • اطلاعات جمعیت‌شناختی بیننده در کالیفرنیا (گروه سنی و جنسیت)
      • جمعیت‌شناسی بیننده فهرست پخش در کالیفرنیا (گروه سنی و جنسیت)

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

    • جمعیت‌شناختی
      • اطلاعات جمعیت‌شناختی بیننده در کالیفرنیا (گروه سنی و جنسیت)
      • جمعیت‌شناسی بیننده فهرست پخش در کالیفرنیا (گروه سنی و جنسیت)

تعامل و هم‌رسانی محتوا

sharingService (بُعد اصلی)
این بُعد سرویسی را که برای هم‌رسانی ویدیوها استفاده شده است شناسایی می‌کند. ویدیوها را می‌توان در YouTube (یا ازطریق پخش‌کننده YouTube) بااستفاده از دکمه «هم‌رسانی» هم‌رسانی کرد. This is a core dimension and is subject to the Deprecation Policy.

جدول زیر مقادیر معتبر بُعد را فهرست می‌کند:
سرویس اشتراک‌گذاری مقدار میانای برنامه‌سازی کاربردی
Allo ALLO
Ameba AMEBA
ایمیل Android ANDROID_EMAIL
Android Messenger ANDROID_MESSENGER
پیام‌رسانی Android ANDROID_MMS
کادر گفتگوی هم‌رسانی سیستم Android ANDROID_SYSTEM_SHARE_DIALOG
Blackberry Messenger BBM
گرفتن واکنش BLIND_REACT
Blogger BLOGGER
کپی در بریده‌دان COPY_PASTE
Cyworld CYWORLD
Digg DIGG
کادر گفتگوی فعالیت مستقیم سیستم DIRECT_SYSTEM_ACTIVITY_DIALOG
Discord DISCORD
رمزینه پاسخ‌سریع نمایش‌داده‌شده DISPLAYED_QR_CODE
Dropbox DROPBOX
جاسازی EMBED
ایمیل MAIL
فیس‌بوک FACEBOOK
فیس‌بوک Lite FACEBOOK_LITE
پیام‌رسان فیس‌بوک FACEBOOK_MESSENGER
صفحه‌های فیس‌بوک FACEBOOK_PAGES
هم‌رسانی کردن در گروه «فیس‌بوک» FACEBOOK_SHARE_TO_GROUP
داستان‌های فیس‌بوک FACEBOOK_STORIES
Fotka FOTKA
Gmail GMAIL
goo GOO
برنامه Google GOOGLE_APP
Google Chat GOOGLE_CHAT
Google Chrome GOOGLE_CHROME
Google Inbox INBOX
Google Keep GOOGLE_KEEP
Google+‎ GOOGLEPLUS
Go SMS GO_SMS
GroupMe GROUPME
Hangouts HANGOUTS
hi5 HI5
پیامک HTC HTC_MMS
IMO IMO
Instagram INSTAGRAM
داستان‌های Instagram INSTAGRAM_STORIES
پیوند دعوت (Android) INVITE_LINK_ANDROID
پیوند دعوت (iOS) INVITE_LINK_IOS
دعوت کردن مشارکت‌کنندگان فهرست پخش INVITE_PLAYLIST_COLLABORATORS
کادر گفتگوی فعالیت سیستم iOS IOS_SYSTEM_ACTIVITY_DIALOG
KAKAO Story KAKAO_STORY
Kakao (Kakao Talk) KAKAO
پیام‌های KaiOS KAIOS_MESSAGES
Kik KIK
ایمیل LGE LGE_EMAIL
خط LINE
LinkedIn LINKEDIN
LiveJournal LIVEJOURNAL
کپی/ جای‌گذاری Maps MAPS_COPY_PASTE
هم‌رسانی زنده Meet MEET_LIVE_SHARING
menéame MENEAME
mixi MIXI
Motorola Messaging MOTOROLA_MESSAGING
Myspace MYSPACE
Naver NAVER
هم‌رسانی با اطراف NEARBY_SHARE
NUjij NUJIJ
Odnoklassniki (Одноклассники) ODNOKLASSNIKI
غیره OTHER
Pinterest PINTEREST
هم‌رسانی سریع QUICK_SHARE
هم‌رسانی سریع (Samsung) QUICK_SHARE_SAMSUNG
Rakuten (楽天市場) RAKUTEN
reddit REDDIT
بازآمیزی REMIX
Samsung Messages SAMSUNG_MESSAGES
Samsung Notes SAMSUNG_NOTES
ذخیره در عکس‌های دستگاه SAVE_TO_DEVICE_PHOTOS
هم‌رسانی بدون آگهی SHARE_AD_FREE
هم‌رسانی با دوربین Snapchat SHARE_TO_SNAPCHAT_CAMERA
هم‌رسانی با کودکان SHARE_WITH_KIDS
Skype SKYPE
Skyrock SKYBLOG
Snapchat SNAPCHAT
مکالمه‌های Sony SONY_CONVERSATIONS
StumbleUpon STUMBLEUPON
Telegram TELEGRAM
پیام نوشتاری TEXT_MESSAGE
Tuenti TUENTI
tumblr. TUMBLR
Twitter TWITTER
نامشخص UNKNOWN
پیام‌های Verizon VERIZON_MMS
Viber VIBER
VKontakte (ВКонтакте) VKONTAKTE
کادر گفتگوی فعالیت سیستم وب WEB_SYSTEM_ACTIVITY_DIALOG
WeChat WECHAT
Weibo WEIBO
واتساپ WHATS_APP
واتساپ Business WHATS_APP_BUSINESS
Wykop WYKOP
Yahoo!‎ ژاپن YAHOO
پست انجمن YouTube YOUTUBE_COMMUNITY_POST
بازنشر پست انجمن YouTube YOUTUBE_COMMUNITY_REPOST
YouTube Gaming YOUTUBE_GAMING
YouTube Kids YOUTUBE_KIDS
YouTube Mango YOUTUBE_MANGO
YouTube Music YOUTUBE_MUSIC
پیش‌نمایش هم‌رسانی YouTube Music در Snapchat YTM_SHARE_TO_SNAPCHAT_PREVIEW
پرده سبز «کوته‌ویدیوهای YouTube» YOUTUBE_SHORTS_GREEN_SCREEN
YouTube TV YOUTUBE_TV
تماشای YouTube با دوستان YOUTUBE_WATCH_WITH_FRIENDS

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

مثال‌ها

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

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

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

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

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

حفظ مخاطب

elapsedVideoTimeRatio
این بُعد نسبت بخش سپری‌شده ویدیو به طول ویدیو را مشخص می‌کند. از سنجه‌ها و ابعاد «حفظ» برای اندازه‌گیری حفظ مخاطب درطول زمان استفاده می‌شود و بُعد elapsedVideoTimeRatio سنجه زمان است. برای مثال، مقدار 0.4 نشان می‌دهد که داده‌های گزارش مربوطه داده‌های حفظ مخاطب را پس‌از گذشت ۴۰ درصد از ویدیو نشان می‌دهد.

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

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

مثال‌ها

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

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

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

جاری‌سازی زنده

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

لغو عضویت‌ها

membershipsCancellationSurveyReason
تعداد نظرسنجی‌های تکمیل‌شده توسط کاربران YouTube که عضویت کانال خود را برای کانال مشخص‌شده در طول دوره گزارش‌دهی لغو کرده‌اند. جدول زیر مقادیر معتبر بُعد را فهرست می‌کند:
مقدار میانای برنامه‌سازی کاربردی توضیح
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 – آگهی تصویری یا رسانه تعاملی که به‌صورت هم‌پوشانی در پایین پخش‌کننده ویدیو، به‌عنوان واحد آگهی ۲۵۰×۳۰۰ در صفحه تماشای ویدیو، یا ترکیبی از هر دو ظاهر می‌شود. وقتی هم‌پوشانی اجرا می‌شود، پس‌از نمایش برای مدت‌زمان مشخصی به‌طور خودکار بسته می‌شود و کاربر نیز می‌تواند هم‌پوشانی را ببندد. اگر هم‌پوشانی و بنر با هم نشان داده شوند، هر آگهی به‌عنوان یک ظهور جداگانه محاسبه می‌شود.

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

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

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

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

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

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

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

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

  • reservedInstreamSelect

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

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

  • unknown – YouTube نتوانست این نوع آگهی را طبقه‌بندی کند.

مثال‌ها

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

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

    • درآمد/آگهی
      • سنجه‌های عملکرد آگهی و درآمد کانال
      • سنجه‌های عملکرد آگهی و درآمد روزانه
      • سنجه‌های عملکرد آگهی و درآمد مختص کشور
      • ۱۰ ویدیو برتر – ویدیوهای با بیشترین درآمد
      • سنجه‌های عملکرد آگهی برای انواع مختلف آگهی

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

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

ابعاد مالک محتوا

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

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

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

به‌ارزش claimedStatus به‌ارزش uploaderType شرح
[تنظیم‌نشده] خودم داده‌های YouTube Analytics را برای محتوای ادعاشده و ادعانشده بارگذاری‌شده توسط مالک محتوا بازیابی می‌کند.
ادعا شده [تنظیم‌نشده] داده‌های مربوط به محتوای ادعاشده را که توسط مالک محتوا یا شخص ثالث بارگذاری شده است بازیابی می‌کند.
ادعا شده خودم داده‌های مربوط به محتوای ادعاشده را که توسط مالک محتوا بارگذاری شده است بازیابی می‌کند.
ادعا شده thirdParty داده‌های مربوط به محتوای ادعاشده بارگذاری‌شده توسط شخص ثالث را بازیابی می‌کند.

مثال‌ها

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