این سند ابعادی را تعریف میکند که YouTube Reporting API پشتیبانی میکند. این API گزارشهای انبوه حاوی دادههای YouTube Analytics را برای یک کانال یا مالک محتوا بازیابی میکند.
ابعاد معیارهای رایجی هستند که برای جمع آوری داده ها استفاده می شوند، مانند تاریخی که فعالیت کاربر در آن رخ داده است یا کشوری که کاربران در آن قرار داشتند.
هر گزارش انبوه از یک لیست از پیش تعریف شده ابعاد پشتیبانی می کند و در هر گزارشی، هر ردیف از داده ها ترکیبی منحصر به فرد از مقادیر ابعاد دارد. به این ترتیب، ترکیب مقادیر ابعاد هر ردیف به عنوان کلید اصلی برای آن سطر عمل می کند. شما نه نیازی به تعیین ابعاد دارید و نه گزینه ای برای تعیین ابعاد در گزارش درج شده است.
ابعاد هسته
در حالی که YouTube Reporting API مشمول خطمشی منسوخ تعریف شده در شرایط خدمات است، ابعاد غیر اصلی (و معیارهای غیر اصلی) مشمول این خطمشی نمیشوند. در تعاریف موجود در این صفحه، هر بُعدی که یک بعد اصلی باشد به صراحت به عنوان آن مشخص می شود.
لیست زیر ابعاد اصلی API را مشخص می کند. همه آنها همچنین ابعاد اصلی در YouTube Analytics API هستند.
برای اطلاعات بیشتر، به فهرست APIهای YouTube مشمول خطمشی منسوخ شدن مراجعه کنید.
ابعاد
بخشهای زیر ابعادی را تعریف میکنند که در گزارشهای انبوه YouTube Reporting API استفاده میشوند. مگر اینکه غیر از این ذکر شود، این ابعاد هم در گزارشهای کانال و هم در گزارش مالک محتوا استفاده میشوند.
منابع
این ابعاد مربوط به منابعی است که کانالها و صاحبان محتوا در YouTube مدیریت میکنند:
- video_id (core dimension)
- شناسه یک ویدیوی YouTube. در YouTube Data API، این مقدار ویژگی
id
یک منبعvideo
است. This is a core dimension and is subject to the Deprecation Policy . - playlist_id
- شناسه یک لیست پخش YouTube. در YouTube Data API، این مقدار ویژگی
id
منبعplaylist
است. - channel_id (core dimension)
- شناسه یک کانال YouTube. در YouTube Data API، این مقدار ویژگی
id
یک منبعchannel
است. This is a core dimension and is subject to the Deprecation Policy . - asset_id (only used in content owner reports)
- شناسه دارایی مدیریت شده در سیستم Content ID YouTube. دارایی نشان دهنده مالکیت معنوی شما در آن سیستم است. در وبسایت YouTube، میتوانید شناسههای دارایی را در مدیریت محتوای YouTube پیدا کنید. همچنین میتوانید با استفاده از YouTube Content ID 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)
- این بعد تاریخ مرتبط با معیارهای هر ردیف گزارش را مشخص می کند. در گزارشهای انبوه، تاریخ به دورهای اشاره دارد که از ساعت 12:00 صبح به وقت اقیانوس آرام شروع میشود و در روز، ماه و سال مشخص شده در ساعت 11:59 به وقت اقیانوس آرام به پایان میرسد. بسته به زمان سال، زمان اقیانوس آرام UTC-7 یا UTC-8 است.
توجه داشته باشید که در حالی که تاریخها معمولاً یک دوره 24 ساعته را نشان میدهند، تاریخهایی که ساعتها برای زمان تابستانی به جلو تنظیم میشوند، نشاندهنده یک دوره 23 ساعته هستند، و تاریخهایی که ساعتها به عقب تنظیم میشوند نشاندهنده یک دوره 25 ساعته است. This is a core dimension and is subject to the Deprecation Policy .
مکان های پخش
این ابعاد بینشی را در مورد صفحه یا برنامه ای که فعالیت کاربر در آن رخ داده است ارائه می دهد.
- playback_location_type
- این بعد نوع صفحه یا برنامهای را که در آن فعالیت کاربر رخ داده است، مشخص میکند. جدول زیر مقادیر ابعاد را فهرست می کند:
ارزش ها 0
داده ها مربوط به فعالیتی است که در صفحه تماشای ویدیو در YouTube یا در یک برنامه رسمی YouTube مانند برنامه YouTube Android رخ داده است. 1
دادهها مربوط به فعالیتهایی است که در وبسایت یا برنامه دیگری رخ داده است که در آن ویدیو با استفاده از جاسازی <iframe>
یا<object>
جاسازی شده است.2
داده ها مربوط به فعالیتی است که در صفحه کانال YouTube رخ داده است. 5
داده ها مربوط به معیارهایی است که نمی توان آنها را به یکی از انواع مکان های فهرست شده دیگر طبقه بندی کرد. 7
این داده ها مربوط به بازدیدهایی است که در صفحه اصلی یا صفحه اصلی YouTube، در فید اشتراک کاربر، یا در یکی دیگر از ویژگی های مرور YouTube انجام شده است. 8
داده ها مربوط به بازدیدهایی است که مستقیماً در صفحه نتایج جستجوی YouTube انجام شده است. 10
داده ها مربوط به بازدیدهایی است که در فید YouTube Shorts انجام شده است. - playback_location_detail
- این بعد نشانی اینترنتی یا برنامه ای را که پخش در آن انجام شده است مشخص می کند. این بعد فقط برای نماهایی پشتیبانی میشود که در پخشکنندههای تعبیهشده رخ دادهاند، به این معنی که مقدار بعد فقط در ردیفهایی پر میشود که مقدار بعد
1
است. در ردیف های دیگر، مقدار این بعد خالی است.
جزئیات پخش
- live_or_on_demand
- این بعد نشان می دهد که آیا معیارهای فعالیت کاربر در ردیف داده با بازدیدهای پخش زنده مرتبط است یا خیر. دادههای این بعد برای تاریخهایی که از 1 آوریل 2014 شروع میشوند در دسترس است.
جدول زیر مقادیر ابعاد را فهرست می کند:ارزش ها live
دادههای ردیف، فعالیت کاربر را که در طول پخش زنده رخ داده است، توصیف میکند. onDemand
دادههای ردیف، فعالیت کاربر را توصیف میکند که در طول پخش زنده رخ نداده است. - subscribed_status
- این بعد نشان میدهد که آیا معیارهای فعالیت کاربر در ردیف دادهها با بینندگانی مرتبط است که در کانال ویدیو یا فهرست پخش مشترک شدهاند. مقادیر ممکن
subscribed
وunsubscribed
هستند.
توجه داشته باشید که مقدار بعد از زمانی که فعالیت کاربر رخ می دهد دقیق است. به عنوان مثال، فرض کنید کاربری مشترک کانالی نشده است و یکی از ویدیوهای آن کانال را تماشا می کند، سپس در کانال مشترک شده و ویدیوی دیگری را در همان روز تماشا می کند. گزارش کانال نشان میدهد که یک بازدید دارای مقدار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
ویژگی ها را مرور کنید
بیننده از یک صفحه YouTube که به ویدیوها یا کانال ها منتهی می شود ارجاع داده شد. در گزارش منبع ترافیک، اگر مقدار این بعد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
جستجوی یوتیوب
بینندگان از نتایج جستجوی YouTube ارجاع داده شدند. در گزارش منبع ترافیک، اگر مقدار این بعد5
باشد، بعد traffic_source_detail عبارت جستجوی مرتبط را مشخص میکند. در گزارش های پرس و جو، این نوع منبع ترافیک به عنوانYT_SEARCH
شناسایی می شود.7
ویدیوهای پیشنهادی
بینندگان از یک فهرست ویدیوی مرتبط در صفحه تماشای ویدیوی دیگر ارجاع شدند. در گزارش منبع ترافیک، اگر مقدار این بعد7
باشد، بعد traffic_source_detail شناسه ویدیو را برای آن ویدیو مشخص میکند. در گزارشهای جستجو، این نوع منبع ترافیک بهعنوانRELATED_VIDEO
یاYT_RELATED
شناسایی میشود.8
سایر ویژگی های یوتیوب
بینندگان از یک صفحه YouTube که در یکی از انواع دیگر منبع ترافیک فهرست شده قرار نمی گیرد، ارجاع داده شدند. در گزارش منبع ترافیک، اگر مقدار این بعد8
باشد، بعد traffic_source_detail URL صفحه را مشخص می کند. در گزارشهای جستجو، این نوع منبع ترافیک به عنوانYT_OTHER_PAGE
شناسایی میشود. مقادیر ممکن عبارتند از:ارزش ها g-crec
کانال های پیشنهادی offline
آفلاین promotion
ارتقای شریک unknown
ناشناس widget
ویجت صفحه اصلی اندروید youtu.be
youtu.be ytremote
کنترل از راه دور YouTube 9
خارجی
بینندگان از پیوندی در وب سایت دیگری ارجاع داده شدند. این منبع ترافیک شامل ارجاعاتی از نتایج جستجوی Google است. در گزارش منبع ترافیک، اگر مقدار این بعد9
باشد، بعد traffic_source_detail صفحه وب خارجی را مشخص می کند. در گزارش های پرس و جو، این نوع منبع ترافیک به عنوانEXT_URL
شناسایی می شود.11
کارت های ویدئویی و حاشیه نویسی
بینندگان با کلیک بر روی یک حاشیه نویسی یا کارت در یک ویدیو دیگر ارجاع داده شدند. در گزارش های پرس و جو، این نوع منبع ترافیک به عنوانANNOTATION
شناسایی می شود.14
لیست های پخش
بازدیدها هنگام پخش ویدیو به عنوان بخشی از فهرست پخش اتفاق افتاد. در گزارش های پرس و جو، این نوع منبع ترافیک به عنوانPLAYLIST
شناسایی می شود.
توجه داشته باشید که این منبع ترافیک با منبع نوع18
متفاوت است، که نشان می دهد بازدیدها از صفحه ای نشات گرفته اند که همه ویدیوهای موجود در لیست پخش را فهرست می کند .17
اطلاعیه ها
بینندگان از طریق ایمیل یا اعلان از YouTube ارجاع شدند. در گزارشهای جستجو، این نوع منبع ترافیک بهعنوانNOTIFICATION
شناسایی میشود. مقادیر ممکن عبارتند از:ارزش ها inbox
push
sdig
بازدیدها از اعلانهایی نشأت میگرفتند که بخشی از خلاصه مشترکان بودند uploaded_other
بازدیدها از اعلانهای غیر فشاری، مانند اعلانهای ایمیل یا صندوق ورودی، که هنگام آپلود ویدیو برای مشترکین ارسال میشوند، ایجاد میشوند. uploaded_push
بازدیدها از اعلانهای فشاری که هنگام آپلود ویدیو برای مشترکین ارسال میشد، نشأت میگرفتند 18
صفحات لیست پخش
بازدیدها از صفحهای نشأت میگیرند که همه ویدیوهای یک لیست پخش را فهرست میکند. در گزارش های پرس و جو، این نوع منبع ترافیک به عنوانYT_PLAYLIST_PAGE
شناسایی می شود.
توجه داشته باشید که این منبع ترافیک با منبع نوع14
متفاوت است، که نشان میدهد این بازدیدها در حین پخش ویدیو به عنوان بخشی از فهرست پخش رخ داده است.19
برنامه نویسی از محتوای ادعا شده
بازدیدها از ویدیوهای ادعا شده و بارگذاری شده توسط کاربر که مالک محتوا برای تبلیغ محتوای مشاهده شده استفاده میکرده است. در گزارش های پرس و جو، این منبع ترافیک به عنوانCAMPAIGN_CARD
شناسایی می شود. این منبع ترافیک فقط برای گزارش های مالک محتوا پشتیبانی می شود.20
صفحه پایانی ویدئویی تعاملی
بازدیدها از صفحه پایانی یک ویدیوی دیگر سرچشمه می گیرند. در گزارشهای جستجو، این نوع منبع ترافیک به عنوانEND_SCREEN
شناسایی میشود.23
داستان ها
بیننده با کشیدن انگشت به صورت عمودی از ویدیوی قبلی در تجربه مشاهده Stories ارجاع داده شد.24
شورت
بیننده با کشیدن انگشت به صورت عمودی از ویدیوی قبلی در تجربه مشاهده Shorts ارجاع داده شد.25
صفحات محصول
ویدیوهای موجود در صفحه محصول بینندگان را به کانال دیگری می آورد.26
صفحات هشتگ
بازدیدها از صفحات هشتگ VOD یا صفحات محوری هشتگ Shorts نشات گرفته اند.27
صفحات صدا
بازدیدها از صفحات محوری صدای Shorts سرچشمه میگیرند.28
تغییر مسیر زنده
بازدیدها از تغییر مسیرهای زنده نشات گرفته اند.30
ویدیوی ریمیکس شده
بازدیدها از یک پیوند ویدیویی ریمیکس شده در پخش کننده Shorts نشات گرفته اند.31
فید زنده عمودی
بازدیدها از فید زنده عمودی نشات گرفته اند.32
ویدیوی مرتبط
بازدیدها از پیوند ویدیویی مرتبط در پخش کننده Shorts نشات گرفته اند. - traffic_source_detail
- این بعد جزئیات بیشتری را در مورد منبع ترافیک ارائه میکند که بعد traffic_source_type ردیف ارزش دارد. این مقدار ابعاد برای مقادیر ابعاد ترافیک_source_type زیر پر شده است:
-
1
- مقدار ابعاد نوع تبلیغی را که به بیننده نشان داده شده است مشخص می کند. برای لیستی از مقادیر ممکن، تعریف traffic_source_type را ببینید. -
3
- مقدار بعد مشخص کننده ویژگی YouTube است که منجر به ترافیک ارجاع شده است. برای لیستی از مقادیر ممکن، تعریف traffic_source_type را ببینید. -
4
– مقدار ابعاد شناسه کانالی را که بیننده از آن ارجاع داده شده است را مشخص می کند. -
5
– مقدار بعد عبارت جستجویی را مشخص می کند که منجر به ترافیک ارجاع شده است. -
7
- مقدار ابعاد ویدیویی را که بیننده از آن ارجاع داده شده است مشخص می کند. -
8
– مقدار بعد نوع صفحه یوتیوب را که منجر به ترافیک ارجاع شده است مشخص می کند. برای لیستی از مقادیر ممکن، تعریف traffic_source_type را ببینید. -
9
– مقدار ابعاد صفحه خارجی را که ترافیک از آن ارجاع داده شده است مشخص می کند. -
17
- مقدار بعد نوع اعلانی را که منجر به ترافیک ارجاع شده است مشخص می کند. برای لیستی از مقادیر ممکن، تعریف traffic_source_type را ببینید. -
19
- مقدار ابعاد ویدیویی را که بیننده از آن ارجاع داده شده است مشخص می کند. -
20
- مقدار ابعاد ویدیویی را که بیننده از آن ارجاع داده شده است مشخص می کند. -
25
- مقدار ابعاد شناسه محصول را که یک شناسه نمودار دانش Google است، مشخص می کند. -
26
- مقدار ابعاد هشتگی را که منجر به ترافیک ارجاع شده است مشخص می کند. -
27
- مقدار ابعاد ویدیویی را که بیننده از آن ارجاع داده شده است مشخص می کند. -
28
- مقدار ابعاد شناسه کانالی را که بیننده از طریق تغییر مسیرهای زنده از آن ارجاع داده شده است را مشخص می کند. -
30
- مقدار ابعاد ویدیویی را که بیننده از آن ارجاع داده شده است مشخص می کند.
-
دستگاه ها
- device_type
- این بعد فاکتور شکل فیزیکی دستگاهی را که نما روی آن رخ داده است مشخص می کند. جدول زیر مقادیر ابعاد معتبر را فهرست می کند:
ارزش ها 100
ناشناس 101
کامپیوتر 102
تلویزیون 103
کنسول بازی 104
تلفن همراه 105
تبلت - operating_system
- این بعد سیستم نرم افزاری دستگاهی را که نما روی آن رخ داده است مشخص می کند. جدول زیر مقادیر ابعاد معتبر را فهرست می کند:
ارزش ها 1
دیگر 2
ویندوز 3
ویندوز موبایل 4
اندروید 5
iOS 6
سیمبین 7
شاه توت 9
مکینتاش 10
پلی استیشن 11
بادا 12
WebOS 13
لینوکس 14
هیپ تاپ 15
MeeGo 16
Wii 17
ایکس باکس 18
پلی استیشن ویتا 19
تلویزیون هوشمند 20
نینتندو 3DS 21
Chromecast 22
تایزن 23
فایرفاکس 24
RealMedia 25
KaiOS 26
روکو 27
نینتندو سوییچ 28
Apple tvOS 29
Fire OS 30
ChromeOS 31
ویدا
جمعیت شناسی
ابعاد جمعیتی به شما کمک می کند تا محدوده سنی و توزیع جنسیتی مخاطبان خود را درک کنید. مرکز راهنمایی YouTube حاوی اطلاعات بیشتری درباره دادههای جمعیتی در گزارشهای 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_
-
- gender (core dimension)
- این بعد جنسیت کاربرانی را که وارد سیستم شده اند مرتبط با داده های گزارش را مشخص می کند. مقادیر معتبر
FEMALE
،MALE
وGENDER_OTHER
هستند. This is a core dimension and is subject to the Deprecation Policy .
مشارکت و به اشتراک گذاری محتوا
- این بعد، سرویسی را که برای اشتراکگذاری ویدیوها استفاده شده است، مشخص میکند. ویدیوها را می توان در YouTube (یا از طریق پخش کننده YouTube) با استفاده از دکمه "اشتراک گذاری" به اشتراک گذاشت. This is a core dimension and is subject to the Deprecation Policy .
جدول زیر مقادیر ابعاد معتبر را فهرست می کند:ارزش ها 0
ناشناس 1
دیگ 4
reddit 5
StumbleUpon 6
میکسی 7
یاهو ژاپن 8
خوب 9
آمیبا 10
فیس بوک 11
مای اسپیس 12
نوجیج 18
تونتی 20
منیم 21
وایکوپ 22
اسکای راک 25
فتکا 28
سلام5 31
توییتر 32
Cyworld 34
وبلاگ نویس 36
VKontakte (ВКонтакте) 37
راکوتن (楽天市場) 38
LiveJournal 39
Odnoklassniki (Одноклассники) 40
وبلاگ Tumblr 42
لینکدین 43
+Google 44
Weibo 45
پینترست 46
ایمیل 47
فیس بوک مسنجر 49
واتس اپ 50
Hangouts 51
جیمیل 52
کاکائو (گفتگوی کاکائو) 53
دیگر 55
در کلیپ بورد کپی کنید 59
جاسازی کنید 60
پیامک 61
پیام رسان اندروید 62
پیام های Verizon 63
پیامک HTC 64
مکالمات سونی 65
برو اس ام اس 66
ایمیل LGE 67
خط 68
وایبر 69
کیک 70
اسکایپ 71
پیام رسان بلک بری 72
وی چت 73
داستان کاکائو 74
دراپ باکس 75
تلگرام 76
صفحات فیس بوک 77
GroupMe 78
ایمیل اندروید 79
پیام رسانی موتورولا 80
اشتراک گذاری نزدیک 81
ناور 82
گفتگوی فعالیت سیستم iOS 83
صندوق ورودی گوگل 84
مسنجر اندروید 85
YouTube Music 86
بازی YouTube 87
YouTube Kids 88
YouTube TV
برای اطلاعات بیشتر به اسناد راهنما مراجعه کنید.
حاشیه نویسی ها
- annotation_type
- این بعد نحوه نمایش حاشیه نویسی را در طول ویدیو مشخص می کند. جدول زیر مقادیر ابعاد احتمالی را فهرست می کند:
مرکز راهنمایی YouTube جزئیات بیشتری در مورد انواع مختلف حاشیه نویسی و همچنین فرآیند افزودن حاشیه نویسی به ویدیوهای شما ارائه می دهد.ارزش ها 0
ناشناس 1
توجه داشته باشید 3
کانون توجه 4
عنوان 8
حباب گفتار 9
برچسب بزنید 10
واترمارک برندینگ 11
ویدیوی ویژه 12
لیست پخش ویژه 30
فراخوان برای اقدام - annotation_id
- شناسه ای که YouTube برای شناسایی منحصر به فرد یک حاشیه نویسی استفاده می کند.
کارت ها
- card_type
- این بعد نوع کارتی را که به کاربر نمایش داده شده است مشخص می کند. جدول زیر مقادیر ابعاد احتمالی را فهرست می کند:
مرکز راهنمایی YouTube جزئیات بیشتری در مورد انواع مختلف کارت ها و همچنین فرآیند افزودن کارت به ویدیوهای شما ارائه می دهد.ارزش ها 0
ناشناس 60
پیوند 61
جمع آوری کمک های مالی 62
ویدئو 63
لیست پخش 65
تامین مالی طرفداران 66
کالا 68
وب سایت مرتبط 69
کانال - card_id
- شناسهای که YouTube برای شناسایی منحصربهفرد یک کارت استفاده میکند.
صفحه های پایانی
- end_screen_element_type
- این بعد نوع عنصر صفحه پایانی را که به کاربر نمایش داده شده است مشخص می کند. جدول زیر انواع عناصر صفحه پایانی و مقادیر آنها را فهرست می کند:
ارزش ها 501
ویدیو - این عنصر ویدیوی YouTube دیگری را تبلیغ می کند. 502
لیست پخش - این عنصر لیست پخش YouTube را تبلیغ می کند. 503
وب سایت - عنصر به وب سایت مرتبط شما پیوند می یابد. 504
کانال - عنصر به کانال دیگری پیوند می خورد. 505
اشتراک - عنصر اشتراک در کانال شما را تشویق می کند. 506
مرتبط 507
تأمین مالی جمعی - این عنصر به یک وب سایت تأمین مالی تأیید شده پیوند دارد. 508
کالا - عنصر به یک وب سایت کالای تأیید شده پیوند می دهد. 509
آپلود اخیر - عنصر به آخرین ویدیوی آپلود شده کانال شما پیوند دارد. 510
بهترین برای بیننده - end_screen_element_id
- شناسهای که YouTube برای شناسایی منحصربهفرد عنصر صفحه پایانی استفاده میکند.
زیرنویس
- subtitle_language
- این بعد زبان زیرنویس بسته را که برای طولانیترین زمان در طول مشاهده استفاده میشود، مشخص میکند. بازدیدهایی که زیرنویسهای بسته برای آنها اغلب غیرفعال شده است، شمارش نمیشود. برای اطلاعات بیشتر درباره گزارشهایی که حاوی این بعد هستند، به مستندات گزارشهای کانال یا گزارشهای مالک محتوا مراجعه کنید.
- subtitle_language_autotranslated
- این بعد، زبان شرح بسته ترجمه شده خودکار را که برای طولانیترین زمان در حین مشاهده استفاده میشود، مشخص میکند. بازدیدهایی که زیرنویسهای بسته برای آنها اغلب غیرفعال شده است، شمارش نمیشود. برای اطلاعات بیشتر درباره گزارشهایی که حاوی این بعد هستند، به مستندات گزارشهای کانال یا گزارشهای مالک محتوا مراجعه کنید.
عملکرد تبلیغات
- ad_type
- بعد
ad_type
در گزارشهای عملکرد آگهی استفاده میشود و معیارهای درخواستی را بر اساس انواع تبلیغاتی که در حین پخش ویدیو اجرا میشوند جمعآوری میکند. جدول زیر مقادیر ابعاد احتمالی را فهرست می کند. برای اطلاعات بیشتر درباره قالبهای تبلیغات YouTube، به مرکز راهنمایی YouTube مراجعه کنید.ارزش توضیحات ارزش در گزارش های پرس و جو 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 این ردیف حاوی داده هایی برای محتوای ادعا شده است که توسط شخص ثالث بارگذاری شده است.