Dimensions

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

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

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

ابعاد هسته

اگرچه API گزارش‌دهی یوتیوب تابع سیاست منسوخ‌سازی تعریف‌شده در شرایط خدمات است، ابعاد غیر اصلی (و معیارهای غیر اصلی) تابع این سیاست نیستند. در تعاریف این صفحه، هر بُعدی که بُعد اصلی باشد، به صراحت به عنوان بُعد اصلی شناخته می‌شود.

لیست زیر ابعاد اصلی API را مشخص می‌کند. همه آنها ابعاد اصلی در API YouTube Analytics نیز هستند.

• age_group
• channel_id
• country_code
• date
• gender
• sharing_service
• uploader_type
• video_id

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

ابعاد

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

منابع

این ابعاد مربوط به منابعی است که کانال‌ها و صاحبان محتوا در یوتیوب مدیریت می‌کنند:

• video_id
• playlist_id
• channel_id
• asset_id

video_id (core dimension)

شناسه‌ی یک ویدیوی یوتیوب. در API داده‌های یوتیوب، این مقدار، ویژگی id یک منبع video است. This is a core dimension and is subject to the Deprecation Policy .

playlist_id

شناسه‌ی یک لیست پخش یوتیوب. در API داده‌های یوتیوب، این مقدار، مقدار ویژگی id یک منبع playlist است.

channel_id (core dimension)

شناسه یک کانال یوتیوب. در API داده یوتیوب، این مقدار ویژگی id یک منبع channel است. This is a core dimension and is subject to the Deprecation Policy .

asset_id (only used in content owner reports)

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

مناطق جغرافیایی

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

country_code (core dimension)

کشور مرتبط با معیارها در ردیف گزارش. مقدار بُعد، یک کد کشور دو حرفی ISO-3166-1 مانند US ، CN (چین) یا FR (فرانسه) است. کد کشور ZZ برای گزارش معیارهایی استفاده می‌شود که YouTube نمی‌تواند کشور مرتبط با آنها را شناسایی کند. This is a core dimension and is subject to the Deprecation Policy .

province_code

ایالت یا قلمرو ایالات متحده مرتبط با معیارهای موجود در ردیف گزارش. مقدار بُعد، کد ISO 3166-2 است که یک ایالت ایالات متحده یا ناحیه کلمبیا، مانند US-MI (میشیگان) یا US-TX (تگزاس) را مشخص می‌کند. کد استان US-ZZ برای گزارش معیارهایی استفاده می‌شود که YouTube نتوانسته ایالت مرتبط با آنها را در ایالات متحده شناسایی کند.

توجه: این بُعد از مقادیر ISO 3166-2 که مناطق دورافتاده ایالات متحده را مشخص می‌کنند پشتیبانی نمی‌کند، زیرا آن مناطق نیز کدهای کشوری ISO 3166-1 خود را دارند. همچنین از تقسیمات کشورهای غیر از ایالات متحده پشتیبانی نمی‌کند.

دوره‌های زمانی

date (core dimension)

این بُعد، تاریخ مرتبط با معیارها در هر ردیف گزارش را مشخص می‌کند. در گزارش‌های انبوه، تاریخ به دوره‌ای اشاره دارد که از ساعت ۱۲:۰۰ بامداد به وقت اقیانوس آرام شروع و در ساعت ۱۱:۵۹ شب به وقت اقیانوس آرام در روز، ماه و سال مشخص شده پایان می‌یابد. بسته به زمان سال، زمان اقیانوس آرام یا UTC-7 یا UTC-8 است.

توجه داشته باشید که اگرچه تاریخ‌ها معمولاً نشان‌دهنده یک دوره ۲۴ ساعته هستند، تاریخ‌هایی که ساعت‌ها برای تغییر ساعت تابستانی به جلو تنظیم می‌شوند، نشان‌دهنده یک دوره ۲۳ ساعته هستند و تاریخ‌هایی که ساعت‌ها به عقب تنظیم می‌شوند، نشان‌دهنده یک دوره ۲۵ ساعته هستند. This is a core dimension and is subject to the Deprecation Policy .

