نمونه درخواست های API

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

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

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

dimensions=day
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained
sort=day

معیارهای حاشیه نویسی روزانه برای ویدیوهای یک کانال

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

dimensions=day
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
sort=day

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

بازدید از لیست پخش روزانه برای یک کانال

این درخواست تعداد بازدیدهای روزانه (یک متریک ویدیوی انبوه )، بازدیدهای فهرست پخش (سنجه درون فهرست پخش )، شروع‌های فهرست پخش، دقیقه‌های تخمینی تماشا، و بازدیدها در هر شروع فهرست پخش را برای کانال کاربر تأیید شده بازیابی می‌کند. نتایج به ترتیب زمانی مرتب شده اند.

dimensions=day
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart
sort=day

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

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

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

dimensions=country
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained
sort=-estimatedMinutesWatched

معیارهای حاشیه نویسی خاص کشور برای ویدیوهای یک کانال

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

dimensions=country
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
sort=-annotationClickThroughRate

معیارهای ویژه استان برای ایالت های ایالات متحده و واشنگتن دی سی

این درخواست به تفکیک استان به استان تعداد بازدیدها، دقیقه‌های تخمینی تماشا، و میانگین مدت زمان مشاهده ویدیوهای کانال را بازیابی می‌کند. داده ها ایالت های ایالات متحده را پوشش می دهند و نتایج واشنگتن دی سی بر اساس کدهای ISO 3166-2 استان ها مرتب شده اند.

dimensions=province
metrics=views,estimatedMinutesWatched,averageViewDuration
filters=claimedStatus==claimed;country==US
sort=province

10 فیلم برتر - پربازدیدترین ویدیوها در یک کشور خاص

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

توجه: این گزارش از شما می‌خواهد که مقداری برای پارامتر درخواست sort مشخص کنید و پارامتر maxResults را روی مقدار صحیح 10 یا کمتر تنظیم کنید.

dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=country==US
maxResults=10
sort=-views

10 شهر برتر ایالات متحده بر اساس کل بازدیدها

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

    dimensions=city
metrics=views
filters=country==US
maxResults=10
sort=-views

10 شهر برتر ایالات متحده بر اساس کل بازدیدها برای هر نوع محتوا

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

    dimensions=city,creatorContentType
metrics=views
filters=country==US
maxResults=10
sort=-views

10 شهر برتر ایالات متحده بر اساس کل زمان تماشا

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

    dimensions=city,day
metrics=estimatedWatchTime
filters=country==US
maxResults=10
sort=-estimatedWatchTime

10 فیلم برتر - پربازدیدترین ویدیو در اروپا

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

توجه: این گزارش از شما می‌خواهد که مقداری برای پارامتر درخواست sort مشخص کنید و پارامتر maxResults را روی مقدار صحیح 10 یا کمتر تنظیم کنید.

dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=continent==150
maxResults=10
sort=-views

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

معیارهای زمان تماشای خاص کشور برای لیست‌های پخش کانال

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

dimensions=country
metrics=views,estimatedMinutesWatched,playlistStarts,averageTimeInPlaylist
sort=-estimatedMinutesWatched

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

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

توجه: از آنجایی که این گزارش از بعد playlist استفاده می کند، باید مقداری برای پارامتر درخواست sort مشخص کنید و همچنین پارامتر maxResults را روی مقدار صحیح 10 یا کمتر تنظیم کنید.

dimensions=playlist
metrics=playlistStarts,views,estimatedMinutesWatched,averageViewDuration
filters=isCurated==1;country==US
maxResults=10
sort=-playlistStarts

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

تعداد بازدید و زمان تماشا از مکان‌های پخش مختلف

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

dimensions=insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
sort=-views

تعداد نمایش روزانه و زمان تماشا از مکان‌های پخش مختلف

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

    dimensions=day,insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
filters=country==US
sort=day

10 برتر – سایت های شخص ثالثی که بیشترین بازدید را برای یک ویدیوی جاسازی شده ایجاد می کنند

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

