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

فیلترها

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

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

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

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

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

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

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

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

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

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

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

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

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

آمار اولیه

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

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

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

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

مبتنی بر زمان

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

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

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

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

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

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

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

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

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

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

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

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

جزئیات پخش

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

جزئیات پخش بر اساس کشور با معیار میانگینViewPercentage

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

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

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

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

جزئیات پخش بر اساس استان با معیار میانگینViewPercentage

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

مکان های پخش

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

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

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

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

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

منابع ترافیک

منبع ترافیک

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

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

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

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

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

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

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

نوع دستگاه

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

سیستم عامل

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

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

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

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

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

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

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

حفظ مخاطب

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

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

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

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

ویدیوهای برتر به طور کلی، بر اساس کشور، قاره، یا بر اساس شبه قاره (<= 200 نتیجه)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

آمار اولیه

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

مبتنی بر زمان

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

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

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

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

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

مکان های پخش

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

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

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

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

منابع ترافیک

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• درآمد ناخالص
• adImpressions
• cpm

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

• playbackBasedCpm
• پخش های پولی

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