مکان‌های پخش

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

playback_location_type

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

ارزش‌ها
0	این داده‌ها مربوط به فعالیت‌هایی است که در صفحه تماشای ویدیو در یوتیوب یا در یک برنامه رسمی یوتیوب، مانند برنامه اندروید یوتیوب، رخ داده است.
1	این داده‌ها مربوط به فعالیتی است که در وب‌سایت یا برنامه دیگری رخ داده است که در آن ویدیو با استفاده از جاسازی <iframe> یا <object> جاسازی شده است.
2	این داده‌ها مربوط به فعالیت‌هایی است که در صفحه یک کانال یوتیوب رخ داده است.
5	این داده‌ها مربوط به معیارهایی هستند که نمی‌توان آنها را در هیچ یک از انواع دیگر مکان‌های ذکر شده طبقه‌بندی کرد.
7	این داده‌ها مربوط به بازدیدهایی است که در صفحه اصلی یا هوم اسکرین یوتیوب، در فید اشتراک کاربر یا در یکی دیگر از ویژگی‌های مرور یوتیوب انجام شده است.
8	این داده‌ها مربوط به بازدیدهایی است که مستقیماً در صفحه نتایج جستجوی یوتیوب رخ داده‌اند.
10	این داده‌ها مربوط به بازدیدهایی است که در فید ویدیوهای کوتاه یوتیوب (YouTube Shorts) انجام شده است.

playback_location_detail

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

جزئیات پخش

live_or_on_demand

این بُعد نشان می‌دهد که آیا معیارهای فعالیت کاربر در ردیف داده‌ها با بازدیدهای یک پخش زنده مرتبط هستند یا خیر. داده‌های این بُعد برای تاریخ‌های شروع از ۱ آوریل ۲۰۱۴ در دسترس است.

جدول زیر مقادیر ابعاد را فهرست می‌کند:

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

subscribed_status

این بُعد نشان می‌دهد که آیا معیارهای فعالیت کاربر در ردیف داده‌ها با بینندگانی که در کانال ویدیو یا لیست پخش مشترک شده‌اند، مرتبط است یا خیر. مقادیر ممکن subscribed و unsubscribed هستند.

توجه داشته باشید که مقدار بُعد (dimention) در زمان وقوع فعالیت کاربر دقیق است. برای مثال، فرض کنید کاربری در کانالی مشترک نشده است و یکی از ویدیوهای آن کانال را تماشا می‌کند، سپس در کانال مشترک می‌شود و ویدیوی دیگری را تماشا می‌کند، همه در همان روز. گزارش کانال نشان می‌دهد که یک نما دارای مقدار subscribed_status برابر با subscribed و یک نما دارای مقدار subscribed_status برابر با unsubscribed است.

منابع ترافیک

traffic_source_type

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

