Metrics

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

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

سنجه‌های اصلی

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

فهرست زیر سنجه‌های اصلی میانای برنامه‌سازی کاربردی را مشخص می‌کند. هرکدام از این سنجه‌ها که در YouTube Analytics API نیز استفاده می‌شوند، سنجه‌های اصلی در آن API نیز هستند.

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

مشاهده سنجه‌ها

engaged_views (سنجه اصلی)
تعداد دفعاتی که ویدیوهای کانال پس‌از قاب اول مشاهده شده‌اند، یا کاربر برای پخش کردن کلیک/ تک‌ضرب می‌زند.
بازدیدها (سنجه اصلی)
تعداد دفعاتی که ویدیو مشاهده شده است. در گزارش فهرست پخش، این سنجه نشان‌دهنده تعداد دفعاتی است که ویدیو در زمینه فهرست پخش دیده شده است. این سنجه شامل بازدیدهای مشترک است که در آن چند نفر با هم در صفحه‌نمایش تلویزیون تماشا می‌کنند. مرکز راهنمایی YouTube اطلاعات بیشتری درباره نحوه گزارش بازدیدها ارائه می‌دهد. This is a core metric and is subject to the Deprecation Policy.
red_views
تعداد دفعاتی که ویدیو توسط اعضای YouTube Premium (که قبلاً YouTube Red نامیده می‌شد) مشاهده شده است.
views_percentage (سنجه اصلی)
درصد بینندگانی که هنگام تماشای ویدیو یا فهرست پخش به سیستم وارد شده بودند. This is a core metric and is subject to the Deprecation Policy.

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

video_thumbnail_impressions
تعداد دفعاتی که ریزعکس‌های ویدیو به بینندگان نشان داده شده است. اگر ریزعکس بیش‌از ۱ ثانیه نشان داده شود و حداقل ۵۰٪ ریزعکس در صفحه نمایان باشد، ظهورها شمارش می‌شود. برای اطلاعات بیشتر، به مرکز راهنمایی YouTube مراجعه کنید.
video_thumbnail_impressions_ctr
درصد ظهورهایی که منجر به کلیک برای تماشای ویدیو شده‌اند. این مقدار با تقسیم کردن کلیک‌ها بر ظهورها محاسبه می‌شود.

سنجه‌های زمان تماشا

watch_time_minutes (سنجه اصلی)
تعداد دقیقه‌هایی که کاربران ویدیوهای کانال، مالک محتوا، ویدیو، یا فهرست پخش مشخص‌شده را تماشا کرده‌اند. این سنجه شامل بازدیدهای مشترک است که در آن چند نفر با هم در صفحه‌نمایش تلویزیون تماشا می‌کنند. This is a core metric and is subject to the Deprecation Policy.
red_watch_time_minutes
تعداد دقیقه‌هایی که اعضای YouTube Premium (که قبلاً با نام YouTube Red شناخته می‌شد) ویدیو را تماشا کرده‌اند.
average_view_duration_seconds (سنجه اصلی)
میانگین طول بازپخش‌های ویدیو برحسب ثانیه. از ۱۳ دسامبر ۲۰۲۱، این سنجه ترافیک کلیپ‌های حلقه‌ای را مستثنی می‌کند. در گزارش فهرست پخش، این سنجه نشان‌دهنده میانگین طول بازپخش‌های ویدیو برحسب ثانیه است که در بافت فهرست پخش رخ داده است. This is a core metric and is subject to the Deprecation Policy.
average_view_duration_percentage
میانگین درصدی از ویدیو که درطول بازپخش ویدیو تماشا شده است. از ۱۳ دسامبر ۲۰۲۱، این سنجه ترافیک کلیپ‌های حلقه‌ای را مستثنی می‌کند.

سنجه‌های تعامل

نظرات (سنجه اصلی)
تعداد دفعاتی که کاربران برای ویدیویی نظر گذاشته‌اند. برای اطلاعات بیشتر، به مرکز راهنمایی YouTube مراجعه کنید. This is a core metric and is subject to the Deprecation Policy.
پسندیدن‌ها (سنجه اصلی)
تعداد دفعاتی که کاربران با ارائه رده‌بندی مثبت نشان می‌دهند که ویدیویی را می‌پسندند. This is a core metric and is subject to the Deprecation Policy.
نپسندیدن‌ها (سنجه اصلی)
تعداد دفعاتی که کاربران با ارائه رده‌بندی منفی نشان می‌دهند که ویدیویی را نمی‌پسندند. This is a core metric and is subject to the Deprecation Policy.
هم‌رسانی‌ها (سنجه اصلی)
تعداد دفعاتی که کاربران ویدیویی را ازطریق دکمه Share هم‌رسانی کرده‌اند. برای اطلاعات بیشتر، به مرکز راهنمایی YouTube مراجعه کنید. This is a core metric and is subject to the Deprecation Policy.
subscribers_gained (سنجه اصلی)
تعداد دفعاتی که کاربران در کانال مشترک شده‌اند. This is a core metric and is subject to the Deprecation Policy.

