YouTube Analytics API: Channel Reports

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

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

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

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

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

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

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

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

مجوز

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

درخواست‌های YouTube Analytics 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 حساب YouTube خود را مدیریت کنید. در YouTube Analytics API، صاحبان کانال از این محدوده برای مدیریت گروه‌ها و موارد گروه YouTube Analytics استفاده می‌کنند.
https://www.googleapis.com/auth/youtubepartner دارایی‌های YouTube و محتوای مرتبط را در YouTube مشاهده و مدیریت کنید. در YouTube Analytics API، صاحبان محتوا از این محدوده برای مدیریت گروه‌ها و موارد گروه YouTube Analytics استفاده می‌کنند.

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

فیلترها

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

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

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

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

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

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

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

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

با این حال، مقدار پارامتر day,month نامعتبر است زیرا از دو بعد مبتنی بر زمان استفاده می‌کند، اما درخواست می‌تواند از 0 یا 1 استفاده کند. در این مورد، مقدار پارامتر subscribedStatus,youtubeProduct در واقع گزارشی را برمی‌گرداند، اما معیارها جمع‌آوری نمی‌شوند. بر اساس روز، هفته، ماه و غیره (این گزارش به طور جداگانه در اسناد ثبت شده است.)

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

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

  • این عبارات به معنای یک مقدار لازم است:
    • الزامی: باید مقدار را وارد کنید.
    • دقیقاً از 1 استفاده کنید: باید یک مقدار را از گروه وارد کنید.
    • از 1 یا بیشتر استفاده کنید: می‌توانید یک یا همه مقادیر را از گروه وارد کنید، اما باید حداقل یکی را وارد کنید.
  • این عبارات به این معنی است که یک مقدار اختیاری است:
    • اختیاری: شما این گزینه را دارید که مقدار را درج کنید.
    • از 0 یا 1 استفاده کنید: شما می توانید یک مقدار را از گروه اضافه کنید.
    • استفاده از 0 یا بیشتر: شما این امکان را دارید که یک یا همه مقادیر را از گروه اضافه کنید.

گزارش های تصویری

آمار اولیه

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

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

فهرست
ابعاد:
[هیچ یک]
معیارهای:
از 1 یا بیشتر استفاده کنید 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 *
فیلترها:
از 0 یا 1 استفاده کنید country , continent , subContinent
از 0 یا 1 استفاده کنید video , group

آمار اصلی فعالیت کاربر برای ایالت های ایالات متحده

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

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

مبتنی بر زمان

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

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

فهرست
ابعاد:
دقیقا از 1 استفاده کنید day , month
اختیاری creatorContentType
معیارهای:
از 1 یا بیشتر استفاده کنید 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 *
فیلترها:
از 0 یا 1 استفاده کنید country , continent , subContinent
از 0 یا 1 استفاده کنید video , group

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

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

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

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

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

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

فهرست
ابعاد:
ضروری country
اختیاری creatorContentType
معیارهای:
از 1 یا بیشتر استفاده کنید 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 *
فیلترها:
از 0 یا 1 استفاده کنید continent , subContinent
از 0 یا 1 استفاده کنید video , group

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

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

فهرست
ابعاد:
ضروری province
اختیاری creatorContentType
معیارهای:
از 1 یا بیشتر استفاده کنید views , redViews , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration , averageViewPercentage , annotationClickThroughRate , annotationCloseRate , annotationImpressions , annotationClickableImpressions , annotationClosableImpressions , annotationClicks , annotationCloses , cardClickRate , cardTeaserClickRate , cardImpressions , cardTeaserImpressions , cardClicks , cardTeaserClicks
فیلترها:
ضروری country ==US
از 0 یا 1 استفاده کنید 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.
از 0 یا 1 استفاده کنید day , month
معیارهای:
از 1 یا بیشتر استفاده کنید views , estimatedMinutesWatched , averageViewDuration , averageViewPercentage
فیلترها:
از 0 یا 1 استفاده کنید country , province , continent , subContinent
از 0 یا 1 استفاده کنید video , group
گزینه های مرتب سازی: - views
- estimatedMinutesWatched