ارزش‌ها
0	مستقیم یا ناشناخته این مقدار شامل ترافیک مستقیم به یک صفحه و همچنین صفحاتی می‌شود که ارجاع‌دهنده آنها ناشناخته است. در گزارش‌های جستجو، این نوع منبع ترافیک به صورت NO_LINK_OTHER یا UNKNOWN_MOBILE_OR_DIRECT شناسایی می‌شود.
1	تبلیغات یوتیوب بیننده از طریق یک تبلیغ به ویدیو ارجاع داده شده است. در گزارش منبع ترافیک، اگر مقدار این بُعد 1 باشد، بُعد traffic_source_detail نوع تبلیغی را که به بیننده نشان داده شده است، مشخص می‌کند. در گزارش‌های پرس‌وجو، این نوع منبع ترافیک به عنوان ADVERTISING شناسایی می‌شود. مقادیر ممکن عبارتند از: ارزش‌ها ctp_engagement_ad تبلیغ تعاملی کلیکی برای پخش engagement_ad تبلیغ نامزدی googlemediaads تبلیغات جستجوی گوگل insearch_display TrueView در جستجو و نمایش instream TrueView در حال پخش instream-select قابل رد شدن در جریان رزرو شده unknown تبلیغات یوتیوب بدون دسته‌بندی video_wall دیوار ویدیویی yva تبلیغ ویدیویی صفحه اصلی
3	مرور ویژگی‌ها بیننده از یک صفحه یوتیوب که به ویدیوها یا کانال‌ها منتهی می‌شود، ارجاع داده شده است. در گزارش منبع ترافیک، اگر مقدار این بُعد 3 باشد، بُعد traffic_source_detail ویژگی‌ای را که ترافیک را ارجاع داده است، شناسایی می‌کند. در گزارش‌های پرس‌وجو، این نوع منبع ترافیک به عنوان SUBSCRIBER شناسایی می‌شود. مقادیر ممکن عبارتند از: ارزش‌ها explore بچه‌ها: کاوش learning بچه‌ها: یادگیری music فید موسیقی my-history تاریخچه تماشا my-subscriptions اشتراک‌های من my-uploads آپلودهای من podcasts صفحه مقصد پادکست‌ها shows بچه‌ها: نمایش‌ها watch-later بعداً تماشا کنید what-to-watch چه چیزی را تماشا کنیم
4	کانال‌های یوتیوب بینندگان از یک صفحه کانال یوتیوب ارجاع داده شده‌اند. در گزارش منبع ترافیک، اگر مقدار این بُعد 4 باشد، بُعد traffic_source_detail شناسه کانال را برای آن کانال مشخص می‌کند. در گزارش‌های پرس‌وجو، این نوع منبع ترافیک به عنوان YT_CHANNEL شناسایی می‌شود.
5	جستجوی یوتیوب بینندگان از نتایج جستجوی یوتیوب ارجاع داده شده‌اند. در گزارش منبع ترافیک، اگر مقدار این بُعد 5 باشد، بُعد traffic_source_detail عبارت جستجوی مرتبط را مشخص می‌کند. در گزارش‌های پرس‌وجو، این نوع منبع ترافیک به عنوان YT_SEARCH شناسایی می‌شود.
7	ویدیوهای پیشنهادی بینندگان از یک لیست ویدیوی مرتبط در صفحه تماشای ویدیوی دیگر ارجاع داده شده‌اند. در گزارش منبع ترافیک، اگر مقدار این بُعد 7 باشد، بُعد traffic_source_detail شناسه ویدیوی آن ویدیو را مشخص می‌کند. در گزارش‌های پرس‌وجو، این نوع منبع ترافیک به صورت RELATED_VIDEO یا YT_RELATED شناسایی می‌شود.
8	سایر ویژگی‌های یوتیوب بینندگان از یک صفحه یوتیوب ارجاع داده شده‌اند که در هیچ یک از انواع دیگر منابع ترافیک ذکر شده قرار نمی‌گیرد. در گزارش منبع ترافیک، اگر مقدار این بُعد 8 باشد، بُعد traffic_source_detail آدرس اینترنتی صفحه را مشخص می‌کند. در گزارش‌های پرس‌وجو، این نوع منبع ترافیک به عنوان YT_OTHER_PAGE شناسایی می‌شود. مقادیر ممکن عبارتند از: ارزش‌ها g-crec کانال‌های پیشنهادی offline آفلاین promotion ارتقاء شریک unknown ناشناخته widget ویجت صفحه اصلی اندروید youtu.be یوتو بی ytremote یوتیوب از راه دور
9	خارجی بینندگان از طریق لینکی در وب‌سایت دیگری ارجاع داده شده‌اند. این منبع ترافیک شامل ارجاعات از نتایج جستجوی گوگل است. در گزارش منبع ترافیک، اگر مقدار این بُعد 9 باشد، بُعد traffic_source_detail صفحه وب خارجی را مشخص می‌کند. در گزارش‌های پرس‌وجو، این نوع منبع ترافیک به عنوان EXT_URL شناسایی می‌شود.
11	کارت‌های ویدیویی و حاشیه‌نویسی‌ها بینندگان با کلیک روی یک حاشیه‌نویسی یا کارت در ویدیوی دیگری ارجاع داده شده‌اند. در گزارش‌های جستجو، این نوع منبع ترافیک به عنوان ANNOTATION شناسایی می‌شود.
14	لیست‌های پخش بازدیدها در حین پخش ویدیو به عنوان بخشی از یک لیست پخش رخ داده است. در گزارش‌های جستجو، این نوع منبع ترافیک به عنوان PLAYLIST شناسایی می‌شود. توجه داشته باشید که این منبع ترافیک با منبع نوع 18 متفاوت است، که نشان می‌دهد بازدیدها از صفحه‌ای سرچشمه گرفته‌اند که تمام ویدیوهای موجود در لیست پخش را فهرست می‌کند .
17	اعلان‌ها بینندگان از طریق ایمیل یا اعلان از یوتیوب ارجاع داده شده‌اند. در گزارش‌های جستجو، این نوع منبع ترافیک به عنوان NOTIFICATION شناسایی می‌شود. مقادیر ممکن عبارتند از: ارزش‌ها inbox push sdig بازدیدها از اعلان‌هایی سرچشمه می‌گرفتند که بخشی از خلاصه‌ی مشترکین بودند uploaded_other بازدیدها از طریق اعلان‌های غیر فشاری، مانند ایمیل یا اعلان‌های صندوق ورودی، که هنگام آپلود ویدیو برای مشترکین ارسال می‌شود، صورت گرفته است. uploaded_push بازدیدها از طریق اعلان‌های فوری ارسال شده به مشترکین هنگام آپلود ویدیو، ایجاد شده‌اند.
18	صفحات لیست پخش بازدیدها از صفحه‌ای سرچشمه می‌گیرند که تمام ویدیوهای موجود در یک لیست پخش را فهرست می‌کند. در گزارش‌های جستجو، این نوع منبع ترافیک به عنوان YT_PLAYLIST_PAGE شناسایی می‌شود. توجه داشته باشید که این منبع ترافیک با منبع نوع 14 متفاوت است، که نشان می‌دهد بازدیدها هنگام پخش ویدیو به عنوان بخشی از یک لیست پخش رخ داده است.
19	برنامه‌نویسی از محتوای ادعا شده بازدیدها از ویدیوهای آپلود شده توسط کاربر که ادعا شده توسط صاحب محتوا برای تبلیغ محتوای مشاهده شده استفاده شده است، سرچشمه می‌گیرند. در گزارش‌های جستجو، این منبع ترافیک به عنوان CAMPAIGN_CARD شناسایی می‌شود. این منبع ترافیک فقط برای گزارش‌های صاحب محتوا پشتیبانی می‌شود.
20	صفحه پایانی ویدیوی تعاملی بازدیدها از صفحه انتهایی ویدیوی دیگری سرچشمه گرفته‌اند. در گزارش‌های پرس‌وجو، این نوع منبع ترافیک به عنوان END_SCREEN شناسایی می‌شود.
23	داستان‌ها بیننده با کشیدن عمودی انگشت از ویدیوی قبلی در تجربه مشاهده استوری‌ها، به صفحه دیگری ارجاع داده می‌شد.
24	شلوارک بیننده با کشیدن عمودی انگشت از ویدیوی قبلی در تجربه تماشای Shorts به ویدیو ارجاع داده شد.
25	صفحات محصول ویدیوهای موجود در صفحه محصول، بینندگان را به کانال دیگری هدایت می‌کرد.
26	صفحات هشتگ بازدیدها از صفحات هشتگ VOD یا صفحات محوری هشتگ Shorts سرچشمه گرفته‌اند.
27	صفحات صوتی بازدیدها از صفحات محوری صدای Shorts سرچشمه گرفته‌اند.
28	تغییر مسیر زنده بازدیدها از Live Redirects سرچشمه گرفته‌اند.
29	پادکست‌ها بازدیدها از صفحه پادکست‌های یوتیوب سرچشمه گرفته‌اند.
30	ویدیوی ریمیکس شده بازدیدها از یک لینک ویدیوی ریمیکس شده در پخش کننده Shorts سرچشمه گرفته است.
31	تغذیه زنده عمودی بازدیدها از فید زنده عمودی سرچشمه می‌گرفتند.
32	ویدئوی مرتبط بازدیدها از یک لینک ویدیویی مرتبط در پخش‌کننده‌ی Shorts سرچشمه گرفته بودند.

