يحدّد هذا المستند السمات التي تتيحها 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
فيديو ريمكس
المشاهدات الناتجة من رابط لفيديو ريمكس في مشغّل فيديوهات Shorts31
خلاصة البث المباشر بالوضع العمودي
المشاهدات التي نشأت من خلاصة البث المباشر بالوضع العمودي.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_
- الجنس (السمة الأساسية)
- تحدِّد هذه السمة جنس المستخدمين المسجّلين الدخول المرتبطين ببيانات التقرير.
القيم الصالحة هي
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
الحث على اتخاذ إجراء - 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.
سمات مالك المحتوى
تُستخدم السمات التالية في تقارير مالك المحتوى فقط.
- ادعاء_الحالة (يُستخدم في تقارير مالك المحتوى فقط)
- تشير هذه السمة إلى أنّ صف البيانات يحتوي فقط على مقاييس للمحتوى المُطالَب بملكيته. القيمة الصالحة الوحيدة لهذه السمة هي
claimed
. يقدِّم الجدول في تعريف السمةuploader_type
مزيدًا من التفاصيل عن كيفية استخدام هذه السمة.
- نوع القائم بالتحميل (السمة الأساسية) (تُستخدم فقط في تقارير مالكي المحتوى)
- تشير هذه السمة إلى ما إذا كان صف من البيانات يحتوي على مقاييس للمحتوى الذي حمّله مالك المحتوى المحدّد و/أو المحتوى المحمّل من قِبل جهات خارجية، مثل الفيديوهات التي يحمّلها المستخدمون. القيمتان الصالحتان هما
self
وthirdParty
. هذه سمة أساسية وتخضع لسياسة الإيقاف.
يوضّح الجدول أدناه التركيبات المتوافقة للسمتَينclaimed_status
وuploader_type
:
قيمة claimed_status
قيمة uploader_type
الوصف [لم يتم الضبط] نفسي يحتوي الصف على بيانات "إحصاءات YouTube" للمحتوى المُطالَب بملكيته وغير المُطالَب بملكيته وحمَّله مالك المحتوى. تمت المطالبة بملكيته نفسي يحتوي الصف على بيانات عن المحتوى المُطالَب بملكيته والذي حمَّله مالك المحتوى. تمت المطالبة بملكيته thirdParty يحتوي الصف على بيانات عن المحتوى المُطالَب بملكيته والذي حمّلته جهة خارجية.