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,subscribedStatus
  • dimensions=month,subscribedStatus,youtubeProduct
  • dimensions=month,youtubeProduct

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

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

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

  • این عبارات به معنای یک مقدار لازم است:
    • الزامی: باید مقدار را وارد کنید.
    • دقیقاً از 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

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

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

مطالب
ابعاد:
مورد نیاز dma
از 0 یا 1 استفاده کنید day
month
creatorContentType
subscribedStatus
معیارها:
از 1 یا بیشتر استفاده کنید views
estimatedMinutesWatched
averageViewDuration
averageViewPercentage
فیلترها:
از 0 یا 1 استفاده کنید country ==US
province
از 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 یا از پیوند به یک ویدیوی مرتبط ناشی شده است، شناسایی می کند.

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

مطالب
ابعاد:
مورد نیاز 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

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

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

نوع دستگاه

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

مطالب
ابعاد:
مورد نیاز 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 با طول مشابه حفظ می کند.

  • آمار ساعت گرانول

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

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

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

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

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

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

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

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

توجه: این گزارش ها از شما می خواهند که پارامتر 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
مطالب
ابعاد:
مورد نیاز province
معیارها:
از 1 یا بیشتر استفاده کنید views , redViews , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration , playlistStarts , viewsPerPlaylistStart , averageTimeInPlaylist
فیلترها:
مورد نیاز isCurated ==1; country ==US
از 0 یا 1 استفاده کنید playlist , group
از 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

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

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

نوع دستگاه

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

با استفاده از 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

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

لغو عضویت

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

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

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

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

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

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

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

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

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