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 مساءً بتوقيت المحيط الهادئ في اليوم والشهر والسنة المحدّدة. حسب الوقت من السنة، يكون توقيت المحيط الهادئ إما 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.
11 تتعلّق البيانات بالمشاهدات التي تمّت على خلاصة البث المباشر بالوضع العمودي.
12 تتعلّق البيانات بالمشاهدات التي تمّت في علامة التبويب "عيّنات" في YouTube Music.
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 إعلان قابل للتخطي أثناء عرض الفيديو
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. القيم المحتمَلة هي:
القيمة الوصف
creator استوديو YouTube
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 الحدث المباشر التالي
المشاهدات الواردة من ميزة الحدث المباشر التالي
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
32 VegaOS

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

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

age_group (سمة أساسية)
تحدّد هذه السمة الفئة العمرية للمستخدمين الذين سجّلوا الدخول والمرتبطين ببيانات التقرير، وتشمل المستخدمين الذين يقدّر YouTube أنّ عمرهم أقل من 18 عامًا. تستخدم واجهة برمجة التطبيقات الفئات العمرية التالية:
  • 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 Conversations
65 Go SMS
66 LGE Email
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 Inbox
84 Android Messenger
85 YouTube Music
86 YouTube لألعاب الفيديو
87 YouTube Kids
88 YouTube TV
89 المشاهدة مع الأصدقاء على YouTube
90 Allo
91 منشور في "المنتدى" على YouTube
92 إعادة نشر مشاركة في "المنتدى" على YouTube
93 رسائل KaiOS
94 النسخ واللصق في "خرائط Google"
95 المشاركة مع الأطفال
96 مربّع حوار نشاط النظام على الويب
97 Snapchat
98 معاينة ميزة مشاركة محتوى YouTube Music على Snapchat
99 المشاركة مع كاميرا Snapchat
100 مربّع حوار المشاركة في نظام Android
101 الحفظ في معرض الصور على الجهاز
102 Instagram
103 مربّع حوار مباشر حول نشاط النظام
104 Discord
105 قصص Instagram
106 قصص Facebook
107 المشاركة المباشرة في Meet
108 Samsung Messages
109 واتساب للأعمال
110 Samsung Notes
111 Google Keep
112 Lite
113 IMO
114 YouTube Mango
115 المشاركة مع مجموعة على Facebook
116 Google Chat
117 دعوة متعاونين إلى قائمة التشغيل
118 Quick Share
119 Quick Share (Samsung)
120 رمز الاستجابة السريعة المعروض
121 ميزة "الشاشة الخضراء" في YouTube Shorts
122 مشاركة محتوى بلا إعلانات
123 تطبيق Google
124 متصفح Google Chrome
125 التفاعل بدون معرفة المحتوى
126 رابط الدعوة (Android)
127 رابط الدعوة (iOS)
128 ريمكس

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

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

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 يحتوي الصف على بيانات لمحتوى تمّت المطالبة بملكيته وحمّلته جهة خارجية.