کانال‌ها می‌توانند در چندین مکان، ازجمله صفحه تماشای ویدیو، صفحه کانال، و راهنمایی که در صفحه اصلی YouTube ظاهر می‌شود، مشترک جذب کنند یا ازدست بدهند. برای شناسایی تعداد مشترکان جدید کانال که ازطریق صفحه تماشای ویدیو مشترک نشده‌اند، گزارش فعالیت کاربر پایه حاوی ردیفی است که مقدار بُعد video_id را مشخص نمی‌کند. آن ردیف همچنین مقداری را برای سنجه subscribersLost مشخص می‌کند، اما مقادیری را برای سنجه‌های دیگر مشخص نمی‌کند.
subscribers_lost (سنجه اصلی)
تعداد دفعاتی که کاربران اشتراک خود را در کانال لغو کرده‌اند. This is a core metric and is subject to the Deprecation Policy.

داده‌های این سنجه مشابه سنجه subscribers_gained گزارش می‌شود. برای شناسایی تعداد کاربرانی که لغو اشتراک کرده‌اند اما در صفحه تماشای ویدیو لغو اشتراک نکرده‌اند، گزارش فعالیت کاربر پایه حاوی ردیفی است که مقدار بُعد video_id را مشخص نمی‌کند. آن ردیف همچنین مقداری را برای سنجه subscribers_gained مشخص می‌کند، اما مقادیری را برای سنجه‌های دیگر مشخص نمی‌کند.
videos_added_to_playlists
تعداد دفعاتی که ویدیوها به هر فهرست پخش YouTube اضافه شده‌اند. ویدیوها ممکن است به فهرست پخش مالک ویدیو یا به فهرست‌های پخش کانال‌های دیگر اضافه شده باشند.

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

این سنجه یک عدد مطلق را برمی‌گرداند، به این معنی که اگر کاربری ویدیویی را به فهرست پخش اضافه کند، آن را حذف کند و سپس دوباره آن را اضافه کند، مقدار سنجه نشان‌دهنده این است که ویدیو دو بار به فهرست پخش اضافه شده است. داده‌های این سنجه برای تاریخ‌های قبل‌از ۱ اکتبر ۲۰۱۴ دردسترس نیست.
videos_removed_from_playlists
تعداد دفعاتی که ویدیوها از هر فهرست پخش YouTube برداشته شده‌اند. ویدیوها ممکن است از فهرست پخش مالک ویدیو یا از فهرست‌های پخش کانال‌های دیگر برداشته شده باشند.

مقدار سنجه شامل تعداد دفعاتی است که ویدیوها از فهرست‌های پخش پیش‌فرض مانند فهرست پخش «تماشا در فرصتی دیگر» برداشته شده‌اند.

این سنجه یک عدد مطلق را برمی‌گرداند، به این معنی که اگر کاربری ویدیویی را به فهرست پخش اضافه کند، آن را بردارد، دوباره اضافه کند و سپس دوباره بردارد، مقدار سنجه نشان‌دهنده دو بار برداشته شدن ویدیو از فهرست پخش است. داده‌های این سنجه برای تاریخ‌های قبل‌از ۱ اکتبر ۲۰۱۴ دردسترس نیست.

سنجه‌های فهرست پخش

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

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

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

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

بیشتر سنجه‌های زیر سنجه‌های درون فهرست پخش هستند؛ سنجه‌های باقی‌مانده در فهرست، مانند سنجه playlistSaves، درباره تعاملات کاربر با خود فهرست پخش هستند و نه با ویدیوهای موجود در فهرست پخش. بنابراین، این سنجه‌ها نه به‌عنوان سنجه‌های تجمیعی ویدیو و نه به‌عنوان سنجه‌های درون فهرست پخش مشخص می‌شوند.