dimensions=insightPlaybackLocationDetail
metrics=views,estimatedMinutesWatched
filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED
maxResults=10
sort=-views

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

تعداد نمایش لیست پخش و زمان تماشا از مکان‌های پخش مختلف

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

dimensions=insightPlaybackLocationType
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews
sort=-playlistStarts

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

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

dimensions=day,insightPlaybackLocationType
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews
filters=country==US
sort=day

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

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

این پرس و جو تعداد لایک ها و نپسندیدن ها را برای هر نوع محتوای یک کانال بازیابی می کند.

dimensions=creatorContentType
metrics=likes,dislikes

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

تعداد بازدید و زمان تماشا از منابع مختلف ترافیک در یک کشور

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

dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=country==US

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

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

dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched
sort=day

10 مورد برتر - عبارات جستجوی YouTube که بیشترین ترافیک را برای یک ویدیو ایجاد می کنند

این پرس و جو 10 عبارت جستجویی را که بیشترین بازدید را از نتایج جستجوی YouTube برای یک یا چند ویدیو خاص داشته اند، بازیابی می کند. نتایج بر اساس تعداد بازدید به ترتیب نزولی مرتب شده اند. توجه داشته باشید که برای اجرای این پرس و جو در APIs Explorer، باید رشته VIDEO_ID در مقدار پارامتر filters را با یک لیست جدا شده با کاما از حداکثر 500 شناسه ویدیو جایگزین کنید.

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

dimensions=insightTrafficSourceDetail
metrics=views
filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH
maxResults=10
sort=-views

10 برتر – وب سایت های خارجی که بیشترین ترافیک را برای یک ویدیو ایجاد می کنند

این پرس و جو 10 وب سایت خارجی را که بیشترین بازدید را برای یک ویدیو یا گروهی از ویدیوها ایجاد کرده اند، بازیابی می کند. نتایج بر اساس زمان تخمینی تماشا به ترتیب نزولی مرتب شده‌اند. توجه داشته باشید که برای اجرای این پرس و جو در APIs Explorer، باید رشته VIDEO_ID در مقدار پارامتر filters را با یک لیست جدا شده با کاما از حداکثر 500 شناسه ویدیو برای ویدیوهای آپلود شده خود جایگزین کنید.

dimensions=insightTrafficSourceDetail
metrics=estimatedMinutesWatched,views
filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL
maxResults=25
sort=-estimatedMinutesWatched

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

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

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

dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatchedplaylistStarts,playlistViews
filters=country==US

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

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

dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews
sort=day

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

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

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

dimensions=day,deviceType
metrics=estimatedMinutesWatched,views
filters=operatingSystem==ANDROID
sort=day

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

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

dimensions=day,operatingSystem
metrics=estimatedMinutesWatched,views
filters=deviceType==MOBILE
sort=day

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

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

dimensions=day,operatingSystem,deviceType
metrics=estimatedMinutesWatched,views
sort=day

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

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

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

dimensions=day,deviceType
metrics=views,estimatedMinutesWatched,playlistViews
filters=operatingSystem==ANDROID
sort=day

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

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

dimensions=day,operatingSystem
metrics=views,estimatedMinutesWatched
filters=deviceType==MOBILE
sort=day

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

جمعیت شناسی بینندگان در کالیفرنیا (گروه سنی و جنسیت)

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

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=province==US-CA
sort=gender,ageGroup

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

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

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

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=province==US-CA
sort=gender,ageGroup

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

این درخواست تعداد دفعاتی را که کاربران از دکمه Share برای اشتراک‌گذاری ویدیوهای یک کانال استفاده کرده‌اند، بازیابی می‌کند. نتایج با سرویس اشتراک‌گذاری (Google+، Twitter و غیره) جمع‌آوری می‌شوند و به ترتیب نزولی تعداد اشتراک‌گذاری‌ها مرتب می‌شوند.

dimensions=sharingService
metrics=shares
sort=-shares

معیارهای حفظ مخاطب برای یک ویدیو