جزئیات پخش

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

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

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

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

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

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

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

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

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

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

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

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

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

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

این گزارش آمار جزئیات پخش را برای بازه های زمانی خاص ارائه می دهد. از معیار میانگین نمایش درصد پشتیبانی می کند.

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

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

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

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

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

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

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

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

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

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

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

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

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

مکان های پخش

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

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

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

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

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

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

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

منابع ترافیک

منبع ترافیک

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

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

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

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

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

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

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

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

نوع وسیله

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

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

سیستم عامل

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

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

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

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

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

جمعیت شناسی بیننده

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

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

به عنوان مثال، گزارشی که از بعد subscribedStatus استفاده می‌کند، داده‌های viewerPercentage را تا 100 درصد برای بازدیدهای مشترک و داده viewerPercentage را تا 100 درصد برای بازدیدهای بدون اشتراک اضافه می‌کند. (مقدار کل فیلدهای viewerPercentage در گزارش 200 درصد است.)

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

مشارکت و به اشتراک گذاری محتوا

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

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

حفظ مخاطب

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

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

فهرست
ابعاد:
ضروری elapsedVideoTimeRatio
اختیاری creatorContentType
معیارهای:
از 1 یا بیشتر استفاده کنید audienceWatchRatio , relativeRetentionPerformance
فیلترها:
ضروری video
از 0 یا بیشتر استفاده کنید audienceType , subscribedStatus , youtubeProduct

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

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

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

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

فهرست
ابعاد:
ضروری video
اختیاری creatorContentType
معیارهای:
از 1 یا بیشتر استفاده کنید 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 *
فیلترها:
از 0 یا 1 استفاده کنید country , continent , subContinent
گزینه های مرتب سازی: - views
- redViews
- estimatedRevenue
- estimatedRedPartnerRevenue
- estimatedMinutesWatched
- estimatedRedMinutesWatched
- subscribersGained
- subscribersLost

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

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

فهرست
ابعاد:
ضروری video
اختیاری creatorContentType
معیارهای:
از 1 یا بیشتر استفاده کنید 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
معیارهای:
از 1 یا بیشتر استفاده کنید 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
از 0 یا 1 استفاده کنید country , continent , subContinent
گزینه های مرتب سازی: - views
- redViews
- estimatedMinutesWatched
- estimatedRedMinutesWatched

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

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

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

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

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

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

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

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

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

یادداشت هشدار زیر تغییرات بین دو نسخه گزارش را با جزئیات بیشتری توضیح می دهد.

معیارهای ویدئویی انبوه

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

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

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

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

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

آمار اولیه

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

با استفاده از isCurated
فهرست
ابعاد:
[هیچ یک]
معیارهای:
از 1 یا بیشتر استفاده کنید views , redViews , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration , playlistStarts , viewsPerPlaylistStart , averageTimeInPlaylist
فیلترها:
ضروری isCurated ==1
از 0 یا 1 استفاده کنید playlist , group
از 0 یا 1 استفاده کنید country , province , continent , subContinent
از 0 یا بیشتر استفاده کنید subscribedStatus , youtubeProduct

مبتنی بر زمان

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

با استفاده از isCurated
فهرست
ابعاد:
دقیقا از 1 استفاده کنید day , month
از 0 یا بیشتر استفاده کنید subscribedStatus , youtubeProduct
معیارهای:
از 1 یا بیشتر استفاده کنید views , redViews , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration , playlistStarts , viewsPerPlaylistStart , averageTimeInPlaylist
فیلترها:
ضروری isCurated ==1
از 0 یا 1 استفاده کنید playlist , group
از 0 یا 1 استفاده کنید country , province , continent , subContinent
از 0 یا بیشتر استفاده کنید subscribedStatus , youtubeProduct

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

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

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