traffic_source_detail

این بُعد جزئیات بیشتری در مورد منبع ترافیک که مقدار بُعد traffic_source_type ردیف را دارد، ارائه می‌دهد. این مقدار بُعد برای مقادیر بُعد traffic_source_type زیر پر می‌شود:

• 1 – مقدار بُعد، نوع تبلیغاتی را که به بیننده نشان داده شده است، مشخص می‌کند. برای مشاهده‌ی فهرستی از مقادیر ممکن، به تعریف traffic_source_type مراجعه کنید.
• 3 – مقدار بُعد، ویژگی یوتیوبی را که منجر به ترافیک ارجاعی شده است، مشخص می‌کند. برای مشاهده‌ی فهرستی از مقادیر ممکن، به تعریف traffic_source_type مراجعه کنید.
• 4 – مقدار بُعد، شناسه کانالی را که بیننده از آن ارجاع داده شده است، مشخص می‌کند.
• 5 – مقدار بُعد، عبارت جستجویی را مشخص می‌کند که منجر به ترافیک ارجاع‌شده شده است.
• 7 – مقدار بُعد، ویدئویی را که بیننده از آن ارجاع داده شده است، مشخص می‌کند.
• 8 – مقدار بُعد، نوع صفحه یوتیوبی که منجر به ترافیک ارجاعی شده است را مشخص می‌کند. برای مشاهده فهرستی از مقادیر ممکن، به تعریف traffic_source_type مراجعه کنید.
• 9 – مقدار بُعد، صفحه خارجی که ترافیک از آن ارجاع داده شده است را مشخص می‌کند.
• 17 – مقدار بُعد، نوع اعلانی را که منجر به ترافیک ارجاع شده شده است، مشخص می‌کند. برای فهرستی از مقادیر ممکن، به تعریف traffic_source_type مراجعه کنید.
• 19 – مقدار بُعد، ویدئویی را که بیننده از آن ارجاع داده شده است، مشخص می‌کند.
• 20 – مقدار بُعد، ویدئویی را که بیننده از آن ارجاع داده شده است، مشخص می‌کند.
• 25 – مقدار بُعد، شناسه محصول را مشخص می‌کند که یک شناسه نمودار دانش گوگل است.
• 26 – مقدار بُعد، هشتگی را که منجر به ترافیک ارجاع شده شده است، مشخص می‌کند.
• 27 – مقدار بُعد، ویدئویی را که بیننده از آن ارجاع داده شده است، مشخص می‌کند.
• 28 – مقدار بُعد، شناسه کانالی را مشخص می‌کند که بیننده از طریق Live Redirects از آن ارجاع داده شده است.
• 30 – مقدار بُعد، ویدئویی را که بیننده از آن ارجاع داده شده است، مشخص می‌کند.