playlist_starts
تعداد دفعاتی که بینندگان بازپخش یک فهرست پخش را آغاز کرده‌اند. توجه داشته باشید که این سنجه فقط شامل بازدیدهای فهرست پخش است که در وب رخ داده‌اند.
playlist_saves_added (فقط در YouTube Reporting API پشتیبانی می‌شود)
تعداد دفعاتی که کاربران فهرست پخش را ذخیره کرده‌اند. برای اطلاعات بیشتر درباره فهرست‌های پخش ذخیره‌شده، به مرکز راهنمایی YouTube مراجعه کنید. این سنجه عددی مطلق را برمی‌گرداند، به این معنی که اگر کاربری فهرست پخشی را ذخیره کند، آن را از فهرست پخش‌های ذخیره‌شده بردارد، و دوباره آن را ذخیره کند، مقدار سنجه دو ذخیره فهرست پخش اضافه‌شده را نشان می‌دهد.
playlist_saves_removed (فقط در YouTube Reporting API پشتیبانی می‌شود)
تعداد دفعاتی که کاربران فهرست پخش را از فهرست‌های پخش ذخیره‌شده خود حذف کرده‌اند. این سنجه یک عدد مطلق را برمی‌گرداند، به این معنی که اگر کاربری یک فهرست پخش را ذخیره کند، آن را از فهرست پخش‌های ذخیره‌شده حذف کند، دوباره آن را ذخیره کند و دوباره آن را حذف کند، مقدار سنجه نشان‌دهنده حذف دو ذخیره فهرست پخش است.

سنجه‌های حاشیه‌نویسی‌ها

annotation_impressions
تعداد کل دفعات نمایش حاشیه‌نویسی.
annotation_clickable_impressions
تعداد حاشیه‌نویسی‌هایی که ظاهر شده‌اند و قابل کلیک کردن بوده‌اند.
annotation_clicks
تعداد حاشیه‌نویسی‌های کلیک‌شده.
annotation_click_through_rate (سنجه اصلی)
نسبت حاشیه‌نویسی‌هایی که بینندگان روی آن‌ها کلیک کرده‌اند به تعداد کل ظهورهای حاشیه‌نویسی قابل کلیک. This is a core metric and is subject to the Deprecation Policy. «مرکز راهنمایی YouTube» اطلاعات بیشتری درباره ایجاد حاشیه‌نویسی و استفاده از حاشیه‌نویسی پیوند دارد.
annotation_closable_impressions
تعداد حاشیه‌نویسی‌هایی که ظاهر شدند و می‌توانستند بسته شوند.
annotation_closes
تعداد حاشیه‌نویسی‌های بسته‌شده.
annotation_close_rate (سنجه اصلی)
نسبت حاشیه‌نویسی‌هایی که بینندگان بسته‌اند به تعداد کل ظهورهای حاشیه‌نویسی. This is a core metric and is subject to the Deprecation Policy.

سنجه‌های کارت

«مرکز راهنمایی YouTube» حاوی دستورالعمل‌های دقیق‌تری برای افزودن کارت به ویدیوهایتان و گزارش کارت‌های YouTube Analytics است.

card_impressions
تعداد دفعاتی که کارت‌ها نمایش داده شده‌اند. وقتی پانل کارت باز می‌شود، یک ظهور کارت برای هریک از کارت‌های ویدیو ثبت می‌شود.
card_clicks
تعداد دفعاتی که روی کارت‌ها کلیک شده است.
card_click_rate
نرخ کلیک‌گذری برای کارت‌ها که به‌عنوان نسبت کلیک‌های کارت به دفعات ظهور کارت محاسبه می‌شود.
card_teaser_impressions
تعداد دفعاتی که تیزرهای کارت نمایش داده شده‌اند. یک بازدید ویدیو می‌تواند چندین نمایش برچسب تبلیغ ایجاد کند.
card_teaser_clicks
تعداد کلیک‌ها روی برچسب‌های تبلیغ کارت. کلیک‌های روی نماد کارت به آخرین برچسب تبلیغ نمایش‌داده‌شده به کاربر نسبت داده می‌شود.
card_teaser_click_rate
نرخ کلیک‌گذری برای برچسب‌های تبلیغ کارت که به‌عنوان نسبت کلیک‌ها روی برچسب‌های تبلیغ کارت به تعداد کل دفعات ظهور برچسب تبلیغ کارت محاسبه می‌شود.

سنجه‌های صفحه پایانی

صفحه پایانی عنصری است که در ۵ تا ۲۰ ثانیه آخر ویدیو برای تبلیغ محتوا، کانال، و وب‌سایت‌های شما نمایش داده می‌شود. مرکز راهنمایی YouTube حاوی دستورالعمل‌های دقیق‌تری برای افزودن صفحه‌های پایانی به ویدیوهای شما و گزارش صفحه‌های پایانی YouTube Analytics است.