با استفاده از isCurated
فهرست
ابعاد:
ضروری country
از 0 یا بیشتر استفاده کنید subscribedStatus , youtubeProduct
معیارهای:
از 1 یا بیشتر استفاده کنید views , redViews , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration , playlistStarts , viewsPerPlaylistStart , averageTimeInPlaylist
فیلترها:
ضروری isCurated ==1
از 0 یا 1 استفاده کنید playlist , group
از 0 یا 1 استفاده کنید continent , subContinent
از 0 یا بیشتر استفاده کنید subscribedStatus , youtubeProduct

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

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

مکان های پخش

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

با استفاده از isCurated
فهرست
ابعاد:
ضروری insightPlaybackLocationType
از 0 یا بیشتر استفاده کنید day , subscribedStatus
معیارهای:
از 1 یا بیشتر استفاده کنید views , estimatedMinutesWatched , playlistStarts , viewsPerPlaylistStart , averageTimeInPlaylist
فیلترها:
ضروری isCurated ==1
از 0 یا 1 استفاده کنید playlist , group
از 0 یا 1 استفاده کنید country , province , continent , subContinent
اختیاری subscribedStatus

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

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

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

توصیه شده
فهرست
ابعاد:
ضروری insightPlaybackLocationDetail
معیارهای:
از 1 یا بیشتر استفاده کنید views , estimatedMinutesWatched , averageViewDuration , averageTimeInPlaylist , playlistAverageViewDuration , playlistEstimatedMinutesWatched , playlistStarts , playlistViews , viewsPerPlaylistStart
فیلترها:
ضروری insightPlaybackLocationType ==EMBEDDED
دقیقا از 1 استفاده کنید playlist , group
گزینه های مرتب سازی: - playlistViews
- playlistEstimatedMinutesWatched
- playlistStarts
با استفاده از isCurated
فهرست
ابعاد:
ضروری insightPlaybackLocationDetail
معیارهای:
از 1 یا بیشتر استفاده کنید views , estimatedMinutesWatched , playlistStarts , viewsPerPlaylistStart , averageTimeInPlaylist
فیلترها:
ضروری isCurated ==1; insightPlaybackLocationType ==EMBEDDED
از 0 یا 1 استفاده کنید playlist , group
از 0 یا 1 استفاده کنید country , province , continent , subContinent
اختیاری subscribedStatus
گزینه های مرتب سازی: - views
- estimatedMinutesWatched
- playlistStarts

منابع ترافیک

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

با استفاده از isCurated
فهرست
ابعاد:
ضروری insightTrafficSourceType
از 0 یا بیشتر استفاده کنید day , subscribedStatus
معیارهای:
از 1 یا بیشتر استفاده کنید views , estimatedMinutesWatched , playlistStarts , viewsPerPlaylistStart , averageTimeInPlaylist
فیلترها:
ضروری isCurated ==1
از 0 یا 1 استفاده کنید playlist , group
از 0 یا 1 استفاده کنید country , province , continent , subContinent
اختیاری subscribedStatus

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

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

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

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

توصیه شده
فهرست
ابعاد:
ضروری insightTrafficSourceDetail
معیارهای:
از 1 یا بیشتر استفاده کنید views , estimatedMinutesWatched , averageViewDuration , averageTimeInPlaylist , playlistAverageViewDuration , playlistEstimatedMinutesWatched , playlistSaves , playlistStarts , playlistViews , viewsPerPlaylistStart
فیلترها:
ضروری insightTrafficSourceType ==ADVERTISING (or another supported value)
دقیقا از 1 استفاده کنید playlist , group
گزینه های مرتب سازی: - playlistViews
- playlistEstimatedMinutesWatched
- playlistStarts
با استفاده از isCurated
فهرست
ابعاد:
ضروری insightTrafficSourceDetail
معیارهای:
از 1 یا بیشتر استفاده کنید views , estimatedMinutesWatched , playlistStarts , viewsPerPlaylistStart , averageTimeInPlaylist
فیلترها:
ضروری isCurated ==1; insightTrafficSourceType ==ADVERTISING (or another supported value)
از 0 یا 1 استفاده کنید playlist , group
از 0 یا 1 استفاده کنید country , province , continent , subContinent
اختیاری subscribedStatus
گزینه های مرتب سازی: - views
- estimatedMinutesWatched
- playlistStarts

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

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

