Dimensions

يحدّد هذا المستند السمات التي تتيحها YouTube Reporting API. تسترد واجهة برمجة التطبيقات هذه التقارير المجمّعة التي تتضمّن بيانات "إحصاءات YouTube" لقناة أو مالك محتوى.

السمات هي معايير شائعة تُستخدَم لتجميع البيانات، مثل تاريخ حدوث نشاط المستخدِم أو البلد الذي كان فيه المستخدِمون.

يتيح كل تقرير مجمّع قائمة السمات المحدّدة مسبقًا، ويحتوي كل صف من البيانات في أي تقرير على مجموعة فريدة من قيم السمات. وعلى هذا النحو، تعمل مجموعة قيم السمات في كل صف كمفتاح أساسي لهذا الصف. لا تحتاج إلى تحديد السمات التي يتم تضمينها في التقرير أو توفُّر خيار تحديدها.

السمات الأساسية

تخضع واجهة YouTube Reporting API لسياسة الإيقاف الواردة في بنود الخدمة والسمات غير الأساسية (والمقاييس غير الأساسية) ليست وفقًا للسياسة. في التعريفات الواردة في هذه الصفحة، أي بُعد يُعد بُعدًا أساسيًا المحددة بشكل صريح على هذا النحو.

وتحدِّد القائمة التالية السمات الأساسية لواجهة برمجة التطبيقات. تشكّل كلّها أيضًا سمات أساسية في YouTube Analytics API.

للمزيد من المعلومات، يمكنك الاطّلاع على قائمة واجهات برمجة تطبيقات YouTube الخاضعة لسياسة الإيقاف.

الأبعاد

تحدّد الأقسام التالية السمات المستخدمة في التقارير المجمّعة لواجهة YouTube Reporting API. تُستخدَم هذه السمات في تقارير القناة ومالك المحتوى ما لم يُذكر خلاف ذلك.

الموارد

تتوافق هذه السمات مع الموارد التي يديرها مالكو القنوات والمحتوى على YouTube:

video_id (السمة الأساسية)
معرّف فيديو على YouTube في YouTube Data API، هذه هي قيمة video الخاص بالمورد id. This is a core dimension and is subject to the Deprecation Policy.
playlist_id
رقم تعريف قائمة تشغيل على YouTube في YouTube Data API، هذه هي قيمة السمة id الخاصة بمورد playlist.
channel_id (السمة الأساسية)
معرّف قناة على YouTube في YouTube Data API، هذه هي قيمة السمة id الخاصة بمورد channel. This is a core dimension and is subject to the Deprecation Policy.
asset_id (تُستخدَم في تقارير مالك المحتوى فقط)
معرّف مادة عرض مُدارة في نظام Content ID في YouTube تمثل مادة العرض حقوق الملكية الفكرية في هذا النظام. على موقع YouTube الإلكتروني، يمكنك العثور على معرّفات مواد العرض في نظام "إدارة المحتوى" في YouTube. ويمكنك أيضًا استردادها باستخدام YouTube Content ID API.

المناطق الجغرافية

وتحدِّد هذه السمات منطقة جغرافية مرتبطة بنشاط المستخدِم أو أداء الإعلان أو مقاييس الأرباح المقدّرة.

country_code (السمة الأساسية)
البلد المرتبط بالمقاييس الواردة في صف التقرير. قيمة السمة هي رمز بلد مكوّن من حرفَين وفقًا لمعيار 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. ولا توفّر أيضًا التقسيمات الفرعية لبلدان أخرى غير الولايات المتحدة.

الفترات الزمنية

