این سند سنجههایی را که YouTube Reporting API بازیابی میکند تعریف میکند. این میانای برنامهسازی کاربردی گزارشهای دادههای انبوه را که حاوی دادههای YouTube Analytics برای مالک کانال یا محتوا است بازیابی میکند.
سنجهها اندازهگیریهای فردی فعالیت کاربر، عملکرد آگهی، یا درآمد تخمینی هستند. سنجههای فعالیت کاربر شامل مواردی مانند تعداد بازدیدهای ویدیو و رتبهبندیها (پسندیدنها و نپسندیدنها) میشود.
سنجههای اصلی
درحالیکه YouTube Reporting API تابع «خطمشی منسوخ کردن» تعریفشده در شرایط خدمات است، سنجههای غیرهستهای (و ابعاد غیرهستهای) تابع این خطمشی نیستند. در تعاریف این صفحه، هر سنجهای که سنجه اصلی باشد بهطور صریح بهعنوان سنجه اصلی مشخص شده است.
فهرست زیر سنجههای اصلی میانای برنامهسازی کاربردی را مشخص میکند. هرکدام از این سنجهها که در YouTube Analytics API نیز استفاده میشوند، سنجههای اصلی در آن API نیز هستند.
annotation_click_through_rateannotation_close_rateaverage_view_duration_secondscommentsdislikesengaged_viewsestimated_partner_revenuelikessharessubscribers_gainedsubscribers_lostviews_percentageviewswatch_time_minutes
برای اطلاعات بیشتر، فهرست 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
- نرخ کلیکگذری برای کارتها که بهعنوان نسبت کلیکهای کارت به دفعات ظهور کارت محاسبه میشود.
- تعداد دفعاتی که تیزرهای کارت نمایش داده شدهاند. یک بازدید ویدیو میتواند چندین نمایش برچسب تبلیغ ایجاد کند.
- تعداد کلیکها روی برچسبهای تبلیغ کارت. کلیکهای روی نماد کارت به آخرین برچسب تبلیغ نمایشدادهشده به کاربر نسبت داده میشود.
- نرخ کلیکگذری برای برچسبهای تبلیغ کارت که بهعنوان نسبت کلیکها روی برچسبهای تبلیغ کارت به تعداد کل دفعات ظهور برچسب تبلیغ کارت محاسبه میشود.
سنجههای صفحه پایانی
صفحه پایانی عنصری است که در ۵ تا ۲۰ ثانیه آخر ویدیو برای تبلیغ محتوا، کانال، و وبسایتهای شما نمایش داده میشود. مرکز راهنمایی YouTube حاوی دستورالعملهای دقیقتری برای افزودن صفحههای پایانی به ویدیوهای شما و گزارش صفحههای پایانی YouTube Analytics است.
- end_screen_element_impressions
- تعداد عناصر صفحه پایانی که نمایش داده شدهاند. یک ظهور برای هر عنصر صفحه پایانی که نمایش داده میشود ثبت میشود.
- end_screen_element_clicks
- تعداد دفعاتی که روی عناصر صفحه پایانی کلیک شده است.
- end_screen_element_click_rate
- نرخ کلیکگذری برای عناصر صفحه پایانی که بهصورت نسبت کلیکهای عنصر صفحه پایانی به ظهورهای عنصر صفحه پایانی محاسبه میشود.
سنجههای لغو عضویت
- membershipsCancellationSurveyResponses
- تعداد نظرسنجیهای تکمیلشده توسط کاربران YouTube که عضویت کانال خود را برای کانال مشخصشده در طول دوره گزارشدهی لغو کردهاند.
سنجههای درآمد تخمینی
توجه: سنجههای درآمد تخمینی مشمول تعدیلهای پایان ماه هستند و شامل تبلیغات فروختهشده توسط شریک و ارائهشده توسط شریک نمیشوند. برای اطلاعات بیشتر و یادداشتهایی درباره ارقام درآمد تخمینی، به مرکز راهنمایی YouTube مراجعه کنید.
- 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
- درآمد ناخالص تخمینی بهازای هر هزار بازپخش.