نوع وسیله

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

با استفاده از isCurated
فهرست
ابعاد:
ضروری deviceType
از 0 یا بیشتر استفاده کنید day , subscribedStatus , youtubeProduct
معیارهای:
از 1 یا بیشتر استفاده کنید views , estimatedMinutesWatched , playlistStarts , viewsPerPlaylistStart , averageTimeInPlaylist
فیلترها:
ضروری isCurated ==1
از 0 یا 1 استفاده کنید playlist , group
از 0 یا 1 استفاده کنید country , province , continent , subContinent
از 0 یا بیشتر استفاده کنید operatingSystem , subscribedStatus , youtubeProduct

سیستم عامل

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

با استفاده از isCurated
فهرست
ابعاد:
ضروری operatingSystem
از 0 یا بیشتر استفاده کنید day , subscribedStatus , youtubeProduct
معیارهای:
از 1 یا بیشتر استفاده کنید views , estimatedMinutesWatched , playlistStarts , viewsPerPlaylistStart , averageTimeInPlaylist
فیلترها:
ضروری isCurated ==1
از 0 یا 1 استفاده کنید playlist , group
از 0 یا 1 استفاده کنید country , province , continent , subContinent
از 0 یا بیشتر استفاده کنید deviceType , subscribedStatus , youtubeProduct

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

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

با استفاده از isCurated
فهرست
ابعاد:
ضروری deviceType , operatingSystem
از 0 یا بیشتر استفاده کنید day , subscribedStatus , youtubeProduct
معیارهای:
از 1 یا بیشتر استفاده کنید views , estimatedMinutesWatched , playlistStarts , viewsPerPlaylistStart , averageTimeInPlaylist
فیلترها:
ضروری isCurated ==1
از 0 یا 1 استفاده کنید playlist , group
از 0 یا 1 استفاده کنید country , province , continent , subContinent
از 0 یا بیشتر استفاده کنید subscribedStatus , youtubeProduct

جمعیت شناسی بیننده

توصیه شده
فهرست
ابعاد:
از 1 یا بیشتر استفاده کنید ageGroup , gender
معیارهای:
ضروری viewerPercentage
فیلترها:
دقیقا از 1 استفاده کنید playlist , group
با استفاده از isCurated
فهرست
ابعاد:
از 1 یا بیشتر استفاده کنید ageGroup , gender
از 0 یا بیشتر استفاده کنید subscribedStatus
معیارهای:
ضروری viewerPercentage
فیلترها:
ضروری isCurated ==1
از 0 یا 1 استفاده کنید playlist , group
از 0 یا 1 استفاده کنید country , province , continent , subContinent
اختیاری subscribedStatus
توجه: مقادیر viewerPercentage در این گزارش برای مقادیر مختلف بعد جزئیات پخش subscribedStatus عادی نشده است.

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

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

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

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

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

با استفاده از isCurated
فهرست
ابعاد:
ضروری playlist
معیارهای:
از 1 یا بیشتر استفاده کنید views , redViews , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration , playlistStarts , viewsPerPlaylistStart , averageTimeInPlaylist
فیلترها:
ضروری isCurated ==1
از 0 یا 1 استفاده کنید country , province , continent , subContinent
از 0 یا بیشتر استفاده کنید playlist , subscribedStatus , youtubeProduct
گزینه های مرتب سازی: - views
- redViews
- estimatedMinutesWatched
- estimatedRedMinutesWatched
- playlistStarts

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

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

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

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

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

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

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