YouTube Analytics API: Channel Reports

این صفحه گزارش‌هایی را فهرست می‌کند که صاحبان کانال می‌توانند با استفاده از API یوتیوب آنالیتیکس بازیابی کنند. گزارش‌های کانال، معیارهای فعالیت کاربر را برای یک کانال مشخص ارائه می‌دهند و مواردی مانند بازدید ویدیو، رتبه‌بندی و تعداد اشتراک را اندازه‌گیری می‌کنند.

  • گزارش‌های ویدیویی، آماری از تمام فعالیت‌های کاربران مربوط به ویدیوهای یک کانال ارائه می‌دهند.
  • گزارش‌های لیست پخش، آماری را ارائه می‌دهند که به‌طور خاص مربوط به بازدیدهای ویدیویی است که در متن یک لیست پخش رخ می‌دهند.
  • گزارش‌های عملکرد تبلیغات شامل معیارهایی مربوط به درآمد و عملکرد تبلیغات هستند. آن‌ها از بُعد adType برای گروه‌بندی معیارها بر اساس انواع تبلیغاتی که در طول پخش ویدیو اجرا می‌شوند، استفاده می‌کنند. بخش گزارش‌های عملکرد تبلیغات، دو نوع معیار عملکرد تبلیغات را که API پشتیبانی می‌کند، توضیح می‌دهد.

بازیابی یک گزارش