end_screen_element_impressions
تعداد عناصر صفحه پایانی که نمایش داده شده‌اند. یک ظهور برای هر عنصر صفحه پایانی که نمایش داده می‌شود ثبت می‌شود.
end_screen_element_clicks
تعداد دفعاتی که روی عناصر صفحه پایانی کلیک شده است.
end_screen_element_click_rate
نرخ کلیک‌گذری برای عناصر صفحه پایانی که به‌صورت نسبت کلیک‌های عنصر صفحه پایانی به ظهورهای عنصر صفحه پایانی محاسبه می‌شود.

سنجه‌های لغو عضویت

membershipsCancellationSurveyResponses
تعداد نظرسنجی‌های تکمیل‌شده توسط کاربران YouTube که عضویت کانال خود را برای کانال مشخص‌شده در طول دوره گزارش‌دهی لغو کرده‌اند.

سنجه‌های درآمد تخمینی

توجه: سنجه‌های درآمد تخمینی مشمول تعدیل‌های پایان ماه هستند و شامل تبلیغات فروخته‌شده توسط شریک و ارائه‌شده توسط شریک نمی‌شوند. برای اطلاعات بیشتر و یادداشت‌هایی درباره ارقام درآمد تخمینی، به مرکز راهنمایی YouTube مراجعه کنید.

‫YouTube Reporting API همه ارقام درآمد تخمینی و خالص را به دلار امریکا گزارش می‌کند.
estimated_partner_revenue (core metric)
کل درآمد خالص تخمینی از همه منابع تبلیغاتی فروخته‌شده توسط Google و همچنین از منابع غیرتبلیغاتی برای محدوده تاریخ و منطقه انتخاب‌شده.
estimated_partner_ad_revenue
کل درآمد خالص تخمینی از همه منابع تبلیغاتی فروخته‌شده توسط Google برای محدوده تاریخ و منطقه انتخاب‌شده.

سنجه‌های درآمد تخمینی مشمول تعدیل پایان ماه هستند و شامل تبلیغات فروخته‌شده توسط شریک و ارائه‌شده توسط شریک نمی‌شوند.
estimated_partner_ad_auction_revenue (فقط در YouTube Reporting API پشتیبانی می‌شود)
کل درآمد تخمینی (درآمد خالص) حاصل از تبلیغات حراج ویدیو ازطریق AdSense برای محدوده تاریخ و منطقه انتخابی. این سنجه قبلاً estimated_partner_ad_sense_revenue نام داشت.
estimated_partner_ad_reserved_revenue (فقط در YouTube Reporting API پشتیبانی می‌شود)
مجموع تخمینی درآمدها (درآمد خالص) حاصل از تبلیغات رزروشده/فروخته‌شده ازطریق DoubleClick ‏(DCLK) و سایر منابع فروش YouTube. این سنجه قبلاً estimated_partner_double_click_revenue نام داشت.
estimated_partner_red_revenue (فقط در YouTube Reporting API پشتیبانی می‌شود)
مجموع تخمینی درآمدها (درآمد خالص) از اشتراک‌های YouTube Premium (که قبلاً YouTube Red نامیده می‌شد).
estimated_partner_transaction_revenue (فقط در YouTube Reporting API پشتیبانی می‌شود)
کل درآمد تخمینی از تراکنش‌ها، مانند محتوای پولی و «تأمین بودجه از طرفداران»، منهای هرگونه استرداد وجه کسرشده از شریک.

سنجه‌های عملکرد آگهی

estimated_youtube_ad_revenue
درآمد ناخالص تخمینی، به دلار امریکا، از تمام تبلیغات فروخته‌شده توسط Google یا شریک DoubleClick برای محدوده تاریخ و منطقه انتخابی. درآمد ناخالص تحت تعدیل پایان ماه قرار می‌گیرد و شامل تبلیغات ارائه‌شده توسط شریک نمی‌شود. درآمد ناخالص نباید با درآمد تخمینی یا درآمد خالص اشتباه گرفته شود، که سهم مالکیت شما و قراردادهای توزیع سهم درآمد را درنظر می‌گیرد.
estimated_cpm
درآمد ناخالص تخمینی به‌ازای هر هزار ظهور آگهی.
ad_impressions
تعداد دفعات نمایش آگهی تأییدشده ارائه‌شده.
estimated_monetized_playbacks
تعداد دفعاتی که بیننده ویدیو شما را پخش کرده و حداقل یک ظهور آگهی به او نشان داده شده است. اگر آگهی پیش‌پخش به بیننده نشان داده شود اما بیننده قبل‌از شروع ویدیو شما تماشای آگهی را متوقف کند، بازپخش درآمدزا محاسبه می‌شود. خطای تخمینی موردانتظار برای این رقم ±۲٫۰٪ است.
estimated_playback_based_cpm
درآمد ناخالص تخمینی به‌ازای هر هزار بازپخش.