دستگاه‌ها

device_type

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

ارزش‌ها
100	ناشناخته
101	کامپیوتر
102	تلویزیون
103	کنسول بازی
104	تلفن همراه
105	قرص

operating_system

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

ارزش‌ها
1	دیگر
2	ویندوز
3	ویندوز موبایل
4	اندروید
5	آی‌او‌اس
6	سیمبیان
7	شاه‌توت
9	مکینتاش
10	پلی‌استیشن
11	بادا
12	وب او اس
13	لینوکس
14	هیپ‌تاپ
15	می گو
16	وی
17	ایکس‌باکس
18	پلی‌استیشن ویتا
19	تلویزیون هوشمند
20	نینتندو ۳دی‌اس
21	کروم‌کست
22	تایزن
23	فایرفاکس
24	ریل‌مدیا
25	کای او اس
26	روکو
27	نینتندو سوییچ
28	اپل تی‌وی او اس
29	سیستم عامل فایر او اس
30	کروم او اس
31	ویدا
32	وگا او اس

جمعیت‌شناسی

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

age_group (core dimension)

این بُعد، گروه سنی کاربران وارد شده مرتبط با داده‌های گزارش را مشخص می‌کند. API از گروه‌های سنی زیر استفاده می‌کند:

• AGE_13_17
• AGE_18_24
• AGE_25_34
• AGE_35_44
• AGE_45_54
• AGE_55_64
• AGE_65_