التاريخ (السمة الأساسية)
تحدِّد هذه السمة التاريخ المرتبط بالمقاييس الواردة في كل صف من صفوف التقرير. دُفعة واحدة التقارير، يشير التاريخ إلى الفترة التي تبدأ في الساعة 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
تحدِّد هذه السمة عنوان URL أو التطبيق الذي تم تشغيل الفيديو عليه. لا تتوفّر هذه السمة إلا للمشاهدات التي حدثت في مشغّلات مضمّنة، ما يعني أنّه لا تتم تعبئة قيمة السمة إلا في الصفوف التي تكون فيها قيمة السمة 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 الإعلانات على YouTube
تمّت إحالة المُشاهد إلى الفيديو من خلال إعلان. في تقرير مصدر الزيارات، إذا كانت قيمة هذه السمة هي 1، ستحدِّد السمة traffic_source_detail نوع الإعلان الذي تم عرضه للمُشاهد. في تقارير طلبات البحث، يتمّ تحديد نوع مصدر الزيارات هذا على أنّه ADVERTISING. القيم المتاحة:
القيم
ctp_engagement_ad إعلان جذب من خلال النقر للتشغيل
engagement_ad إعلان جذب
googlemediaads الإعلانات على شبكة بحث Google
insearch_display TrueView ضمن البحث وضمن العرض
instream TrueView ضمن البث
instream-select إعلان محجوز ضمن عرض الفيديو قابل للتخطي
unknown إعلانات YouTube غير المصنفة
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 قنوات YouTube
تمّت إحالة المشاهدين من صفحة قناة على YouTube. في تقرير مصدر الزيارات، إذا كانت قيمة هذه السمة هي 4، ستحدّد السمة traffic_source_detail معرّف القناة لتلك القناة. في تقارير طلبات البحث، يتمّ تحديد نوع مصدر الزيارات هذا على أنّه YT_CHANNEL.
5 بحث YouTube
تمّت إحالة المشاهدين من نتائج البحث على YouTube. في تقرير مصدر الزيارات، إذا كانت قيمة هذه السمة هي 5، ستحدِّد السمة traffic_source_detail عبارة البحث المرتبطة. في تقارير طلبات البحث، يتمّ تحديد نوع مصدر الزيارات هذا على أنّه YT_SEARCH.
7 الفيديوهات المقترَحة
تمت إحالة المشاهدين من بيانات فيديو ذات صلة على صفحة مشاهدة فيديو أخرى. في تقرير مصدر الزيارات، إذا كانت قيمة هذه السمة هي 7، ستحدّد السمة traffic_source_detail معرّف الفيديو لذلك الفيديو. في تقارير طلبات البحث، يتمّ تحديد نوع مصدر الزيارات هذا على أنّه RELATED_VIDEO أو YT_RELATED.
8 ميزات أخرى على YouTube
تمّت إحالة المشاهدين من صفحة على YouTube لا تندرج ضمن أي من مصادر الزيارات الأخرى المُدرَجة. في تقرير مصدر الزيارات، إذا كانت قيمة هذه السمة هي 8، ستحدِّد السمة traffic_source_detail عنوان URL للصفحة. في تقارير طلبات البحث، يتمّ تحديد نوع مصدر الزيارات هذا على أنّه YT_OTHER_PAGE. القيم المتاحة:
القيم
g-crec القنوات الموصى بها
offline بلا إنترنت
promotion الترويج للشركاء
unknown غير معروف
widget أداة شاشة Android الرئيسية
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 القصص
تمت إحالة المُشاهد من خلال التمرير سريعًا عموديًا من الفيديو السابق في تجربة مشاهدة "القصص".
24 فيديوهات Shorts
تمت إحالة المُشاهد من خلال التمرير سريعًا عموديًا من الفيديو السابق في تجربة مشاهدة فيديوهات Shorts.
25 صفحات المنتجات
جذبت الفيديوهات على صفحة أحد المشاهدين المشاهدين إلى قناة أخرى.
26 صفحات الهاشتاغ
المشاهدات مصدرها صفحات الهاشتاغ الخاصة بالفيديوهات عند الطلب أو من صفحات Shorts المحورية الخاصة بعلامة الهاشتاغ في فيديوهات Shorts.
27 صفحات الصوت
المشاهدات التي نشأت من صفحات Shorts المحورية للمحتوى الصوتي.
28 الحدث المباشر التالي
المشاهدات مصدرها الحدث المباشر التالي.
30 فيديو ريمكس
المشاهدات الناتجة من رابط لفيديو ريمكس في مشغّل فيديوهات Shorts
31 خلاصة البث المباشر بالوضع العمودي
المشاهدات التي نشأت من خلاصة البث المباشر بالوضع العمودي.
32 فيديو ذو صلة
المشاهدات الناتجة من رابط فيديو ذي صلة في مشغّل فيديوهات Shorts
traffic_source_detail
توفّر هذه السمة تفاصيل إضافية عن مصدر الزيارات الذي تُدخله قيمة السمة traffic_source_type للصف. تتمّ تعبئة قيمة السمة هذه لقيم السمة traffic_source_type التالية:
  • 1 – تحدِّد قيمة السمة نوع الإعلان الذي تم عرضه للمشاهد. اطّلِع على تعريف traffic_source_type للحصول على قائمة بالقيم المحتملة.
  • 3 – تحدِّد قيمة البُعد ميزة YouTube التي أدّت إلى الزيارات المُشار إليها. اطّلِع على تعريف traffic_source_type للحصول على قائمة بالقيم المحتملة.
  • 4 – تحدّد قيمة البُعد معرّف القناة الذي تمت إحالة المُشاهد منه.
  • 5 – تحدّد قيمة البُعد عبارة البحث التي أدت إلى الزيارات المُحالة.
  • 7 – تحدد قيمة البُعد الفيديو الذي تمت إحالة المُشاهد منه.
  • 8 – تحدد قيمة البُعد نوع صفحة YouTube التي أدت إلى الزيارات التي تمت إحالتها. اطّلِع على تعريف 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 Windows
