تحدّد هذه المقالة الأبعاد التي تتيحها YouTube Reporting API. تتيح واجهة برمجة التطبيقات هذه استرداد التقارير المجمّعة التي تتضمّن بيانات "إحصاءات YouTube" لقناة أو مالك محتوى.
السمات هي معايير شائعة تُستخدَم لتجميع البيانات، مثل التاريخ الذي حدث فيه نشاط المستخدِم أو البلد الذي كان يتواجد فيه المستخدِمون.
يتيح كل تقرير مجمّع قائمة محدّدة مسبقًا من السمات، وفي أي تقرير، يحتوي كل صف من البيانات على مجموعة فريدة من قيم السمات. وبالتالي، تعمل مجموعة قيم السمات في كل صف كمفتاح أساسي لهذا الصف. لا تحتاج إلى تحديد السمات التي يتم تضمينها في التقرير، ولا يتوفّر لك خيار تحديدها.
السمات الأساسية
مع أنّ سياسة الإيقاف النهائي المحدّدة في بنود الخدمة تنطبق على YouTube Reporting API، إلا أنّ السِمتَين غير الأساسيتَين (والمقاييس غير الأساسية) لا تخضعان لهذه السياسة. في التعريفات الواردة في هذه الصفحة، يتم تحديد أي سمة أساسية بشكل صريح.
تحدّد القائمة التالية السمات الأساسية لواجهة برمجة التطبيقات. وكلّها أيضًا سمات أساسية في "واجهة برمجة تطبيقات YouTube Analytics".
لمزيد من المعلومات، يُرجى الاطّلاع على قائمة واجهات برمجة التطبيقات في 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 الخاصة بها. ولا يتيح أيضًا تقسيم البلدان إلى مناطق فرعية باستثناء الولايات المتحدة.
الفترات الزمنية
- التاريخ (سمة أساسية)
- تحدّد هذه السمة التاريخ المرتبط بالمقاييس في كل صف من صفوف التقرير. في التقارير المجمّعة، يشير التاريخ إلى الفترة التي تبدأ في الساعة 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_displayTrueView ضمن البحث وضمن العرض 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.beyoutu.be ytremoteجهاز تحكم YouTube 9مصدر خارجي
تمت إحالة المشاهدين من رابط على موقع إلكتروني آخر. يتضمّن مصدر الزيارات هذا الإحالات الواردة من نتائج "بحث Google". في تقرير مصدر الزيارات، إذا كانت قيمة هذه السمة هي9، تحدّد السمة traffic_source_detail صفحة الويب الخارجية. في تقارير طلبات البحث، يتم تحديد نوع مصدر الزيارات هذا على أنّهEXT_URL.11بطاقات الفيديو والتعليقات التوضيحية
تمت إحالة المشاهدين إلى الفيديو من خلال النقر على تعليق توضيحي أو بطاقة في فيديو آخر. في تقارير طلبات البحث، يتم تحديد نوع مصدر الزيارات هذا على أنّهANNOTATION.14قوائم التشغيل
حدثت المشاهدات أثناء تشغيل الفيديو كجزء من قائمة تشغيل. في تقارير طلبات البحث، يتم تحديد نوع مصدر الزيارات هذا على أنّهPLAYLIST.
يُرجى العِلم أنّ مصدر الزيارات هذا يختلف عن نوع المصدر18، الذي يشير إلى أنّ المشاهدات نشأت من الصفحة التي تدرج جميع الفيديوهات في قائمة التشغيل.17الإشعارات
تمت إحالة المشاهدين من رسالة إلكترونية أو إشعار من YouTube. في تقارير طلبات البحث، يتم تحديد نوع مصدر الزيارات هذا على أنّهNOTIFICATION. القيم المحتملة هي:القيم inboxpushsdigالمشاهدات الناتجة من الإشعارات التي كانت جزءًا من ملخّص المشتركين uploaded_otherمشاهدات مصدرها إشعارات غير فورية، مثل الإشعارات عبر البريد الإلكتروني أو في البريد الوارد، التي يتم إرسالها إلى المشتركين عند تحميل فيديو uploaded_pushمشاهدات مصدرها الإشعارات الفورية المُرسَلة إلى المشتركين عند تحميل فيديو 18صفحات قوائم التشغيل
مشاهدات ناتجة من صفحة تعرض كل الفيديوهات في قائمة تشغيل. في تقارير طلبات البحث، يتم تحديد نوع مصدر الزيارات هذا على أنّهYT_PLAYLIST_PAGE.
يُرجى العِلم أنّ مصدر الزيارات هذا يختلف عن نوع المصدر14، ما يشير إلى أنّ المشاهدات حدثت أثناء تشغيل الفيديو كجزء من قائمة تشغيل.19المحتوى المبرمَج من محتوى تمّت المطالبة بملكيته
هي المشاهدات التي نشأت من فيديوهات حمّلها المستخدمون وتمّت المطالبة بملكيتها، واستخدمها مالك المحتوى للترويج للمحتوى الذي تمت مشاهدته. في تقارير طلبات البحث، يتم تحديد مصدر الزيارات هذا على أنّهCAMPAIGN_CARD. لا يتوفّر مصدر الزيارات هذا إلا في تقارير مالكي المحتوى.20شاشة نهاية الفيديو التفاعلية
المشاهدات التي مصدرها شاشة نهاية فيديو آخر في تقارير طلبات البحث، يتم تحديد نوع مصدر الزيارات هذا على أنّهEND_SCREEN.23القصص
تمت إحالة المشاهد من خلال التمرير عموديًا من الفيديو السابق في تجربة مشاهدة "القصص".24Shorts
تمت إحالة المشاهد من خلال التمرير عموديًا من الفيديو السابق في تجربة مشاهدة فيديوهات Shorts.25صفحات المنتجات
نقلت الفيديوهات على صفحة منتج المشاهدين إلى قناة أخرى.26صفحات الهاشتاغ
المشاهدات الناتجة من صفحات هاشتاغ الفيديوهات عند الطلب أو صفحات Shorts المحورية للهاشتاغ27صفحات الصوت
المشاهدات الواردة من صفحات الصوت في فيديوهات Shorts28الحدث المباشر التالي
المشاهدات الواردة من الأحداث المباشرة التالية29ملفات البودكاست:
المشاهدات التي مصدرها صفحة البودكاست على YouTube30الفيديو المُعاد مزجه
عدد المشاهدات التي تم تسجيلها من رابط فيديو مُعاد مزجه في مشغّل 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غير ذلك 2Windows 3Windows Mobile 4Android 5iOS 6Symbian 7Blackberry 9نظام التشغيل Macintosh 10Playstation 11Bada 12WebOS 13Linux 14Hiptop 15MeeGo 16نظام التشغيل Wii 17Xbox 18PlayStation Vita 19تلفزيون ذكي 20Nintendo 3DS 21Chromecast 22Tizen 23Firefox 24RealMedia 25KaiOS 26Roku 27Nintendo Switch 28Apple tvOS 29Fire OS 30ChromeOS 31Vidaa 32VegaOS
الخصائص الديمغرافية
تساعدك السمات الديمغرافية في فهم توزيع جمهورك حسب العمر والجنس. يتضمّن مركز مساعدة YouTube معلومات إضافية حول البيانات الديمغرافية في تقارير YouTube Analytics.
- age_group (سمة أساسية)
- تحدّد هذه السمة الفئة العمرية للمستخدِمين الذين سجّلوا الدخول والمرتبطين ببيانات التقرير. تستخدِم واجهة برمجة التطبيقات الفئات العمرية التالية:
AGE_13_17AGE_18_24AGE_25_34AGE_35_44AGE_45_54AGE_55_64AGE_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غير معروف 1Digg 4reddit 5StumbleUpon 6mixi 7Yahoo! اليابان 8goo 9Ameba 10Facebook 11Myspace 12NUjij 18Tuenti 20menéame 21Wykop 22Skyrock 25Fotka 28hi5 31Twitter 32Cyworld 34Blogger 36VKontakte (ВКонтакте) 37Rakuten (楽天市場) 38لايفجورنال 39Odnoklassniki (Одноклассники) 40tumblr 42Linkedin 43Google+ 44Weibo 45Pinterest 46البريد الإلكتروني 47Facebook Messenger 49WhatsApp 50Hangouts 51Gmail 52Kakao (Kakao Talk) 53غير ذلك 55نسخ إلى الحافظة 59تضمين 60رسالة نصيّة 61المراسلة على Android 62رسائل Verizon 63رسالة نصية من HTC 64محادثات Sony 65Go SMS 66LGE Email 67Line 68Viber 69Kik 70Skype 71Blackberry Messenger 72WeChat 73KAKAO Story 74Dropbox 75Telegram 76صفحات Facebook 77GroupMe 78بريد Android الإلكتروني 79تطبيق "المراسلة" من Motorola 80المشاركة عن قرب 81Naver 82مربّع حوار نشاط نظام التشغيل iOS 83Google Inbox 84Android Messenger 85YouTube Music 86YouTube لألعاب الفيديو 87YouTube Kids 88YouTube TV
يمكنك الاطّلاع على مستندات المساعدة لمزيد من المعلومات.
التعليقات التوضيحية
- annotation_type
- تحدّد هذه السمة الطريقة التي يتم بها عرض التعليق التوضيحي أثناء الفيديو. يسرد الجدول التالي قيم السمات المحتملة:
يقدّم مركز المساعدة في YouTube مزيدًا من التفاصيل حول الأنواع المختلفة من التعليقات التوضيحية بالإضافة إلى عملية إضافة تعليقات توضيحية إلى فيديوهاتك.القيم 0غير معروف 1ملاحظة 3قوائم التشغيل البارزة 4العنوان 8فقاعة تفسيرية كلامية 9التصنيف 10علامة مائية للعلامة التجارية 11فيديو مميّز 12قائمة تشغيل مميزة 30الحث على اتخاذ إجراء - annotation_id
- المعرّف الذي يستخدمه YouTube لتحديد تعليق توضيحي بشكلٍ فريد.
بيانات بطاقات الائتمان
- card_type
- تحدّد هذه السمة نوع البطاقة التي تم عرضها للمستخدِم. يسرد الجدول التالي قيم السمات المحتملة:
يقدّم مركز مساعدة YouTube المزيد من التفاصيل حول الأنواع المختلفة من البطاقات بالإضافة إلى عملية إضافة البطاقات إلى فيديوهاتك.القيم 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إعلانات الفيديو القابلة للتخطّي (مزاد الإعلانات) auctionTrueviewInstream2الإعلانات الصورية (مزاد الإعلانات) auctionDisplay3إعلانات الفيديو غير القابلة للتخطّي (مزاد الإعلانات) auctionInstream5الإعلانات الصورية (إعلانات محجوزة) reservedDisplay6إعلانات الفيديو غير القابلة للتخطّي (إعلانات محجوزة) reservedInstream13غير معروف unknown15إعلانات الفيديو القابلة للتخطّي (إعلانات محجوزة) reservedInstreamSelect19إعلانات الملصقات الصغيرة (مزاد) auctionBumperInstream20إعلانات الملصقات الصغيرة (محجوزة) reservedBumperInstreamملاحظة: قد تعرض تقارير طلبات البحث بعض أنواع الإعلانات الإضافية التي تم استخدامها سابقًا على YouTube.
سمات مالك المحتوى
لا تُستخدَم السمات التالية إلا في تقارير مالكي المحتوى.
- claimed_status (يُستخدم في تقارير مالكي المحتوى فقط)
- تشير هذه السمة إلى أنّ صف البيانات لا يحتوي إلا على مقاييس للمحتوى الذي تمّت المطالبة بملكيته. القيمة الصالحة الوحيدة لهذه السمة هي
claimed. يقدّم الجدول في تعريف السمةuploader_typeتفاصيل أكثر حول كيفية استخدام هذه السمة.
- uploader_type (سمة أساسية) (تُستخدَم فقط في تقارير مالك المحتوى)
- تشير هذه السمة إلى ما إذا كان صف البيانات يحتوي على مقاييس للمحتوى الذي حمّله مالك المحتوى المحدّد و/أو المحتوى الذي حمّلته جهات خارجية، مثل الفيديوهات التي حمّلها المستخدمون. القيم الصالحة هي
selfوthirdParty. هذه سمة أساسية وتخضع لسياسة الإيقاف النهائي.
يعرض الجدول أدناه المجموعات المتوافقة للسمتَينclaimed_statusوuploader_type:
قيمة claimed_statusقيمة uploader_typeالوصف [لم يتم الضبط] self يحتوي الصف على بيانات "إحصاءات YouTube" للمحتوى الذي حمّله مالك المحتوى وطالب بملكيته أو لم يطالب بملكيته. تمت المطالبة بملكيته self يحتوي الصف على بيانات المحتوى الذي تمّت المطالبة بملكيته والذي حمّله مالك المحتوى. تمت المطالبة بملكيته thirdParty يحتوي الصف على بيانات المحتوى الذي تمّت المطالبة بملكيته والذي حمّلته جهة خارجية.