YouTube Analytics API: Channel Reports

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

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

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

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

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

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

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

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

مجوز

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

درخواست‌های YouTube Analytics API از حوزه‌های مجوز زیر استفاده می‌کنند:

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

فیلترها

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

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

برای توضیح کامل نحوه فیلتر کردن نتایج 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 مشخص کنید.

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

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

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

جزئیات پخش

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

مکان های پخش

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

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

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

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

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

منابع ترافیک

منبع ترافیک

این گزارش آمار بازدید را بر اساس روشی که بینندگان به محتوای ویدیوی شما می‌رسند جمع‌آوری می‌کند. به عنوان مثال، تعداد بازدیدهایی را که از جستجوی 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 با طول مشابه حفظ می کند.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

آمار اولیه

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

مبتنی بر زمان

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

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

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

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

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

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

مکان های پخش

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

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

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

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

منابع ترافیک

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

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

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

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

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

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

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

نوع دستگاه

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

سیستم عامل

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

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

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

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

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

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

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

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

لغو عضویت

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

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

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

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

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

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

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

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

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