YouTube Analytics API: Content Owner Reports

توجه: Content owner reports are only accessible to YouTube content partners who participate in the YouTube Partner Program .

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

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

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

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

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

برای بازیابی گزارش مالک محتوا، با روش reports.query API تماس بگیرید و مقدار پارامتر ids در درخواست API روی contentOwner== OWNER_NAME تنظیم کنید، جایی که OWNER_NAME شناسه مالک محتوا را مشخص می‌کند. از مدیر شریک خود بپرسید که آیا از ارزش آن مطمئن نیستید.

مجوز

همه درخواست‌های 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 دامنه دسترسی می‌دهد.

فیلترها

همه درخواست‌های API برای بازیابی گزارش‌های مالک محتوا باید داده‌ها را با استفاده از بعد video ، بعد channel ، بعد isCurated یا ترکیبی از ابعاد claimedStatus و uploaderType فیلتر کنند. (ترکیب های پشتیبانی شده در تعریف بعد uploaderType ذکر شده است.)

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

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

برای توضیح کامل نحوه فیلتر کردن نتایج 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 یا بیشتر: شما این امکان را دارید که یک یا همه مقادیر را از گروه اضافه کنید.
مهم: همه درخواست‌های API برای بازیابی گزارش‌های ویدیویی مالک محتوا باید داده‌ها را با استفاده از بعد ویدیو ، بعد کانال ، بعد گروه یا ترکیبی از ابعاد ادعاشده وضعیت و آپلودکننده تایپ فیلتر کنند. (برخی گزارش‌ها از همه این گزینه‌ها پشتیبانی نمی‌کنند.) ترکیب‌های پشتیبانی شده، که در تعریف بعد uploaderType نیز ذکر شده‌اند، عبارتند از:
  • uploaderType==self
  • claimedStatus==claimed
  • claimedStatus==claimed;uploaderType==self
  • claimedStatus==claimed;uploaderType==thirdParty

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

آمار اولیه

آمار اولیه (از جمله تعداد مشترکین)

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

فهرست
ابعاد:
[هیچ یک]
معیارهای:
از 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 *
فیلترها:
دقیقا از 1 استفاده کنید video , channel , group , or a supported combination of uploaderType and claimedStatus
از 0 یا 1 استفاده کنید country , continent , subContinent

آمار پایه ایالت های آمریکا

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

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

مبتنی بر زمان

فعالیت برای دوره های زمانی

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

فهرست
ابعاد:
دقیقا از 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 *
فیلترها:
دقیقا از 1 استفاده کنید video , channel , group , or a supported combination of uploaderType and claimedStatus
از 0 یا 1 استفاده کنید country , continent , subContinent

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

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

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

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

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

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

فهرست
ابعاد:
ضروری 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 *
فیلترها:
دقیقا از 1 استفاده کنید video , channel , group , or a supported combination of uploaderType and claimedStatus
از 0 یا 1 استفاده کنید continent , subContinent

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

این گزارش آمار فعالیت کاربران را برای ایالت های ایالات متحده و ناحیه کلمبیا ارائه می دهد. برای این گزارش، باید مقدار پارامتر 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
فیلترها:
دقیقا از 1 استفاده کنید video , channel , group , or a supported combination of uploaderType and claimedStatus
ضروری country ==US