این گزارش توانایی یک ویدیو در حفظ مخاطبان خود را می سنجد. گزارش فقط برای یک ویدیو در یک زمان قابل بازیابی است. توجه داشته باشید که برای اجرای این عبارت در APIs Explorer، باید رشته VIDEO_ID در مقدار پارامتر filters را با شناسه ویدیوی یکی از ویدیوهای آپلود شده خود جایگزین کنید. توجه داشته باشید که گزارش‌های حفظ مخاطب از قابلیت تعیین چندین مقدار برای فیلتر video پشتیبانی نمی‌کنند.

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

توجه داشته باشید که داده‌های فیلتر audienceType از 25 سپتامبر 2013 در دسترس است. API داده‌هایی را برای جستارهایی که از فیلتر برای بازیابی داده‌های تاریخ‌های قبلی استفاده می‌کنند، باز نمی‌گرداند. جستارهایی که از فیلتر استفاده نمی کنند برای هیچ تاریخی بعد از 1 ژوئیه 2008 کار می کنند.

dimensions=elapsedVideoTimeRatio
metrics=audienceWatchRatio,relativeRetentionPerformance
filters=video==VIDEO_ID;audienceType==ORGANIC

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

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

metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks

معیارهای درآمد روزانه و عملکرد تبلیغات

این درخواست معیارهای درآمد روزانه و عملکرد تبلیغات کانال را بازیابی می کند.

dimensions=day
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks

معیارهای درآمد و عملکرد تبلیغات خاص کشور

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

dimensions=country
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
sort=-estimatedRevenue

10 تا - ویدیوهایی با بالاترین درآمد

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

dimensions=video
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
maxResults=10
sort=-estimatedRevenue

معیارهای عملکرد تبلیغات برای انواع مختلف تبلیغات

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

dimensions=adType
metrics=grossRevenue,adImpressions,cpm
filters=claimedStatus==claimed
sort=-adType

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

معیارهای زمان تماشای روزانه برای محتوای بارگذاری شده توسط خود

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

dimensions=day
metrics=estimatedMinutesWatched,averageViewPercentage,views,monetizedPlaybacks,adImpressions
filters=uploaderType==self
sort=day

معیارهای حاشیه نویسی برای محتوای ادعا شده

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

dimensions=day
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
filters=claimedStatus==claimed
sort=day

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

بازدیدهای روزانه فهرست پخش برای صاحب محتوا

این درخواست معیارهایی را برای تعامل روزانه کاربر با ویدیوهای موجود در لیست پخش مالک محتوا بازیابی می کند. معیارهای بازیابی شده در گزارش عبارتند از: playlistViews ، playlistStarts ، playlistEstimatedMinutesWatched ، و viewsPerPlaylistStart . همه این معیارها معیارهای درون لیست پخش هستند. از آنجایی که تمام معیارهای درخواستی معیارهای درون لیست پخش هستند، نیازی نیست که درخواست شامل فهرست پخش یا فیلتر گروه نیز باشد.

dimensions=day
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart
sort=day

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

معیارهای زمان تماشای کشور برای محتوای بارگذاری شده توسط خود

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

dimensions=country
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,estimatedRevenue,estimatedAdRevenue,grossRevenue
filters=uploaderType==self
sort=-estimatedMinutesWatched

معیارهای حاشیه نویسی خاص کشور برای محتوای بارگذاری شده توسط خود

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

dimensions=country
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
filters=uploaderType==self
sort=-annotationClickThroughRate

معیارهای ویژه استان برای ایالت های ایالات متحده و واشنگتن دی سی

این درخواست تفکیک استان به استان تعداد بازدیدها، دقایق تخمینی تماشا و میانگین مدت زمان مشاهده ویدیوهای ادعا شده مالک محتوا را بازیابی می‌کند. داده ها ایالت های ایالات متحده را پوشش می دهند و نتایج واشنگتن دی سی بر اساس کدهای ISO 3166-2 استان ها مرتب شده اند.

dimensions=province
metrics=views,estimatedMinutesWatched,averageViewDuration
filters=claimedStatus==claimed;country==US
sort=province

