يحدّد هذا المستند السمات المتوافقة مع 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". ويمكنك أيضًا استردادها باستخدام واجهة برمجة تطبيقات Content ID في YouTube.
المناطق الجغرافية
تحدِّد هذه السمات منطقة جغرافية مرتبطة بنشاط المستخدِم أو أداء الإعلان أو مقاييس الأرباح المقدَّرة.
- 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
إعلان قابل للتخطي أثناء عرض الفيديو 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
صفحات الهاشتاغ
المشاهدات التي مصدرها صفحات الهاشتاغ عند الطلب أو الصفحات المحورية لعلامات الهاشتاغ الخاصة بفيديوهات Shorts27
صفحات الصوت
المشاهدات التي نتجت من صفحات 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
توت بري 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_
- الجنس (السمة الأساسية)
- تحدِّد هذه السمة جنس المستخدمين الذين سجّلوا دخولهم والمرتبطين ببيانات التقرير.
القيم الصالحة هي
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
goo 9
Ameba 10
Facebook 11
Myspace 12
NUjij 18
تونتي 20
مينيم 21
ويكوب 22
سكاي روك 25
فوتكا 28
hi5 31
Twitter 32
عالم Cyworld 34
Blogger 36
VKontakte (تجنُّب Контакте) 37
Rakuten (楽天▼場) 38
LiveJournal 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
إرسال رسالة SMS 66
البريد الإلكتروني لـ LGE 67
سطر 68
Viber 69
كيك 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 Gaming 87
YouTube Kids 88
YouTube TV
اطّلِع على مستندات المساعدة للحصول على مزيد من المعلومات.
التعليقات التوضيحية
- annotation_type
- تحدّد هذه السمة طريقة عرض التعليق التوضيحي أثناء الفيديو. يسرد الجدول التالي قيم السمات المحتمَلة:
القيم 0
غير معروف 1
ملاحظة 3
قوائم التشغيل البارزة 4
العنوان 8
فقاعة تفسيرية كلامية 9
التصنيف 10
استخدام العلامة المائية للعلامة التجارية 11
فيديو مميّز 12
قائمة تشغيل مميزة 30
الحث على اتخاذ إجراء - annotation_id
- المعرّف الذي تستخدمه YouTube لتحديد التعليق التوضيحي بشكل فريد.
البطاقات
- card_type
- تحدِّد هذه السمة نوع البطاقة التي تم عرضها للمستخدم. يسرد الجدول التالي قيم السمات المحتمَلة:
القيم 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.
سمات مالك المحتوى
تُستخدم السمات التالية في تقارير مالكي المحتوى فقط.
- claim_status (تُستخدم فقط في تقارير مالكي المحتوى)
- تشير هذه السمة إلى أنّ صفًا من البيانات يحتوي فقط على مقاييس للمحتوى المُطالَب بملكيته. القيمة الوحيدة الصالحة لهذه السمة هي
claimed
. يقدّم الجدول الوارد في تعريف السمةuploader_type
مزيدًا من التفاصيل حول كيفية استخدام هذه السمة.
- segmentation_type (السمة الأساسية) (تُستخدَم فقط في تقارير مالكي المحتوى)
- تشير هذه السمة إلى ما إذا كان صف من البيانات يتضمّن مقاييس للمحتوى الذي حمّله مالك المحتوى المحدّد و/أو المحتوى الذي حمّلته جهات خارجية، مثل الفيديوهات التي حمّلها المستخدمون. القيمتان الصالحتان هما
self
وthirdParty
. هذه سمة أساسية وتخضع لسياسة الإيقاف.
يعرض الجدول أدناه التركيبات المتوافقة للسمتَينclaimed_status
وuploader_type
:
قيمة claimed_status
قيمة uploader_type
الوصف [لم يتم الضبط] ذاتي يتضمن الصف بيانات "إحصاءات YouTube" للمحتوى المُطالَب بملكيته وغير المُطالَب بملكيته والذي حمّله مالك المحتوى. تمت المطالبة بملكيته ذاتي يتضمّن الصفّ بيانات حول المحتوى المُطالَب بملكيته وحمّله مالك المحتوى. تمت المطالبة بملكيته thirdParty يتضمن الصف بيانات حول المحتوى المُطالَب بملكيته وحمّلته جهة خارجية.