يحدّد هذا المستند المقاييس التي تستردّها واجهة YouTube Reporting API. تستردّ واجهة برمجة التطبيقات هذه تقارير بيانات مجمّعة تتضمّن بيانات "إحصاءات YouTube" لقناة أو مالك محتوى.
المقاييس هي قياسات فردية لنشاط المستخدم أو أداء الإعلان أو الإيرادات المقدَّرة. تشمل مقاييس نشاط المستخدمين عدد مشاهدات الفيديو والتقييمات (المعجبين وغير المعجبين).
المقاييس الأساسية
على الرغم من أنّ YouTube Reporting API تخضع لسياسة الإيقاف النهائي المحدّدة في بنود الخدمة، لا تخضع المقاييس غير الأساسية (والسمات غير الأساسية) لهذه السياسة. في التعريفات الواردة في هذه الصفحة، يتم تحديد أي مقياس أساسي بشكل صريح على هذا النحو.
تحدّد القائمة أدناه المقاييس الأساسية لواجهة برمجة التطبيقات. وأي من هذه المقاييس التي يتم استخدامها أيضًا في YouTube Analytics API هي أيضًا مقاييس أساسية في واجهة برمجة التطبيقات هذه.
annotation_click_through_rateannotation_close_rateaverage_view_duration_secondscommentsdislikesengaged_viewsestimated_partner_revenuelikessharessubscribers_gainedsubscribers_lostviews_percentageviewswatch_time_minutes
لمزيد من المعلومات، يمكنك الاطّلاع على قائمة واجهات برمجة تطبيقات YouTube التي تخضع لسياسة الإيقاف النهائي.
عرض المقاييس
- engaged_views (مقياس أساسي)
- عدد المرات التي تمت فيها مشاهدة فيديوهات القناة بعد الإطار الأول، أو عدد المرات التي نقر فيها المستخدم لتشغيل الفيديو
- المشاهدات (مقياس أساسي)
- عدد مرات مشاهدة الفيديو في تقرير قائمة التشغيل، يشير المقياس إلى عدد مرات مشاهدة الفيديو في سياق قائمة تشغيل. يتضمّن هذا المقياس المشاهدات الجماعية عندما يشاهد عدة أشخاص المحتوى معًا على شاشة تلفزيون.
يوفّر
مركز مساعدة YouTube
معلومات إضافية حول كيفية تسجيل المشاهدات.
This is a core metric and is subject to the Deprecation Policy.
- red_views
- عدد المرّات التي شاهد فيها المشتركون في YouTube Premium (المعروف سابقًا باسم YouTube Red) فيديو معيّنًا
- views_percentage (مقياس أساسي)
- النسبة المئوية للمشاهدين الذين سجّلوا الدخول عند مشاهدة الفيديو أو قائمة التشغيل This is a core metric and is subject to the Deprecation Policy.
مقاييس مدى الوصول إلى الجمهور
- video_thumbnail_impressions
- عدد مرّات ظهور الصور المصغّرة للفيديوهات أمام المشاهدين يتم احتساب مرّات الظهور إذا تم عرض الصورة المصغّرة لأكثر من ثانية وظهر نصفها على الأقلّ على الشاشة. لمزيد من المعلومات، يُرجى الانتقال إلى مركز مساعدة YouTube.
- video_thumbnail_impressions_ctr
- النسبة المئوية لمرّات الظهور التي أدّت إلى نقرة لمشاهدة الفيديو ويتم احتسابها من خلال قسمة عدد النقرات على عدد مرّات الظهور.
مقاييس أوقات المشاهدة
- watch_time_minutes (مقياس أساسي)
- عدد الدقائق التي شاهد فيها المستخدمون فيديوهات القناة أو مالك المحتوى أو الفيديو أو قائمة التشغيل المحدّدة. يتضمّن هذا المقياس المشاهدات الجماعية عندما يشاهد عدة أشخاص المحتوى معًا على شاشة تلفزيون. This is a core metric and is subject to the Deprecation Policy.
- red_watch_time_minutes
- عدد الدقائق التي شاهد فيها المشتركون في YouTube Premium (المعروف سابقًا باسم YouTube Red) فيديو معيّنًا
- average_view_duration_seconds (مقياس أساسي)
- متوسط مدة تشغيل الفيديوهات بالثواني اعتبارًا من 13 ديسمبر 2021، يستبعد هذا المقياس الزيارات من المقاطع المتكررة. في تقرير قائمة التشغيل، يشير المقياس إلى متوسّط مدة تشغيل الفيديوهات بالثواني في سياق قائمة تشغيل. This is a core metric and is subject to the Deprecation Policy.
- average_view_duration_percentage
- متوسّط النسبة المئوية لمقدار ما تمّت مشاهدته من الفيديو أثناء تشغيله اعتبارًا من 13 ديسمبر 2021، يستبعد هذا المقياس الزيارات من المقاطع المتكررة.
مقاييس التفاعل
- التعليقات (مقياس أساسي)
- عدد المرّات التي علّق فيها المستخدمون على فيديو لمزيد من المعلومات، يُرجى الانتقال إلى مركز مساعدة YouTube. This is a core metric and is subject to the Deprecation Policy.
- المعجبون (مقياس أساسي)
- عدد المرات التي أبدى فيها المستخدمون إعجابهم بفيديو من خلال تقييمه إيجابيًا This is a core metric and is subject to the Deprecation Policy.
- عدد علامات عدم الإعجاب (مقياس أساسي)
- عدد المرات التي أبدى فيها المستخدمون عدم إعجابهم بفيديو من خلال تقييمه سلبيًا This is a core metric and is subject to the Deprecation Policy.
- عدد المرّات التي شارك فيها المستخدمون فيديو عبر الزر
Shareلمزيد من المعلومات، يُرجى الانتقال إلى مركز مساعدة YouTube. This is a core metric and is subject to the Deprecation Policy. - subscribers_gained (مقياس أساسي)
- عدد المرات التي اشترك فيها المستخدمون في قناة This is a core metric and is subject to the Deprecation Policy.
يمكن أن تكتسب القنوات مشتركين أو تفقدهم في أماكن متعددة، بما في ذلك صفحة مشاهدة الفيديو وصفحة القناة والدليل الذي يظهر على صفحة YouTube الرئيسية. لتحديد عدد المشتركين الجدد في القناة الذين لم يشتركوا من خلال صفحة مشاهدة فيديو، يحتوي تقرير نشاط المستخدم الأساسي على صف لا يحدّد قيمة سمة video_id. يحدّد هذا الصف أيضًا قيمة للمقياسsubscribersLost، ولكنّه لا يحدّد قيمًا للمقاييس الأخرى. - subscribers_lost (مقياس أساسي)
- عدد المرات التي ألغى فيها المستخدمون اشتراكهم في قناة This is a core metric and is subject to the Deprecation Policy.
يتم تسجيل بيانات هذا المقياس بطريقة مشابهة لمقياسsubscribers_gained. لتحديد عدد المستخدمين الذين ألغوا اشتراكهم ولكن ليس من صفحة مشاهدة فيديو، يحتوي تقرير نشاط المستخدم الأساسي على صف لا يحدّد قيمة سمة video_id. يحدّد هذا الصف أيضًا قيمة للمقياسsubscribers_gained، ولكنّه لا يحدّد قيمًا للمقاييس الأخرى. - videos_added_to_playlists
- عدد المرات التي تمت فيها إضافة الفيديوهات إلى أي قوائم تشغيل على YouTube وقد تكون الفيديوهات قد أُضيفت إلى قائمة تشغيل مالك الفيديو أو إلى قوائم تشغيل قنوات أخرى.
وتشمل قيمة المقياس عدد المرات التي تمت فيها إضافة الفيديوهات إلى قوائم التشغيل التلقائية، مثل قائمة التشغيل "المشاهدة لاحقًا". ومع ذلك، لا يتم احتساب قوائم التشغيل التي يُضاف إليها فيديو تلقائيًا، مثل قائمة تشغيل الفيديوهات المحمّلة في قناة أو سجلّ المشاهدة الخاص بمستخدم.
يعرض هذا المقياس رقمًا مطلقًا، ما يعني أنّه إذا أضاف مستخدم فيديو إلى قائمة تشغيل ثم أزاله ثم أضافه مرة أخرى، ستعكس قيمة المقياس إضافة الفيديو إلى قائمة تشغيل مرّتين. لا تتوفّر بيانات هذا المقياس للتواريخ التي تسبق 1 أكتوبر 2014. - videos_removed_from_playlists
- عدد المرّات التي تمت فيها إزالة الفيديوهات من أي قوائم تشغيل على YouTube وقد تكون الفيديوهات قد أُزيلت من قائمة تشغيل مالك الفيديو أو من قوائم تشغيل قنوات أخرى.
تشمل قيمة المقياس عدد المرات التي أُزيلت فيها الفيديوهات من قوائم التشغيل التلقائية، مثل قائمة التشغيل "المشاهدة لاحقًا".
يعرض هذا المقياس عددًا مطلقًا، ما يعني أنّه إذا أضاف مستخدم فيديو إلى قائمة تشغيل وأزاله ثم أضافه مجددًا وأزاله مجددًا، تعكس قيمة المقياس إزالة الفيديو من قائمة تشغيل مرّتين. لا تتوفّر بيانات هذا المقياس للتواريخ التي تسبق 1 أكتوبر 2014.
مقاييس قوائم التشغيل
تحتوي تقارير قوائم التشغيل على نوعَين من المقاييس التي توضّح كيفية تفاعل المشاهدين مع الفيديوهات في قائمة تشغيل:
-
مقاييس الفيديوهات المجمّعة توفّر مقاييس نشاط المستخدمين ومرّات الظهور التي يتم تجميعها لكل الفيديوهات في قائمة التشغيل والتي تملكها أيضًا القناة التي تملك قائمة التشغيل. لا يتم احتساب مقاييس الفيديوهات التي تملكها قنوات أخرى في عملية التجميع. نتيجةً لذلك، إذا أنشأت قناة قائمة تشغيل تحتوي فقط على فيديوهات تملكها قنوات أخرى، لن توفّر التقارير الخاصة بقوائم التشغيل هذه قيمًا لهذه المقاييس.
يُرجى الرجوع إلى قسمَي مقاييس المشاهدات ومقاييس وقت المشاهدة في هذا المستند للاطّلاع على تعريفات مقاييس الفيديوهات المجمّعة المتوافقة.
-
تعكس مقاييس قائمة التشغيل نشاط المستخدمين وتفاعلهم في سياق صفحة قائمة التشغيل. وتشمل هذه المقاييس عدد المشاهدات لجميع الفيديوهات في قائمة التشغيل، بغض النظر عن القناة التي تملكها، ولكنّها تحتسب فقط المشاهدات التي حدثت في سياق قائمة التشغيل.
معظم المقاييس التالية هي مقاييس داخل قائمة التشغيل، أمّا المقاييس المتبقية في القائمة، مثل المقياس playlistSaves، فهي تتعلّق بتفاعلات المستخدمين مع قائمة التشغيل نفسها وليس مع الفيديوهات في قائمة التشغيل. وبالتالي، لن يتم تصنيف هذه المقاييس على أنّها مقاييس مجمّعة للفيديوهات أو مقاييس ضمن قائمة التشغيل.
- playlist_starts
- عدد المرات التي بدأ فيها المشاهدون تشغيل قائمة تشغيل يُرجى العِلم أنّ هذا المقياس
يتضمّن فقط مشاهدات قوائم التشغيل التي تمّت على الويب.
- playlist_saves_added (متاح فقط في YouTube Reporting API)
- عدد المرّات التي حفظ فيها المستخدمون قائمة تشغيل لمزيد من المعلومات حول قوائم التشغيل المحفوظة، يُرجى الانتقال إلى مركز مساعدة YouTube. يعرض هذا المقياس رقمًا مطلقًا، أي إذا حفظ مستخدم قائمة تشغيل وأزالها من قائمة قوائم التشغيل المحفوظة ثم حفظها مرة أخرى، ستعكس قيمة المقياس إضافة عمليتَي حفظ لقائمة التشغيل.
- playlist_saves_removed (متاح فقط في YouTube Reporting API)
- عدد المرات التي أزال فيها المستخدمون قائمة التشغيل من قوائم التشغيل المحفوظة لديهم يعرض هذا المقياس رقمًا مطلقًا، أي إذا حفظ مستخدم قائمة تشغيل ثم أزالها من قائمة قوائم التشغيل المحفوظة، ثم حفظها مرة أخرى وأزالها مرة أخرى، ستعكس قيمة المقياس إزالة قائمتَي تشغيل محفوظتَين.
مقاييس التعليقات التوضيحية
- annotation_impressions
- إجمالي عدد مرّات ظهور التعليقات التوضيحية
- annotation_clickable_impressions
- عدد التعليقات التوضيحية التي ظهرت وكان من الممكن النقر عليها
- annotation_clicks
- عدد التعليقات التوضيحية التي تم النقر عليها
- annotation_click_through_rate (مقياس أساسي)
- نسبة التعليقات التوضيحية التي نقر عليها المشاهدون إلى إجمالي عدد مرات ظهور التعليقات التوضيحية القابلة للنقر This is a core metric and is subject to the Deprecation Policy. يتضمّن "مركز مساعدة YouTube" المزيد من المعلومات حول إنشاء التعليقات التوضيحية واستخدام التعليقات التوضيحية للروابط.
- annotation_closable_impressions
- عدد التعليقات التوضيحية التي ظهرت وكان من الممكن إغلاقها
- annotation_closes
- عدد التعليقات التوضيحية المغلقة
- annotation_close_rate (مقياس أساسي)
- نسبة التعليقات التوضيحية التي أغلقها المشاهدون إلى إجمالي عدد مرات ظهور التعليقات التوضيحية This is a core metric and is subject to the Deprecation Policy.
مقاييس البطاقات
يحتوي "مركز مساعدة YouTube" على تعليمات أكثر تفصيلاً حول إضافة البطاقات إلى فيديوهاتك وتقرير البطاقات في "إحصاءات YouTube".
- card_impressions
- عدد مرات عرض البطاقات عند فتح لوحة البطاقات، يتم تسجيل مرّة ظهور لكل بطاقة من بطاقات الفيديو.
- card_clicks
- عدد المرات التي تم فيها النقر على البطاقات
- card_click_rate
- نسبة النقر إلى الظهور للبطاقات، ويتم احتسابها على أنّها نسبة النقرات على البطاقات إلى مرّات ظهور البطاقات.
- عدد مرّات عرض الجمل المحفّزة على البطاقات ويمكن أن تؤدي مشاهدة فيديو واحدة إلى ظهور جملة محفّزة عدة مرات.
- عدد النقرات على الجمل المحفّزة على البطاقات وتُنسب النقرات على رمز البطاقة إلى الجملة المحفّزة الأخيرة التي تظهر للمستخدم.
- نسبة النقر إلى الظهور للجمل المحفّزة على البطاقات، ويتم احتسابها من خلال قسمة عدد النقرات على الجمل المحفّزة على البطاقات على إجمالي عدد مرات ظهورها.
مقاييس شاشة النهاية
شاشات النهاية هي عناصر تظهر خلال آخر 5 إلى 20 ثانية من الفيديو للترويج للمحتوى والقناة والمواقع الإلكترونية. يحتوي "مركز مساعدة YouTube" على تعليمات أكثر تفصيلاً حول إضافة شاشات النهاية إلى فيديوهاتك وتقرير شاشات النهاية في "إحصاءات YouTube".
- end_screen_element_impressions
- عدد عناصر شاشة النهاية التي تم عرضها يتم تسجيل مرّة ظهور واحدة لكل عنصر شاشة نهاية يتم عرضه.
- end_screen_element_clicks
- عدد المرّات التي تم فيها النقر على عناصر شاشة النهاية
- end_screen_element_click_rate
- نسبة النقر إلى الظهور لعناصر شاشة النهاية، ويتم احتسابها من خلال قسمة عدد النقرات على عناصر شاشة النهاية على عدد مرّات ظهور عناصر شاشة النهاية.
مقاييس إلغاء العضويات
- membershipsCancellationSurveyResponses
- عدد الاستطلاعات التي أكملها مستخدمو YouTube الذين ألغوا عضويتهم في القناة المحدّدة خلال الفترة المشمولة بالتقارير.
مقاييس الإيرادات المقدَّرة
ملاحظة: تخضع مقاييس الإيرادات المقدَّرة لتسويات في نهاية الشهر، وهي لا تشمل الإعلانات التي يبيعها الشركاء أو يعرضونها. يمكنك الانتقال إلى مركز مساعدة YouTube للحصول على معلومات وملاحظات إضافية حول أرقام الإيرادات المقدَّرة.
- estimated_partner_revenue (مقياس أساسي)
- إجمالي صافي الإيرادات المقدَّرة من كل مصادر الإعلانات التي تبيعها Google ومن المصادر غير الإعلانية للنطاق الزمني والمنطقة المحدّدَين
- estimated_partner_ad_revenue
- إجمالي صافي الإيرادات المقدَّرة من كلّ مصادر الإعلانات التي باعتها Google في النطاق الزمني والمنطقة المحدّدَين.
تخضع مقاييس الإيرادات المقدَّرة للتسوية في نهاية كل شهر، ولا تشمل الإعلانات التي يبيعها أو يعرضها الشركاء. - estimated_partner_ad_auction_revenue (متاح فقط في YouTube Reporting API)
- إجمالي الأرباح المقدّرة (صافي الإيرادات) من الإعلانات المباعة في المزاد عبر AdSense في النطاق الزمني والمنطقة المحدّدَين كان هذا المقياس يُعرف سابقًا باسم
estimated_partner_ad_sense_revenue. - estimated_partner_ad_reserved_revenue (تتوفّر فقط في YouTube Reporting API)
- إجمالي الأرباح المقدّرة (صافي الإيرادات) من الإعلانات المحجوزة والمباعة عبر DoubleClick (DCLK) وغيره من مصادر YouTube المبيعة. كان هذا المقياس يُعرف سابقًا باسم
estimated_partner_double_click_revenue. - estimated_partner_red_revenue (متاحة فقط في YouTube Reporting API)
- إجمالي الأرباح المقدَّرة (صافي الإيرادات) من اشتراكات YouTube Premium (المعروف سابقًا باسم YouTube Red)
- estimated_partner_transaction_revenue (متاح فقط في YouTube Reporting API)
- إجمالي الإيرادات المقدَّرة من المعاملات، مثل المحتوى المدفوع والتمويل من المعجبين، مع خصم الأموال المستردة المفروضة على الشركاء.
مقاييس أداء الإعلانات
- estimated_youtube_ad_revenue
- إجمالي الإيرادات المقدَّرة بالدولار الأمريكي من كلّ الإعلانات التي باعتها Google أو شركاء DoubleClick في النطاق الزمني والمنطقة المحدّدَين يخضع إجمالي الإيرادات لتسوية في نهاية الشهر، وهو لا يشمل الإعلانات التي يعرضها الشركاء. يجب عدم الخلط بين إجمالي الإيرادات والإيرادات المقدَّرة أو صافي الإيرادات، والتي تأخذ في الاعتبار حصتك من الملكية واتفاقيات مشاركة الإيرادات.
- estimated_cpm
- إجمالي الإيرادات المقدَّرة لكل ألف ظهور للإعلان
- ad_impressions
- عدد مرّات ظهور الإعلانات التي تم التحقّق منها.
- estimated_monetized_playbacks
- عدد المرات التي شغّل فيها المشاهد الفيديو الخاص بك وظهر له مرة ظهور إعلان واحدة على الأقل. يتم احتساب عملية تشغيل تحقّق الربح إذا ظهر إعلان ما قبل التشغيل للمشاهد ولكنه توقّف عن مشاهدة الإعلان قبل بدء الفيديو. الخطأ المقدَّر المتوقَّع لهذا الرقم هو ±2.0%.
- estimated_playback_based_cpm
- إجمالي الإيرادات المقدَّرة لكل ألف عملية تشغيل