توجه: Content owner reports are only accessible to YouTube content partners who participate in the YouTube Partner Program .
این صفحه گزارشهایی را فهرست میکند که مالکان محتوا میتوانند با استفاده از API یوتیوب آنالیتیکس بازیابی کنند. گزارشهای مالکان محتوا شامل معیارهایی برای کانالهای مرتبط با یک مالک محتوای یوتیوب مشخص است. معیارها، اندازهگیریهای فردی از فعالیت کاربر، عملکرد تبلیغات یا درآمد تخمینی هستند.
گزارشهای ویدیویی شامل فعالیت کاربر، عملکرد تبلیغات و معیارهای تخمینی درآمد برای ویدیوها در کانالهای صاحب محتوا است.
گزارشهای لیست پخش، آماری را ارائه میدهند که بهطور خاص مربوط به بازدیدهای ویدیویی در متن یک لیست پخش است. گزارشهای لیست پخش از بسیاری از ابعاد و فیلترهای مشابه گزارشهای ویدیویی استفاده میکنند.
گزارشهای عملکرد تبلیغات شامل معیارهایی مربوط به درآمد و عملکرد تبلیغات هستند. آنها از بُعد adType برای گروهبندی معیارها بر اساس انواع تبلیغاتی که در طول پخش ویدیو اجرا میشوند، استفاده میکنند. بخش گزارشهای عملکرد تبلیغات، دو نوع معیار عملکرد تبلیغات را که API پشتیبانی میکند، توضیح میدهد.
بازیابی یک گزارش
برای بازیابی گزارش مالک محتوا، متد reports.query مربوط به API را فراخوانی کنید و مقدار پارامتر ids را در درخواست API روی contentOwner== OWNER_NAME تنظیم کنید، که در آن OWNER_NAME شناسه مالک محتوا را مشخص میکند. اگر از مقدار آن مطمئن نیستید، از مدیر همکار خود بپرسید.
مجوز
تمام درخواستهای API یوتیوب آنالیتیکس باید مجاز باشند. راهنمای مجوزدهی نحوه استفاده از پروتکل OAuth 2.0 برای بازیابی توکنهای مجوز را توضیح میدهد.
درخواستهای API یوتیوب آنالیتیکس از حوزههای مجوز زیر استفاده میکنند:
| محدودهها |
|---|
| https://www.googleapis.com/auth/yt-analytics.readonly | گزارشهای YouTube Analytics را برای محتوای YouTube خود مشاهده کنید. این دامنه دسترسی به معیارهای فعالیت کاربر، مانند تعداد بازدیدها و تعداد رتبهبندیها را فراهم میکند. |
| https://www.googleapis.com/auth/yt-analytics-monetary.readonly | گزارشهای مالی YouTube Analytics را برای محتوای YouTube خود مشاهده کنید. این بخش دسترسی به معیارهای فعالیت کاربر و معیارهای تخمینی درآمد و عملکرد تبلیغات را فراهم میکند. |
| https://www.googleapis.com/auth/youtube | حساب یوتیوب خود را مدیریت کنید. در API یوتیوب آنالیتیکس، صاحبان کانال از این محدوده برای مدیریت گروهها و موارد گروهی یوتیوب آنالیتیکس استفاده میکنند. |
| https://www.googleapis.com/auth/youtubepartner | مشاهده و مدیریت داراییهای یوتیوب و محتوای مرتبط در یوتیوب. در API یوتیوب آنالیتیکس، مالکان محتوا از این حوزه برای مدیریت گروهها و موارد گروهی یوتیوب آنالیتیکس استفاده میکنند. |
توجه: معیارهایی که با ستاره ( * ) مشخص شدهاند، نیاز به یک توکن مجوز دارند که دسترسی به محدوده https://www.googleapis.com/auth/yt-analytics-monetary.readonly را اعطا میکند.
فیلترها
تمام درخواستهای API برای بازیابی گزارشهای مالک محتوا باید دادهها را با استفاده از بُعد video ، بُعد channel یا ترکیبی پشتیبانیشده از بُعدهای claimedStatus و uploaderType فیلتر کنند. (ترکیبهای پشتیبانیشده در تعریف بُعد uploaderType فهرست شدهاند.)
جداولی که گزارشهای پشتیبانیشده را توضیح میدهند، فیلترهایی را که میتوانند برای هر گزارش مشخص استفاده شوند، مشخص میکنند. در توضیحات، فیلترهای نشان داده شده در پرانتز اختیاری هستند. برای مثال، اگر در گزارشی video(,country) به عنوان گزینه فیلتر ذکر شده باشد، میتوان گزارش را طوری فیلتر کرد که فقط شامل دادههای یک ویدیوی خاص باشد یا فقط شامل دادههای یک ویدیوی خاص در یک کشور خاص باشد.
این API همچنین از قابلیت تعیین چندین مقدار برای فیلترهای video ، playlist و channel پشتیبانی میکند. اگر چندین مقدار برای یکی از این فیلترها تعیین کنید، میتوانید آن فیلتر را به لیست ابعادی که برای درخواست مشخص میکنید نیز اضافه کنید. این موضوع حتی اگر فیلتر به عنوان یک بعد پشتیبانی شده برای یک گزارش خاص ذکر نشده باشد، صادق است.
برای توضیح کامل نحوه فیلتر کردن نتایج API برای یک مقدار خاص یا مجموعهای از مقادیر، به تعریف پارامتر filters مراجعه کنید.
آشنایی با جداول گزارش
این بخش قالببندی و اصطلاحات مورد استفاده در جداولی را توضیح میدهد که گزارشهای پشتیبانیشده توسط API را تعریف میکنند. جدول زیر ابعاد، معیارها و فیلترهای پشتیبانیشده برای گزارش ویدیوی جزئیات پخش را با استفاده از بُعد زمان و معیار averageViewPercentage فهرست میکند.
| فهرست مطالب |
|---|
| ابعاد: | |
| معیارها: | |
| فیلترها: | |
این جدول شامل دو ردیف برای ابعاد، یک ردیف برای معیارها و سه ردیف برای فیلترها است. برای ابعاد و فیلترها، مقادیر هر ردیف را میتوان در یک درخواست API ترکیب کرد، مادامی که این ترکیب از قوانین استفاده در جدول پیروی کند. بنابراین، برای مثال، مقادیر معتبر پارامترهای dimensions برای این گزارش عبارتند از:
-
dimensions=day -
dimensions=day,subscribedStatus -
dimensions=month,subscribedStatus,youtubeProduct -
dimensions=month,youtubeProduct
با این حال، مقدار پارامتر day,month نامعتبر است زیرا از دو بُعد مبتنی بر زمان استفاده میکند و درخواست باید از ۰ یا ۱ استفاده کند.
اصطلاحات جدول گزارش
جداول از اصطلاحات زیر برای نشان دادن اینکه ابعاد الزامی هستند یا اختیاری استفاده میکنند:
- این اصطلاحات به این معنی است که یک مقدار مورد نیاز است:
- الزامی: شما باید مقدار را وارد کنید.
- دقیقاً از عدد ۱ استفاده کنید: شما باید یک مقدار از گروه را وارد کنید.
- از ۱ یا بیشتر استفاده کنید: میتوانید هر یا همه مقادیر گروه را وارد کنید، اما حداقل باید یکی را وارد کنید.
- این اصطلاحات به این معنی است که یک مقدار اختیاری است:
- اختیاری: شما میتوانید مقدار را نیز وارد کنید.
- استفاده از ۰ یا ۱: شما میتوانید یک مقدار از گروه را اضافه کنید.
- استفاده از ۰ یا بیشتر: شما میتوانید هر یا همه مقادیر گروه را در نظر بگیرید.
مهم: تمام درخواستهای API برای بازیابی گزارشهای ویدیویی مالک محتوا باید دادهها را با استفاده از بُعد
ویدیو ، بُعد
کانال ، بُعد
گروه یا ترکیبی پشتیبانیشده از ابعاد
claimStatus و
uploaderType فیلتر کنند. (برخی گزارشها از همه این گزینهها پشتیبانی نمیکنند.) ترکیبات پشتیبانیشده، که در تعریف بُعد
uploaderType نیز ذکر شدهاند، عبارتند از:
-
uploaderType==self -
claimedStatus==claimed -
claimedStatus==claimed;uploaderType==self -
claimedStatus==claimed;uploaderType==thirdParty
گزارشهای ویدیویی
آمار پایه
آمار پایه (شامل تعداد مشترکین)
این گزارش، آمار مربوط به اقدامات کاربر در تمام کانالهای صاحب محتوا را ارائه میدهد. میتوانید گزارش را طوری فیلتر کنید که فقط دادههای مربوط به یک ویدیو یا کشور خاص را برگرداند. همچنین میتوان از آن برای بازیابی آمار محتوای ادعا شده، از جمله محتوای ادعا شده آپلود شده توسط صاحب محتوا، اشخاص ثالث یا هر دو، استفاده کرد.
| فهرست مطالب |
|---|
| ابعاد: | |
| معیارها: | | از ۱ یا بیشتر استفاده کنید | engagedViews , views , redViews , comments , likes , dislikes , videosAddedToPlaylists , videosRemovedFromPlaylists , shares , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration , averageViewPercentage , annotationClickThroughRate , annotationCloseRate , annotationImpressions , annotationClickableImpressions , annotationClosableImpressions , annotationClicks , annotationCloses , cardClickRate , cardTeaserClickRate , cardImpressions , cardTeaserImpressions , cardClicks , cardTeaserClicks , subscribersGained , subscribersLost , estimatedRevenue *, estimatedAdRevenue *, grossRevenue *, estimatedRedPartnerRevenue *, monetizedPlaybacks *, playbackBasedCpm *, adImpressions *, cpm * |
|
| فیلترها: | |
آمار پایه برای ایالتهای آمریکا
این گزارش آمار مربوط به یک ایالت خاص ایالات متحده یا ناحیه کلمبیا را ارائه میدهد. توجه داشته باشید که این گزارش فقط از زیرمجموعهای از معیارهای موجود در گزارش خاص کشور که در بالا توضیح داده شد، پشتیبانی میکند.
| فهرست مطالب |
|---|
| ابعاد: | |
| معیارها: | | از ۱ یا بیشتر استفاده کنید | engagedViews , views , redViews , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration , averageViewPercentage , annotationClickThroughRate , annotationCloseRate , annotationImpressions , annotationClickableImpressions , annotationClosableImpressions , annotationClicks , annotationCloses , cardClickRate , cardTeaserClickRate , cardImpressions , cardTeaserImpressions , cardClicks , cardTeaserClicks |
|
| فیلترها: | |
مبتنی بر زمان
فعالیت برای دورههای زمانی
این گزارش، آمار مربوط به اقدامات کاربران در تمام کانالهای صاحب محتوا را برای فواصل زمانی خاص ارائه میدهد. میتوانید گزارش را فیلتر کنید تا فقط دادههای مربوط به یک ویدیو یا کشور خاص را نشان دهد.
| فهرست مطالب |
|---|
| ابعاد: | |
| معیارها: | | از ۱ یا بیشتر استفاده کنید | engagedViews , views , redViews , comments , likes , dislikes , videosAddedToPlaylists , videosRemovedFromPlaylists , shares , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration , averageViewPercentage , annotationClickThroughRate , annotationCloseRate , annotationImpressions , annotationClickableImpressions , annotationClosableImpressions , annotationClicks , annotationCloses , cardClickRate , cardTeaserClickRate , cardImpressions , cardTeaserImpressions , cardClicks , cardTeaserClicks , subscribersGained , subscribersLost , uniques , estimatedRevenue *, estimatedAdRevenue *, grossRevenue *, estimatedRedPartnerRevenue *, monetizedPlaybacks *, playbackBasedCpm *, adImpressions *, cpm * |
|
| فیلترها: | |
فعالیت کاربران در ایالتهای آمریکا برای دورههای زمانی خاص
این گزارش آمار مربوط به یک ایالت خاص ایالات متحده یا ناحیه کلمبیا را ارائه میدهد. توجه داشته باشید که این گزارش فقط از زیرمجموعهای از معیارهای موجود در گزارش خاص کشور که در بالا توضیح داده شد، پشتیبانی میکند.
| فهرست مطالب |
|---|
| ابعاد: | |
| معیارها: | | از ۱ یا بیشتر استفاده کنید | engagedViews , views , redViews , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration , averageViewPercentage , annotationClickThroughRate , annotationCloseRate , annotationImpressions , annotationClickableImpressions , annotationClosableImpressions , annotationClicks , annotationCloses , cardClickRate , cardTeaserClickRate , cardImpressions , cardTeaserImpressions , cardClicks , cardTeaserClicks |
|
| فیلترها: | |
جغرافیای کاربر
فعالیت کاربران بر اساس کشور
این گزارش، آمار مربوط به فعالیت کاربران را به صورت کشور به کشور برای همه کانالهای صاحب محتوا ارائه میدهد. میتوانید گزارش را طوری فیلتر کنید که فقط دادههای مربوط به یک ویدیو یا کانال خاص را نشان دهد.
| فهرست مطالب |
|---|
| ابعاد: | |
| معیارها: | | از ۱ یا بیشتر استفاده کنید | engagedViews , views , redViews , comments , likes , dislikes , videosAddedToPlaylists , videosRemovedFromPlaylists , shares , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration , averageViewPercentage , annotationClickThroughRate , annotationCloseRate , annotationImpressions , annotationClickableImpressions , annotationClosableImpressions , annotationClicks , annotationCloses , cardClickRate , cardTeaserClickRate , cardImpressions , cardTeaserImpressions , cardClicks , cardTeaserClicks , subscribersGained , subscribersLost , estimatedRevenue *, estimatedAdRevenue *, grossRevenue *, estimatedRedPartnerRevenue *, monetizedPlaybacks *, playbackBasedCpm *, adImpressions *, cpm * |
|
| فیلترها: | |
فعالیت کاربران بر اساس استان
این گزارش آمار فعالیت کاربران را برای ایالتهای آمریکا و ناحیه کلمبیا ارائه میدهد. برای این گزارش، باید مقدار پارامتر filters را روی country==US تنظیم کنید.
| فهرست مطالب |
|---|
| ابعاد: | |
| معیارها: | | از ۱ یا بیشتر استفاده کنید | engagedViews , views , redViews , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration , averageViewPercentage , annotationClickThroughRate , annotationCloseRate , annotationImpressions , annotationClickableImpressions , annotationClosableImpressions , annotationClicks , annotationCloses , cardClickRate , cardTeaserClickRate , cardImpressions , cardTeaserImpressions , cardClicks , cardTeaserClicks |
|
| فیلترها: | |
جزئیات پخش
گزارشهای جزئیات پخش، آماری مربوط به ویژگیهای مشاهده زیر را ارائه میدهند:
- آیا این نمایش، پخش زنده ویدیو بود یا یک ویدیوی درخواستی؟
- آیا بیننده در کانالی که صاحب ویدیو است مشترک شده است؟
- این بازدید در کدام محصول یوتیوب رخ داده است؟
از نظر فنی، ابعاد جزئیات پخش که این گزارشها پشتیبانی میکنند، همگی اختیاری هستند. اگر ابعاد جزئیات پخش را در درخواست خود لحاظ نکنید، گزارش برگشتی در واقع شبیه به یکی از گزارشهای آمار پایه ، مبتنی بر زمان یا جغرافیای کاربر خواهد بود.
نکته: بُعد و فیلتر liveOrOnDemand را نمیتوان همراه با معیار averageViewPercentage استفاده کرد. به همین دلیل، هر یک از زیربخشهای زیر دو گزارش را فهرست میکنند. یک گزارش از بُعد (و فیلتر) liveOrOnDemand پشتیبانی میکند، در حالی که گزارش دیگر از معیار averageViewPercentage پشتیبانی میکند.
فعالیت کاربر بر اساس وضعیت اشتراک
این گزارش، معیارهای فعالیت کاربر را برای بینندگان مشترک و لغو اشتراک ارائه میدهد. آمار را میتوان بر اساس دوره زمانی ( روز یا ماه ) گروهبندی کرد و گزارش را میتوان بر اساس کشور ، قاره یا شبه قاره فیلتر کرد.
| فهرست مطالب |
|---|
| ابعاد: | |
| معیارها: | | از ۱ یا بیشتر استفاده کنید | engagedViews , views , redViews , likes , dislikes , videosAddedToPlaylists , videosRemovedFromPlaylists , shares , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration , averageViewPercentage , annotationClickThroughRate , annotationCloseRate , annotationImpressions , annotationClickableImpressions , annotationClosableImpressions , annotationClicks , annotationCloses , cardClickRate , cardTeaserClickRate , cardImpressions , cardTeaserImpressions , cardClicks , cardTeaserClicks |
|
| فیلترها: | |
فعالیت کاربر بر اساس وضعیت اشتراک برای استانها
این گزارش معیارهای فعالیت کاربران را برای بینندگان مشترک و لغو اشتراک در ایالتهای ایالات متحده یا ناحیه کلمبیا ارائه میدهد. این گزارش از معیارهای کمتری نسبت به گزارش قبلی پشتیبانی میکند.
| فهرست مطالب |
|---|
| ابعاد: | |
| معیارها: | | از ۱ یا بیشتر استفاده کنید | engagedViews , views , redViews , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration , averageViewPercentage , annotationClickThroughRate , annotationCloseRate , annotationImpressions , annotationClickableImpressions , annotationClosableImpressions , annotationClicks , annotationCloses , cardClickRate , cardTeaserClickRate , cardImpressions , cardTeaserImpressions , cardClicks , cardTeaserClicks |
|
| فیلترها: | |
جزئیات پخش با بُعد زمانی اختیاری
بُعد زمانی - روز یا ماه - برای این گزارشها اختیاری است، زیرا صرف نظر از آن، شما باید از پارامترهای درخواست startDate و endDate برای مشخص کردن محدوده تاریخی که گزارش پوشش خواهد داد، استفاده کنید. این بُعد، در صورت وجود، نشان میدهد که میخواهید دادههای گزارش بر اساس روز، ماه و غیره جمعآوری شوند.
جزئیات پخش با بُعد زمانی اختیاری و آمار liveOrOnDemand
این گزارش، آمار جزئیات پخش را برای فواصل زمانی خاص ارائه میدهد. این گزارش از بُعد (و فیلتر) liveOrOnDemand پشتیبانی میکند.
| فهرست مطالب |
|---|
| ابعاد: | |
| معیارها: | |
| فیلترها: | |
این گزارش، آمار جزئیات پخش را برای فواصل زمانی خاص ارائه میدهد.
| فهرست مطالب |
|---|
| ابعاد: | |
| معیارها: | |
| فیلترها: | |
جزئیات پخش بر اساس کشور
جزئیات پخش بر اساس کشور با آمار liveOrOnDemand
این گزارش آمار جزئیات پخش را بر اساس کشور به کشور ارائه میدهد. این گزارش از بُعد (و فیلتر) liveOrOnDemand پشتیبانی میکند.
| فهرست مطالب |
|---|
| ابعاد: | |
| معیارها: | |
| فیلترها: | |
گزارش زیر مشابه گزارش قبلی است. این گزارش از معیار averageViewPercentage پشتیبانی میکند، اما از liveOrOnDemand به عنوان یک بُعد یا فیلتر پشتیبانی نمیکند.
| فهرست مطالب |
|---|
| ابعاد: | |
| معیارها: | |
| فیلترها: | |
جزئیات پخش بر اساس استان
جزئیات پخش بر اساس استان با آمار liveOrOnDemand
این گزارش آمار جزئیات پخش را برای ایالتهای آمریکا و ناحیه کلمبیا ارائه میدهد. این گزارش از بُعد (و فیلتر) liveOrOnDemand پشتیبانی میکند.
| فهرست مطالب |
|---|
| ابعاد: | |
| معیارها: | |
| فیلترها: | |
گزارش زیر مشابه گزارش قبلی است. این گزارش از معیار averageViewPercentage پشتیبانی میکند، اما از liveOrOnDemand به عنوان یک بُعد یا فیلتر پشتیبانی نمیکند.
| فهرست مطالب |
|---|
| ابعاد: | |
| معیارها: | |
| فیلترها: | |
مکانهای پخش
گزارش موقعیت مکانی پخش ویدیو
این گزارش آماری مربوط به نوع صفحه یا برنامهای که پخش ویدیو در آن رخ داده است را ارائه میدهد.
| فهرست مطالب |
|---|
| ابعاد: | |
| معیارها: | |
| فیلترها: | |
جزئیات مکان پخش (<= 25 نتیجه)
نکته: این گزارش از شما میخواهد که پارامتر maxResults را روی یک مقدار صحیح 25 یا کمتر تنظیم کنید. برخلاف اکثر گزارشهای دیگر، این گزارش همچنین از شما میخواهد که مقداری را برای پارامتر درخواست sort مشخص کنید.
این گزارش، پخشکنندههای ویدیوی جاسازیشدهای را که بیشترین بازدید یا زمان مشاهده را برای محتوای صاحب محتوا ایجاد کردهاند، شناسایی میکند. هنگام بازیابی این گزارش، باید فیلتر insightPlaybackLocationType را روی EMBEDDED تنظیم کنید.
منابع ترافیک
منبع ترافیک
این گزارش، آمار بازدید را بر اساس نحوهی دسترسی بینندگان به محتوای ویدیوی شما جمعآوری میکند. برای مثال، تعداد بازدیدهایی که از جستجوی گوگل یا از طریق لینک به یک ویدیوی مرتبط حاصل شدهاند را مشخص میکند.
توجه: اگر حاصلضرب تعداد ویدیوهای درخواستشده در X تعداد روز در محدوده تاریخ از ۵۰۰۰۰ بیشتر شود، این گزارش خطا میدهد. برای مثال، یک پرسوجو که دادههای ۵۰۰ شناسه ویدیو را بازیابی میکند، میتواند حداکثر برای ۱۰۰ روز داده درخواست کند. برای کاهش تعداد ردیفهایی که یک درخواست برمیگرداند، پرسوجوی خود را به چندین پرسوجو تقسیم کنید که ویدیوهای کمتری را مشخص میکنند یا محدودههای تاریخ کوتاهتری را تنظیم میکنند.
| فهرست مطالب |
|---|
| ابعاد: | |
| معیارها: | |
| فیلترها: | |
جزئیات منبع ترافیک (<= 25 نتیجه)
نکته: این گزارش از شما میخواهد که پارامتر maxResults را روی یک مقدار صحیح 25 یا کمتر تنظیم کنید. برخلاف اکثر گزارشهای دیگر، این گزارش همچنین از شما میخواهد که مقداری را برای پارامتر درخواست sort مشخص کنید.
این گزارش، آمار بازدید را بر اساس ارجاعدهندگانی که بیشترین بازدید را برای محتوای صاحب محتوا ایجاد کردهاند، جمعآوری میکند. ارجاعدهندگان بر اساس نوع منبع ترافیک طبقهبندی میشوند و تعریف بُعد insightTrafficSourceDetail ، منابع ترافیکی را که گزارش برای آنها در دسترس است، شناسایی میکند. برای مثال، اگر فیلتر insightTrafficSourceType را روی ADVERTISING تنظیم کنید، گزارش انواع تبلیغاتی را که بیشترین بازدید یا زمان مشاهده را برای محتوای صاحب محتوا ایجاد کردهاند، فهرست میکند.
توجه: این گزارش فقط برای منابع ترافیکی خاص پشتیبانی میشود. منابع ترافیکی VIDEO_REMIXES ، NOTIFICATION ، END_SCREEN ، CAMPAIGN_CARD ، VIDEO_REMIXES و NO_LINK_EMBEDDED برخی از مواردی هستند که پشتیبانی نمیشوند.
نوع دستگاه و سیستم عامل
نوع دستگاه
این گزارش آمار بازدید را بر اساس نوع دستگاهی که بینندگان هنگام تماشای محتوای شما استفاده کردهاند، جمعآوری میکند. به عنوان مثال، تعداد بازدیدهایی که از طریق تبلت یا کنسولهای بازی رخ داده است را مشخص میکند.
| فهرست مطالب |
|---|
| ابعاد: | |
| معیارها: | |
| فیلترها: | |
سیستم عامل
این گزارش آمار بازدید را بر اساس سیستم عامل بینندگان جمعآوری میکند. برای مثال، تعداد بازدیدهایی که در دستگاههای اندروید یا پلیاستیشن رخ داده است را مشخص میکند.
| فهرست مطالب |
|---|
| ابعاد: | |
| معیارها: | |
| فیلترها: | |
سیستم عامل و نوع دستگاه
این گزارش آمار بازدید را بر اساس سیستم عامل و نوع دستگاه بینندگان جمعآوری میکند. به عنوان مثال، تعداد بازدیدهایی که در تبلتهای اندرویدی یا دستگاههای دسکتاپ ویندوزی رخ داده است را مشخص میکند.
| فهرست مطالب |
|---|
| ابعاد: | |
| معیارها: | |
| فیلترها: | |
آمار جمعیتی بینندگان
این گزارش آمار بازدید را بر اساس گروه سنی و جنسیت بینندگان جمعآوری میکند.
| فهرست مطالب |
|---|
| ابعاد: | |
| معیارها: | |
| فیلترها: | |
تعامل و اشتراکگذاری محتوا
این گزارش آماری را ارائه میدهد که نشان میدهد ویدیوهای این کانال چند وقت یکبار در پلتفرمهای اجتماعی مختلف به اشتراک گذاشته شدهاند.
| فهرست مطالب |
|---|
| ابعاد: | |
| معیارها: | | از ۱ یا بیشتر استفاده کنید | shares |
|
| فیلترها: | |
حفظ مخاطب
این گزارش توانایی یک ویدیو در حفظ مخاطب خود را اندازهگیری میکند. بُعد elapsedVideoTimeRatio میزان زمانی که ویدیو برای مقادیر معیار مربوطه سپری شده است را اندازهگیری میکند. معیارهای audienceWatchRatio و relativeRetentionPerformance دو معیار ارائه میدهند که نشان میدهند ویدیو چقدر خوب مخاطب خود را حفظ میکند. اولی یک مقدار مطلق است، در حالی که دومی نشان میدهد که ویدیو نسبت به سایر ویدیوهای YouTube با مدت زمان مشابه چگونه عمل میکند.
توجه: گزارشهای حفظ مخاطب از امکان تعیین فهرستی از مقادیر جدا شده با کاما برای فیلتر video پشتیبانی نمیکنند؛ مقدار باید یک شناسه ویدیوی واحد را مشخص کند.
| فهرست مطالب |
|---|
| ابعاد: | |
| معیارها: | |
| فیلترها: | |
ویدیوهای برتر
توجه: این گزارشها از شما میخواهند که پارامتر maxResults را روی یک مقدار صحیح 200 یا کمتر تنظیم کنید. قبل از ۱ ژانویه ۲۰۱۳، دادهها فقط برای ۱۰ ویدیوی برتر در دسترس هستند. برخلاف اکثر گزارشهای دیگر، این گزارشها همچنین از شما میخواهند که مقداری را برای پارامتر درخواست sort مشخص کنید.
ویدیوهای برتر به طور کلی، بر اساس کشور، قاره یا شبه قاره (<= 200 نتیجه)
این گزارش، برترین ویدیوهای صاحب محتوا را بر اساس معیارهای فیلترینگ و مرتبسازی مشخصشده فهرست میکند.
| فهرست مطالب |
|---|
| ابعاد: | |
| معیارها: | | از ۱ یا بیشتر استفاده کنید | engagedViews , views , redViews , comments , likes , dislikes , videosAddedToPlaylists , videosRemovedFromPlaylists , shares , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration , averageViewPercentage , annotationClickThroughRate , annotationCloseRate , annotationImpressions , annotationClickableImpressions , annotationClosableImpressions , annotationClicks , annotationCloses , cardClickRate , cardTeaserClickRate , cardImpressions , cardTeaserImpressions , cardClicks , cardTeaserClicks , subscribersGained , subscribersLost , estimatedRevenue *, estimatedAdRevenue *, grossRevenue *, estimatedRedPartnerRevenue *, monetizedPlaybacks *, playbackBasedCpm *, adImpressions *, cpm * |
|
| فیلترها: | |
| گزینههای مرتبسازی: | - engagedViews
- views
- redViews
- estimatedRevenue
- estimatedRedPartnerRevenue
- estimatedMinutesWatched
- estimatedRedMinutesWatched
- subscribersGained
- subscribersLost |
ویدیوهای برتر به طور کلی بر اساس ایالت ایالات متحده (<= 200 نتیجه)
این گزارش، برترین ویدیوهای صاحب محتوا را در یک ایالت خاص ایالات متحده یا ناحیه کلمبیا فهرست میکند. توجه داشته باشید که این گزارش فقط زیرمجموعهای از معیارهای موجود در گزارش مختص کشور که در بالا توضیح داده شد را پشتیبانی میکند.
| فهرست مطالب |
|---|
| ابعاد: | |
| معیارها: | | از ۱ یا بیشتر استفاده کنید | engagedViews , views , redViews , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration , averageViewPercentage , annotationClickThroughRate , annotationCloseRate , annotationImpressions , annotationClickableImpressions , annotationClosableImpressions , annotationClicks , annotationCloses , cardClickRate , cardTeaserClickRate , cardImpressions , cardTeaserImpressions , cardClicks , cardTeaserClicks |
|
| فیلترها: | |
| گزینههای مرتبسازی: | - engagedViews
- views
- redViews
- estimatedMinutesWatched
- estimatedRedMinutesWatched |
ویدیوهای برتر برای بینندگان مشترک یا لغو اشتراک (<= 200 نتیجه)
این گزارش، ویدیوهای برتر را برای بینندگان مشترک یا لغو اشتراک فهرست میکند. این گزارش را میتوان فیلتر کرد تا ویدیوهای برتر را بر اساس کشور ، قاره یا شبهقاره فهرست کند. گزارش قبلی به شما امکان میدهد ویدیوهای برتر را در یک ایالت خاص ایالات متحده برای بینندگان مشترک یا لغو اشتراک بازیابی کنید، اما از معیارهای کمتری نسبت به این گزارش پشتیبانی میکند.
| فهرست مطالب |
|---|
| ابعاد: | |
| معیارها: | | از ۱ یا بیشتر استفاده کنید | engagedViews , views , redViews , likes , dislikes , videosAddedToPlaylists , videosRemovedFromPlaylists , shares , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration , averageViewPercentage , annotationClickThroughRate , annotationCloseRate , annotationImpressions , annotationClickableImpressions , annotationClosableImpressions , annotationClicks , annotationCloses , cardClickRate , cardTeaserClickRate , cardImpressions , cardTeaserImpressions , cardClicks , cardTeaserClicks |
|
| فیلترها: | |
| گزینههای مرتبسازی: | - engagedViews
- views
- redViews
- estimatedMinutesWatched
- estimatedRedMinutesWatched |
ویدیوهای برتر بر اساس محصول یوتیوب (<= 200 نتیجه)
این گزارش، ویدیوهای برتر را فهرست میکند و از جزئیات پخش و فیلترهای جغرافیایی پشتیبانی میکند. این گزارش مشابه گزارش قبلی است، اما از معیارهای کمتری پشتیبانی میکند و از فیلتر youtubeProduct نیز پشتیبانی میکند.
ویدیوهای برتر با فیلترهای جزئیات پخش (<= 200 نتیجه)
این گزارش، ویدیوهای برتر صاحب محتوا را فهرست میکند و بر اساس یک یا چند بُعد جزئیات پخش فیلتر میکند: liveOrOnDemand ، subscribedStatus و youtubeProduct . این گزارش همچنین از فیلتر کردن بر اساس منطقه پشتیبانی میکند.
گزارشهای لیست پخش
گزارشهای لیست پخش شامل معیارهایی مربوط به فعالیت کاربر در رابطه با ویدیوهای موجود در لیست پخش صاحب کانال است. دو نسخه از این گزارشها در دسترس است و برای هر گزارش موجود، بخشهای زیر شامل توضیحی از هر نسخه است:
معیارهای ویدیویی تجمیعشده
این معیارها، معیارهای فعالیت و تأثیرگذاری کاربر را ارائه میدهند که برای همه ویدیوهای موجود در لیست پخش که متعلق به کانال صاحب لیست پخش نیز هستند، تجمیع میشوند. معیارهای ویدیوهای متعلق به کانالهای دیگر در این تجمیع محاسبه نمیشوند. در نتیجه، اگر کانالی لیست پخشی ایجاد کند که فقط شامل ویدیوهای متعلق به کانالهای دیگر باشد، گزارشهای مربوط به آن لیستهای پخش، مقادیری برای این معیارها ارائه نمیدهند.
برای مشاهده فهرستی از معیارهای کلی ویدیویی که یوتیوب پشتیبانی میکند، به بخش معیارهای لیست پخش پشتیبانیشده مراجعه کنید.
معیارهای درون لیست پخش
این معیارها فعالیت و تعامل کاربر را در زمینه صفحه لیست پخش منعکس میکنند. این معیارها شامل بازدیدهای همه ویدیوهای موجود در لیست پخش، صرف نظر از اینکه متعلق به کدام کانال هستند، میشود، اما فقط بازدیدهایی را که در زمینه لیست پخش رخ دادهاند، شمارش میکند.
معیارهای لیست پخش پشتیبانی شده
آمار پایه
این گزارش آماری مربوط به تعامل کاربران با ویدیوهای موجود در لیستهای پخش کانالهای صاحب محتوا را ارائه میدهد. این گزارش هیچ بُعد الزامی ندارد.
| فهرست مطالب |
|---|
| ابعاد: | |
| معیارها: | | از ۱ یا بیشتر استفاده کنید | engagedViews , views , estimatedMinutesWatched , averageViewDuration , averageTimeInPlaylist , playlistAverageViewDuration , playlistEstimatedMinutesWatched , playlistSaves , playlistStarts , playlistViews , viewsPerPlaylistStart |
|
| فیلترها: | |
مبتنی بر زمان
این گزارش، آمار مربوط به تعامل کاربران با ویدیوهای موجود در لیستهای پخش برای کانالهای صاحب محتوا را در فواصل زمانی خاص ارائه میدهد. میتوانید گزارش را طوری فیلتر کنید که فقط دادههای مربوط به یک لیست پخش یا کانال خاص را نشان دهد.
| فهرست مطالب |
|---|
| ابعاد: | |
| معیارها: | | از ۱ یا بیشتر استفاده کنید | engagedViews , views , estimatedMinutesWatched , averageViewDuration , averageTimeInPlaylist , playlistAverageViewDuration , playlistEstimatedMinutesWatched , playlistSaves , playlistStarts , playlistViews , viewsPerPlaylistStart |
|
| فیلترها: | |
جغرافیای کاربر
این گزارش، آماری مرتبط با تعاملاتی که کاربران در یک کشور خاص با ویدیوهای موجود در لیستهای پخش کانال دارند را ارائه میدهد.
این گزارش آمار لیست پخش را بر اساس کشور ارائه میدهد.
| فهرست مطالب |
|---|
| ابعاد: | |
| معیارها: | |
| فیلترها: | |
فعالیت لیست پخش بر اساس استان
این گزارش آمار فعالیت لیست پخش را برای ایالتهای آمریکا و ناحیه کلمبیا ارائه میدهد. برای این گزارش، شما country==US را در مقدار پارامتر filters لحاظ میکنید.
| فهرست مطالب |
|---|
| ابعاد: | |
| معیارها: | |
| فیلترها: | |
مکانهای پخش
این گزارش آماری مربوط به نوع صفحه یا برنامهای که پخشهای لیست پخش در آن رخ داده است را ارائه میدهد.
| فهرست مطالب |
|---|
| ابعاد: | |
| معیارها: | |
| فیلترها: | |
جزئیات مکان پخش (<= 25 نتیجه)
نکته: این گزارش از شما میخواهد که پارامتر maxResults را روی یک مقدار صحیح 25 یا کمتر تنظیم کنید. برخلاف اکثر گزارشهای دیگر، این گزارش همچنین از شما میخواهد که مقداری را برای پارامتر درخواست sort مشخص کنید.
این گزارش، پخشکنندههای ویدیویی تعبیهشدهای را که بیشترین بازدید یا زمان مشاهده را برای لیستهای پخش صاحب محتوا ایجاد کردهاند، شناسایی میکند.
منابع ترافیک
این گزارش، آمار بازدید را بر اساس نحوهی دسترسی بینندگان به محتوای لیست پخش شما جمعآوری میکند. برای مثال، تعداد بازدیدهایی که از جستجوی گوگل یا صفحهی کانال سرچشمه گرفتهاند را مشخص میکند.
| فهرست مطالب |
|---|
| ابعاد: | |
| معیارها: | | از ۱ یا بیشتر استفاده کنید | engagedViews , views , estimatedMinutesWatched , averageViewDuration , averageTimeInPlaylist , playlistAverageViewDuration , playlistEstimatedMinutesWatched , playlistSaves , playlistStarts , playlistViews , viewsPerPlaylistStart |
|
| فیلترها: | |
جزئیات منبع ترافیک (<= 25 نتیجه)
نکته: این گزارش از شما میخواهد که پارامتر maxResults را روی یک مقدار صحیح 25 یا کمتر تنظیم کنید. برخلاف اکثر گزارشهای دیگر، این گزارش همچنین از شما میخواهد که مقداری را برای پارامتر درخواست sort مشخص کنید.
این گزارش، آمار بازدید را بر اساس ارجاعدهندگانی که بیشترین بازدید را برای لیستهای پخش مالک محتوا ایجاد کردهاند، جمعآوری میکند. ارجاعدهندگان بر اساس نوع منبع ترافیک طبقهبندی میشوند و تعریف بُعد insightTrafficSourceDetail ، منابع ترافیکی را که گزارش برای آنها در دسترس است، شناسایی میکند. برای مثال، اگر فیلتر insightTrafficSourceType را روی ADVERTISING تنظیم کنید، گزارش انواع تبلیغاتی را که بیشترین بازدید یا زمان مشاهده را برای لیستهای پخش مالک محتوا ایجاد کردهاند، فهرست میکند.
| فهرست مطالب |
|---|
| ابعاد: | |
| معیارها: | | از ۱ یا بیشتر استفاده کنید | engagedViews , views , estimatedMinutesWatched , averageViewDuration , averageTimeInPlaylist , playlistAverageViewDuration , playlistEstimatedMinutesWatched , playlistSaves , playlistStarts , playlistViews , viewsPerPlaylistStart |
|
| فیلترها: | |
| گزینههای مرتبسازی: | - playlistViews
- playlistEstimatedMinutesWatched
- playlistStarts |
توجه: این گزارش فقط برای منابع ترافیکی خاص پشتیبانی میشود. منابع ترافیکی VIDEO_REMIXES ، NOTIFICATION ، END_SCREEN ، CAMPAIGN_CARD ، VIDEO_REMIXES و NO_LINK_EMBEDDED برخی از مواردی هستند که پشتیبانی نمیشوند.
نوع دستگاه و سیستم عامل
نوع دستگاه برای لیستهای پخش
این گزارش، آمار بازدید را بر اساس نوع دستگاهی که بینندگان برای تماشای محتوای لیست پخش شما استفاده کردهاند، جمعآوری میکند. به عنوان مثال، تعداد بازدیدهای انجام شده روی دستگاههای تلفن همراه یا کنسولهای بازی را مشخص میکند.
| فهرست مطالب |
|---|
| ابعاد: | |
| معیارها: | |
| فیلترها: | |
سیستم عامل برای لیستهای پخش
این گزارش آمار بازدید را بر اساس سیستم عامل بینندگان جمعآوری میکند. برای مثال، تعداد بازدیدهای لیست پخش که در دستگاههای اندروید یا پلیاستیشن رخ داده است را مشخص میکند.
| فهرست مطالب |
|---|
| ابعاد: | |
| معیارها: | |
| فیلترها: | |
سیستم عامل و نوع دستگاه برای لیستهای پخش
این گزارش آمار بازدید را بر اساس سیستم عامل و نوع دستگاه بینندگان جمعآوری میکند. برای مثال، تعداد بازدیدهای لیست پخش که در تبلتهای اندرویدی یا دستگاههای دسکتاپ ویندوزی رخ داده است را مشخص میکند.
| فهرست مطالب |
|---|
| ابعاد: | |
| معیارها: | |
| فیلترها: | |
آمار جمعیتی بینندگان
این گزارش آمار بازدید را بر اساس گروه سنی و جنسیت بینندگان جمعآوری میکند.
| فهرست مطالب |
|---|
| ابعاد: | |
| معیارها: | |
| فیلترها: | |
برترین لیستهای پخش
توجه: این گزارشها از شما میخواهند که پارامتر maxResults را روی یک مقدار صحیح 200 یا کمتر تنظیم کنید. قبل از ۱ ژانویه ۲۰۱۳، دادهها فقط برای ۱۰ لیست پخش برتر در دسترس هستند. برخلاف اکثر گزارشهای دیگر، این گزارشها همچنین از شما میخواهند که مقداری را برای پارامتر درخواست sort مشخص کنید.
این گزارش، لیستهای پخش برتر صاحب محتوا را بر اساس معیارهای فیلتر و مرتبسازی مشخصشده فهرست میکند.
توجه: گزارشهای عملکرد تبلیغات نیاز به یک توکن مجوز دارند که دسترسی به محدوده https://www.googleapis.com/auth/yt-analytics-monetary.readonly را اعطا میکند.
گزارشهای عملکرد تبلیغات، معیارهای مبتنی بر تعداد نمایش تبلیغات را برای تبلیغاتی که در حین پخش ویدیو اجرا شدهاند، ارائه میدهند. این معیارها هر نمایش تبلیغ را در نظر میگیرند و هر پخش ویدیو میتواند چندین نمایش داشته باشد.
معیارهای عملکرد تبلیغات مبتنی بر نمایش عبارتند از:
علاوه بر این، برخی از گزارشهای ویدیویی از معیارهای عملکرد تبلیغ مبتنی بر پخش زیر پشتیبانی میکنند. با این حال، این معیارها در گزارشهای عملکرد تبلیغ لحاظ نمیشوند.
| فهرست مطالب |
|---|
| ابعاد: | |
| معیارها: | |
| فیلترها: | |