برای بازیابی گزارش کانال، باید مقدار پارامتر ids را در درخواست API خود روی یکی از مقادیر زیر تنظیم کنید:

  • channel==MINE – این API داده‌های مربوط به کانال یوتیوب کاربر احراز هویت شده را برمی‌گرداند.

  • channel== CHANNEL_ID – مقدار CHANNEL_ID را برابر با شناسه کانال منحصر به فرد کانالی که داده‌ها را برای آن بازیابی می‌کنید، قرار دهید. کاربری که درخواست را تأیید می‌کند باید مالک کانال باشد.

    شناسه کانال در حال حاضر رشته‌ای است که با حروف UC شروع می‌شود، اگرچه قالب آن ممکن است تغییر کند. (می‌توانید شناسه کانال خود را در صفحه تنظیمات پیشرفته حساب کاربری کانال یوتیوب خود پیدا کنید، یا می‌توانید شناسه کانال خود را به صورت برنامه‌نویسی شده با استفاده از متد channels.list YouTube Data API's بازیابی کنید.)

مجوز

تمام درخواست‌های API یوتیوب آنالیتیکس باید مجاز باشند. راهنمای مجوزدهی نحوه استفاده از پروتکل OAuth 2.0 برای بازیابی توکن‌های مجوز را توضیح می‌دهد.

درخواست‌های API یوتیوب آنالیتیکس از حوزه‌های مجوز زیر استفاده می‌کنند:

محدوده‌ها
https://www.googleapis.com/auth/yt-analytics.readonly گزارش‌های YouTube Analytics را برای محتوای YouTube خود مشاهده کنید. این دامنه دسترسی به معیارهای فعالیت کاربر، مانند تعداد بازدیدها و تعداد رتبه‌بندی‌ها را فراهم می‌کند.
https://www.googleapis.com/auth/yt-analytics-monetary.readonly گزارش‌های مالی YouTube Analytics را برای محتوای YouTube خود مشاهده کنید. این بخش دسترسی به معیارهای فعالیت کاربر و معیارهای تخمینی درآمد و عملکرد تبلیغات را فراهم می‌کند.
https://www.googleapis.com/auth/youtube حساب یوتیوب خود را مدیریت کنید. در API یوتیوب آنالیتیکس، صاحبان کانال از این محدوده برای مدیریت گروه‌ها و موارد گروهی یوتیوب آنالیتیکس استفاده می‌کنند.
https://www.googleapis.com/auth/youtubepartner مشاهده و مدیریت دارایی‌های یوتیوب و محتوای مرتبط در یوتیوب. در API یوتیوب آنالیتیکس، مالکان محتوا از این حوزه برای مدیریت گروه‌ها و موارد گروهی یوتیوب آنالیتیکس استفاده می‌کنند.

توجه: معیارهای تخمینی درآمد و عملکرد تبلیغات برای گزارش‌های کانال پشتیبانی می‌شوند. برای دسترسی به این معیارها، درخواست شما باید با دامنه https://www.googleapis.com/auth/yt-analytics-monetary.readonly مجاز باشد. علاوه بر این، کانال کاربر احراز هویت شده باید عضو برنامه شریک یوتیوب باشد. درخواست معیارهای پولی برای کانالی که در برنامه شریک یوتیوب نیست، منجر به خطای 403 Forbidden می‌شود.

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

فیلترها

جداولی که گزارش‌های پشتیبانی‌شده را توضیح می‌دهند، فیلترهایی را که می‌توانند برای هر گزارش استفاده شوند، مشخص می‌کنند. در جداول، فیلترهای نشان داده شده در پرانتز اختیاری هستند. به عنوان مثال، برای گزینه فیلتر کردن video(,country) ، فیلتر ویدیو الزامی است و فیلتر کشور اختیاری است.

این API همچنین از قابلیت تعیین چندین مقدار برای فیلترهای video و playlist پشتیبانی می‌کند. اگر چندین مقدار برای یکی از این فیلترها تعیین کنید، می‌توانید آن فیلتر را به لیست ابعادی که برای درخواست مشخص می‌کنید نیز اضافه کنید. این موضوع حتی اگر فیلتر به عنوان یک بعد پشتیبانی شده برای یک گزارش خاص ذکر نشده باشد، صادق است.

برای توضیح کامل نحوه فیلتر کردن نتایج API برای یک مقدار خاص یا مجموعه‌ای از مقادیر، به تعریف پارامتر filters مراجعه کنید.

آشنایی با جداول گزارش

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

فهرست مطالب
ابعاد:
از 0 یا بیشتر استفاده کنید creatorContentType , subscribedStatus , youtubeProduct
از ۰ یا ۱ استفاده کنید day , month
معیارها:
از ۱ یا بیشتر استفاده کنید engagedViews , views , redViews , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration , averageViewPercentage
فیلترها:
از ۰ یا ۱ استفاده کنید country , province , continent , subContinent
از ۰ یا ۱ استفاده کنید video , group
از 0 یا بیشتر استفاده کنید subscribedStatus , youtubeProduct

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

  • dimensions=day
  • dimensions=day,subscribedStatus
  • dimensions=month,subscribedStatus,youtubeProduct
  • dimensions=month,youtubeProduct

با این حال، مقدار پارامتر day,month نامعتبر است زیرا از دو بُعد مبتنی بر زمان استفاده می‌کند و درخواست باید از ۰ یا ۱ استفاده کند.

در حالی که جداول گزارش، ابعاد، معیارها و فیلترهای پشتیبانی‌شده را تعریف می‌کنند، API محدودیت‌های بین پارامتری را اعمال می‌کند. پرس‌وجو از ترکیب‌های پشتیبانی‌نشده یا ناسازگار (مانند ترکیب فیلترهای جغرافیایی ناسازگار یا حذف پارامترهای مورد نیاز) باعث خطای HTTP 400 badRequest با پیام The query is not supported می‌شود. جداول گزارش‌های جداگانه را در این صفحه برای محدودیت‌های خاصی که برای هر گزارش اعمال می‌شود، مرور کنید.

اصطلاحات جدول گزارش

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

  • این اصطلاحات به این معنی است که یک مقدار مورد نیاز است:
    • الزامی: شما باید مقدار را وارد کنید.
    • دقیقاً از عدد ۱ استفاده کنید: شما باید یک مقدار از گروه را وارد کنید.
    • از ۱ یا بیشتر استفاده کنید: می‌توانید هر یا همه مقادیر گروه را وارد کنید، اما حداقل باید یکی را وارد کنید.
  • این اصطلاحات به این معنی است که یک مقدار اختیاری است:
    • اختیاری: شما می‌توانید مقدار را نیز وارد کنید.
    • استفاده از ۰ یا ۱: شما می‌توانید یک مقدار از گروه را اضافه کنید.
    • استفاده از ۰ یا بیشتر: شما می‌توانید هر یا همه مقادیر گروه را در نظر بگیرید.

گزارش‌های ویدیویی

آمار پایه

آمار فعالیت اولیه کاربران

این گزارش، آمار مربوط به اقدامات کاربران در یک کانال را ارائه می‌دهد. می‌توانید گزارش را فیلتر کنید تا فقط داده‌های مربوط به یک ویدیو یا کشور خاص را نشان دهد.

فهرست مطالب
ابعاد:
[هیچکدام]
معیارها:
از ۱ یا بیشتر استفاده کنید engagedViews , views , redViews , comments , likes , dislikes , videosAddedToPlaylists , videosRemovedFromPlaylists , shares , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration , averageViewPercentage , annotationClickThroughRate , annotationCloseRate , annotationImpressions , annotationClickableImpressions , annotationClosableImpressions , annotationClicks , annotationCloses , cardClickRate , cardTeaserClickRate , cardImpressions , cardTeaserImpressions , cardClicks , cardTeaserClicks , subscribersGained , subscribersLost , estimatedRevenue *, estimatedAdRevenue *, grossRevenue *, estimatedRedPartnerRevenue *, monetizedPlaybacks *, playbackBasedCpm *, adImpressions *, cpm *
فیلترها:
از ۰ یا ۱ استفاده کنید country , continent , subContinent
از ۰ یا ۱ استفاده کنید video , group

آمار اولیه فعالیت کاربران برای ایالت‌های آمریکا

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

فهرست مطالب
ابعاد:
[هیچکدام]
معیارها:
از ۱ یا بیشتر استفاده کنید engagedViews , views , redViews , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration , averageViewPercentage , annotationClickThroughRate , annotationCloseRate , annotationImpressions , annotationClickableImpressions , annotationClosableImpressions , annotationClicks , annotationCloses , cardClickRate , cardTeaserClickRate , cardImpressions , cardTeaserImpressions , cardClicks , cardTeaserClicks
فیلترها:
مورد نیاز province
از ۰ یا ۱ استفاده کنید video , group

مبتنی بر زمان

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

این گزارش، آمار مربوط به اقدامات کاربران در یک کانال را برای فواصل زمانی خاص ارائه می‌دهد. می‌توانید گزارش را فیلتر کنید تا فقط داده‌های مربوط به یک ویدیو یا کشور خاص را نشان دهد.

فهرست مطالب
ابعاد:
دقیقاً از ۱ استفاده کنید day , month
اختیاری creatorContentType
معیارها:
از ۱ یا بیشتر استفاده کنید engagedViews , views , redViews , comments , likes , dislikes , videosAddedToPlaylists , videosRemovedFromPlaylists , shares , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration , averageViewPercentage , annotationClickThroughRate , annotationCloseRate , annotationImpressions , annotationClickableImpressions , annotationClosableImpressions , annotationClicks , annotationCloses , cardClickRate , cardTeaserClickRate , cardImpressions , cardTeaserImpressions , cardClicks , cardTeaserClicks , subscribersGained , subscribersLost , uniques , estimatedRevenue *, estimatedAdRevenue *, grossRevenue *, estimatedRedPartnerRevenue *, monetizedPlaybacks *, playbackBasedCpm *, adImpressions *, cpm *
فیلترها:
از ۰ یا ۱ استفاده کنید country , continent , subContinent
از ۰ یا ۱ استفاده کنید video , group

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

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

فهرست مطالب
ابعاد:
دقیقاً از ۱ استفاده کنید day , month
اختیاری creatorContentType
معیارها:
از ۱ یا بیشتر استفاده کنید engagedViews , views , redViews , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration , averageViewPercentage , annotationClickThroughRate , annotationCloseRate , annotationImpressions , annotationClickableImpressions , annotationClosableImpressions , annotationClicks , annotationCloses , cardClickRate , cardTeaserClickRate , cardImpressions , cardTeaserImpressions , cardClicks , cardTeaserClicks
فیلترها:
مورد نیاز province
از ۰ یا ۱ استفاده کنید video , group

جغرافیای کاربر

فعالیت کاربران بر اساس کشور

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

فهرست مطالب
ابعاد:
مورد نیاز country
اختیاری creatorContentType
معیارها:
از ۱ یا بیشتر استفاده کنید engagedViews , views , redViews , comments , likes , dislikes , videosAddedToPlaylists , videosRemovedFromPlaylists , shares , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration , averageViewPercentage , annotationClickThroughRate , annotationCloseRate , annotationImpressions , annotationClickableImpressions , annotationClosableImpressions , annotationClicks , annotationCloses , cardClickRate , cardTeaserClickRate , cardImpressions , cardTeaserImpressions , cardClicks , cardTeaserClicks , subscribersGained , subscribersLost , estimatedRevenue *, estimatedAdRevenue *, grossRevenue *, estimatedRedPartnerRevenue *, monetizedPlaybacks *, playbackBasedCpm *, adImpressions *, cpm *
فیلترها:
از ۰ یا ۱ استفاده کنید continent , subContinent
از ۰ یا ۱ استفاده کنید video , group

فعالیت کاربران بر اساس استان

این گزارش آمار فعالیت کاربران را برای ایالت‌های آمریکا و ناحیه کلمبیا ارائه می‌دهد. برای این گزارش، باید مقدار پارامتر filters را روی country==US تنظیم کنید.

فهرست مطالب
ابعاد:
مورد نیاز province
اختیاری creatorContentType
معیارها:
از ۱ یا بیشتر استفاده کنید engagedViews , views , redViews , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration , averageViewPercentage , annotationClickThroughRate , annotationCloseRate , annotationImpressions , annotationClickableImpressions , annotationClosableImpressions , annotationClicks , annotationCloses , cardClickRate , cardTeaserClickRate , cardImpressions , cardTeaserImpressions , cardClicks , cardTeaserClicks
فیلترها:
مورد نیاز country ==US
از ۰ یا ۱ استفاده کنید video , group

فعالیت کاربران بر اساس شهر (<= 250 نتیجه)

نکته: این گزارش از شما می‌خواهد که پارامتر maxResults را روی یک مقدار صحیح 250 یا کمتر تنظیم کنید. برخلاف اکثر گزارش‌های دیگر، این گزارش همچنین از شما می‌خواهد که مقداری را برای پارامتر درخواست sort مشخص کنید.

این گزارش آمار فعالیت کاربران را بر اساس شهر ارائه می‌دهد.

فهرست مطالب
ابعاد:
مورد نیاز city
از 0 یا بیشتر استفاده کنید creatorContentType , country , province , subscribedStatus

Note: If you include the province dimension, you must also use the country ==US filter.
از ۰ یا ۱ استفاده کنید day , month
معیارها:
از ۱ یا بیشتر استفاده کنید engagedViews , views , estimatedMinutesWatched , averageViewDuration , averageViewPercentage
فیلترها:
از ۰ یا ۱ استفاده کنید country , province , continent , subContinent
از ۰ یا ۱ استفاده کنید video , group
گزینه‌های مرتب‌سازی: - views
- estimatedMinutesWatched

فعالیت کاربر بر اساس DMA

این گزارش آمار فعالیت کاربران را بر اساس منطقه بازار تعیین‌شده (DMA) ارائه می‌دهد. برای این گزارش، باید مقدار پارامتر filters را روی country==US تنظیم کنید یا فیلتر را روی یک استان خاص (ایالت ایالات متحده) تنظیم کنید.

فهرست مطالب
ابعاد:
مورد نیاز dma
از ۰ یا ۱ استفاده کنید day
month
creatorContentType
subscribedStatus
معیارها:
از ۱ یا بیشتر استفاده کنید engagedViews
views
estimatedMinutesWatched
averageViewDuration
averageViewPercentage
فیلترها:
از ۰ یا ۱ استفاده کنید country ==US
province
از ۰ یا ۱ استفاده کنید video
group
گزینه‌های مرتب‌سازی: - views
- estimatedMinutesWatched

جزئیات پخش

گزارش‌های جزئیات پخش، آماری مربوط به ویژگی‌های مشاهده زیر را ارائه می‌دهند:

  • آیا این نمایش، پخش زنده ویدیو بود یا یک ویدیوی درخواستی؟
  • آیا بیننده در کانالی که صاحب ویدیو است مشترک شده است؟
  • این بازدید در کدام محصول یوتیوب رخ داده است؟

نکته: بُعد و فیلتر liveOrOnDemand را نمی‌توان همراه با معیار averageViewPercentage استفاده کرد. به همین دلیل، هر یک از زیربخش‌های زیر دو گزارش را فهرست می‌کنند. یک گزارش از بُعد (و فیلتر) liveOrOnDemand پشتیبانی می‌کند، در حالی که گزارش دیگر از معیار averageViewPercentage پشتیبانی می‌کند.

فعالیت کاربر بر اساس وضعیت اشتراک

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

فهرست مطالب
ابعاد:
از 0 یا بیشتر استفاده کنید creatorContentType , subscribedStatus
از ۰ یا ۱ استفاده کنید day , month
معیارها:
از ۱ یا بیشتر استفاده کنید engagedViews , views , redViews , likes , dislikes , videosAddedToPlaylists , videosRemovedFromPlaylists , shares , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration , averageViewPercentage , annotationClickThroughRate , annotationCloseRate , annotationImpressions , annotationClickableImpressions , annotationClosableImpressions , annotationClicks , annotationCloses , cardClickRate , cardTeaserClickRate , cardImpressions , cardTeaserImpressions , cardClicks , cardTeaserClicks
فیلترها:
از ۰ یا ۱ استفاده کنید country , continent , subContinent
از ۰ یا ۱ استفاده کنید video , group
اختیاری subscribedStatus

فعالیت کاربر بر اساس وضعیت اشتراک برای استان‌ها

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

فهرست مطالب
ابعاد:
از 0 یا بیشتر استفاده کنید creatorContentType , subscribedStatus
از ۰ یا ۱ استفاده کنید day , month
معیارها:
از ۱ یا بیشتر استفاده کنید engagedViews , views , redViews , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration , averageViewPercentage , annotationClickThroughRate , annotationCloseRate , annotationImpressions , annotationClickableImpressions , annotationClosableImpressions , annotationClicks , annotationCloses , cardClickRate , cardTeaserClickRate , cardImpressions , cardTeaserImpressions , cardClicks , cardTeaserClicks
فیلترها:
از ۰ یا ۱ استفاده کنید video , group
از 0 یا بیشتر استفاده کنید province , subscribedStatus

جزئیات پخش با بُعد زمانی اختیاری

بُعد زمانی - روز یا ماه - برای این گزارش‌ها اختیاری است، زیرا صرف نظر از آن، شما باید از پارامترهای درخواست startDate و endDate برای مشخص کردن محدوده تاریخی که گزارش پوشش خواهد داد، استفاده کنید. این بُعد، در صورت وجود، نشان می‌دهد که می‌خواهید داده‌های گزارش بر اساس روز، ماه و غیره جمع‌آوری شوند.

جزئیات پخش با بُعد زمانی اختیاری و آمار liveOrOnDemand

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

فهرست مطالب
ابعاد:
از 0 یا بیشتر استفاده کنید creatorContentType , liveOrOnDemand , subscribedStatus , youtubeProduct
از ۰ یا ۱ استفاده کنید day , month
معیارها:
از ۱ یا بیشتر استفاده کنید engagedViews , views , redViews , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration
فیلترها:
از ۰ یا ۱ استفاده کنید country , province , continent , subContinent
از ۰ یا ۱ استفاده کنید video , group
از 0 یا بیشتر استفاده کنید liveOrOnDemand , subscribedStatus , youtubeProduct
جزئیات پخش با بُعد زمانی اختیاری و معیار averageViewPercentage

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

فهرست مطالب
ابعاد:
از 0 یا بیشتر استفاده کنید creatorContentType , subscribedStatus , youtubeProduct
از ۰ یا ۱ استفاده کنید day , month
معیارها:
از ۱ یا بیشتر استفاده کنید engagedViews , views , redViews , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration , averageViewPercentage
فیلترها:
از ۰ یا ۱ استفاده کنید country , province , continent , subContinent
از ۰ یا ۱ استفاده کنید video , group
از 0 یا بیشتر استفاده کنید subscribedStatus , youtubeProduct

جزئیات پخش بر اساس کشور

جزئیات پخش بر اساس کشور با آمار liveOrOnDemand

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

فهرست مطالب
ابعاد:
مورد نیاز country
از 0 یا بیشتر استفاده کنید creatorContentType , liveOrOnDemand , subscribedStatus , youtubeProduct
معیارها:
از ۱ یا بیشتر استفاده کنید engagedViews , views , redViews , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration
فیلترها:
از ۰ یا ۱ استفاده کنید continent , subContinent
از ۰ یا ۱ استفاده کنید video , group
از 0 یا بیشتر استفاده کنید liveOrOnDemand , subscribedStatus , youtubeProduct
جزئیات پخش بر اساس کشور با معیار averageViewPercentage

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

فهرست مطالب
ابعاد:
مورد نیاز country
از 0 یا بیشتر استفاده کنید creatorContentType , subscribedStatus , youtubeProduct
معیارها:
از ۱ یا بیشتر استفاده کنید engagedViews , views , redViews , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration , averageViewPercentage
فیلترها:
از ۰ یا ۱ استفاده کنید continent , subContinent
از ۰ یا ۱ استفاده کنید video , group
از 0 یا بیشتر استفاده کنید subscribedStatus , youtubeProduct

جزئیات پخش بر اساس استان

جزئیات پخش بر اساس استان با آمار liveOrOnDemand

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

فهرست مطالب
ابعاد:
مورد نیاز province
از 0 یا بیشتر استفاده کنید creatorContentType , liveOrOnDemand , subscribedStatus , youtubeProduct
معیارها:
از ۱ یا بیشتر استفاده کنید engagedViews , views , redViews , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration
فیلترها:
مورد نیاز country ==US
از ۰ یا ۱ استفاده کنید video , group
از 0 یا بیشتر استفاده کنید liveOrOnDemand , subscribedStatus , youtubeProduct
جزئیات پخش بر اساس استان با معیار میانگین مشاهده درصد

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

فهرست مطالب
ابعاد:
مورد نیاز province
از 0 یا بیشتر استفاده کنید creatorContentType , subscribedStatus , youtubeProduct
معیارها:
از ۱ یا بیشتر استفاده کنید engagedViews , views , redViews , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration , averageViewPercentage
فیلترها:
مورد نیاز country ==US
از ۰ یا ۱ استفاده کنید video , group
از 0 یا بیشتر استفاده کنید subscribedStatus , youtubeProduct

مکان‌های پخش

گزارش موقعیت مکانی پخش ویدیو

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

فهرست مطالب
ابعاد:
مورد نیاز insightPlaybackLocationType
از 0 یا بیشتر استفاده کنید creatorContentType , day , liveOrOnDemand , subscribedStatus
معیارها:
از ۱ یا بیشتر استفاده کنید engagedViews , views , estimatedMinutesWatched
فیلترها:
از ۰ یا ۱ استفاده کنید country , province , continent , subContinent
از ۰ یا ۱ استفاده کنید video , group
از 0 یا بیشتر استفاده کنید liveOrOnDemand , subscribedStatus

جزئیات مکان پخش (<= 25 نتیجه)

نکته: این گزارش از شما می‌خواهد که پارامتر maxResults را روی یک مقدار صحیح 25 یا کمتر تنظیم کنید. برخلاف اکثر گزارش‌های دیگر، این گزارش همچنین از شما می‌خواهد که مقداری را برای پارامتر درخواست sort مشخص کنید.

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

فهرست مطالب
ابعاد:
مورد نیاز insightPlaybackLocationDetail
اختیاری creatorContentType
معیارها:
از ۱ یا بیشتر استفاده کنید engagedViews , views , estimatedMinutesWatched
فیلترها:
مورد نیاز insightPlaybackLocationType ==EMBEDDED
از ۰ یا ۱ استفاده کنید country , province , continent , subContinent
از ۰ یا ۱ استفاده کنید video , group
از 0 یا بیشتر استفاده کنید liveOrOnDemand , subscribedStatus
گزینه‌های مرتب‌سازی: - views
- estimatedMinutesWatched

منابع ترافیک

منبع ترافیک

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

توجه: اگر حاصلضرب تعداد ویدیوهای درخواست‌شده در X تعداد روز در محدوده تاریخ از ۵۰۰۰۰ بیشتر شود، این گزارش خطا می‌دهد. برای مثال، یک پرس‌وجو که داده‌های ۵۰۰ شناسه ویدیو را بازیابی می‌کند، می‌تواند حداکثر برای ۱۰۰ روز داده درخواست کند. برای کاهش تعداد ردیف‌هایی که یک درخواست برمی‌گرداند، پرس‌وجوی خود را به چندین پرس‌وجو تقسیم کنید که ویدیوهای کمتری را مشخص می‌کنند یا محدوده‌های تاریخ کوتاه‌تری را تنظیم می‌کنند.

فهرست مطالب
ابعاد:
مورد نیاز insightTrafficSourceType
از 0 یا بیشتر استفاده کنید creatorContentType , day , liveOrOnDemand , subscribedStatus
معیارها:
از ۱ یا بیشتر استفاده کنید engagedViews , views , estimatedMinutesWatched
فیلترها:
از ۰ یا ۱ استفاده کنید country , province , continent , subContinent
از ۰ یا ۱ استفاده کنید video , group
از 0 یا بیشتر استفاده کنید liveOrOnDemand , subscribedStatus

جزئیات منبع ترافیک (<= 25 نتیجه)

نکته: این گزارش از شما می‌خواهد که پارامتر maxResults را روی یک مقدار صحیح 25 یا کمتر تنظیم کنید. برخلاف اکثر گزارش‌های دیگر، این گزارش همچنین از شما می‌خواهد که مقداری را برای پارامتر درخواست sort مشخص کنید.

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

فهرست مطالب
ابعاد:
مورد نیاز insightTrafficSourceDetail
اختیاری creatorContentType
معیارها:
از ۱ یا بیشتر استفاده کنید engagedViews , views , estimatedMinutesWatched
فیلترها:
مورد نیاز insightTrafficSourceType (see note below table)
از ۰ یا ۱ استفاده کنید country , province , continent , subContinent
از ۰ یا ۱ استفاده کنید video , group
از 0 یا بیشتر استفاده کنید liveOrOnDemand , subscribedStatus
گزینه‌های مرتب‌سازی: - views
- estimatedMinutesWatched

توجه: این گزارش فقط برای منابع ترافیکی خاص پشتیبانی می‌شود. منابع ترافیکی VIDEO_REMIXES ، NOTIFICATION ، END_SCREEN ، CAMPAIGN_CARD ، VIDEO_REMIXES و NO_LINK_EMBEDDED برخی از مواردی هستند که پشتیبانی نمی‌شوند.

نوع دستگاه و سیستم عامل

نوع دستگاه

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

فهرست مطالب
ابعاد:
مورد نیاز deviceType
از 0 یا بیشتر استفاده کنید creatorContentType , day , liveOrOnDemand , subscribedStatus , youtubeProduct
معیارها:
از ۱ یا بیشتر استفاده کنید engagedViews , views , estimatedMinutesWatched
فیلترها:
از ۰ یا ۱ استفاده کنید country , province , continent , subContinent
از ۰ یا ۱ استفاده کنید video , group
از 0 یا بیشتر استفاده کنید operatingSystem , liveOrOnDemand , subscribedStatus , youtubeProduct

سیستم عامل

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

فهرست مطالب
ابعاد:
مورد نیاز operatingSystem
از 0 یا بیشتر استفاده کنید creatorContentType , day , liveOrOnDemand , subscribedStatus , youtubeProduct
معیارها:
از ۱ یا بیشتر استفاده کنید engagedViews , views , estimatedMinutesWatched
فیلترها:
از ۰ یا ۱ استفاده کنید country , province , continent , subContinent
از ۰ یا ۱ استفاده کنید video , group
از 0 یا بیشتر استفاده کنید deviceType , liveOrOnDemand , subscribedStatus , youtubeProduct

سیستم عامل و نوع دستگاه

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

فهرست مطالب
ابعاد:
مورد نیاز deviceType , operatingSystem
از 0 یا بیشتر استفاده کنید creatorContentType , day , liveOrOnDemand , subscribedStatus , youtubeProduct
معیارها:
از ۱ یا بیشتر استفاده کنید engagedViews , views , estimatedMinutesWatched
فیلترها:
از ۰ یا ۱ استفاده کنید country , province , continent , subContinent
از ۰ یا ۱ استفاده کنید video , group
از 0 یا بیشتر استفاده کنید liveOrOnDemand , subscribedStatus , youtubeProduct

آمار جمعیتی بینندگان

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

فهرست مطالب
ابعاد:
از ۱ یا بیشتر استفاده کنید ageGroup , gender
از 0 یا بیشتر استفاده کنید creatorContentType , liveOrOnDemand , subscribedStatus
معیارها:
از ۱ یا بیشتر استفاده کنید viewerPercentage
فیلترها:
از ۰ یا ۱ استفاده کنید country , province , continent , subContinent
از ۰ یا ۱ استفاده کنید video , group
از 0 یا بیشتر استفاده کنید liveOrOnDemand , subscribedStatus
توجه: مقادیر viewerPercentage در این گزارش برای مقادیر مختلف یا ترکیبی از مقادیر برای ابعاد جزئیات پخش ( subscribedStatus ، liveOrOnDemand یا youtubeProduct ) نرمال‌سازی نشده‌اند.

برای مثال، گزارشی که از بُعد subscribedStatus استفاده می‌کند، داده‌های viewerPercentage را با مجموع ۱۰۰ درصد برای نماهای مشترک و داده‌های viewerPercentage را با مجموع ۱۰۰ درصد برای نماهای لغو اشتراک بازمی‌گرداند. (مقدار کل همه فیلدهای viewerPercentage در گزارش ۲۰۰ درصد است.)

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

تعامل و اشتراک‌گذاری محتوا

این گزارش آماری را ارائه می‌دهد که نشان می‌دهد ویدیوهای این کانال چند وقت یکبار در پلتفرم‌های اجتماعی مختلف به اشتراک گذاشته شده‌اند.

فهرست مطالب
ابعاد:
مورد نیاز sharingService
از 0 یا بیشتر استفاده کنید creatorContentType , subscribedStatus
معیارها:
از ۱ یا بیشتر استفاده کنید shares
فیلترها:
از ۰ یا ۱ استفاده کنید country , continent , subContinent
از ۰ یا ۱ استفاده کنید video , group
اختیاری subscribedStatus

حفظ مخاطب

این گزارش توانایی یک ویدیو در حفظ مخاطب خود را اندازه‌گیری می‌کند و همچنین نشان می‌دهد که بخش‌های خاصی از یک ویدیو چند بار تماشا شده‌اند. بُعد elapsedVideoTimeRatio میزان زمانی که ویدیو برای مقادیر معیار مربوطه سپری شده است را اندازه‌گیری می‌کند. معیارها را می‌توان به دو دسته تقسیم کرد:

  • حفظ مخاطب

    این معیارها نشان می‌دهند که ویدیو چقدر خوب مخاطبان خود را حفظ می‌کند.

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

    این معیارها اطلاعاتی در مورد اینکه بخش‌های خاصی از یک ویدیو چند وقت یکبار تماشا شده‌اند، ارائه می‌دهند.

    • startedWatching نشان می‌دهد که بینندگان چند وقت یکبار در طول یک بخش خاص از ویدیو، شروع به تماشای آن کرده‌اند.
    • stoppedWatching نشان می‌دهد که بینندگان چند بار در طول یک بخش خاص از ویدیو، تماشای آن را متوقف کرده‌اند.
    • totalSegmentImpressions نشان می‌دهد که یک بخش خاص از ویدیو چند بار مشاهده شده است.

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

فهرست مطالب
ابعاد:
مورد نیاز elapsedVideoTimeRatio
معیارها:
از ۱ یا بیشتر استفاده کنید audienceWatchRatio
relativeRetentionPerformance
startedWatching
stoppedWatching
totalSegmentImpressions
فیلترها:
مورد نیاز video
از 0 یا بیشتر استفاده کنید audienceType
subscribedStatus
youtubeProduct

بینندگان همزمان (برای پخش زنده)

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

فهرست مطالب
ابعاد:
از ۰ یا ۱ استفاده کنید livestreamPosition
معیارها:
از ۱ یا بیشتر استفاده کنید averageConcurrentViewers
peakConcurrentViewers
فیلترها:
مورد نیاز video

ویدیوهای برتر

توجه: این گزارش‌ها از شما می‌خواهند که پارامتر maxResults را روی یک مقدار صحیح 200 یا کمتر تنظیم کنید. قبل از ۱ ژانویه ۲۰۱۳، داده‌ها فقط برای ۱۰ ویدیوی برتر در دسترس هستند. برخلاف اکثر گزارش‌های دیگر، این گزارش‌ها همچنین از شما می‌خواهند که مقداری را برای پارامتر درخواست sort مشخص کنید.

ویدیوهای برتر با فیلترهای منطقه‌ای اختیاری (<= 200 نتیجه)

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

فهرست مطالب
ابعاد:
مورد نیاز video
اختیاری creatorContentType
معیارها:
از ۱ یا بیشتر استفاده کنید engagedViews , views , redViews , comments , likes , dislikes , videosAddedToPlaylists , videosRemovedFromPlaylists , shares , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration , averageViewPercentage , annotationClickThroughRate , annotationCloseRate , annotationImpressions , annotationClickableImpressions , annotationClosableImpressions , annotationClicks , annotationCloses , cardClickRate , cardTeaserClickRate , cardImpressions , cardTeaserImpressions , cardClicks , cardTeaserClicks , subscribersGained , subscribersLost , estimatedRevenue *, estimatedAdRevenue *, grossRevenue *, estimatedRedPartnerRevenue *, monetizedPlaybacks *, playbackBasedCpm *, adImpressions *, cpm *
فیلترها:
از ۰ یا ۱ استفاده کنید country , continent , subContinent
گزینه‌های مرتب‌سازی: - views
- redViews
- estimatedRevenue
- estimatedRedPartnerRevenue
- estimatedMinutesWatched
- estimatedRedMinutesWatched
- subscribersGained
- subscribersLost

ویدیوهای برتر بر اساس ایالت (<= 200 نتیجه)

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

فهرست مطالب
ابعاد:
مورد نیاز video
اختیاری creatorContentType
معیارها:
از ۱ یا بیشتر استفاده کنید engagedViews , views , redViews , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration , averageViewPercentage , annotationClickThroughRate , annotationCloseRate , annotationImpressions , annotationClickableImpressions , annotationClosableImpressions , annotationClicks , annotationCloses , cardClickRate , cardTeaserClickRate , cardImpressions , cardTeaserImpressions , cardClicks , cardTeaserClicks
فیلترها:
مورد نیاز province
اختیاری subscribedStatus
گزینه‌های مرتب‌سازی: - views
- redViews
- estimatedMinutesWatched
- estimatedRedMinutesWatched

ویدیوهای برتر برای بینندگان مشترک یا لغو اشتراک (<= 200 نتیجه)

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

فهرست مطالب
ابعاد:
مورد نیاز video
اختیاری creatorContentType
معیارها:
از ۱ یا بیشتر استفاده کنید engagedViews , views , redViews , likes , dislikes , videosAddedToPlaylists , videosRemovedFromPlaylists , shares , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration , averageViewPercentage , annotationClickThroughRate , annotationCloseRate , annotationImpressions , annotationClickableImpressions , annotationClosableImpressions , annotationClicks , annotationCloses , cardClickRate , cardTeaserClickRate , cardImpressions , cardTeaserImpressions , cardClicks , cardTeaserClicks
فیلترها:
اختیاری subscribedStatus
از ۰ یا ۱ استفاده کنید country , continent , subContinent
گزینه‌های مرتب‌سازی: - views
- redViews
- estimatedMinutesWatched
- estimatedRedMinutesWatched

ویدیوهای برتر بر اساس محصول یوتیوب (<= 200 نتیجه)

این گزارش، ویدیوهای برتر کانال را فهرست می‌کند و از جزئیات پخش و فیلترهای جغرافیایی پشتیبانی می‌کند. این گزارش مشابه گزارش قبلی است، اما از معیارهای کمتری پشتیبانی می‌کند و پشتیبانی از فیلتر youtubeProduct را نیز اضافه کرده است.

فهرست مطالب
ابعاد:
مورد نیاز video
اختیاری creatorContentType
معیارها:
از ۱ یا بیشتر استفاده کنید engagedViews , views , redViews , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration , averageViewPercentage
فیلترها:
از ۰ یا ۱ استفاده کنید country , province , continent , subContinent
از 0 یا بیشتر استفاده کنید subscribedStatus , youtubeProduct
گزینه‌های مرتب‌سازی: - views
- redViews
- estimatedMinutesWatched
- estimatedRedMinutesWatched

ویدیوهای برتر با فیلترهای جزئیات پخش (<= 200 نتیجه)

این گزارش، ویدیوهای برتر کانال را فهرست می‌کند و بر اساس هر یا همه ابعاد جزئیات پخش فیلتر می‌شود: liveOrOnDemand ، subscribedStatus و youtubeProduct . برخلاف گزارش قبلی، این گزارش از فیلتر liveOrOnDemand پشتیبانی می‌کند و از معیار averageViewPercentage پشتیبانی نمی‌کند.

فهرست مطالب
ابعاد:
مورد نیاز video
اختیاری creatorContentType
معیارها:
از ۱ یا بیشتر استفاده کنید engagedViews , views , redViews , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration
فیلترها:
از ۰ یا ۱ استفاده کنید country , province , continent , subContinent
از 0 یا بیشتر استفاده کنید liveOrOnDemand , subscribedStatus , youtubeProduct
گزینه‌های مرتب‌سازی: - views
- redViews
- estimatedMinutesWatched
- estimatedRedMinutesWatched

گزارش‌های لیست پخش

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

معیارهای ویدیویی تجمیع‌شده

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

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

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

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

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

فهرست مطالب
معیارهای ویدیویی تجمیع‌شده بازدیدهای فعال ، بازدیدها ، دقایق تخمینی مشاهده شده ، میانگین مدت زمان مشاهده
معیارهای درون لیست پخش playlistViews ، playlistEstimatedMinutesWatched ، playlistAverageViewDuration ، playlistSaves ، playlistStarts ، viewsPerPlaylistStart ، averageTimeInPlaylist

آمار پایه

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

فهرست مطالب
ابعاد:
[هیچکدام]
معیارها:
از ۱ یا بیشتر استفاده کنید engagedViews , views , estimatedMinutesWatched , averageViewDuration , averageTimeInPlaylist , playlistAverageViewDuration , playlistEstimatedMinutesWatched , playlistSaves , playlistStarts , playlistViews , viewsPerPlaylistStart
فیلترها:
دقیقاً از ۱ استفاده کنید playlist , group

مبتنی بر زمان

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

فهرست مطالب
ابعاد:
دقیقاً از ۱ استفاده کنید day , month
معیارها:
از ۱ یا بیشتر استفاده کنید engagedViews , views , estimatedMinutesWatched , averageViewDuration , averageTimeInPlaylist , playlistAverageViewDuration , playlistEstimatedMinutesWatched , playlistSaves , playlistStarts , playlistViews , viewsPerPlaylistStart
فیلترها:
دقیقاً از ۱ استفاده کنید playlist , group

جغرافیای کاربر

فعالیت لیست پخش بر اساس کشور

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

فهرست مطالب
ابعاد:
مورد نیاز country
معیارها:
از ۱ یا بیشتر استفاده کنید engagedViews , views , estimatedMinutesWatched , averageViewDuration
فیلترها:
دقیقاً از ۱ استفاده کنید playlist , group
از ۰ یا ۱ استفاده کنید continent , subContinent

فعالیت لیست پخش بر اساس استان

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

فهرست مطالب
ابعاد:
مورد نیاز province
معیارها:
از ۱ یا بیشتر استفاده کنید engagedViews , views , estimatedMinutesWatched , averageViewDuration
فیلترها:
مورد نیاز country ==US
دقیقاً از ۱ استفاده کنید playlist , group

مکان‌های پخش

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

فهرست مطالب
ابعاد:
مورد نیاز insightPlaybackLocationType
معیارها:
از ۱ یا بیشتر استفاده کنید engagedViews , views , estimatedMinutesWatched , averageViewDuration , averageTimeInPlaylist , playlistAverageViewDuration , playlistEstimatedMinutesWatched , playlistStarts , playlistViews , viewsPerPlaylistStart
فیلترها:
دقیقاً از ۱ استفاده کنید playlist , group

جزئیات مکان پخش (<= 25 نتیجه)

نکته: این گزارش از شما می‌خواهد که پارامتر maxResults را روی یک مقدار صحیح 25 یا کمتر تنظیم کنید. برخلاف اکثر گزارش‌های دیگر، این گزارش همچنین از شما می‌خواهد که مقداری را برای پارامتر درخواست sort مشخص کنید.

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

فهرست مطالب
ابعاد:
مورد نیاز insightPlaybackLocationDetail
معیارها:
از ۱ یا بیشتر استفاده کنید engagedViews , views , estimatedMinutesWatched , averageViewDuration , averageTimeInPlaylist , playlistAverageViewDuration , playlistEstimatedMinutesWatched , playlistStarts , playlistViews , viewsPerPlaylistStart
فیلترها:
مورد نیاز insightPlaybackLocationType ==EMBEDDED
دقیقاً از ۱ استفاده کنید playlist , group
گزینه‌های مرتب‌سازی: - playlistViews
- playlistEstimatedMinutesWatched
- playlistStarts

منابع ترافیک

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

فهرست مطالب
ابعاد:
مورد نیاز insightTrafficSourceType
معیارها:
از ۱ یا بیشتر استفاده کنید engagedViews , views , estimatedMinutesWatched , averageViewDuration , averageTimeInPlaylist , playlistAverageViewDuration , playlistEstimatedMinutesWatched , playlistSaves , playlistStarts , playlistViews , viewsPerPlaylistStart
فیلترها:
دقیقاً از ۱ استفاده کنید playlist , group

جزئیات منبع ترافیک (<= 25 نتیجه)

نکته: این گزارش از شما می‌خواهد که پارامتر maxResults را روی یک مقدار صحیح 25 یا کمتر تنظیم کنید. برخلاف اکثر گزارش‌های دیگر، این گزارش همچنین از شما می‌خواهد که مقداری را برای پارامتر درخواست sort مشخص کنید.

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

برای مثال، اگر فیلتر insightTrafficSourceType را روی ADVERTISING تنظیم کنید، گزارش انواع تبلیغاتی را که بیشترین بازدید یا زمان مشاهده را برای لیست‌های پخش کانال ایجاد کرده‌اند، فهرست می‌کند.

فهرست مطالب
ابعاد:
مورد نیاز insightTrafficSourceDetail
معیارها:
از ۱ یا بیشتر استفاده کنید engagedViews , views , estimatedMinutesWatched , averageViewDuration , averageTimeInPlaylist , playlistAverageViewDuration , playlistEstimatedMinutesWatched , playlistSaves , playlistStarts , playlistViews , viewsPerPlaylistStart
فیلترها:
مورد نیاز insightTrafficSourceType ==ADVERTISING (or another supported value)
دقیقاً از ۱ استفاده کنید playlist , group
گزینه‌های مرتب‌سازی: - playlistViews
- playlistEstimatedMinutesWatched
- playlistStarts

توجه: این گزارش فقط برای منابع ترافیکی خاص پشتیبانی می‌شود. منابع ترافیکی VIDEO_REMIXES ، NOTIFICATION ، END_SCREEN ، CAMPAIGN_CARD ، VIDEO_REMIXES و NO_LINK_EMBEDDED برخی از مواردی هستند که پشتیبانی نمی‌شوند.

نوع دستگاه و سیستم عامل

نوع دستگاه

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

فهرست مطالب
ابعاد:
مورد نیاز deviceType
معیارها:
از ۱ یا بیشتر استفاده کنید engagedViews , views , estimatedMinutesWatched , averageViewDuration , averageTimeInPlaylist , playlistAverageViewDuration , playlistEstimatedMinutesWatched , playlistStarts , playlistViews , viewsPerPlaylistStart
فیلترها:
دقیقاً از ۱ استفاده کنید playlist , group

سیستم عامل

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

فهرست مطالب
ابعاد:
مورد نیاز operatingSystem
معیارها:
از ۱ یا بیشتر استفاده کنید engagedViews , views , estimatedMinutesWatched , averageViewDuration , averageTimeInPlaylist , playlistAverageViewDuration , playlistEstimatedMinutesWatched , playlistStarts , playlistViews , viewsPerPlaylistStart
فیلترها:
دقیقاً از ۱ استفاده کنید playlist , group

سیستم عامل و نوع دستگاه

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

فهرست مطالب
ابعاد:
مورد نیاز deviceType , operatingSystem
معیارها:
از ۱ یا بیشتر استفاده کنید engagedViews , views , estimatedMinutesWatched , averageViewDuration , averageTimeInPlaylist , playlistAverageViewDuration , playlistEstimatedMinutesWatched , playlistStarts , playlistViews , viewsPerPlaylistStart
فیلترها:
دقیقاً از ۱ استفاده کنید playlist , group

آمار جمعیتی بینندگان

فهرست مطالب
ابعاد:
از ۱ یا بیشتر استفاده کنید ageGroup , gender
معیارها:
مورد نیاز viewerPercentage
فیلترها:
دقیقاً از ۱ استفاده کنید playlist , group

برترین لیست‌های پخش

توجه: این گزارش‌ها از شما می‌خواهند که پارامتر maxResults را روی یک مقدار صحیح 200 یا کمتر تنظیم کنید. قبل از ۱ ژانویه ۲۰۱۳، داده‌ها فقط برای ۱۰ لیست پخش برتر در دسترس هستند. برخلاف اکثر گزارش‌های دیگر، این گزارش‌ها همچنین از شما می‌خواهند که مقداری را برای پارامتر درخواست sort مشخص کنید.

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

فهرست مطالب
ابعاد:
مورد نیاز playlist
معیارها:
از ۱ یا بیشتر استفاده کنید averageTimeInPlaylist , playlistAverageViewDuration , playlistEstimatedMinutesWatched , playlistSaves , playlistStarts , playlistViews , viewsPerPlaylistStart
گزینه‌های مرتب‌سازی: - playlistViews
- playlistEstimatedMinutesWatched
- playlistStarts

گزارش‌های عضویت

لغو عضویت

این گزارش آماری ارائه می‌دهد که نشان می‌دهد چرا کاربران عضویت خود در کانال را لغو کرده‌اند.

فهرست مطالب
ابعاد:
از ۰ یا ۱ استفاده کنید membershipsCancellationSurveyReason
معیارها:
مورد نیاز membershipsCancellationSurveyResponses

گزارش‌های عملکرد تبلیغات

توجه: گزارش‌های عملکرد تبلیغات نیاز به یک توکن مجوز دارند که دسترسی به محدوده https://www.googleapis.com/auth/yt-analytics-monetary.readonly را اعطا می‌کند.

گزارش‌های عملکرد تبلیغات، معیارهای مبتنی بر تعداد نمایش تبلیغات را برای تبلیغاتی که در حین پخش ویدیو اجرا شده‌اند، ارائه می‌دهند. این معیارها هر نمایش تبلیغ را در نظر می‌گیرند و هر پخش ویدیو می‌تواند چندین نمایش داشته باشد.

معیارهای عملکرد تبلیغات مبتنی بر نمایش عبارتند از:

علاوه بر این، برخی از گزارش‌های ویدیویی از معیارهای عملکرد تبلیغ مبتنی بر پخش زیر پشتیبانی می‌کنند. با این حال، این معیارها در گزارش‌های عملکرد تبلیغ لحاظ نمی‌شوند.

عملکرد تبلیغات بر اساس نوع تبلیغ

فهرست مطالب
ابعاد:
مورد نیاز adType
اختیاری day
معیارها:
از ۱ یا بیشتر استفاده کنید grossRevenue , adImpressions , cpm
فیلترها:
از ۰ یا ۱ استفاده کنید video , group
از ۰ یا ۱ استفاده کنید country , continent , subContinent