Metrics

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

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

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

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

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

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

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

views (core metric)
تعداد دفعاتی که یک ویدیو مشاهده شده است. در گزارش فهرست پخش، معیار تعداد دفعاتی را نشان می‌دهد که یک ویدیو در متن یک فهرست پخش مشاهده شده است. مرکز راهنمای YouTube اطلاعات بیشتری درباره نحوه گزارش بازدیدها ارائه می دهد. 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 .

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

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)
میانگین طول پخش ویدیو بر حسب ثانیه. از 13 دسامبر 2021، این معیار ترافیک کلیپ‌های حلقه‌ای را مستثنی می‌کند. در گزارش فهرست پخش، این متریک میانگین طول پخش‌های ویدیویی را که در متن یک فهرست پخش انجام شده، بر حسب ثانیه نشان می‌دهد. This is a core metric and is subject to the Deprecation Policy .
average_view_duration_percentage
میانگین درصد ویدیوی تماشا شده در حین پخش ویدیو. از 13 دسامبر 2021، این معیار ترافیک کلیپ‌های حلقه‌ای را مستثنی می‌کند.

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

comments (core metric)
تعداد دفعاتی که کاربران روی یک ویدیو نظر دادند. برای اطلاعات بیشتر به مرکز راهنمایی YouTube مراجعه کنید. 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 به اشتراک گذاشته اند. برای اطلاعات بیشتر به مرکز راهنمایی YouTube مراجعه کنید. 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 .

کانال‌ها می‌توانند در مکان‌های مختلف، از جمله صفحه تماشای ویدیو، صفحه کانال، و راهنمای نمایش داده شده در صفحه اصلی YouTube، مشترکین به دست آورند یا از دست بدهند. برای شناسایی تعداد مشترکین کانال جدید که از طریق صفحه تماشای ویدیو مشترک نشده‌اند، گزارش فعالیت اصلی کاربر حاوی ردیفی است که مقدار بعد 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
تعداد دفعاتی که ویدیوها به هر فهرست پخش YouTube اضافه شده است. ویدئوها می‌توانست به لیست پخش مالک ویدئو یا به لیست پخش کانال‌های دیگر اضافه شود.

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

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

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

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

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

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

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

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

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

بیشتر معیارهای ذکر شده در زیر معیارهای درون لیست پخش هستند. معیارهای باقی‌مانده در فهرست، مانند اندازه‌گیری 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 . مرکز راهنمایی YouTube اطلاعات بیشتری درباره ایجاد حاشیه‌نویسی و استفاده از حاشیه‌نویسی پیوند دارد.
annotation_closable_impressions
تعداد حاشیه‌نویسی‌هایی که ظاهر می‌شوند و می‌توانند بسته شوند.
annotation_closes
تعداد حاشیه نویسی های بسته
annotation_close_rate (core metric)
نسبت حاشیه‌نویسی‌هایی که بینندگان بسته‌اند به تعداد کل برداشت‌های حاشیه‌نویسی. 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
نرخ کلیک برای تیزرهای کارت، که به عنوان نسبت کلیک روی تیزر کارت به تعداد کل نمایش‌های تیزر کارت محاسبه می‌شود.

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

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

توجه: داده‌های معیارهای صفحه پایانی از ۱ مه ۲۰۱۶ در دسترس است.

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

معیارهای حفظ مخاطب

audience_retention_percentage
نسبت مطلق بینندگانی که ویدیو را در نقطه داده شده از ویدیو تماشا می کنند. این نسبت با مقایسه تعداد دفعاتی که یک قسمت از یک ویدیو تماشا شده است با تعداد کل بازدیدهای ویدیو محاسبه می شود. بعد elapsed_video_time_percentage قسمتی از ویدیو را که معیار با آن مطابقت دارد مشخص می کند.

توجه داشته باشید که بخشی از یک ویدیو را می‌توان بیش از یک بار (یا اصلاً) در یک نمای ویدیویی مشاهده کرد. به عنوان مثال، اگر کاربران یک قسمت از یک ویدیو را چندین بار به عقب برگردانند و تماشا کنند، نسبت مطلق برای آن بخش از ویدیو می‌تواند بیشتر از 1 باشد.

مثال های زیر نحوه محاسبه مقدار را نشان می دهد:
  • یک ویدیوی یک دقیقه ای 100 بار تماشا می شود. نیمی از بینندگان بعد از 15 ثانیه دیگر تماشا نمی کنند و بقیه کل ویدیو را تماشا می کنند. هیچ یک از بینندگان هیچ قسمتی از ویدیو را بیش از یک بار تماشا نمی کنند. در این حالت، مقدار این متریک برای سطل های زمانی در سه ماهه اول ویدیو 1 و مقدار آن برای بقیه ویدیو 0.50 خواهد بود.
  • یک ویدیوی یک دقیقه ای 100 بار تماشا می شود. همه بینندگان کل ویدیو را تماشا می کنند، اما 20 نفر از بینندگان تا زمانی که ویدیو به 45 ثانیه برسد، آن را تماشا می کنند، سپس به نقطه 30 ثانیه ویدیو برمی گردند و سپس بقیه ویدیو را تماشا می کنند. در این حالت، مقدار متریک برای سطل‌های زمانی در نیمه اول یا سه‌ماهه آخر ویدیو 1 خواهد بود. با این حال، مقدار 1.2 برای سطل های زمانی در سه ماهه سوم ویدیو خواهد بود زیرا 100 درصد بینندگان آن بخش از ویدیو را تماشا کردند اما 20 درصد از آن بینندگان این بخش را دو بار تماشا کردند.

معیارهای درآمد تخمینی

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

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

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

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

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