فیلم، موسیقی و تلویزیون
جدول زیر فیلدهایی را تعریف میکند که در گزارشهای مدیریت شده توسط سیستم API گزارش YouTube برای شرکای فیلم، موسیقی و تلویزیون ظاهر میشوند:
فیلدها | |
---|---|
active_claims | تعداد ادعاهای فعال |
active_reference_id | شناسه تولید شده توسط YouTube برای مرجع فعال مرتبط. |
activity_month | ماه گزارش |
adjustment_type | نشان میدهد که آیا ردیف دادههای درآمد عادی را نشان میدهد یا تعدیلی در درآمد گزارششده قبلی:
|
administer_publish_rights | نشان میدهد که آیا برچسب موسیقی حقوق انتشار را مدیریت میکند یا خیر، به این معنی که پرداختهای حق امتیاز را برای ترانهسراها، آهنگسازان، یا ناشران یا سایر احزاب صاحب آهنگ جمعآوری و مدیریت میکند. مقادیر ممکن True و False هستند. |
adsense_earnings_month | ماه درآمدی که در آن می توان از گزارش AdSense پرس و جو کرد. |
album | آلبومی که صدای ضبط شده در آن ظاهر می شود. این مقدار حداکثر 255 بایت طول دارد. |
approx_daily_views | میانگین بازدید روزانه از دارایی. |
artist | نام هنرمند مرتبط با دارایی مشخص شده در ردیف گزارش. این مقدار حداکثر 255 بایت طول دارد. |
asset_channel_id | کانالی که مالک ویدیوی بارگذاری شده توسط شریک است که توسط این دارایی ادعا شده است ( asset_id ). مقدار فیلد یک شناسه کانال YouTube است که به طور منحصر به فرد کانال را شناسایی می کند. با استفاده از روش channels.list YouTube Data API میتوانید دادههای اضافی درباره کانال را بازیابی کنید. |
asset_custom_id | فیلد فراداده دارایی اختیاری که برای شناسایی منحصر به فرد یک دارایی، معمولاً یک کد داخلی، استفاده میشود. شرکای دیگر نمی توانند شناسه های سفارشی شما را ببینند. |
asset_id | شناسه دارایی YouTube که دارایی مرتبط با دادههای ردیف را بهطور منحصربهفرد شناسایی میکند. میتوانید با استفاده از روش assets.list در YouTube Content ID API دادههای اضافی درباره دارایی را بازیابی کنید یا دارایی را در صفحه دارایی studio.youtube.com جستجو کنید. |
asset_labels | برچسبهای دارایی که با دارایی مرتبط هستند. برچسبهای دارایی راهی برای گروهبندی داراییها در دستههای سفارشی ارائه میکنند. سپس میتوان از این برچسبها برای جستجوی داراییها، بهروزرسانی گروههای دارایی، ایجاد کمپین برای داراییهای برچسبدار، فیلتر کردن YouTube Analytics و موارد دیگر استفاده کرد. |
asset_metadata_type | نوع دارایی برای مرجع، مانند Web یا فیلم. |
asset_owners | صاحبان دارایی فعلی برای مرجع. |
asset_policy_block | مناطقی که خطمشی مالک در آنها Block است. ارزش، کد دو حرفی کشور یا منطقه برای تروریسم است. |
asset_policy_id | شناسه منحصر به فرد برای یک خط مشی مالک. در حال حاضر، این مقدار فقط در API موجود است. این اطلاعات در مدیریت محتوای استودیو نشان داده نمیشود. |
asset_policy_monetize | مناطقی که خطمشی مالک آن Monetize است. Value کد دو حرفی کشور یا منطقه برای قلمرو است. |
asset_policy_track | مناطقی که خطمشی مالک آن Track است. Value کد دو حرفی کشور یا منطقه برای قلمرو است. |
asset_title | عنوان دارایی |
asset_type | نوع دارایی مقادیر ممکن عبارتند از:
|
audio_royalties | درآمد شناسایی شده شما از درآمد ردیف صوتی YouTube. بر اساس محاسبه بیشتر بین سهم صوتی شریک از درآمد خالص تبلیغات صوتی و حداقل درآمد شریک صوتی در هر بازی. |
audio_share | نسبت پخشهای ردیف صوتی شریک به کل پخشهای ردیف صوتی. |
category | ژانر ویدیو، همانطور که در صفحه تماشای ویدیو نشان داده شده است. مقدار یک شناسه دسته ویدیوی YouTube است. میتوانید از روش YouTube Data API's videoCategories.list برای بازیابی نگاشت شناسههای دستهبندی ویدیو به نام دستهها استفاده کنید. |
channel_display_name | نام نمایشی کانالی که ویدیو را آپلود کرده است. |
channel_id | کانالی که مالک ویدیو ( video_id ) مرتبط با داده های ردیف است. مقدار فیلد یک شناسه کانال YouTube است که به طور منحصر به فرد کانال را شناسایی می کند. با استفاده از روش channels.list YouTube Data API میتوانید دادههای اضافی درباره کانال را بازیابی کنید. |
claiming_asset_type | نوع دارایی برای ادعا |
claim_created_date | تاریخی که ادعا ایجاد شد. |
claim_id | شناسه ادعای YouTube که دارایی مرتبط با ادعا را در ردیف به طور منحصربهفرد شناسایی میکند. میتوانید با استفاده از روش claims.list در YouTube Content ID API دادههای اضافی درباره دارایی را بازیابی کنید یا دارایی را در صفحه ادعاهای studio.youtube.com جستجو کنید. |
claim_origin | روشی که با آن ادعا علیه ویدیو ایجاد شد. مقادیر احتمالی فیلد عبارتند از:
|
claim_policy_block | مناطقی که سیاست ادعای اعمال شده Block است. مقدار کد کشور/منطقه دو حرفی است. |
claim_policy_id | شناسه منحصر به فرد برای یک خط مشی کاربردی. در حال حاضر، این مقدار فقط در API موجود است. این اطلاعات در مدیریت محتوای استودیو نشان داده نمیشود. |
claim_policy_monetize | مناطقی که خطمشی ادعای اعمالشده، Monetize است. مقدار کد کشور/منطقه دو حرفی است. |
claim_policy_track | مناطقی که خطمشی ادعای اعمالشده Track است. مقدار کد کشور/منطقه دو حرفی است. |
claim_status | مشخص می کند که وضعیت یک ادعا ACTIVE , INACTIVE یا PENDING باشد . |
claim_status_detail | جزئیات درباره وضعیت یک ادعا، مانند CLOSED_MANUALLY . |
claim_type | نشان می دهد که آیا این ادعا شامل بخش صوتی، تصویری یا سمعی بصری محتوای ادعا شده است یا خیر. مقادیر معتبر برای این فیلد عبارتند از:
|
claim_quality | منبع ویدیوی ادعا شده مقادیر احتمالی فیلد عبارتند از:
توجه: این فیلد |
claimed_by_another_owner | نشان می دهد که آیا مالک محتوای دیگری ادعای شخص اول یا شخص ثالث فعالی در مورد ویدیو دارد یا خیر. |
claimed_by_this_owner | نشان می دهد که آیا مالک محتوایی که گزارش را ایجاد می کند، ادعای شخص اول یا شخص ثالث فعالی در مورد ویدیو دارد. |
comments_allowed | نشان می دهد که آیا نظرات برای ویدیو فعال هستند یا خیر. |
composition_right_type | انواع حقوق ترکیب مرتبط با ادعا را مشخص می کند. مقادیر معتبر برای این فیلد عبارتند از:
|
conflicting_country_code | کدهای کشور ISO برای مناطق دارای تضاد مالکیت با شرکای دیگر. |
conflicting_owner | شناسههای شریک برای شرکای دیگر با مالکیت متضاد. |
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 | نشان می دهد که آیا تبلیغات شخص ثالث در ویدیو نمایش داده می شود یا خیر. |
effective_policy | خطمشی استفادهای که برای ویدیو در قلمرو مالکیت مالک محتوا اعمال میشود. |
eidr | Entertainment Identifier Registry (EIDR) که به یک قسمت فیلم یا تلویزیون اختصاص داده شده است. این مقدار حاوی یک پیشوند استاندارد برای رجیستری EIDR است که به دنبال آن یک اسلش رو به جلو، یک رشته هگزادسیمال 20 کاراکتری و یک کاراکتر بررسی الفبایی (0-9A-Z) قرار دارد. |
embedding_allowed | نشان می دهد که آیا ویدیو می تواند در وب سایت های شخص ثالث جاسازی شود یا خیر. |
end_date | تاریخ و زمان پایان |
episode_number | شماره قسمت مرتبط با ویدیو. |
episode_title | عنوان یک قسمت تلویزیونی یا سینمایی. |
excluded_perc | درصد مرجعی که بر اساس کل استثناها و طول حذف شده است. |
exclusions | بخشهایی از مرجع حذف شده و نوع حذف (مثلاً همپوشانی مرجع، حذف دستی، بخش نامعتبر). انواع حذف موجود:
|
grid | شناسه انتشار جهانی، یک فیلد فراداده اختیاری است که برای شناسایی منحصر به فرد دارایی استفاده می شود. مقدار فیلد دقیقاً شامل 18 کاراکتر الفبایی است. |
has_multiple_claims | نشان می دهد که آیا بیش از یک ادعا در مورد ویدیو وجود دارد یا خیر. اگر یک ادعا در مورد ویدیو وجود داشته باشد، مقدار false است و اگر بیش از یک ادعا وجود داشته باشد، true .توجه: این فیلد Multiple Claims? در گزارشهای قابل دانلود از منوی گزارشهای استودیوی سازندگان YouTube. |
hfa | کد شش کاراکتری که توسط آژانس هری فاکس (HFA) برای شناسایی منحصر به فرد یک ترکیب صادر شده است. |
hfa_song_code | کد شش کاراکتری که توسط آژانس هری فاکس (HFA) برای شناسایی منحصر به فرد یک ترکیب صادر شده است. |
inactive_reference_id | شناسه تولید شده توسط YouTube برای مرجع غیرفعال مرتبط. |
is_made_for_kids_effective_setting | تنظیم موثر «ساخته شده برای بچه ها» برای ویدیو. |
is_made_for_kids_modifiable | نشان می دهد که آیا تنظیمات "ساخته شده برای کودکان" توسط کاربر قابل تغییر است یا خیر. |
is_made_for_kids_user_selection | نشان می دهد که آیا ویدیو به عنوان «ساخته شده برای کودکان» توسط کاربر مشخص شده است یا خیر. |
is_merged | نشان می دهد که آیا دارایی به دلیل ادغام دارایی ایجاد شده است یا خیر. |
isrc | کد ثبت استاندارد بین المللی (ISRC) دارایی مرتبط. مقدار فیلد دقیقاً شامل 12 کاراکتر الفبایی است. |
iswc | کد بین المللی استاندارد کار موسیقی (ISWC) دارایی آهنگسازی. مقدار فیلد دقیقاً شامل 11 کاراکتر در قالب یک حرف (T) به همراه 10 رقم است. |
label | کمپانی ضبطی که صدای ضبط شده را منتشر کرد. این مقدار حداکثر 255 بایت طول دارد. |
length_sec | طول مرجع بر حسب ثانیه |
local_currency | نوع ارز محلی که درآمد با آن پرداخت می شود. |
longest_match | طولانی ترین بخش منطبق از یک ادعا. |
long_nonskippable_video_ads_enabled | نشان می دهد که آیا تبلیغات طولانی غیرقابل رد شدن شخص ثالث می توانند در طول ویدیو پخش شوند یا خیر. تبلیغات ویدیویی درون جریان در حین پخش ویدیوی محتوا نشان داده می شود. |
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 | مجموع تمام بازدیدهای درآمدزایی فقط صوتی و سمعی و بصری در تمام محتوای ادعا شده شرکای موسیقی YouTube در سرویس اشتراک YouTube Premium. این مقدار فقط برای شرکای موسیقی در دسترس است. |
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 | تعداد کل پخشهای ویدیویی پوششی ایجاد شده توسط کاربر که به محتوای شما در سرویس اشتراک YouTube Premium نسبت داده میشود. این مقدار فقط برای شرکای موسیقی مرتبط است. |
monetized_views_ugc_cover_shared_audio_visual | تعداد کل ویدیوهای جلد تولید شده توسط کاربر با سه طرفه اشتراک درآمد که به محتوای شما در سرویس اشتراک YouTube Premium نسبت داده شده است. این مقدار فقط برای شرکای موسیقی مرتبط است. |
monetized_watchtime | کل مدت زمان تماشای اشتراک YouTube Premium، بر حسب ثانیه، منتسب به ویدیوهای غیرموسیقی شما. |
month | ماهی که فعالیت رخ داده است. |
midrolls_enabled | نشان می دهد که آیا تبلیغات میان فیلم می توانند برای ویدیو پخش شوند یا خیر. Mid-rolls تبلیغات ویدیویی هستند که در طول ویدیو یا رویداد دیگری ظاهر می شوند. به عنوان مثال، یک تبلیغ ویدیویی میان فیلم ممکن است در فواصل زمانی یک فیلم بلند ظاهر شود. تبلیغات میان فیلم فقط برای محتوای دارای مجوز است. |
multiple_claims | نشان می دهد که آیا بیش از یک ادعا در مورد ویدیو وجود دارد یا خیر. اگر یک ادعا در مورد ویدیو وجود داشته باشد، مقدار false است و اگر بیش از یک ادعا وجود داشته باشد، true .توجه: این فیلد Multiple Claims? در گزارشهای قابل دانلود از منوی گزارشهای استودیوی سازندگان YouTube. |
music_claim_type | نشان می دهد که آیا این ادعا شامل بخش صوتی، تصویری یا سمعی بصری محتوای ادعا شده است یا خیر. مقادیر معتبر برای این فیلد عبارتند از:
|
music_share | درصد فعالیت موسیقی در هر کشور و پیشنهاد. |
net_partner_revenue | درآمد خالص برای شریک |
net_partner_revenue_post_revshare | درآمد خالص برای شریک پس از اعمال تقسیم سهم درآمد. |
revshare_rate_type | نوع نرخ revshare اعمال شده برای درآمد. |
nonskippable_video_ads_enabled | نشان می دهد که آیا تبلیغات غیرقابل رد شدن شخص ثالث برای ویدیو پخش می شود یا خیر. تبلیغات ویدیویی درون جریان در حین پخش ویدیوی محتوا نشان داده می شود. |
notes | در مورد پرداخت های تعدیل معوق، پرداخت را از یک ماه قبل نشان می دهد. |
offweb_syndicatable | نشان می دهد که آیا ویدیو می تواند خارج از مرورگر نمایش داده شود یا خیر. |
overlay_ads_enabled | نشان می دهد که آیا تبلیغات همپوشانی برای ویدیو پخش می شود یا خیر. همپوشانی ها تبلیغات نمایشی هستند که بعد از 10 ثانیه در بالای ویدیو نشان داده می شوند. |
other_owners_claiming | نام سایر صاحبان محتوا که در مورد ویدیو نیز ادعایی دارند. |
other_ownership_origination | منبع پیدایش مالکیت برای سایر مالکان. |
owned_views | تعداد کل بازدیدهای محتوای متعلق به شما که خطمشی که برای محتوا تعیین کردهاید کسب درآمد یا پیگیری است. گزارشهای تبلیغات YouTube و گزارشهای اشتراک YouTube Premium برای محتوای غیرموسیقی هر دو حاوی فیلد policy هستند که نشان میدهد خطمشی مرتبط با دادهها monetize بوده یا track است. |
owned_subscription_views | تعداد کل بازدیدهای اشتراک YouTube Premium از محتوای متعلق به شما که خطمشی محتوا برای آن کسب درآمد یا ردیابی است. |
ownership | مالک دارایی در مناطق خاص. |
ownership_last_updated | تاریخ و زمان آخرین بهروزرسانی مالکیت. |
ownership_origination | منبع پیدایش مالکیت |
ownership_percentage | درصد ترکیبی که متعلق به شماست. |
partner_audio_ad_revshare | سهم درآمد Pro Rata YouTube Audio Tier شما با در نظر گرفتن نرخ(های) revshare. برای محاسبه بیشتر از محاسبه استفاده می شود. |
partner_audio_ad_revshare_rate | نرخ سهم درآمد تبلیغات شریک. |
partner_playbacks | بازپخش در سرویس ردیف صوتی YouTube که به محتوای شما نسبت داده می شود. |
partner_revenue | درآمد شما به دلار از تبلیغات پس از اعمال تقسیم درآمد. این فیلد در گزارش های تبلیغات YouTube ظاهر می شود. فیلد youtube_revenue_split حاوی کل درآمد قبل از اعمال تقسیم درآمد است. |
partner_revenue_art_track | سهم درآمد اشتراک YouTube Premium شما برای محتوای آهنگ هنری پخش شده در حالت سمعی و بصری. |
partner_revenue_audio | سهم درآمد اشتراک YouTube Premium شما برای محتوای پخش شده در حالت فقط صوتی. |
partner_revenue_local | درآمد شما به ارز محلی از تبلیغات پس از اعمال تقسیم درآمد. این فیلد در گزارش های تبلیغات YouTube ظاهر می شود. فیلد youtube_revenue_split حاوی کل درآمد قبل از اعمال تقسیم درآمد است. |
partner_revenue_usd | درآمد شما از تبلیغات پس از اعمال تقسیم سهم درآمد. این فیلد در گزارش های تبلیغات YouTube ظاهر می شود. فیلد youtube_revenue_split حاوی کل درآمد قبل از اعمال تقسیم درآمد است. |
partner_revenue_auction | درآمد شما از تبلیغات AdSense در حراج. |
partner_revenue_per_play_min | درآمد بر اساس حداقل بازی محاسبه می شود. هنگامی که در سطح کشور تجمیع می شود، برای محاسبه بیشتر از محاسبه استفاده می شود. |
partner_revenue_per_sub_min | درآمد هر کشور بر اساس حداقل های هر مشترک محاسبه می شود. برای محاسبه بیشتر از محاسبه استفاده می شود. |
partner_revenue_pro_rata | سهم درآمد اشتراک YouTube Premium Pro Rata شما، با در نظر گرفتن نرخ(های) 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 | سهم درآمد اشتراک YouTube Premium Pro Rata شما برای محتوای 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 | نرخ هر زیر حداقل در آن کشور خاص. |
policy | خط مشی اعمال شده در ویدیو. ارزش یا monetize یا track است. |
pool_participating_rate | سهم بازار با پشتیبانی آگهی (AVOD) همه شرکای شرکت کننده در استخر پویا نسبت به معیار اصلی. |
postrolls_enabled | نشان می دهد که آیا تبلیغات پس از پخش می توانند برای ویدیو پخش شوند یا خیر. تبلیغات پس از پخش پس از ویدیو یا پخش زنده ای که بیننده در حال تماشای آن است پخش می شود. |
prerolls_enabled | نشان می دهد که آیا تبلیغات پیش از پخش برای ویدیو قابل پخش است یا خیر. تبلیغات پیش از پخش قبل از پخش ویدیو یا پخش جریانی زنده که بیننده در حال تماشای آن است پخش می شود. گاهی اوقات بیش از یک تبلیغ قبل از پخش پخش می شود. |
provider | نام مالک محتوا که مرجع ارائه کرده است. |
ratings_allowed | نشان می دهد که آیا رتبه بندی برای ویدیو فعال است یا خیر. |
record_label | نام برچسب ضبط از فراداده دارایی. فقط مربوط به شرکای موسیقی است. |
reference_id | شناسه ایجاد شده توسط YouTube برای مرجع مرتبط با یک ادعا. این قسمت برای ادعاهای بارگذاری شده توسط شریک خالی خواهد بود. |
reference_type | نوع یا کانال مرجع، مانند Audio ، Visual ، AudioVisual . |
reference_video_id | شناسه ویدیوی یک مرجع تولید شده توسط YouTube. فقط در صورتی اعمال می شود که ادعا با مرجع ایجاد شده از یک ویدیوی YouTube مرتبط باشد. |
release_date | تاریخ انتشار از فراداده دارایی. فقط مربوط به شرکای تلویزیونی/فیلمی است. |
revenue_source | منبع درآمد را نشان می دهد. مقادیر ممکن عبارتند از:
|
revenue_type | نوع درآمدی را که ردیف نشان می دهد نشان می دهد. |
right_type | انواع حقوق ترکیب مرتبط با ادعا را مشخص می کند. مقادیر معتبر برای این فیلد عبارتند از:
|
season | شماره فصل مرتبط با یک قسمت تلویزیونی. طول فیلد حداکثر 5 بایت است. |
shorts_flat_fee_revenue_usd | درآمد ثابت به دلار برای شورت. |
shorts_monthly_pool_usd | درآمد ماهانه به دلار برای استخر شلوارک. |
shorts_partner_revenue_usd | درآمد شریک به دلار برای شورت. |
shorts_usages_marketshare | سهم بازار برای استفاده از شورت. |
skippable_video_ads_enabled | نشان می دهد که آیا تبلیغات ویدیویی قابل رد شدن برای ویدیو فعال هستند یا خیر. تبلیغات درون جریانی قابل رد شدن قبل، در حین یا بعد از ویدیوهای دیگر در YouTube و وبسایتها و برنامهها در شرکای ویدیویی Google پخش میشوند. پس از 5 ثانیه، بیننده این گزینه را دارد که از تبلیغ رد شود و به تماشای ویدیو ادامه دهد. |
source_of_fingerprint | منبع اثر انگشت برای یک فایل مرجع معین. |
sponsored_cards_enabled | نشان می دهد که آیا کارت های حمایت شده برای ویدیو فعال هستند یا خیر. کارتهای اطلاعات محصول حمایتشده به بینندگان اجازه میدهند محصولاتی را که در ویدیوها میبینند خرید کنند. |
start_date | تاریخ و زمان شروع |
status | وضعیت دارایی را نشان می دهد. مقادیر ممکن active یا inactive هستند. |
studio | استودیو مرتبط با دارایی. |
subscribers | تعداد مشترکین. |
tax_withholding_rate | نرخ کسر مالیات قابل اعمال در گزارش کسر مالیات. |
tax_withheld_amount | میزان مالیات کسر شده در گزارش کسر مالیات. |
third_party_ads_enabled | نشان می دهد که آیا تبلیغات شخص ثالث برای ویدیو فعال هستند یا خیر. |
third_party_video_id | شناسه ویدیوی ارائهشده توسط شریک که توسط شریک برای شناسایی ویدیو برای اهداف هدفیابی تبلیغات استفاده میشود. |
time_published | تاریخ و زمان انتشار ویدیو در YouTube در قالب MM/DD/YYYY HH:MM:SS . این قسمت برای ویدیوهایی که هرگز عمومی نشده اند (به عنوان مثال ویدیوهای خصوصی یا فهرست نشده) خالی خواهد بود. |
time_uploaded | تاریخ و ساعت آپلود ویدیو در YouTube در قالب MM/DD/YYYY HH:MM:SS . |
tms | مقدار شناسه 12 تا 14 کاراکتری Tribune Media Systems (TMS) که به طور منحصربهفرد یک قسمت فیلم یا تلویزیون را شناسایی میکند. |
total_playbacks | مجموع بازپخش در سرویس ردیف صوتی YouTube. |
total_revenue_by_source | کل درآمد بر اساس منبع، مانند درآمد تبلیغات یا اشتراک. |
total_views | تعداد کل بازدیدها |
unlaunched_territories_adjustment | تنظیم استخر شورت برای مناطق راه اندازی نشده. |
upc | کد جهانی محصول (UPC)، یک فیلد فراداده اختیاری است که برای شناسایی منحصر به فرد دارایی استفاده می شود. |
uploader | نام مالک محتوایی که ویدیو را آپلود کرده است. |
upload_source | روشی که برای آپلود ویدیو در یوتیوب استفاده می شود. |
us_sourced_revenue | مقدار درآمدی که از ایالات متحده تامین می شود. |
usd_local_rate | نرخ مبادله ای که برای تبدیل از USD به ارز محلی استفاده می شود. ارزش نشان دهنده یک نرخ متوسط برای معاملات روزانه در طول دوره گزارش است. |
username | نام مالک محتوای YouTube. |
video_channel_id | شناسه کانال ایجاد شده توسط YouTube برای کانالی که ویدیوی ادعا شده را منتشر کرده است. |
video_duration | طول ویدیو. |
video_duration_sec | طول ویدیو بر حسب ثانیه |
video_id | ویدیوی ادعا شده مرتبط با دادههای ردیف. مقدار فیلد یک شناسه ویدیوی YouTube است که به طور منحصر به فرد ویدیو را شناسایی می کند. با استفاده از روش videos.list در YouTube Data API میتوانید دادههای اضافی درباره ویدیو را بازیابی کنید. |
video_length | طول ویدیو بر حسب ثانیه |
video_privacy_status | نشان می دهد که ویدیو عمومی، خصوصی یا فهرست نشده است. |
video_title | عنوان ویدیو مرتبط با دادههای ردیف. |
video_upload_date | تاریخ انتشار ویدیوی ادعا شده. |
video_url | نشانی اینترنتی ویدیو در یوتیوب. |
views | تعداد دفعاتی که ویدیو مشاهده شده است. |
writers | فهرستی از نویسندگان این ترکیب که با خط لوله مشخص شده است. |
youtube_revenue_split | برای شرکای موسیقی، فیلم و تلویزیون: مجموع درآمد تبلیغات YouTube از محتوای شما. این مبلغ متعاقباً بر اساس نرخ سهم درآمد تقسیم می شود. قسمت برای ناشران موسیقی: مجموع درآمد تبلیغات YouTube از محتوای شما، به حساب مالکیت دارایی است، اما قبل از تقسیم بر اساس نرخ سهم درآمد. قسمت |
youtube_revenue_split_auction | برای برچسبهای موسیقی، فیلم و شرکای تلویزیونی: کل درآمد حاصل از تبلیغات AdSense فروخته شده در حراج قبل از اعمال تقسیم درآمد. برای ناشران موسیقی: کل درآمد حاصل از تبلیغات AdSense فروخته شده در مزایده، حسابداری برای مالکیت دارایی، اما قبل از اعمال تقسیم درآمد. |
youtube_revenue_split_partner_sold_partner_served | برای شرکای موسیقی، فیلم و تلویزیون: مجموع درآمد حاصل از فروش شریک و تبلیغات ارائه شده توسط شریک. این مبلغ متعاقباً بر اساس نرخ سهم درآمد تقسیم می شود. برای ناشران موسیقی: کل درآمد حاصل از فروش شریک، تبلیغات ارائه شده توسط شریک، حسابداری مالکیت دارایی. این مبلغ متعاقباً بر اساس نرخ سهم درآمد تقسیم می شود. |
youtube_revenue_split_partner_sold_youtube_served | برای شرکای موسیقی، فیلم و تلویزیون: کل درآمد حاصل از DoubleClick for Publishers (DFP). این مبلغ متعاقباً بر اساس نرخ سهم درآمد تقسیم می شود. برای ناشران موسیقی: مجموع درآمد حاصل از DoubleClick for Publishers (DFP)، حسابداری برای مالکیت دارایی. این مبلغ متعاقباً بر اساس نرخ سهم درآمد تقسیم می شود. |
youtube_revenue_split_reserved | برای برچسبهای موسیقی، فیلم و شرکای تلویزیونی: کل درآمد حاصل از تبلیغات رزرو شده از طریق DoubleClick (DCLK) و سایر منابع فروخته شده توسط YouTube. این مبلغ متعاقباً بر اساس نرخ سهم درآمد تقسیم می شود. برای ناشران موسیقی: کل درآمد حاصل از تبلیغات رزرو شده از طریق DoubleClick (DCLK) و سایر منابع فروخته شده توسط YouTube، به حساب مالکیت دارایی. این مبلغ متعاقباً بر اساس نرخ سهم درآمد تقسیم می شود. |
پرایم تایم
جدول زیر فیلدهایی را تعریف میکند که در گزارشهای مدیریت شده توسط سیستم API گزارش YouTube برای شرکای برنامهنویسی Primetime ظاهر میشوند:
فیلدها | |
---|---|
AgeGroup | گروه سنی بینندگان در گزارش. توجه داشته باشید که برای لیست شدن آن گروه، باید حداقل 50 رویداد مشاهده توسط اعضای یک گروه سنی خاص وجود داشته باشد. مقادیر احتمالی فیلد عبارتند از:
|
AverageViewDuration | میانگین تعداد ثانیه های مشاهده شده از برنامه در تمام رویدادهای مشاهده. |
AverageViewPercent | میانگین درصد برنامه ای که در تمام رویدادهای مشاهده مشاهده شد. |
CallSign | در صورت وجود، علامت تماس ایستگاهی را که برنامه در آن پخش شده است مشخص می کند. |
ConcurrentViewers | تعداد کل رویدادهای مشاهده ای که طی آن یک دقیقه خاص از قسمت، که با مقدار فیلد MinutesSinceStart مشخص شده است، مشاهده شده است. |
ContentId | یک مقدار منحصر به فرد که شما، ارائه دهنده ابرداده، برای شناسایی دارایی استفاده می کنید و به YouTube ارائه کرده اید. شما می توانید از این مقدار برای تطبیق دارایی با سیستم مدیریت محتوای خود استفاده کنید. مقدار می تواند یک شناسه منحصر به فرد باشد که برای دارایی ایجاد کرده اید یا یک شناسه استاندارد، مانند شناسه TMS. این مقدار حداکثر 64 بایت طول دارد و ممکن است شامل کاراکترهای الفبای عددی، خط تیره (-)، زیرخط (_)، نقطه (.)، نمادهای "at" (@)، یا اسلش جلو (/) باشد. |
ContentLength | مدت زمان برنامه بر حسب ثانیه توجه داشته باشید که مدت زمان تبلیغات برای برنامه های VOD با درج آگهی پویا (DAI) لحاظ نشده است. |
ContentType | نحوه تماشای محتوا توسط بیننده. مقادیر احتمالی فیلد عبارتند از:
|
Date | تاریخی که نمایش برنامه در آن رخ داده است. مقدار در قالب YYYYMMDD است. |
DeviceType | نوع دستگاهی که بیننده محتوا را در آن تماشا می کند. توجه داشته باشید که باید حداقل 50 رویداد مشاهده برای یک نوع دستگاه خاص وجود داشته باشد تا آن نوع دستگاه لیست شود. مقادیر احتمالی فیلد عبارتند از:
|
DmaId | شناسه 3 رقمی که Nielsen برای شناسایی منطقه بازار تعیین شده (DMA) مرتبط با رویدادهای مشاهده شرح داده شده در ردیف داده استفاده می کند. |
EpisodeNumber | در صورت وجود، شماره قسمت متوالی برنامه را در فصل مشخص شده مشخص می کند. فصل با قسمت SeasonNumber مشخص می شود. به عنوان مثال، این مقدار برای اولین قسمت از فصل دوم یک برنامه 1 خواهد بود. |
Gender | جنسیت بینندگان در گزارش. توجه داشته باشید که باید حداقل 50 رویداد مشاهده توسط اعضای یک جنسیت خاص وجود داشته باشد تا آن جنسیت فهرست شود. مقادیر احتمالی فیلد عبارتند از:
|
MinutesSinceStart | تعداد دقایق پس از شروع یک برنامه زمانی که رویداد مشاهده شروع شد. توجه داشته باشید که این عدد شامل زمان برنامه و زمان تبلیغ میشود، به استثنای برنامهنویسی بر اساس تقاضا (VOD) که از درج آگهی پویا (DAI) استفاده میکند. برای برنامه نویسی VOD با DAI، تعداد فقط شامل زمان برنامه می شود. |
Network | ایستگاه یا شبکه ای که محتوا را منتشر کرد یا محتوا در آن پخش شد. |
PeakConcurrentViewers | حداکثر تعداد رویدادهای مشاهده همزمان در هر دقیقه معین از یک برنامه خاص. |
Platform | نحوه تماشای محتوا توسط بیننده. مقادیر احتمالی فیلد عبارتند از:
|
ProgramTitle | عنوان یا نام قسمت، فیلم یا رویداد. |
ProgramType | نوع برنامه ای که بیننده تماشا کرده است. مقادیر احتمالی فیلد عبارتند از:
|
PublishDateTime | تاریخ پخش برنامه یا تاریخ انتشار. مقدار در قالب YYYY-MM-DD است. |
SeasonNumber | شماره فصل مرتبط با برنامه. طول فیلد حداکثر 5 بایت است. |
SeriesTitle | عنوان سری مرتبط با داده های ردیف گزارش. به عنوان مثال، برای یک برنامه تلویزیونی، این مقدار نام نمایش را مشخص می کند و قسمت ProgramTitle عنوان قسمت را مشخص می کند. |
TmsId | مقدار شناسه 12 تا 14 کاراکتری Tribune Media Systems (TMS) که به طور منحصر به فرد برنامه را شناسایی می کند. |
TotalWatchTime | مجموع مدت زمانی که برنامه در تمام رویدادهای مشاهده تماشا شده است، بر حسب ثانیه. |
ViewersComplete | تعداد کل رویدادهای زنده ، DVR و VOD که در طی آن بیننده از تماشای فیلم در یک دقیقه خاص متوقف شده است ، که با ارزش میدان MinutesSinceStart مشخص می شود. اگر مقدار MinutesSinceStart یک مقدار کوتاهتر از کل برنامه ( ContentLength ) را نشان دهد ، این بینندگان قبل از پایان برنامه ، تماشای خود را متوقف می کنند. |
ViewersResume | تعداد کل رویدادهای مشاهده که در آن بیننده یا یک برنامه DVR یا یک برنامه VOD را در هر نقطه ای غیر از دقیقه اول (دقیقه 0) فیلم شروع می کند. |
ViewersStart | تعداد کل وقایع مشاهده که در آن هر یک از موارد زیر صحیح است:
|
Views | تعداد کل دفعاتی که این برنامه در تمام رویدادهای مشاهده مشاهده شده است. |