10 شهر برتر ایالات متحده بر اساس کل بازدیدها

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

    dimensions=city
metrics=views
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-views

10 شهر برتر ایالات متحده بر اساس کل بازدیدها برای هر نوع محتوا

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

    dimensions=city,creatorContentType
metrics=views
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-views

10 شهر برتر ایالات متحده بر اساس کل زمان تماشا

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

    dimensions=city,day
metrics=estimatedWatchTime
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-estimatedWatchTime

10 فیلم برتر - پربیننده ترین ویدیو در اروپا

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

dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=claimedStatus==claimed;filters=continent==150
maxResults=10
sort=-estimatedMinutesWatched

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

سنجه‌های زمان تماشای کشور برای فهرست‌های پخش مالک محتوا

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

dimensions=country
metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts,averageTimeInPlaylist
sort=-playlistEstimatedMinutesWatched

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

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

توجه: از آنجایی که این گزارش از بعد playlist استفاده می کند، باید مقداری برای پارامتر درخواست sort مشخص کنید و همچنین پارامتر maxResults را روی مقدار صحیح 10 یا کمتر تنظیم کنید.

dimensions=playlist
metrics=playlistStarts,playlistViews,playlistEstimatedMinutesWatched,playlistAverageViewDuration
filters=country==US
maxResults=10
sort=-playlistStarts

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

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

این پرس و جو تعداد لایک ها و نپسندیدن ها را برای هر نوع محتوا در یک کانال خاص یا گروهی از کانال ها بازیابی می کند. توجه داشته باشید که برای اجرای این پرس و جو در APIs Explorer، باید رشته CHANNEL_ID در مقدار پارامتر filters را با یک لیست جدا شده با کاما از حداکثر 500 شناسه کانال برای کانال های خود جایگزین کنید.

dimensions=creatorContentType
metrics=likes,dislikes
filters=channel==CHANNEL_ID

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

تعداد بازدید و زمان تماشا از مکان‌های پخش مختلف

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

dimensions=insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
filters=channel==CHANNEL_ID
sort=-views

تعداد نمایش روزانه و زمان تماشا از مکان‌های پخش مختلف

این پرس و جو تعداد بازدیدهای روزانه و زمان تخمینی تماشا در ایالات متحده را برای ویدیوهای آپلود شده در یک کانال خاص یا گروهی از کانال ها بازیابی می کند. نتایج بر اساس روز برای هر نوع صفحه یا برنامه ای که در آن پخش ویدیو انجام شده است، گروه بندی می شوند. نتایج به ترتیب زمانی معکوس مرتب شده اند. توجه داشته باشید که برای اجرای این پرس و جو در APIs Explorer، باید رشته CHANNEL_ID در مقدار پارامتر filters را با یک لیست جدا شده با کاما از حداکثر 500 شناسه کانال برای کانال های خود جایگزین کنید.

dimensions=day,insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
filters=country==US;channel==CHANNEL_ID
sort=-day

10 برتر – سایت های شخص ثالثی که بیشترین بازدید را برای یک ویدیوی جاسازی شده ایجاد می کنند

این درخواست تعداد بازدیدها و زمان تخمینی تماشای یک ویدیو یا گروهی از ویدیوها را بازیابی می‌کند. نتایج توسط سایت شخص ثالثی که ویدیو در آن جاسازی شده است گروه بندی می شود. نتایج به ترتیب نزولی بر اساس تعداد بازدید مرتب شده اند. توجه داشته باشید که برای اجرای این پرس و جو در APIS Explorer ، باید String VIDEO_ID در مقدار پارامتر filters با یک لیست جدا از کاما از 500 شناسه ویدیویی برای فیلم های بارگذاری شده خود جایگزین کنید.

dimensions=insightPlaybackLocationDetail
metrics=views,estimatedMinutesWatched
filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED
maxResults=10
sort=-views

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

نمایش لیست پخش و زمان تماشای مکان های مختلف پخش

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