فعالیت کاربر بر اساس شهر (<= 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
فیلترها:
دقیقا از 1 استفاده کنید video , channel , group , or a supported combination of uploaderType and claimedStatus
از 0 یا 1 استفاده کنید country , province , continent , subContinent
گزینه های مرتب سازی: - 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
فیلترها:
دقیقا از 1 استفاده کنید video , channel , group , or a supported combination of uploaderType and claimedStatus
از 0 یا 1 استفاده کنید country , continent , subContinent
اختیاری 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
فیلترها:
دقیقا از 1 استفاده کنید video , channel , group , or a supported combination of uploaderType and claimedStatus
ضروری province
اختیاری subscribedStatus

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

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

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

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

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

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

فهرست
ابعاد:
از 0 یا بیشتر استفاده کنید creatorContentType , subscribedStatus , youtubeProduct
از 0 یا 1 استفاده کنید day , month
معیارهای:
از 1 یا بیشتر استفاده کنید views , redViews , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration , averageViewPercentage
فیلترها:
دقیقا از 1 استفاده کنید video , channel , group , or a supported combination of uploaderType and claimedStatus
از 0 یا 1 استفاده کنید country , province , continent , subContinent
از 0 یا بیشتر استفاده کنید subscribedStatus , youtubeProduct

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

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

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

فهرست
ابعاد:
اختیاری country
از 0 یا بیشتر استفاده کنید creatorContentType , liveOrOnDemand , subscribedStatus , youtubeProduct
معیارهای:
از 1 یا بیشتر استفاده کنید views , redViews , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration
فیلترها:
دقیقا از 1 استفاده کنید video , channel , group , or a supported combination of uploaderType and claimedStatus
از 0 یا 1 استفاده کنید continent , subContinent
از 0 یا بیشتر استفاده کنید liveOrOnDemand , subscribedStatus , youtubeProduct
جزئیات پخش بر اساس کشور با معیار میانگینViewPercentage

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

فهرست
ابعاد:
اختیاری country
از 0 یا بیشتر استفاده کنید creatorContentType , subscribedStatus , youtubeProduct
معیارهای:
از 1 یا بیشتر استفاده کنید views , redViews , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration , averageViewPercentage
فیلترها:
دقیقا از 1 استفاده کنید video , channel , group , or a supported combination of uploaderType and claimedStatus
از 0 یا 1 استفاده کنید continent , subContinent
از 0 یا بیشتر استفاده کنید subscribedStatus , youtubeProduct

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

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

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

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

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

فهرست
ابعاد:
اختیاری province
از 0 یا بیشتر استفاده کنید creatorContentType , subscribedStatus , youtubeProduct
معیارهای:
از 1 یا بیشتر استفاده کنید views , redViews , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration , averageViewPercentage
فیلترها:
دقیقا از 1 استفاده کنید video , channel , group , or a supported combination of uploaderType and claimedStatus
ضروری country ==US
از 0 یا بیشتر استفاده کنید subscribedStatus , youtubeProduct

مکان های پخش

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

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

فهرست
ابعاد:
ضروری insightPlaybackLocationType
از 0 یا بیشتر استفاده کنید creatorContentType , day , liveOrOnDemand , subscribedStatus
معیارهای:
از 1 یا بیشتر استفاده کنید views , estimatedMinutesWatched
فیلترها:
دقیقا از 1 استفاده کنید video , channel , group , or a supported combination of uploaderType and claimedStatus
از 0 یا 1 استفاده کنید country , province , continent , subContinent
از 0 یا بیشتر استفاده کنید liveOrOnDemand , subscribedStatus

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

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

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

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

منابع ترافیک

منبع ترافیک

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

فهرست
ابعاد:
ضروری insightTrafficSourceType
از 0 یا بیشتر استفاده کنید creatorContentType , day , liveOrOnDemand , subscribedStatus
معیارهای:
از 1 یا بیشتر استفاده کنید views , estimatedMinutesWatched
فیلترها:
دقیقا از 1 استفاده کنید video , channel , group , or a supported combination of uploaderType and claimedStatus
از 0 یا 1 استفاده کنید country , province , continent , subContinent
از 0 یا بیشتر استفاده کنید liveOrOnDemand , subscribedStatus

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

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

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

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

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

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

نوع وسیله

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

فهرست
ابعاد:
ضروری deviceType
از 0 یا بیشتر استفاده کنید creatorContentType , day , liveOrOnDemand , subscribedStatus , youtubeProduct
معیارهای:
از 1 یا بیشتر استفاده کنید views , estimatedMinutesWatched
فیلترها:
دقیقا از 1 استفاده کنید video , channel , group , or a supported combination of uploaderType and claimedStatus
از 0 یا 1 استفاده کنید country , province , continent , subContinent
از 0 یا بیشتر استفاده کنید operatingSystem , liveOrOnDemand , subscribedStatus , youtubeProduct

سیستم عامل

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

فهرست
ابعاد:
ضروری operatingSystem
از 0 یا بیشتر استفاده کنید creatorContentType , day , liveOrOnDemand , subscribedStatus , youtubeProduct
معیارهای:
از 1 یا بیشتر استفاده کنید views , estimatedMinutesWatched
فیلترها:
دقیقا از 1 استفاده کنید video , channel , group , or a supported combination of uploaderType and claimedStatus
از 0 یا 1 استفاده کنید country , province , continent , subContinent
از 0 یا بیشتر استفاده کنید deviceType , liveOrOnDemand , subscribedStatus , youtubeProduct

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

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

فهرست
ابعاد:
ضروری operatingSystem , deviceType
از 0 یا بیشتر استفاده کنید creatorContentType , day , liveOrOnDemand , subscribedStatus , youtubeProduct
معیارهای:
از 1 یا بیشتر استفاده کنید views , estimatedMinutesWatched
فیلترها:
دقیقا از 1 استفاده کنید video , channel , group , or a supported combination of uploaderType and claimedStatus
از 0 یا 1 استفاده کنید country , province , continent , subContinent
از 0 یا بیشتر استفاده کنید liveOrOnDemand , subscribedStatus , youtubeProduct

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

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

فهرست
ابعاد:
از 1 یا بیشتر استفاده کنید ageGroup , gender
از 0 یا بیشتر استفاده کنید creatorContentType , liveOrOnDemand , subscribedStatus
معیارهای:
از 1 یا بیشتر استفاده کنید viewerPercentage
فیلترها:
دقیقا از 1 استفاده کنید video , channel , group , or a supported combination of uploaderType and claimedStatus
از 0 یا 1 استفاده کنید country , province , continent , subContinent
از 0 یا بیشتر استفاده کنید liveOrOnDemand , subscribedStatus
توجه: مقادیر viewerPercentage در این گزارش برای مقادیر مختلف بعد جزئیات پخش subscribedStatus عادی نشده است.

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

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

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

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

فهرست
ابعاد:
ضروری sharingService
اختیاری creatorContentType , subscribedStatus
معیارهای:
از 1 یا بیشتر استفاده کنید shares
فیلترها:
دقیقا از 1 استفاده کنید video , channel , group , or a supported combination of uploaderType and claimedStatus
از 0 یا 1 استفاده کنید country , continent , subContinent
اختیاری 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 *
فیلترها:
دقیقا از 1 استفاده کنید channel or a supported combination of uploaderType and claimedStatus
از 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
فیلترها:
دقیقا از 1 استفاده کنید channel or a supported combination of uploaderType and claimedStatus
ضروری province
گزینه های مرتب سازی: - 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
فیلترها:
دقیقا از 1 استفاده کنید channel or a supported combination of uploaderType and claimedStatus
اختیاری subscribedStatus
از 0 یا 1 استفاده کنید country , continent , subContinent
گزینه های مرتب سازی: - views
- redViews
- estimatedMinutesWatched
- estimatedRedMinutesWatched

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

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

فهرست
ابعاد:
ضروری video
اختیاری creatorContentType
معیارهای:
از 1 یا بیشتر استفاده کنید views , redViews , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration , averageViewPercentage
فیلترها:
دقیقا از 1 استفاده کنید channel or a supported combination of uploaderType and claimedStatus
از 0 یا 1 استفاده کنید country , province , continent , subContinent
از 0 یا بیشتر استفاده کنید subscribedStatus , youtubeProduct
گزینه های مرتب سازی: - views
- redViews
- estimatedMinutesWatched
- estimatedRedMinutesWatched

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

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

فهرست
ابعاد:
ضروری video
اختیاری creatorContentType
معیارهای:
از 1 یا بیشتر استفاده کنید views , redViews , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration
فیلترها:
دقیقا از 1 استفاده کنید channel or a supported combination of uploaderType and claimedStatus
از 0 یا 1 استفاده کنید country , province , continent , subContinent
از 0 یا بیشتر استفاده کنید liveOrOnDemand , subscribedStatus , youtubeProduct
گزینه های مرتب سازی: - views
- redViews
- estimatedMinutesWatched
- estimatedRedMinutesWatched

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

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

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

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

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

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

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

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

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

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

آمار اولیه

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

توصیه شده
فهرست
ابعاد:
[هیچ یک]
معیارهای:
از 1 یا بیشتر استفاده کنید views , estimatedMinutesWatched , averageViewDuration , averageTimeInPlaylist , playlistAverageViewDuration , playlistEstimatedMinutesWatched , playlistSaves , playlistStarts , playlistViews , viewsPerPlaylistStart
فیلترها:
استفاده از 0 یا 1 * playlist , group

Note: Exactly one of these filters must be specified if any of the views , estimatedMinutesWatched , or averageViewDuration metrics is requested in the report.
اختیاری channel
با استفاده از isCurated
فهرست
ابعاد:
[هیچ یک]
معیارهای:
از 1 یا بیشتر استفاده کنید views , redViews , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration , playlistStarts , viewsPerPlaylistStart , averageTimeInPlaylist
فیلترها:
ضروری isCurated ==1
از 0 یا 1 استفاده کنید channel , playlist , group
از 0 یا 1 استفاده کنید country , province , continent , subContinent
از 0 یا بیشتر استفاده کنید subscribedStatus , youtubeProduct

مبتنی بر زمان

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

توصیه شده
فهرست
ابعاد:
دقیقا از 1 استفاده کنید day , month
معیارهای:
از 1 یا بیشتر استفاده کنید views , estimatedMinutesWatched , averageViewDuration , averageTimeInPlaylist , playlistAverageViewDuration , playlistEstimatedMinutesWatched , playlistSaves , playlistStarts , playlistViews , viewsPerPlaylistStart
فیلترها:
استفاده از 0 یا 1 * playlist , group

Note: Exactly one of these filters must be specified if any of the views , estimatedMinutesWatched , or averageViewDuration metrics is requested in the report.
اختیاری channel
با استفاده از isCurated
فهرست
ابعاد:
دقیقا از 1 استفاده کنید day , month
از 0 یا بیشتر استفاده کنید subscribedStatus , youtubeProduct
معیارهای:
از 1 یا بیشتر استفاده کنید views , redViews , estimatedMinutesWatched , estimatedRedMinutesWatched , averageViewDuration , playlistStarts , viewsPerPlaylistStart , averageTimeInPlaylist
فیلترها:
ضروری isCurated ==1
از 0 یا 1 استفاده کنید channel , 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 استفاده کنید continent , subContinent
از 0 یا 1 استفاده کنید playlist , channel , group
از 0 یا بیشتر استفاده کنید subscribedStatus , youtubeProduct

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

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

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

مکان های پخش

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

توصیه شده
فهرست
ابعاد:
ضروری insightPlaybackLocationType
معیارهای:
از 1 یا بیشتر استفاده کنید views , estimatedMinutesWatched , averageViewDuration , averageTimeInPlaylist , playlistAverageViewDuration , playlistEstimatedMinutesWatched , playlistStarts , playlistViews , viewsPerPlaylistStart
فیلترها:
استفاده از 0 یا 1 * playlist , group

Note: Exactly one of these filters must be specified if any of the views , estimatedMinutesWatched , or averageViewDuration metrics is requested in the report.
اختیاری channel
با استفاده از isCurated
فهرست
ابعاد:
ضروری insightPlaybackLocationType
از 0 یا بیشتر استفاده کنید day , subscribedStatus
معیارهای:
از 1 یا بیشتر استفاده کنید views , estimatedMinutesWatched , playlistStarts , viewsPerPlaylistStart , averageTimeInPlaylist
فیلترها:
ضروری isCurated ==1
از 0 یا 1 استفاده کنید country , province , continent , subContinent
از 0 یا 1 استفاده کنید playlist , channel , group
اختیاری subscribedStatus

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

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

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

توصیه شده
فهرست
ابعاد:
ضروری insightPlaybackLocationDetail
معیارهای:
از 1 یا بیشتر استفاده کنید views , estimatedMinutesWatched , averageViewDuration , averageTimeInPlaylist , playlistAverageViewDuration , playlistEstimatedMinutesWatched , playlistStarts , playlistViews , viewsPerPlaylistStart
فیلترها:
ضروری insightPlaybackLocationType ==EMBEDDED
استفاده از 0 یا 1 * playlist , group

Note: Exactly one of these filters must be specified if any of the views , estimatedMinutesWatched , or averageViewDuration metrics is requested in the report.
اختیاری channel
گزینه های مرتب سازی: - playlistViews
- playlistEstimatedMinutesWatched
- playlistStarts
با استفاده از isCurated
فهرست
ابعاد:
ضروری insightPlaybackLocationDetail
معیارهای:
از 1 یا بیشتر استفاده کنید views , estimatedMinutesWatched , playlistStarts , viewsPerPlaylistStart , averageTimeInPlaylist
فیلترها:
ضروری isCurated ==1; insightPlaybackLocationType ==EMBEDDED
از 0 یا 1 استفاده کنید country , province , continent , subContinent
از 0 یا 1 استفاده کنید playlist , channel , group
اختیاری subscribedStatus
گزینه های مرتب سازی: - views
- estimatedMinutesWatched
- playlistStarts

منابع ترافیک

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

توصیه شده
فهرست
ابعاد:
ضروری insightTrafficSourceType
معیارهای:
از 1 یا بیشتر استفاده کنید views , estimatedMinutesWatched , averageViewDuration , averageTimeInPlaylist , playlistAverageViewDuration , playlistEstimatedMinutesWatched , playlistSaves , playlistStarts , playlistViews , viewsPerPlaylistStart
فیلترها:
استفاده از 0 یا 1 * playlist , group

Note: Exactly one of these filters must be specified if any of the views , estimatedMinutesWatched , or averageViewDuration metrics is requested in the report.
اختیاری channel
با استفاده از isCurated
فهرست
ابعاد:
ضروری insightTrafficSourceType
از 0 یا بیشتر استفاده کنید day , subscribedStatus
معیارهای:
از 1 یا بیشتر استفاده کنید views , estimatedMinutesWatched , playlistStarts , viewsPerPlaylistStart , averageTimeInPlaylist
فیلترها:
ضروری isCurated ==1
از 0 یا 1 استفاده کنید country , province , continent , subContinent
از 0 یا 1 استفاده کنید playlist , channel , group
اختیاری subscribedStatus

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

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

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

توصیه شده
فهرست
ابعاد:
ضروری insightTrafficSourceDetail
معیارهای:
از 1 یا بیشتر استفاده کنید views , estimatedMinutesWatched , averageViewDuration , averageTimeInPlaylist , playlistAverageViewDuration , playlistEstimatedMinutesWatched , playlistSaves , playlistStarts , playlistViews , viewsPerPlaylistStart
فیلترها:
ضروری insightTrafficSourceType
استفاده از 0 یا 1 * playlist , group

Note: Exactly one of these filters must be specified if any of the views , estimatedMinutesWatched , or averageViewDuration metrics is requested in the report.
اختیاری channel
گزینه های مرتب سازی: - playlistViews
- playlistEstimatedMinutesWatched
- playlistStarts
با استفاده از isCurated
فهرست
ابعاد:
ضروری insightTrafficSourceDetail
معیارهای:
از 1 یا بیشتر استفاده کنید views , estimatedMinutesWatched , playlistStarts , viewsPerPlaylistStart , averageTimeInPlaylist
فیلترها:
ضروری isCurated ==1; insightTrafficSourceType
از 0 یا 1 استفاده کنید country , province , continent , subContinent
از 0 یا 1 استفاده کنید playlist , channel , group
اختیاری subscribedStatus
گزینه های مرتب سازی: - views
- estimatedMinutesWatched
- playlistStarts

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

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

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

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

توصیه شده
فهرست
ابعاد:
ضروری deviceType
معیارهای:
از 1 یا بیشتر استفاده کنید views , estimatedMinutesWatched , averageViewDuration , averageTimeInPlaylist , playlistAverageViewDuration , playlistEstimatedMinutesWatched , playlistStarts , playlistViews , viewsPerPlaylistStart
فیلترها:
استفاده از 0 یا 1 * playlist , group

Note: Exactly one of these filters must be specified if any of the views , estimatedMinutesWatched , or averageViewDuration metrics is requested in the report.
اختیاری channel
با استفاده از isCurated
فهرست
ابعاد:
ضروری deviceType
از 0 یا بیشتر استفاده کنید day , subscribedStatus , youtubeProduct
معیارهای:
از 1 یا بیشتر استفاده کنید views , estimatedMinutesWatched , playlistStarts , viewsPerPlaylistStart , averageTimeInPlaylist
فیلترها:
ضروری isCurated ==1
از 0 یا 1 استفاده کنید country , province , continent , subContinent
از 0 یا 1 استفاده کنید playlist , channel , group
از 0 یا بیشتر استفاده کنید operatingSystem , subscribedStatus , youtubeProduct

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

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

توصیه شده
فهرست
ابعاد:
ضروری operatingSystem
معیارهای:
از 1 یا بیشتر استفاده کنید views , estimatedMinutesWatched , averageViewDuration , averageTimeInPlaylist , playlistAverageViewDuration , playlistEstimatedMinutesWatched , playlistStarts , playlistViews , viewsPerPlaylistStart
فیلترها:
استفاده از 0 یا 1 * playlist , group

Note: Exactly one of these filters must be specified if any of the views , estimatedMinutesWatched , or averageViewDuration metrics is requested in the report.
اختیاری channel
با استفاده از isCurated
فهرست
ابعاد:
ضروری operatingSystem
از 0 یا بیشتر استفاده کنید day , subscribedStatus , youtubeProduct
معیارهای:
از 1 یا بیشتر استفاده کنید views , estimatedMinutesWatched , playlistStarts , viewsPerPlaylistStart , averageTimeInPlaylist
فیلترها:
ضروری isCurated ==1
از 0 یا 1 استفاده کنید country , province , continent , subContinent
از 0 یا 1 استفاده کنید playlist , channel , group
از 0 یا بیشتر استفاده کنید deviceType , subscribedStatus , youtubeProduct

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

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

توصیه شده
فهرست
ابعاد:
ضروری deviceType , operatingSystem
معیارهای:
از 1 یا بیشتر استفاده کنید views , estimatedMinutesWatched , averageViewDuration , averageTimeInPlaylist , playlistAverageViewDuration , playlistEstimatedMinutesWatched , playlistStarts , playlistViews , viewsPerPlaylistStart
فیلترها:
استفاده از 0 یا 1 * playlist , group

Note: Exactly one of these filters must be specified if any of the views , estimatedMinutesWatched , or averageViewDuration metrics is requested in the report.
اختیاری channel
با استفاده از isCurated
فهرست
ابعاد:
ضروری deviceType , operatingSystem
از 0 یا بیشتر استفاده کنید day , subscribedStatus , youtubeProduct
معیارهای:
از 1 یا بیشتر استفاده کنید views , estimatedMinutesWatched , playlistStarts , viewsPerPlaylistStart , averageTimeInPlaylist
فیلترها:
ضروری isCurated ==1
از 0 یا 1 استفاده کنید country , province , continent , subContinent
از 0 یا 1 استفاده کنید playlist , channel , group
از 0 یا بیشتر استفاده کنید subscribedStatus , youtubeProduct

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

فهرست
ابعاد:
ضروری adType
اختیاری day
معیارهای:
از 1 یا بیشتر استفاده کنید grossRevenue , adImpressions , cpm
فیلترها:
دقیقا از 1 استفاده کنید video , group , or a supported combination of uploaderType and claimedStatus
از 0 یا 1 استفاده کنید country , continent , subContinent