Dimensions

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

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

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

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

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

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

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

الأبعاد

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

الموارد

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

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

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

‫date (سمة أساسية)
تحدِّد هذه السمة التاريخ المرتبط بالمقاييس في كل صف من صفوف التقرير. في تقارير التحميل المُجمَّع، يشير التاريخ إلى الفترة التي تبدأ في الساعة 12:00 صباحًا بالتوقيت المحيط الهادئ وتنتهي في 11:59 مساءً بالتوقيت المحيط الهادئ في اليوم والشهر والسنة المحدّدين. استنادًا إلى الوقت من السنة، يكون توقيت المحيط الهادئ إما التوقيت العالمي المنسق -7 أو التوقيت العالمي المنسق -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 المحورية للهاشتاغ
27 صفحات الصوت
المشاهدات الواردة من صفحات Shorts التي تتضمّن محتوى صوتي
28 الحدث المباشر التالي
المشاهدات الواردة من الأحداث المباشرة التالية
29 ملفات البودكاست
المشاهدات الواردة من صفحة ملفات البودكاست على YouTube
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 OS
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.
‫gender (السمة الأساسية)
تحدِّد هذه السمة جنس المستخدِمين الذين سجّلوا الدخول والمرتبطين ببيانات التقرير. القيم الصالحة هي 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 Digg
4 reddit
5 StumbleUpon
6 mixi
7 Yahoo! اليابان
8 goo
9 Ameba
10 Facebook
11 Myspace
12 NUjij
18 Tuenti
20 menéame
21 Wykop
22 Skyrock
25 Fotka
28 hi5
31 Twitter
32 Cyworld
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 محادثات Sony
65 Go SMS
66 البريد الإلكتروني في LGE
67 Line
68 Viber
69 Kik
70 Skype
71 BlackBerry Messenger
72 WeChat
73 KAKAO Story
74 Dropbox
75 Telegram
76 صفحات Facebook
77 GroupMe
78 بريد إلكتروني على Android
79 تطبيق Motorola Messaging
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_status (لا يتم استخدامها إلا في تقارير مالكي المحتوى)
تشير هذه السمة إلى أنّ صف البيانات يتضمّن مقاييس للمحتوى الذي تمّت المطالبة بملكيته فقط. إنّ القيمة الصالحة الوحيدة لهذه السمة هي claimed. يقدّم الجدول في تعريف سمة uploader_type مزيدًا من التفاصيل حول كيفية استخدام هذه السمة.
uploader_type (سمة أساسية) (تُستخدَم فقط في تقارير مالكي المحتوى)
تشير هذه السمة إلى ما إذا كان صف البيانات يتضمّن مقاييس للمحتوى الذي حمّله مالك المحتوى المحدّد و/أو المحتوى الذي حمّلته جهات خارجية، مثل الفيديوهات التي حمّلها المستخدمون. القيم الصالحة هي self وthirdParty. هذه سمة أساسية وتخضع لسياسة الإيقاف النهائي.

يعرض الجدول التالي التركيبات المسموح بها لسمتَي claimed_status وuploader_type:

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