dimensions=insightPlaybackLocationType
metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts
sort=-playlistStarts

نمایش لیست پخش و زمان تماشای مکان های مختلف پخش

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

dimensions=day,insightPlaybackLocationType
metrics=playlistStarts,playlistViews,playlistEstimatedMinutesWatched
filters=country==US

گزارش های ویدیویی

نمای و زمان تماشای منابع مختلف ترافیک

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

dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=uploaderType==self

نمای روزانه و زمان تماشای منابع مختلف ترافیک

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

dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=uploaderType==self
sort=-day

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

10 مورد برتر - اصطلاحات جستجوی YouTube که بیشترین ترافیک را برای یک فیلم ایجاد می کند

این پرس و جو 10 اصطلاح جستجو را که بیشترین بازدید را از نتایج جستجوی YouTube برای یک فیلم یا گروه خاص از فیلم ها ایجاد می کند ، بازیابی می کند. نتایج با تعداد نمای در ترتیب نزولی طبقه بندی می شوند. توجه داشته باشید که برای اجرای این پرس و جو در APIS Explorer ، باید String VIDEO_ID در مقدار پارامتر filters با یک لیست جدا از کاما از 500 شناسه ویدیویی برای فیلم های بارگذاری شده خود جایگزین کنید.

dimensions=insightTrafficSourceDetail
metrics=views
filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH
maxResults=10
sort=-views

10 وب سایت برتر - وب سایت های خارجی که بیشترین ترافیک را برای یک فیلم ایجاد می کنند

این پرس و جو ، 10 وب سایت خارجی را که بیشترین بازدید را از نتایج جستجوی Google برای یک فیلم یا گروه خاص از فیلم ایجاد کرده اند ، بازیابی می کند. نتایج توسط زمان ساعت برآورد شده به ترتیب نزولی طبقه بندی می شوند. توجه داشته باشید که برای اجرای این پرس و جو در APIS Explorer ، باید String VIDEO_ID در مقدار پارامتر filters با یک لیست جدا از کاما از 500 شناسه ویدیویی برای فیلم های بارگذاری شده خود جایگزین کنید.

dimensions=insightTrafficSourceDetail
metrics=estimatedMinutesWatched,views
filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL
maxResults=25
sort=-estimatedMinutesWatched

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

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

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

dimensions=insightTrafficSourceType
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched
filters=country==US

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

این درخواست نماهای لیست پخش ، لیست پخش را بازیابی می کند ، و لیست پخش زمان تماشای لیست های پخش در یک یا چند کانال صاحب محتوا را تخمین می زند. معیارها توسط منبع ترافیک جمع می شوند. توجه داشته باشید که برای اجرای این پرس و جو در APIS Explorer ، باید String CHANNEL_ID در مقدار پارامتر filters با یک لیست جدا از کاما از 500 شناسه کانال برای کانال های خود جایگزین کنید.

dimensions=day,insightTrafficSourceType
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched
filters=channel==CHANNEL_ID

گزارش های ویدیویی

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

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

dimensions=day,deviceType
metrics=estimatedMinutesWatched,views
filters=claimedStatus==claimed
sort=day

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

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

dimensions=day,operatingSystem
metrics=estimatedMinutesWatched,views
filters=claimedStatus==claimed;deviceType==MOBILE
sort=day

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

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

dimensions=day,operatingSystem,deviceType
metrics=estimatedMinutesWatched,views
sort=day

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

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

این پرس و جو ، تعداد پخش لیست پخش و لیست پخش را در دستگاه های اندرویدی برای لیست های پخش در یک یا چند کانال صاحب محتوا بازیابی می کند. نتایج برای هر نوع دستگاهی که در آن مشاهده لیست پخش رخ داده است ، بازگردانده می شوند. توجه داشته باشید که برای اجرای این پرس و جو در APIS Explorer ، باید String CHANNEL_ID در مقدار پارامتر filters با یک لیست جدا از کاما از 500 شناسه کانال برای کانال های خود جایگزین کنید.

