Metrics

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

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

معیارهای اصلی

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

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

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

مشاهده معیارها

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

معیارهای دسترسی

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

معیارهای زمان تماشا

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

معیارهای تعامل

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

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

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

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

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

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

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

معیارهای لیست پخش

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

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

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

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

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

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

معیارهای حاشیه‌نویسی

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

معیارهای کارت

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

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

معیارهای پایان صفحه

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

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

معیارهای لغو عضویت

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

شاخص‌های درآمد تخمینی

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

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

معیارهای تخمینی درآمد مشمول تعدیل در پایان ماه هستند و شامل تبلیغات فروخته شده توسط شرکا و تبلیغات ارائه شده توسط شرکا نمی‌شوند.
estimated_partner_ad_auction_revenue (only supported in YouTube Reporting API)
کل درآمد تخمینی (درآمد خالص) حاصل از تبلیغات حراجی از طریق AdSense برای محدوده تاریخ و منطقه انتخاب شده. این معیار قبلاً با نام estimated_partner_ad_sense_revenue شناخته می‌شد.
estimated_partner_ad_reserved_revenue (only supported in YouTube Reporting API)
کل درآمد تخمینی (درآمد خالص) از تبلیغات فروش-رزرو شده از طریق DoubleClick (DCLK) و سایر منابع فروش-یوتیو. این معیار قبلاً با نام estimated_partner_double_click_revenue نامگذاری شده بود.
estimated_partner_red_revenue (only supported in YouTube Reporting API)
کل درآمد تخمینی (درآمد خالص) از اشتراک‌های یوتیوب پریمیوم (که قبلاً با نام یوتیوب رد شناخته می‌شد).
estimated_partner_transaction_revenue (only supported in YouTube Reporting API)
کل درآمد تخمینی حاصل از تراکنش‌ها، مانند محتوای پولی و جذب سرمایه از سوی طرفداران، منهای هرگونه بازپرداخت از سوی شرکا.

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

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