This is a core dimension and is subject to the Deprecation Policy .

gender (core dimension)

این بُعد، جنسیت کاربران وارد شده مرتبط با داده‌های گزارش را مشخص می‌کند. مقادیر معتبر عبارتند از FEMALE ، MALE و GENDER_OTHER . This is a core dimension and is subject to the Deprecation Policy .

تعامل و اشتراک‌گذاری محتوا

sharing_service (core dimension)

این بُعد، سرویسی را که برای اشتراک‌گذاری ویدیوها استفاده شده است، مشخص می‌کند. ویدیوها را می‌توان با استفاده از دکمه‌ی «اشتراک‌گذاری» در یوتیوب (یا از طریق پخش‌کننده‌ی یوتیوب) به اشتراک گذاشت. This is a core dimension and is subject to the Deprecation Policy .

جدول زیر مقادیر معتبر ابعاد را فهرست می‌کند:

ارزش‌ها
0	ناشناخته
1	دیگ
4	ردیت
5	استامبل‌آپون
6	میکسی
7	یاهو! ژاپن
8	گو
9	آمیب
10	فیسبوک
11	مای‌اسپیس
12	نوجیج
18	تونتی
20	منه‌آم
21	ویکوپ
22	اسکای‌راک
25	فوتکا
28	سلام5
31	توییتر
32	سایورلد
34	بلاگر
36	VKontakte (ВКонтакте)
37	راکوتن (楽天市場)
38	لایو ژورنال
39	Odnoklassniki (Одноклассники)
40	تامبلر
42	لینکدین
43	گوگل+
44	ویبو
45	پینترست
46	ایمیل
47	مسنجر فیسبوک
49	واتساپ
50	پاتوق‌ها
51	جیمیل
52	کاکائو (گفتگوی کاکائو)
53	دیگر
55	کپی در کلیپ بورد
59	جاسازی
60	پیام متنی
61	پیام رسانی اندروید
62	پیام‌های ورایزون
63	پیامک اچ‌تی‌سی
64	مکالمات سونی
65	برو پیامک
66	ایمیل LGE
67	خط
68	وایبر
69	کیک
70	اسکایپ
71	مسنجر بلک بری
72	وی چت
73	داستان کاکائو
74	دراپ باکس
75	تلگرام
76	صفحات فیسبوک
77	گروه می
78	ایمیل اندروید
79	پیام‌رسانی موتورولا
80	اشتراک‌گذاری در نزدیکی
81	ناور
82	پنجره‌ی فعالیت سیستم iOS
83	صندوق ورودی گوگل
84	مسنجر اندروید
85	یوتیوب موزیک
86	یوتیوب گیمینگ
87	یوتیوب کیدز
88	یوتیوب تی‌وی

برای اطلاعات بیشتر به اسناد راهنما مراجعه کنید.

حاشیه‌نویسی‌ها

annotation_type

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

ارزش‌ها
0	ناشناخته
1	توجه داشته باشید
3	کانون توجه
4	عنوان
8	حباب گفتاری
9	برچسب
10	واترمارک برندسازی
11	ویدیوی ویژه
12	لیست پخش ویژه
30	فراخوان برای اقدام

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

annotation_id

شناسه‌ای که یوتیوب برای شناسایی منحصر به فرد یک یادداشت استفاده می‌کند.