3 Windows Mobile
4 Android
5 iOS
6 Symbian
7 Blackberry
9 نظام التشغيل Macintosh
10 Playstation
11 Bada
12 WebOS
13 Linux
14 Hiptop
15 MeeGo
16 نظام التشغيل Wii
17 Xbox
18 PlayStation Vita
19 تلفزيون ذكي
20 Nintendo 3DS
21 Chromecast
22 Tizen
23 Firefox
24 RealMedia
25 KaiOS
26 Roku
27 Nintendo Switch
28 Apple tvOS
29 نظام التشغيل Fire
30 ChromeOS
31 Vidaa

الخصائص الديمغرافية

تساعدك سمات الخصائص الديمغرافية على فهم توزيع جمهورك حسب الفئة العمرية والجنس. يتضمّن مركز مساعدة YouTube معلومات إضافية عن البيانات الديمغرافية في تقارير YouTube Analytics.

age_group (السمة الأساسية)
تحدِّد هذه السمة الفئة العمرية للمستخدمين المسجّلين الدخول المرتبطين ببيانات التقرير. تستخدم واجهة برمجة التطبيقات الفئات العمرية التالية:
  • 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.
الجنس (السمة الأساسية)
تحدِّد هذه السمة جنس المستخدمين المسجّلين الدخول المرتبطين ببيانات التقرير. القيم الصالحة هي FEMALE وMALE وGENDER_OTHER. This is a core dimension and is subject to the Deprecation Policy.

التفاعل ومشاركة المحتوى