dimensions=deviceType
metrics=playlistViews,playlistEstimatedMinutesWatched
filters=channel==CHANNEL_ID;operatingSystem==ANDROID

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

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

dimensions=operatingSystem
metrics=views,estimatedMinutesWatched
filters=deviceType==MOBILE

گزارش های ویدیویی

جمعیت شناسی بیننده در کالیفرنیا (گروه سنی و جنسیت)

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

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=claimedStatus==claimed;province==US-CA
sort=gender,ageGroup

به اشتراک گذاری معیارها ، جمع شده توسط خدمات که در آن فیلم ها به اشتراک گذاشته شده اند

این درخواست تعداد دفعاتی را که کاربران از دکمه Share برای به اشتراک گذاشتن فیلم هایی که صاحب محتوا بارگذاری کرده است ، بازیابی می کند. نتایج با اشتراک سرویس (Google+ ، توییتر و غیره) جمع می شوند و به ترتیب نزولی تعداد سهام طبقه بندی می شوند.

dimensions=sharingService
metrics=shares
filters=uploaderType==self
sort=-shares

معیارهای حفظ مخاطب برای یک فیلم

این گزارش توانایی یک فیلم در حفظ مخاطبان خود را اندازه گیری می کند. این گزارش فقط می تواند برای یک فیلم واحد به طور همزمان بازیابی شود. توجه داشته باشید که برای اجرای این پرس و جو در APIS Explorer ، باید String VIDEO_ID در مقدار پارامتر filters با شناسه ویدیویی برای یکی از فیلم های بارگذاری شده خود جایگزین کنید. توجه داشته باشید که گزارش های حفظ مخاطب از توانایی مشخص کردن مقادیر مختلف برای فیلتر video پشتیبانی نمی کند.

در این مثال ، این گزارش از فیلتر audienceType برای محدود کردن پاسخ استفاده می کند به طوری که فقط حاوی داده هایی برای نمایش های ارگانیک است که نتیجه یک عمل مستقیم کاربر است ، مانند جستجوی یک فیلم یا کلیک بر روی یک فیلم پیشنهادی. به این ترتیب ، این گزارش شامل داده هایی برای بازدید از تبلیغات TrueView in-Stream یا TrueView در داخل نمایشگاه نیست. می توانید فیلتر را برای بازیابی داده های حفظ مخاطبان فیلم از انواع مخاطبان حذف کنید.

توجه داشته باشید که داده های مربوط به فیلتر audienceType از 25 سپتامبر 2013 در دسترس است. API داده هایی را برای نمایش داده شده هایی که از فیلتر استفاده می کنند برای بازیابی داده ها از تاریخ های قبلی باز نمی گرداند. نمایش داده شده هایی که از کار فیلتر برای هر تاریخ پس از 1 ژوئیه 2008 استفاده نمی کنند.

dimensions=elapsedVideoTimeRatio
metrics=audienceWatchRatio,relativeRetentionPerformance
filters=video==VIDEO_ID;audienceType==ORGANIC

معیارهای درآمد و عملکرد AD برای محتوای ادعا شده

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

metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed

درآمد روزانه و معیارهای عملکرد AD

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

dimensions=day
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed

معیارهای مربوط به درآمد و عملکرد تبلیغاتی کشور

این درخواست درآمد خاص کشور و معیارهای عملکرد AD را برای محتوای ادعا شده صاحب محتوا بازیابی می کند. نتایج به ترتیب نزولی با مبلغ درآمد طبقه بندی می شوند ، به این معنی که اولین کشور ذکر شده در جایی خواهد بود که شریک زندگی بیشترین درآمد تخمین زده شده را داشته است.

dimensions=country
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed
sort=-estimatedRevenue

10 - فیلم های برتر با بالاترین درآمد

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

dimensions=video
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed
maxResults=10
sort=-estimatedRevenue

معیارهای عملکرد تبلیغاتی برای انواع مختلف تبلیغات

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

dimensions=adType
metrics=grossRevenue,adImpressions,cpm
filters=claimedStatus==claimed
sort=-adType