کارت‌ها

card_type

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

ارزش‌ها
0	ناشناخته
60	پیوند
61	جمع‌آوری کمک‌های مالی
62	ویدئو
63	لیست پخش
65	تأمین مالی از طریق هواداران
66	کالا
68	وب‌سایت مرتبط
69	کانال

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

card_id

شناسه‌ای که یوتیوب برای شناسایی منحصر به فرد یک کارت استفاده می‌کند.

صفحات پایان

end_screen_element_type

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

ارزش‌ها
501	ویدیو - این عنصر ویدیوی یوتیوب دیگری را تبلیغ می‌کند.
502	لیست پخش - این عنصر لیست پخش یوتیوب را تبلیغ می‌کند.
503	وب‌سایت - این عنصر به وب‌سایت مرتبط شما لینک می‌دهد.
504	کانال - عنصر به کانال دیگری پیوند دارد.
505	مشترک شوید - این عنصر، مشترکین را به عضویت در کانال شما تشویق می‌کند.
506	مرتبط
507	تامین مالی جمعی - این عنصر به یک وب‌سایت تامین مالی جمعی تایید شده لینک می‌دهد.
508	کالا - این عنصر به یک وب‌سایت کالا تایید شده لینک می‌دهد.
509	آپلود اخیر - این عنصر به جدیدترین ویدیوی آپلود شده در کانال شما پیوند می‌دهد.
510	بهترین برای بیننده

end_screen_element_id

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

زیرنویس‌ها

subtitle_language

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

subtitle_language_autotranslated

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

عملکرد تبلیغات

ad_type

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

ارزش	توضیحات	گزارش‌های مقدار در پرس‌وجو
1	تبلیغات ویدیویی قابل رد شدن (حراج)	auctionTrueviewInstream
2	تبلیغات نمایشی (حراج)	auctionDisplay
3	تبلیغات ویدیویی غیرقابل رد کردن (حراج)	auctionInstream
5	تبلیغات نمایشی (رزرو شده)	reservedDisplay
6	تبلیغات ویدیویی غیرقابل رد کردن (رزرو شده)	reservedInstream
13	ناشناخته	unknown
15	تبلیغات ویدیویی قابل رد شدن (رزرو شده)	reservedInstreamSelect
19	تبلیغات سپر (حراج)	auctionBumperInstream
20	تبلیغات سپر (رزرو شده)	reservedBumperInstream

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

ابعاد صاحب محتوا

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

claimed_status (only used in content owner reports)

این بُعد نشان می‌دهد که یک ردیف از داده‌ها فقط شامل معیارهای محتوای ادعا شده است. تنها مقدار معتبر برای این بُعد، claimed است. جدول موجود در تعریف بُعد uploader_type جزئیات بیشتری در مورد نحوه استفاده از این بُعد ارائه می‌دهد.

uploader_type (core dimension) (only used in content owner reports)

این بُعد نشان می‌دهد که آیا یک ردیف از داده‌ها شامل معیارهایی برای محتوای آپلود شده توسط مالک محتوای مشخص شده و/یا محتوای آپلود شده توسط اشخاص ثالث، مانند ویدیوهای آپلود شده توسط کاربر، است یا خیر. مقادیر معتبر self و thirdParty هستند. این یک بُعد اصلی است و تابع سیاست حذف است.

جدول زیر ترکیب‌های پشتیبانی‌شده برای ابعاد claimed_status و uploader_type را نشان می‌دهد:

مقدار claimed_status	مقدار uploader_type	توضیحات
[تنظیم نشده]	self	این ردیف شامل داده‌های YouTube Analytics برای محتوای آپلود شده توسط مالک محتوا (چه محتوای دارای حق انتشار و چه محتوای بدون حق انتشار) است.
claimed	self	این ردیف شامل داده‌هایی برای محتوای ادعایی آپلود شده توسط مالک محتوا است.
claimed	thirdParty	این ردیف شامل داده‌هایی برای محتوای ادعایی آپلود شده توسط شخص ثالث است.