sharing_service (السمة الأساسية)
تحدّد هذه السمة الخدمة التي تم استخدامها لمشاركة الفيديوهات. يمكن مشاركة الفيديوهات على YouTube (أو عبر مشغّل YouTube) باستخدام الزر "مشاركة" .
This is a core dimension and is subject to the Deprecation Policy.
يستعرض الجدول التالي قيم السمات الصالحة:
القيم
0 غير معروف
1 بدفن الجزء السفلي
4 reddit
5 StumbleUpon
6 mixi
7 Yahoo! اليابان
8 غو
9 Ameba
10 Facebook
11 Myspace
12 NUjij
18 Tuenti
20 صغير
21 Wykop
22 Skyrock
25 فوتكا
28 hi5
31 Twitter
32 عالم الإنترنت
34 Blogger
36 VKontakte (سينКонтакте)
37 Rakuten (楽天 الموثوق場)
38 لايفجورنال
39 Odnoklassniki (للتأكيدноклассники)
40 tumblr.
42 LinkedIn
43 ‏Google+‎
44 Weibo
45 Pinterest
46 البريد الإلكتروني
47 Facebook Messenger
49 WhatsApp
50 Hangouts
51 Gmail
52 Kakao (Kakao Talk)
53 غير ذلك
55 نسخ إلى الحافظة
59 تضمين
60 الرسائل النصية
61 المراسلة على Android
62 رسائل Verizon
63 رسالة نصية من HTC
64 محادثات سوني
65 إرسال رسائل SMS
66 بريد LGE الإلكتروني
67 سطر
68 Viber
69 Kik
70 Skype
71 برنامج Blackberry Messenger
72 WeChat
73 قصة KAKAO
74 Dropbox
75 Telegram
76 صفحات Facebook
77 GroupMe
78 البريد الإلكتروني لنظام التشغيل Android
79 رسائل Motorola
80 المشاركة عن قرب
81 Naver
82 مربّع حوار نشاط نظام iOS
83 البريد الوارد من Google
84 مراسلة Android
85 YouTube Music
86 YouTube لألعاب الفيديو
87 YouTube Kids
88 YouTube TV

يُرجى الاطّلاع على مستندات المساعدة للحصول على مزيد من المعلومات.

التعليقات التوضيحية

annotation_type
تحدد هذه السمة طريقة عرض التعليق التوضيحي أثناء تشغيل الفيديو. يسرد الجدول التالي قيم السمات المحتملة:
القيم
0 غير معروف
1 ملاحظة
3 قوائم التشغيل البارزة
4 العنوان
8 فقاعة تفسيرية كلامية
9 التصنيف
10 علامة مائية للعلامة التجارية
11 فيديو مميّز
12 قائمة تشغيل مميزة
30 الحث على اتخاذ إجراء
يوفر مركز مساعدة YouTube مزيدًا من التفاصيل حول الأنواع المختلفة من التعليقات التوضيحية بالإضافة إلى عملية إضافة التعليقات التوضيحية إلى مقاطع الفيديو.
annotation_id
المعرّف الذي يستخدمه YouTube لتحديد تعليق توضيحي بشكل فريد

البطاقات

card_type
تحدِّد هذه السمة نوع البطاقة التي تم عرضها للمستخدم. يسرد الجدول التالي قيم السمات المحتملة:
القيم
0 غير معروف
60 رابط
61 جمع التبرعات
62 فيديو
63 قائمة تشغيل
65 التمويل من المعجبين
66 السلع
68 الموقع الإلكتروني المرتبط
69 القناة
يقدّم مركز مساعدة YouTube مزيدًا من التفاصيل حول الأنواع المختلفة من البطاقات بالإضافة إلى عملية إضافة بطاقات إلى فيديوهاتك.
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. يقدِّم الجدول في تعريف السمة uploader_type مزيدًا من التفاصيل عن كيفية استخدام هذه السمة.
نوع القائم بالتحميل (السمة الأساسية) (تُستخدم فقط في تقارير مالكي المحتوى)
تشير هذه السمة إلى ما إذا كان صف من البيانات يحتوي على مقاييس للمحتوى الذي حمّله مالك المحتوى المحدّد و/أو المحتوى المحمّل من قِبل جهات خارجية، مثل الفيديوهات التي يحمّلها المستخدمون. القيمتان الصالحتان هما self وthirdParty. هذه سمة أساسية وتخضع لسياسة الإيقاف.

يوضّح الجدول أدناه التركيبات المتوافقة للسمتَين claimed_status وuploader_type:

قيمة claimed_status قيمة uploader_type الوصف
[لم يتم الضبط] نفسي يحتوي الصف على بيانات "إحصاءات YouTube" للمحتوى المُطالَب بملكيته وغير المُطالَب بملكيته وحمَّله مالك المحتوى.
تمت المطالبة بملكيته نفسي يحتوي الصف على بيانات عن المحتوى المُطالَب بملكيته والذي حمَّله مالك المحتوى.
تمت المطالبة بملكيته thirdParty يحتوي الصف على بيانات عن المحتوى المُطالَب بملكيته والذي حمّلته جهة خارجية.