فیلم، موسیقی و تلویزیون
جدول زیر فیلدهایی را که در گزارشهای مدیریتشده توسط سیستم YouTube Reporting API برای شرکای فیلم، موسیقی و تلویزیون نمایش داده میشوند، تعریف میکند:
| فیلدها | |
|---|---|
active_claims | تعداد ادعاهای فعال |
active_reference_id | شناسه تولید شده توسط یوتیوب برای مرجع فعال مرتبط. |
activity_month | ماه گزارش. |
adjustment_type | نشان میدهد که آیا ردیف نشان دهنده دادههای درآمد عادی است یا تعدیل درآمد گزارش شده قبلی:
|
administer_publish_rights | نشان میدهد که آیا ناشر موسیقی، حقوق انتشار را مدیریت میکند یا خیر، به این معنی که پرداختهای حق امتیاز را برای ترانهسرایان، آهنگسازان یا ناشران یا سایر طرفهای مالک اثر جمعآوری و مدیریت میکند. مقادیر ممکن True و False هستند. |
adsense_earnings_month | ماهی که در آن میتوانید گزارش ادسنس را جستجو کنید. |
album | آلبومی که یک فایل صوتی در آن نمایش داده میشود. حداکثر طول این مقدار ۲۵۵ بایت است. |
approx_daily_views | میانگین بازدیدهای روزانه از دارایی. |
approx_daily_engaged_views | تعداد تقریبی بازدیدهای روزانه از آن دارایی. |
artist | نام هنرمند مرتبط با دارایی شناسایی شده در ردیف گزارش. این مقدار حداکثر ۲۵۵ بایت طول دارد. |
asset_channel_id | کانالی که مالک ویدیوی آپلود شده توسط شریک است که توسط دارایی ( asset_id ) ادعا شده است. مقدار فیلد، یک شناسه کانال یوتیوب است که به طور منحصر به فرد کانال را مشخص میکند. میتوانید با استفاده از متد channels.list از API داده یوتیوب، دادههای اضافی در مورد کانال را بازیابی کنید. |
asset_custom_id | فیلد فراداده دارایی اختیاری که برای شناسایی منحصر به فرد یک دارایی، معمولاً یک کد داخلی، استفاده میشود. سایر شرکا نمیتوانند شناسههای سفارشی شما را مشاهده کنند. |
asset_id | شناسهی محتوای یوتیوب که به طور منحصر به فرد، محتوای مرتبط با دادههای موجود در ردیف را مشخص میکند. میتوانید با استفاده از متد assets.list از API شناسهی محتوای یوتیوب، دادههای اضافی در مورد محتوا را بازیابی کنید یا محتوا را در صفحهی داراییهای studio.youtube.com جستجو کنید. |
asset_labels | برچسبهای دارایی که با دارایی مرتبط هستند. برچسبهای دارایی راهی برای گروهبندی داراییها در دستههای سفارشی ارائه میدهند. سپس میتوان از این برچسبها برای جستجوی داراییها، بهروزرسانی گروههای داراییها، ایجاد کمپین برای داراییهای برچسبگذاری شده، فیلتر کردن YouTube Analytics و موارد دیگر استفاده کرد. |
asset_metadata_type | نوع دارایی برای مرجع، مانند Web یا Movie . |
asset_owners | صاحبان فعلی دارایی برای مرجع. در نسخه ۱.۱ و بالاتر، این شامل نامهای نمایشی مالک محتوا (یا شناسههای خارجی) به جای کدهای شریک است. |
asset_policy_block | مناطقی که بیمهنامه مالک آنها Block است. مقدار، کد دو حرفی کشور یا منطقه برای منطقه تروریستی است. |
asset_policy_id | شناسه منحصر به فرد برای خطمشی مالک. در حال حاضر، این مقدار فقط در API موجود است. این اطلاعات در Studio Content Manager نشان داده نمیشود. |
asset_policy_monetize | مناطقی که سیاست مالک آنها Monetize است. ارزش، کد دو حرفی کشور یا منطقه برای آن منطقه است. |
asset_policy_track | مناطقی که سیاست مالک آنها Track است. Value کد دو حرفی کشور یا منطقه برای آن منطقه است. |
asset_title | عنوان دارایی. |
asset_type | نوع دارایی. مقادیر ممکن عبارتند از:
|
audio_royalties | درآمد شناساییشده شما از درآمد ردیف یوتیوب آدیو. بر اساس محاسبهی بیشتر بین سهم صدای شریک از درآمد خالص تبلیغات صوتی و حداقل درآمد شریک به ازای هر پخش صدا. |
audio_share | نسبت پخش ردیف صوتی شریک به کل پخش ردیف صوتی. |
category | ژانر ویدیو، همانطور که در صفحه تماشای ویدیو نمایش داده میشود. مقدار آن، شناسه دسته ویدیوی یوتیوب است. میتوانید از متد videoCategories.list در API دادههای یوتیوب برای بازیابی نگاشت شناسههای دسته ویدیو به نامهای دسته استفاده کنید. |
channel_display_name | نام نمایشی کانالی که ویدیو را آپلود کرده است. |
channel_id | کانالی که مالک ویدیو ( video_id ) مرتبط با دادههای موجود در ردیف است. مقدار فیلد، یک شناسه کانال یوتیوب است که به طور منحصر به فرد کانال را مشخص میکند. میتوانید با استفاده از متد channels.list از API داده یوتیوب، دادههای اضافی در مورد کانال را بازیابی کنید. |
claiming_asset_type | نوع دارایی برای ادعا. |
claim_created_date | تاریخی که ادعا ایجاد شده است. |
claim_id | شناسه ادعای یوتیوب که به طور منحصر به فرد، دارایی مرتبط با یک ادعا در ردیف را مشخص میکند. میتوانید با استفاده از روش claims.list از API شناسه محتوای یوتیوب، دادههای اضافی در مورد دارایی را بازیابی کنید یا دارایی را در صفحه ادعاهای studio.youtube.com جستجو کنید. |
claim_origin | روشی که از طریق آن ادعای علیه ویدیو ایجاد شده است. مقادیر ممکن برای فیلدها عبارتند از:
|
claim_policy_block | مناطقی که سیاست ادعای خسارت اعمالشده در آنها Block است. مقدار، کد دو حرفی کشور/منطقه است. |
claim_policy_id | شناسه منحصر به فرد برای یک سیاست اعمال شده. در حال حاضر، این مقدار فقط در API موجود است. این اطلاعات در Studio Content Manager نشان داده نمیشود. |
claim_policy_monetize | مناطقی که سیاست مطالبه خسارت اعمالشده در آنها Monetize است. ارزش، کد دو حرفی کشور/منطقه است. |
claim_policy_track | مناطقی که سیاست ادعای خسارت اعمال شده در آنها Track است. مقدار، کد دو حرفی کشور/منطقه است. |
claim_status | مشخص میکند که آیا وضعیت یک ادعا ACTIVE ، INACTIVE یا PENDING است یا خیر. |
claim_status_detail | جزئیات مربوط به وضعیت یک ادعا، مانند CLOSED_MANUALLY . |
claim_type | نشان میدهد که آیا ادعا، بخش صوتی، تصویری یا سمعی و بصری محتوای ادعا شده را پوشش میدهد یا خیر. مقادیر معتبر برای این فیلد عبارتند از:
|
claim_quality | منبع ویدیوی ادعا شده. مقادیر ممکن برای فیلدها عبارتند از:
توجه: این فیلد در گزارشهای قابل دانلود از منوی گزارشها در YouTube Creator Studio، |
claimed_by_another_owner | نشان میدهد که آیا مالک محتوای دیگری ادعای فعال شخص اول یا شخص ثالثی روی ویدیو دارد یا خیر. |
claimed_by_this_owner | نشان میدهد که آیا صاحب محتوایی که گزارش را تولید میکند، ادعای فعال شخص اول یا شخص ثالثی در مورد ویدیو دارد یا خیر. |
comments_allowed | نشان میدهد که آیا امکان ارسال نظر برای ویدیو وجود دارد یا خیر. |
composition_right_type | انواع حقوق مربوط به ترکیببندی مرتبط با ادعا را مشخص میکند. مقادیر معتبر برای این فیلد عبارتند از:
|
conflicting_country_code | کدهای کشوری ISO برای سرزمینهایی که مالکیت آنها با سایر شرکا اختلاف دارد. |
conflicting_owner | شناسههای شریک برای سایر شرکایی که مالکیت آنها با یکدیگر در تضاد است. |
conflicting_owner_artist | هنرمندان از دارایی مالک متعارض. |
conflicting_owner_asset_title | سند مالکیت دارایی از مالک متعارض. |
conflicting_owner_isrc | ISRC دارایی از مالک متعارض. |
content_type | منبع ویدیوی ادعا شده. مقادیر ممکن عبارتند از:
|
constituent_asset_id | شناسه قبلی که یک دارایی قبل از ادغام داشته است. |
constituent_asset_ids | شناسههای قبلی که داراییها قبل از ادغام داشتند. |
country | کشوری را که فعالیت در آن رخ داده است، مشخص میکند. |
country_code | کد کشور محل وقوع فعالیت را مشخص میکند. مقدار آن کد کشور ISO 3166-1 alpha-2 است. |
currency | نشان دهنده واحد پولی است که ردیف نشان دهنده آن است. |
currency_code | کد ارزی را که ردیف نشان میدهد، نشان میدهد. |
custom_id | یک مقدار منحصر به فرد که شما، ارائه دهنده ابرداده، برای شناسایی یک دارایی استفاده میکنید. این مقدار میتواند یک شناسه منحصر به فرد باشد که شما برای دارایی ایجاد کردهاید یا یک شناسه استاندارد مانند ISRC. این مقدار حداکثر 64 بایت طول دارد و میتواند شامل کاراکترهای الفبایی-عددی، خط فاصله (-)، زیرخط (_)، نقطه (.)، نمادهای "at" (@) یا اسلش (/) باشد. |
date | تاریخی که فعالیت رخ داده است. این مقدار با فرمت YYYYMMDD است. |
date_created | تاریخ و زمانی که مرجع بر حسب UTC ایجاد شده است. |
date_id | تاریخی که فعالیت رخ داده است. این مقدار با فرمت YYYYMMDD است. |
day | روزی که فعالیت رخ داده است. |
director | مدیر مرتبط با دارایی. |
directors | مدیران مرتبط با دارایی. |
display_ads_enabled | نشان میدهد که آیا تبلیغات شخص ثالث در ویدیو نمایش داده میشود یا خیر. |
display_isrc | ISRC نمایش داده شده برای دارایی. |
effective_policy | سیاست استفادهای که در قلمرو مالکیت مالک محتوا بر ویدیو اعمال میشود. |
eidr | رجیستری شناسه سرگرمی (EIDR) که به یک فیلم یا قسمت تلویزیونی اختصاص داده شده است. این مقدار شامل یک پیشوند استاندارد برای رجیستری EIDR است که به دنبال آن یک اسلش، یک رشته هگزادسیمال 20 کاراکتری و یک کاراکتر کنترلی الفبایی-عددی (0-9A-Z) میآید. |
embedding_allowed | نشان میدهد که آیا میتوان ویدیو را در وبسایتهای شخص ثالث جاسازی کرد یا خیر. |
end_date | تاریخ و زمان پایان. |
engaged_views | تعداد کل بازدیدهای تعاملی ایجاد شده توسط کاربران پشتیبانی شده توسط تبلیغات. |
engaged_views_in_conflict | تعداد بازدیدهای مرتبط با محتوای متناقض. |
episode_number | شماره قسمت مرتبط با ویدیو. |
episode_title | عنوان یک قسمت از سریال تلویزیونی یا فیلم. |
excluded_perc | درصد مرجعی که حذف شده است، بر اساس کل موارد حذف و طول. |
exclusions | بخشهایی از مرجع که حذف شدهاند و نوع حذف (مثلاً همپوشانی مرجع، حذف دستی، بخش نامعتبر). انواع حذف موجود:
|
grid | شناسه انتشار جهانی، یک فیلد فراداده اختیاری که برای شناسایی منحصر به فرد یک دارایی استفاده میشود. مقدار این فیلد دقیقاً شامل ۱۸ کاراکتر الفبایی-عددی است. |
has_multiple_claims | نشان میدهد که آیا بیش از یک ادعا در ویدیو وجود دارد یا خیر. اگر یک ادعا در ویدیو وجود داشته باشد، مقدار false و اگر بیش از یک ادعا وجود داشته باشد، true برمیگرداند.توجه: این فیلد در گزارشهای قابل دانلود از منوی گزارشها در YouTube Creator Studio، Multiple Claims? نامیده میشود. |
hfa | کد شش کاراکتری که توسط آژانس هری فاکس (HFA) برای شناسایی منحصر به فرد یک اثر منتشر شده است. |
hfa_song_code | کد شش کاراکتری که توسط آژانس هری فاکس (HFA) برای شناسایی منحصر به فرد یک اثر منتشر شده است. |
inactive_reference_id | شناسه تولید شده توسط یوتیوب برای مرجع غیرفعال مرتبط. |
is_made_for_kids_effective_setting | تنظیم «ساخته شده برای کودکان» برای ویدیو مؤثر است. |
is_made_for_kids_modifiable | نشان میدهد که آیا تنظیمات «ساخته شده برای کودکان» توسط کاربر قابل تغییر است یا خیر. |
is_made_for_kids_user_selection | نشان میدهد که آیا ویدیو توسط کاربر به عنوان «ساخته شده برای کودکان» مشخص شده است یا خیر. |
is_merged | نشان میدهد که آیا دارایی به دلیل ادغام دارایی ایجاد شده است یا خیر. |
is_shorts_eligible | نشان میدهد که آیا ویدیو واجد شرایط نمایش در بخش Shorts هست یا خیر. |
isrc | کد استاندارد بینالمللی ضبط (ISRC) مربوط به دارایی مرتبط. مقدار این فیلد دقیقاً شامل ۱۲ کاراکتر الفبایی-عددی است. |
iswc | کد استاندارد بینالمللی آثار موسیقی (ISWC) مربوط به دارایی آهنگسازی. مقدار این فیلد دقیقاً شامل ۱۱ کاراکتر در قالب یک حرف (T) و به دنبال آن ۱۰ رقم است. |
label | ناشری که یک فایل صوتی را منتشر کرده است. این مقدار حداکثر ۲۵۵ بایت طول دارد. |
lifetime_engaged_views_in_conflict | دیدگاههای درگیرکنندهی مادامالعمر برای محتوای در تضاد. |
lifetime_views_in_conflict | دیدگاههای مادامالعمر برای محتوای در تضاد. |
length_sec | طول مرجع بر حسب ثانیه. |
local_currency | نوع ارز محلی که درآمد با آن پرداخت میشود. |
longest_match | طولانیترین بخش منطبق از یک ادعا. |
long_nonskippable_video_ads_enabled | منسوخشده: این فیلد منسوخ شده و همیشه با No پر میشود. قبلاً مشخص شده بود که آیا تبلیغات طولانی غیرقابل رد کردن شخص ثالث میتوانند در طول ویدیو پخش شوند یا خیر. |
match_policy | سیاست تطبیق اعمال شده برای دارایی. |
matching_duration | کل مدت زمان تطابق یک ادعا. |
metadata_origination | منبع فرادادهی دارایی. |
monetized_views | تعداد کل پخشهای صوتی و تصویری که به محتوای شما در سرویس اشتراک YouTube Premium نسبت داده شدهاند. این مقدار فقط برای شرکای موسیقی مرتبط است. |
monetized_views_art_track_audio | تعداد پخشهای صوتی از آهنگهای هنری که به محتوای شما در سرویس اشتراک YouTube Premium نسبت داده شدهاند. این فیلد فقط برای شرکای موسیقی پشتیبانی میشود. |
monetized_views_art_track_audio_visual | تعداد پخشهای صوتی و تصویری مربوط به آهنگهای هنری که به محتوای شما در سرویس اشتراک YouTube Premium نسبت داده شدهاند. این فیلد فقط برای شرکای موسیقی پشتیبانی میشود. |
monetized_views_audio | تعداد کل پخشهای صوتی که در سرویس اشتراک YouTube Premium به محتوای شما نسبت داده شدهاند. این مقدار مجموع فیلدهای monetized_views_art_track_audio ، monetized_views_partner_owned_audio و monetized_views_ugc_audio است. این فیلد فقط برای شرکای موسیقی پشتیبانی میشود. |
monetized_views_audio_visual | تعداد کل پخشهای صوتی و تصویری که در سرویس اشتراک YouTube Premium به محتوای شما نسبت داده شدهاند. این مقدار مجموع فیلدهای monetized_views_art_track_audiovisual ، monetized_views_partner_owned_audiovisual و monetized_views_ugc_audiovisual است. این فیلد فقط برای شرکای موسیقی پشتیبانی میشود. |
monetized_views_partner_owned_audio | تعداد پخشهای صوتیِ محتوای موزیک ویدیوی رسمیِ ارائه شده توسط شریک که به محتوای شما در سرویس اشتراک YouTube Premium نسبت داده شدهاند. این فیلد فقط برای شرکای موسیقی پشتیبانی میشود. |
monetized_views_partner_owned_audio_visual | تعداد پخشهای صوتی و تصویری مربوط به محتوای موزیک ویدیوی رسمی ارائه شده توسط شریک که به محتوای شما در سرویس اشتراک YouTube Premium نسبت داده شدهاند. این فیلد فقط برای شرکای موسیقی پشتیبانی میشود. |
monetized_views_total_sub_service | مجموع تمام بازدیدهای پولی فقط صوتی و سمعی و بصری در تمام محتوای ادعایی شرکای موسیقی یوتیوب در سرویس اشتراک یوتیوب پریمیوم. این مقدار فقط برای شرکای موسیقی در دسترس است. |
monetized_views_ugc_audio | تعداد پخشهای صوتیِ محتوای تولید شده توسط کاربر (UGC) که به محتوای شما در سرویس اشتراک YouTube Premium نسبت داده شدهاند. UGC به ویدیوهای آپلود شده توسط کاربر اشاره دارد که با آنها مانند محتوای دارای مجوز ارائه شده توسط شریک برای اشتراک درآمد رفتار نمیشود. این فیلد فقط برای شرکای موسیقی پشتیبانی میشود. |
monetized_views_ugc_audio_visual | تعداد پخشهای صوتی و تصویری فعال از محتوای تولید شده توسط کاربر (UGC) که به محتوای شما در سرویس اشتراک YouTube Premium نسبت داده شدهاند. UGC به ویدیوهای آپلود شده توسط کاربر اشاره دارد که با آنها مانند محتوای دارای مجوز ارائه شده توسط شریک برای تقسیم درآمد رفتار نمیشود. این فیلد فقط برای شرکای موسیقی پشتیبانی میشود. |
monetized_views_ugc_master_audio_visual | تعداد کل پخشهای ضبطشدهی اصلی صوتی و تصویری که به محتوای شما در سرویس اشتراک YouTube Premium نسبت داده شدهاند. این مقدار فقط برای شرکای موسیقی مرتبط است. |
monetized_views_ugc_cover_audio_visual | تعداد کل ویدیوهای تولید شده توسط کاربران که در سرویس اشتراک یوتیوب پریمیوم به محتوای شما نسبت داده شدهاند. این مقدار فقط برای شرکای موسیقی مرتبط است. |
monetized_views_ugc_cover_shared_audio_visual | تعداد کل بازدیدهای فعال برای ویدیوی کاور تولید شده توسط کاربر با تقسیم درآمد سهجانبه که به محتوای شما در سرویس اشتراک YouTube Premium نسبت داده شده است. این مقدار فقط برای شرکای موسیقی مرتبط است. |
monetized_watchtime | کل زمان تماشای ویدیوهای غیر از موزیک ویدیوهای شما در اشتراک پریمیوم یوتیوب، بر حسب ثانیه. |
month | ماهی که فعالیت در آن رخ داده است. |
midrolls_enabled | نشان میدهد که آیا تبلیغات میانپرده میتوانند برای ویدیو پخش شوند یا خیر. تبلیغات میانپرده، تبلیغات ویدیویی هستند که در طول یک ویدیو یا رویداد دیگر ظاهر میشوند. به عنوان مثال، یک تبلیغ ویدیویی میانپرده ممکن است در فواصل زمانی یک فیلم بلند نمایش داده شود. تبلیغات میانپرده فقط برای محتوای دارای مجوز هستند. |
multiple_claims | نشان میدهد که آیا بیش از یک ادعا در ویدیو وجود دارد یا خیر. اگر یک ادعا در ویدیو وجود داشته باشد، مقدار false و اگر بیش از یک ادعا وجود داشته باشد، true برمیگرداند.توجه: این فیلد در گزارشهای قابل دانلود از منوی گزارشها در YouTube Creator Studio، Multiple Claims? نامیده میشود. |
music_claim_type | نشان میدهد که آیا ادعا، بخش صوتی، تصویری یا سمعی و بصری محتوای ادعا شده را پوشش میدهد یا خیر. مقادیر معتبر برای این فیلد عبارتند از:
|
music_share | درصد فعالیت موسیقی به ازای هر کشور و پیشنهاد. |
net_partner_revenue | درآمد خالص برای شریک. |
net_partner_revenue_post_revshare | درآمد خالص برای شریک پس از اعمال تقسیم سهم درآمد. |
revshare_rate_type | نوع نرخ بهره اشتراکی اعمال شده برای درآمد. |
nonskippable_video_ads_enabled | نشان میدهد که آیا تبلیغات غیرقابل رد کردن شخص ثالث برای ویدیو پخش میشوند یا خیر. تبلیغات ویدیویی درون برنامهای در حین پخش ویدیوی محتوا نمایش داده میشوند. |
notes | در صورت وجود پرداختهای تعدیل معوق، نشاندهنده پرداخت ماه قبل است. |
offweb_syndicatable | مشخص میکند که آیا ویدیو میتواند خارج از مرورگر نمایش داده شود یا خیر. |
overlay_ads_enabled | نشان میدهد که آیا تبلیغات روی ویدیو پخش میشوند یا خیر. تبلیغات روی ویدیو، تبلیغات نمایشی هستند که پس از ۱۰ ثانیه روی ویدیو نمایش داده میشوند. |
other_isrc | ISRC ارائه شده توسط شریک دیگر برای دارایی. |
other_owners_claiming | نام سایر صاحبان محتوا که ادعاهایی در مورد ویدیو دارند. |
other_ownership_origination | منبع پیدایش مالکیت برای سایر مالکان. |
owned_views | تعداد بازدیدهای فعال از محتوای متعلق به شما که سیاستی که برای محتوا تعیین کردهاید، یا کسب درآمد است یا پیگیری. گزارشهای تبلیغات یوتیوب و گزارشهای اشتراک یوتیوب پریمیوم برای محتوای غیر از موسیقی، هر دو حاوی فیلد policy هستند که نشان میدهد آیا سیاست مرتبط با دادهها monetize بوده یا track . |
owned_subscription_views | تعداد کل بازدیدهای فعال از محتوای متعلق به شما از مشترکین YouTube Premium که سیاست محتوا برای آنها یا کسب درآمد است یا ردیابی. |
ownership | مالک یک دارایی در سرزمینهای خاص. |
ownership_last_updated | تاریخ و زمان آخرین بهروزرسانی مالکیت. |
ownership_origination | منبع پیدایش مالکیت. |
ownership_percentage | درصد ترکیبی که شما در اختیار دارید. |
partner_audio_ad_revshare | سهم درآمد شما از ردیف صوتی یوتیوب Pro Rata با در نظر گرفتن نرخ(های) اشتراک نسخه. برای محاسبهی بیشترین مقدار محاسبه استفاده میشود. |
partner_audio_ad_revshare_rate | نرخ سهم درآمد تبلیغات شریک. |
partner_playbacks | پخشهای مربوط به محتوای شما در سرویس YouTube Audio Tier. |
partner_revenue | درآمد شما از تبلیغات به دلار آمریکا پس از اعمال تقسیم سهم درآمد. این فیلد در گزارشهای تبلیغات یوتیوب نمایش داده میشود. فیلد youtube_revenue_split شامل کل درآمد قبل از اعمال تقسیم سهم درآمد است. |
partner_revenue_art_track | سهم درآمد اشتراک YouTube Premium شما برای محتوای آهنگ هنری که در حالت سمعی و بصری پخش میشود. |
partner_revenue_audio | سهم درآمد اشتراک YouTube Premium شما برای محتوایی که در حالت فقط صوتی پخش میشود. |
partner_revenue_local | درآمد شما از تبلیغات به واحد پول محلی پس از اعمال تقسیم سهم درآمد. این فیلد در گزارشهای تبلیغات یوتیوب نمایش داده میشود. فیلد youtube_revenue_split شامل کل درآمد قبل از اعمال تقسیم سهم درآمد است. |
partner_revenue_usd | درآمد شما از تبلیغات پس از اعمال تقسیم سهم درآمد. این فیلد در گزارشهای تبلیغات یوتیوب نمایش داده میشود. فیلد youtube_revenue_split شامل کل درآمد قبل از اعمال تقسیم سهم درآمد است. |
partner_revenue_auction | درآمد شما از تبلیغات AdSense که به صورت حراجی فروخته میشوند. |
partner_revenue_per_play_min | درآمد بر اساس حداقلهای هر بازی محاسبه میشود. برای محاسبهی بیشترین درآمد هنگام تجمیع در سطح کشور استفاده میشود. |
partner_revenue_per_sub_min | درآمد هر کشور بر اساس حداقلهای هر مشترک محاسبه میشود؛ برای محاسبهی بیشترین مقدار محاسبه استفاده میشود. |
partner_revenue_pro_rata | سهم درآمد اشتراک Pro Rata YouTube Premium شما، با در نظر گرفتن نرخ(های) revshare. |
partner_revenue_pro_rata_audio | سهم درآمد شما از اشتراک Pro Rata YouTube Premium برای محتوایی که در حالت فقط صوتی پخش میشود. |
partner_revenue_pro_rata_audio_per_sub_min | سهم درآمد شما از اشتراک Pro Rata YouTube Premium برای محتوایی که فقط به صورت صوتی پخش میشود. |
partner_revenue_pro_rata_audio_visual | سهم درآمد شما از اشتراک Pro Rata YouTube Premium برای محتوایی که در حالت سمعی و بصری پخش میشود. |
partner_revenue_pro_rata_partner_owned | سهم درآمد شما از اشتراک Pro Rata YouTube Premium برای محتوای آپلود شده توسط شریک که در حالت سمعی و بصری پخش میشود. |
partner_revenue_pro_rata_ugc | سهم درآمد شما از اشتراک Pro Rata YouTube Premium برای محتوای UGC که در حالت سمعی و بصری پخش میشود. |
partner_revenue_pro_rata_art_track | سهم درآمد شما از اشتراک Pro Rata YouTube Premium برای محتوای Art Track که در حالت سمعی و بصری پخش میشود. |
partner_revenue_partner_sold_partner_served | درآمد شما از تبلیغاتی که فروختهاید و از سرورهای تبلیغاتی خارجی خودتان ارائه میدهید. |
partner_revenue_partner_sold_youtube_served | درآمد شما از تبلیغات فروخته شده از طریق DoubleClick for Publishers (DFP) پس از اعمال تقسیم سهم درآمد. |
partner_revenue_reserved | درآمد شما از تبلیغات فروختهشده از طریق DoubleClick (DCLK) و سایر منابع فروختهشده در YouTube پس از اعمال تقسیم سهم درآمد. |
partner_revenue_ugc | درآمد شما از محتوای تولید شده توسط کاربر. |
payment_period | دوره زمانی که پرداخت انجام شده است. |
per_play_minimum | نرخ حداقل هر بازی در آن کشور خاص. |
per_play_minimum_currency | واحد پول برای حداقل تعداد پخش صدا در هر قطعه. |
per_play_minimum_partner_revenue | درآمد بر اساس حداقلهای هر بازی محاسبه میشود. برای محاسبهی بیشترین مقدار محاسبه استفاده میشود. |
per_sub_min_rate | درآمد هر کشور بر اساس حداقلهای هر مشترک محاسبه میشود؛ برای محاسبهی بیشترین مقدار محاسبه استفاده میشود. |
per_subs_min_rate | نرخ Per Sub Min در آن کشور خاص. |
policy | سیاستی که برای ویدیو اعمال شده است. مقدار آن یا monetize است یا track . |
pool_participating_rate | سهم بازار مبتنی بر تبلیغات (AVOD) از تمام شرکای شرکتکننده در این مجموعه پویا نسبت به رقیب اصلی. |
postrolls_enabled | نشان میدهد که آیا تبلیغات پس از پخش ویدیو میتوانند پخش شوند یا خیر. تبلیغات پس از پخش ویدیو یا پخش زندهای که بیننده در حال تماشای آن است، پخش میشوند. |
prerolls_enabled | نشان میدهد که آیا تبلیغات پیش از پخش ویدیو میتوانند پخش شوند یا خیر. تبلیغات پیش از پخش، قبل از ویدیو یا پخش زندهای که بیننده در حال تماشای آن است، پخش میشوند. گاهی اوقات بیش از یک تبلیغ پیش از پخش پخش میشود. |
provider | نام صاحب محتوا که مرجع را ارائه داده است. |
ratings_allowed | نشان میدهد که آیا رتبهبندی برای ویدیو فعال است یا خیر. |
record_label | نام ناشر موسیقی از فرادادهی فایل. فقط برای شرکای موسیقی مرتبط است. |
reference_id | شناسه تولید شده توسط یوتیوب برای مرجع مرتبط با یک ادعا. این فیلد برای ادعاهای آپلود شده توسط شریک خالی خواهد بود. |
reference_type | نوع یا کانال مرجع، مانند Audio ، Visual ، AudioVisual . |
reference_video_id | شناسه ویدیوی تولید شده توسط یوتیوب برای یک مرجع. فقط در صورتی اعمال میشود که ادعا با مرجعی که از یک ویدیوی یوتیوب ایجاد شده است، مرتبط باشد. |
release_date | تاریخ انتشار از فرادادههای دارایی. فقط برای شرکای تلویزیونی/سینمایی مرتبط است. |
revenue_source | منبع درآمد را نشان میدهد. مقادیر ممکن عبارتند از:
|
revenue_type | نوع درآمدی را که ردیف نشان میدهد، نشان میدهد. |
right_type | انواع حقوق مربوط به ترکیببندی مرتبط با ادعا را مشخص میکند. مقادیر معتبر برای این فیلد عبارتند از:
|
season | شماره فصل مربوط به یک قسمت تلویزیونی. حداکثر طول این فیلد ۵ بایت است. |
shorts_flat_fee_revenue_usd | درآمد ثابت کارمزد به دلار آمریکا برای فروشهای کوتاهمدت. |
shorts_monthly_pool_usd | درآمد ماهانه به دلار آمریکا برای استخر شورت. |
shorts_partner_revenue_usd | درآمد شریک به دلار آمریکا برای فروشهای کوتاهمدت. |
shorts_usages_marketshare | سهم بازار برای استفاده از شلوارک. |
skippable_video_ads_enabled | نشان میدهد که آیا تبلیغات ویدیویی قابل رد شدن برای ویدیو فعال هستند یا خیر. تبلیغات درون برنامهای قابل رد شدن، قبل، حین یا بعد از سایر ویدیوها در یوتیوب و وبسایتها و برنامههای شرکای ویدیویی گوگل پخش میشوند. پس از ۵ ثانیه، بیننده میتواند تبلیغ را رد کند و به تماشای ویدیو ادامه دهد. |
source_of_fingerprint | منبع اثر انگشت برای یک فایل مرجع مشخص. |
sponsored_cards_enabled | نشان میدهد که آیا کارتهای حمایتشده برای ویدیو فعال هستند یا خیر. کارتهای اطلاعات محصول حمایتشده به بینندگان اجازه میدهند محصولاتی را که در ویدیوها میبینند، خریداری کنند. |
sr_approx_daily_engaged_views | تعداد تقریبی بازدیدهای روزانهی مربوط به ضبط صدا. |
start_date | تاریخ و زمان شروع. |
status | وضعیت دارایی را نشان میدهد. مقادیر ممکن active یا inactive هستند. |
status_detail | جزئیات یا دلیل بیشتری در مورد وضعیت فایل مرجع ارائه میدهد. این فیلد فقط در نسخه ۱.۱ گزارش هفتگی مراجع موجود است. |
studio | استودیوی مرتبط با دارایی. |
subscribers | تعداد مشترکین. |
tax_withholding_rate | نرخ کسر مالیات قابل اجرا در گزارش کسر مالیات. |
tax_withheld_amount | مبلغ مالیات کسر شده در گزارش کسر مالیات. |
third_party_ads_enabled | نشان میدهد که آیا تبلیغات شخص ثالث برای ویدیو فعال است یا خیر. |
third_party_video_id | شناسه ویدیویی ارائه شده توسط شریک که توسط شریک برای شناسایی ویدیو جهت اهداف تبلیغاتی استفاده میشود. |
time_published | تاریخ و زمان انتشار ویدیو در یوتیوب با فرمت MM/DD/YYYY HH:MM:SS . این فیلد برای ویدیوهایی که هرگز عمومی نشدهاند (یعنی ویدیوهای خصوصی یا ویدیوهای ثبت نشده) خالی خواهد بود. |
time_uploaded | تاریخ و زمان آپلود ویدیو در یوتیوب با فرمت MM/DD/YYYY HH:MM:SS . |
tms | مقدار شناسه ۱۲ تا ۱۴ کاراکتری Tribune Media Systems (TMS) که به طور منحصر به فرد یک فیلم یا قسمت تلویزیونی را مشخص میکند. |
total_playbacks | کل پخشها در سرویس YouTube Audio Tier. |
total_revenue_by_source | کل درآمد بر اساس منبع، مانند درآمد حاصل از تبلیغات یا حق اشتراک. |
total_views | تعداد کل بازدیدهای ایجاد شده توسط تبلیغات توسط کاربران پشتیبانی شده. |
unlaunched_territories_adjustment | تنظیم استخر شورت برای سرزمینهای راهاندازی نشده. |
upc | کد جهانی محصول (UPC)، یک فیلد فراداده اختیاری که برای شناسایی منحصر به فرد یک دارایی استفاده میشود. |
uploader | نام صاحب محتوایی که ویدیو را آپلود کرده است. |
upload_source | روشی که برای آپلود ویدیو در یوتیوب استفاده میشود. |
us_sourced_revenue | میزان درآمدی که از ایالات متحده آمریکا حاصل میشود. |
usd_local_rate | نرخ تبدیل مورد استفاده برای تبدیل دلار آمریکا به پول رایج محلی. این مقدار نشان دهنده میانگین نرخ تراکنشهای روزانه در طول دوره گزارشدهی است. |
username | نام مالک محتوای یوتیوب. |
video_channel_id | شناسه کانال تولید شده توسط یوتیوب برای کانالی که ویدیوی ادعا شده را منتشر کرده است. |
video_duration | طول ویدیو. |
video_duration_sec | مدت زمان ویدیو بر حسب ثانیه. |
video_id | ویدیوی ادعا شده مرتبط با دادههای موجود در ردیف. مقدار فیلد، شناسه ویدیوی یوتیوب است که به طور منحصر به فرد ویدیو را مشخص میکند. میتوانید با استفاده از متد videos.list از API دادههای یوتیوب، دادههای اضافی در مورد ویدیو را بازیابی کنید. |
video_length | مدت زمان ویدیو بر حسب ثانیه. |
video_matching_length | کل مدت زمان منطبق در ویدیوی ادعا شده. |
video_privacy_status | مشخص میکند که آیا ویدیو عمومی، خصوصی یا فهرست نشده است. |
video_title | عنوان ویدیو مرتبط با دادههای موجود در ردیف. |
video_upload_date | تاریخ انتشار ویدیوی ادعا شده. |
video_url | آدرس اینترنتی (URL) ویدیو در یوتیوب. |
views | تعداد دفعاتی که ویدیو دیده شده است. |
writers | فهرستی از نویسندگانِ قطعهی موسیقی که با حروفِ جدا از هم مشخص شدهاند. |
youtube_revenue_split | برای ناشران موسیقی، شرکای فیلم و تلویزیون: کل درآمد تبلیغات یوتیوب از محتوای شما. این مبلغ متعاقباً بر اساس نرخ سهم درآمد تقسیم میشود. فیلد برای ناشران موسیقی: کل درآمد تبلیغات یوتیوب از محتوای شما، با احتساب مالکیت دارایی، اما قبل از تقسیم بر اساس نرخ سهم درآمد. فیلد |
youtube_revenue_split_auction | برای ناشران موسیقی، شرکای فیلم و تلویزیون: کل درآمد حاصل از تبلیغات AdSense که به صورت حراجی فروخته شدهاند، قبل از اعمال تقسیم سهم درآمد. برای ناشران موسیقی: کل درآمد حاصل از تبلیغات AdSense فروخته شده در حراج، با احتساب مالکیت دارایی، اما قبل از اعمال تقسیم سهم درآمد. |
youtube_revenue_split_partner_sold_partner_served | برای ناشران موسیقی، شرکای فیلم و تلویزیون: کل درآمد حاصل از تبلیغات فروخته شده توسط شریک و ارائه شده توسط شریک. این مبلغ متعاقباً بر اساس نرخ سهم درآمد تقسیم میشود. درآمد حاصل از تبلیغات فروخته برای ناشران موسیقی: کل درآمد حاصل از تبلیغات فروخته شده توسط شریک، تبلیغات ارائه شده توسط شریک، با احتساب مالکیت دارایی. این مبلغ متعاقباً بر اساس نرخ سهم درآمد تقسیم میشود. درآمد حاصل از تبلیغات فروخته شده توسط شریک و تبلیغات ارائه شده |
youtube_revenue_split_partner_sold_youtube_served | برای ناشران موسیقی، فیلم و شرکای تلویزیونی: کل درآمد حاصل از DoubleClick برای ناشران (DFP). این مبلغ متعاقباً بر اساس نرخ سهم درآمد تقسیم میشود. درآمد برای ناشران موسیقی: کل درآمد حاصل از DoubleClick for Publishers (DFP)، با احتساب مالکیت دارایی. این مبلغ متعاقباً بر اساس نرخ سهم درآمد تقسیم میشود. درآمد |
youtube_revenue_split_reserved | برای ناشران موسیقی، شرکای فیلم و تلویزیون: کل درآمد حاصل از تبلیغات رزرو شده از طریق DoubleClick (DCLK) و سایر منابع فروخته شده توسط YouTube. این مبلغ متعاقباً بر اساس نرخ سهم درآمد تقسیم میشود. برای ناشران موسیقی: کل درآمد حاصل از تبلیغات رزرو شده از طریق DoubleClick (DCLK) و سایر منابع فروخته شده در YouTube، با احتساب مالکیت دارایی. این مبلغ متعاقباً بر اساس نرخ سهم درآمد تقسیم میشود. |
your_isrc | ISRC که برای دارایی ارائه دادید. |
ساعات پربیننده
جدول زیر فیلدهایی را که در گزارشهای مدیریتشده توسط سیستم YouTube Reporting API برای شرکای برنامهنویسی Primetime نمایش داده میشوند، تعریف میکند:
| فیلدها | |
|---|---|
AgeGroup | گروه سنی بینندگان در گزارش. توجه داشته باشید که برای فهرست شدن یک گروه سنی خاص، باید حداقل ۵۰ رویداد تماشا توسط اعضای آن گروه سنی وجود داشته باشد. مقادیر ممکن فیلد عبارتند از:
|
AverageViewDuration | میانگین تعداد ثانیههای مشاهدهشده از برنامه در تمام رویدادهای مشاهده. |
AverageViewPercent | میانگین درصد برنامهای که در تمام رویدادهای تماشا مشاهده شده است. |
CallSign | در صورت لزوم، علامت تماس ایستگاهی که برنامه از آن پخش شده است را مشخص کنید. |
ConcurrentViewers | تعداد کل رویدادهای مشاهده که طی آنها یک دقیقه خاص از قسمت، که با مقدار فیلد MinutesSinceStart مشخص میشود، مشاهده شده است. |
ContentId | یک مقدار منحصر به فرد که شما، ارائه دهنده فراداده، برای شناسایی یک دارایی استفاده میکنید و آن را به YouTube ارائه دادهاید. میتوانید از این مقدار برای تطبیق دارایی با سیستم مدیریت محتوای خود استفاده کنید. این مقدار میتواند یک شناسه منحصر به فرد باشد که شما برای دارایی ایجاد کردهاید یا یک شناسه استاندارد، مانند شناسه TMS. این مقدار حداکثر ۶۴ بایت طول دارد و میتواند شامل کاراکترهای الفبایی-عددی، خط فاصله (-)، زیرخط (_)، نقطه (.)، نمادهای "at" (@) یا اسلش (/) باشد. |
ContentLength | مدت زمان برنامه به ثانیه. توجه داشته باشید که مدت زمان تبلیغات برای برنامههای VOD با درج تبلیغات پویا (DAI) لحاظ نشده است. |
ContentType | نحوهی مشاهدهی محتوا توسط بیننده. مقادیر ممکن برای این فیلد عبارتند از:
|
Date | تاریخی که نمایش برنامه در آن رخ داده است. این مقدار با فرمت YYYYMMDD است. |
DeviceType | نوع دستگاهی که بیننده محتوا را در آن تماشا کرده است. توجه داشته باشید که برای فهرست شدن یک نوع دستگاه خاص، باید حداقل ۵۰ رویداد مشاهده وجود داشته باشد. مقادیر ممکن فیلد عبارتند از:
|
DmaId | شناسهی سه رقمی که نیلسن برای شناسایی منطقهی بازار تعیینشده (DMA) مرتبط با رویدادهای مشاهدهای شرح داده شده در ردیف دادهها استفاده میکند. |
EpisodeNumber | در صورت لزوم، شماره قسمت متوالی برنامه را در فصل مشخص شده مشخص میکند. فصل توسط فیلد SeasonNumber مشخص میشود. برای مثال، این مقدار برای قسمت اول فصل دوم یک برنامه 1 خواهد بود. |
Gender | The gender of the viewers in the report. Note that there must be at least 50 viewing events by members of a particular gender for that gender to be listed. Possible field values are:
|
MinutesSinceStart | The number of minutes from the start of a program when the viewing event started. Note that this number includes both program time and ad time with the exception of on-demand (VOD) programming that uses dynamic ad insertion (DAI). For VOD programming with DAI, the number includes only program time. |
Network | The station or network that released the content or on which the content aired. |
PeakConcurrentViewers | The maximum number of concurrent viewing events at any given minute of a particular program. |
Platform | The manner in which the viewer watched the content. Possible field values are:
|
ProgramTitle | The title or name of the episode, movie, or event. |
ProgramType | The type of program that the viewer watched. Possible field values are:
|
PublishDateTime | The program's airing date or release date. The value is in YYYY-MM-DD format. |
SeasonNumber | The season number associated with the program. The field has a maximum length of 5 bytes. |
SeriesTitle | The title of the series associated with the data in the report row. For example, for a TV program, this value would specify the name of the show, and the ProgramTitle field would specify the title of the episode. |
TmsId | The 12- to 14-character Tribune Media Systems (TMS) ID value that uniquely identifies the program. |
TotalWatchTime | The total amount of time, in seconds, that the program was watched across all viewing events. |
ViewersComplete | The total number of live, DVR, and VOD viewing events during which the viewer stopped watching the video during a particular minute, which is identified by the MinutesSinceStart field value. If the MinutesSinceStart value represents a value shorter than the entire program ( ContentLength ), then these viewers stopped watching prior to the end of the program. |
ViewersResume | The total number of viewing events in which the viewer starts either a DVR program or a VOD program at any point other than within the first minute (minute 0) of the video. |
ViewersStart | The total number of viewing events in which any of the following are true:
|
Views | The total numbers of times that the program was viewed across all viewing events. |