Metrics

يحدّد هذا المستند المقاييس التي تستردها واجهة برمجة التطبيقات لإعداد التقارير في YouTube. تسترد واجهة برمجة التطبيقات هذه تقارير البيانات المجمّعة التي تتضمن بيانات "إحصاءات YouTube" لقناة أو مالك محتوى.

المقاييس عبارة عن مقاييس فردية لنشاط المستخدم أو أداء الإعلانات أو الأرباح المقدَّرة. وتشمل مقاييس نشاط المستخدم عناصر مثل عدد مشاهدات الفيديو والتقييمات (الإعجابات وغير المعجبين).

المقاييس الأساسية

على الرغم من أنّ واجهة برمجة التطبيقات YouTube Reporting API تخضع لسياسة الإيقاف النهائي المنصوص عليها في بنود الخدمة، لا تخضع المقاييس غير الأساسية (والسمات غير الأساسية) لهذه السياسة. وفي التعريفات الواردة في هذه الصفحة، يتم تحديد أي مقياس يُعتبر مقياسًا أساسيًا بشكل واضح على هذا النحو.

تحدِّد القائمة أدناه المقاييس الأساسية لواجهة برمجة التطبيقات. وأيّ من هذه المقاييس المستخدَمة أيضًا في YouTube Analytics API هو مقاييس أساسية في واجهة برمجة التطبيقات تلك.

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

عرض المقاييس

المشاهدات (المقياس الأساسي)
عدد مرات مشاهدة الفيديو يشير المقياس في تقرير قوائم التشغيل إلى عدد المرات التي تمّت فيها مشاهدة فيديو في سياق قائمة تشغيل. يقدّم مركز مساعدة 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.

مقاييس أوقات المشاهدة

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
نسبة النقر إلى الظهور للبطاقات، والتي يتم احتسابها من خلال نسبة النقرات على البطاقات إلى مرات ظهور البطاقات
card_teaser_impressions
عدد مرّات عرض الجملة المحفّزة على البطاقة. يمكن أن تؤدي مشاهدة الفيديو إلى ظهور إعلان تشويقي متعدد.
card_teaser_clicks
عدد النقرات على الجمل المحفّزة على البطاقة وتُنسب النقرات على رمز البطاقة إلى الجملة المحفّزة الأخيرة المعروضة للمستخدم.
card_teaser_click_rate
نسبة النقر إلى الظهور للجمل المحفّزة على البطاقة، ويتم احتسابها من خلال نسبة النقرات على الجمل المحفّزة على البطاقة بالنسبة إلى إجمالي عدد مرّات ظهور الجملة المحفّزة على البطاقة.

مقاييس شاشة النهاية

شاشات النهاية هي عناصر تظهر خلال الثواني الخمس إلى الـ 20 الأخيرة من الفيديو للترويج للمحتوى والقناة ومواقع الويب. يتضمّن مركز مساعدة YouTube تعليمات أكثر تفصيلاً حول إضافة شاشات النهاية إلى فيديوهاتك وتقرير شاشات النهاية في "إحصاءات YouTube".

ملاحظة: أصبحت بيانات مقاييس شاشة النهاية متوفّرة اعتبارًا من 1 أيار (مايو) 2016.

end_screen_element_impressions
عدد عناصر شاشة النهاية التي تم عرضها ويتم تسجيل مرّة ظهور واحدة لكل عنصر شاشة نهاية يتم عرضه.
end_screen_element_clicks
عدد مرات النقر على عناصر شاشة النهاية
end_screen_element_click_rate
نسبة النقر إلى الظهور لعناصر شاشة النهاية، والتي يتم احتسابها على أنّه نسبة النقرات على عناصر شاشة النهاية إلى مرّات ظهور عنصر شاشة النهاية

مقاييس الاحتفاظ بالجمهور

audience_retention_percentage
النسبة المطلقة للمستخدمين الذين يشاهدون الفيديو في نقطة معيّنة من الفيديو. ويتمّ احتساب هذه النسبة من خلال مقارنة عدد المرات التي تمّت فيها مشاهدة جزء من الفيديو بإجمالي عدد مشاهدات الفيديو. تحدّد السمة elapsed_video_time_percentage الجزء الذي يتوافق معه المقياس من الفيديو.

يُرجى العِلم أنّه يمكن أن تتم مشاهدة جزء من الفيديو أكثر من مرة (أو لا تتم مشاهدته على الإطلاق) في مشاهدة فيديو معيّنة. على سبيل المثال، إذا ترجيع المستخدمين وشاهدوا الجزء نفسه من الفيديو عدّة مرّات، قد تكون النسبة المطلقة لهذا الجزء من الفيديو أكبر من 1.

توضّح الأمثلة التالية كيفية احتساب القيمة:
  • تتم مشاهدة فيديو مدته دقيقة واحدة 100 مرة. يتوقف نصف المستخدمين عن المشاهدة بعد 15 ثانية، بينما يشاهد البقية الفيديو بالكامل. لا يشاهد أي من المستخدمين أي جزء من الفيديو أكثر من مرة. في هذه الحالة، تكون قيمة هذا المقياس 1 لمجموعات بيانات الوقت خلال الربع الأول من الفيديو، في حين تكون قيمتها 0.50 لبقية الفيديو.
  • تتم مشاهدة فيديو مدته دقيقة واحدة 100 مرة. يشاهد جميع المستخدمين الفيديو بالكامل، لكن 20 منهم يشاهدونه حتى علامة 45 ثانية من الفيديو، ثم ينتقلون مرة أخرى إلى علامة 30 ثانية من الفيديو، ثم يشاهدون الجزء المتبقي من الفيديو. في هذه الحالة، تكون قيمة المقياس 1 لمجموعات بيانات الوقت في النصف الأول أو الربع الأخير من الفيديو. في المقابل، قد تكون القيمة 1.2 لمجموعات بيانات الوقت في الربع الثالث من الفيديو لأنّ %100 من المستخدمين شاهدوا هذا الجزء من الفيديو في حين أنّ %20 من هؤلاء المستخدمين شاهدوا المقطع مرّتين.

مقاييس الأرباح المقدَّرة

ملاحظة: تخضع مقاييس الأرباح المقدّرة للتسويات في نهاية الشهر، وهي لا تشمل الإعلانات التي يبيعها الشركاء أو يعرضونها. يُرجى الانتقال إلى مركز مساعدة YouTube للحصول على المزيد من المعلومات والملاحظات حول الأرقام المقدّرة للأرباح.

تعرض واجهة برمجة التطبيقات YouTube Reporting API جميع الأرقام المقدّرة للأرباح والأرباح بالدولار الأمريكي.
estimated_partner_revenue (المقياس الأساسي)
إجمالي صافي الأرباح المقدَّرة من جميع مصادر Google الإعلانية المُباعة، ومن المصادر غير الإعلانية للنطاق الزمني والمنطقة اللذين تم اختيارهما.
estimated_partner_ad_revenue
إجمالي صافي الأرباح المقدَّرة من جميع مصادر Google الإعلانية التي تبيعها Google للنطاق الزمني والمنطقة اللذين تم اختيارهما.

تخضع مقاييس الأرباح المقدّرة لتسوية في نهاية الشهر، ولا تشمل الإعلانات التي يبيعها الشركاء أو عرضها.
estimated_partner_ad_auction_revenue (متوفّر في واجهة برمجة التطبيقات لإعداد التقارير YouTube فقط)
إجمالي الأرباح المقدَّرة (صافي الأرباح) من الإعلانات التي تم بيعها في المزاد عبر AdSense للنطاق الزمني والمنطقة اللذين تم اختيارهما. كان يُطلق على هذا المقياس اسم "estimated_partner_ad_sense_revenue" في السابق.
estimated_partner_ad_sense_revenue (متوفّر في واجهة برمجة التطبيقات لإعداد التقارير YouTube فقط)
إجمالي الأرباح المقدّرة (صافي الأرباح) من إعلانات AdSense التي تم بيعها في المزاد للنطاق الزمني والمنطقة اللذَين تم اختيارهما.
estimated_partner_ad_reserved_revenue (متوفّر في واجهة برمجة التطبيقات لإعداد تقارير YouTube فقط)
إجمالي الأرباح المقدّرة (صافي الأرباح) من الإعلانات المحجوزة والتي تم بيعها عبر DoubleClick (DCLK) ومصادر أخرى تبيع إعلاناتها على YouTube. كان يُطلق على هذا المقياس اسم "estimated_partner_double_click_revenue" في السابق.
estimated_partner_double_click_revenue (متوفّر في واجهة برمجة التطبيقات لإعداد التقارير في YouTube فقط)
إجمالي الأرباح المقدّرة (صافي الأرباح) من الإعلانات المحجوزة والمباعة عبر DoubleClick (DCLK) وغيرها من مصادر YouTube المباعة.
estimated_partner_red_revenue (متوفّرة في YouTube Reporting API فقط)
إجمالي الأرباح المقدَّرة (صافي الأرباح) من اشتراكات YouTube Premium (المعروفة سابقًا باسم YouTube Red)
estimated_partner_transaction_revenue (متوفّر في واجهة برمجة التطبيقات لإعداد التقارير في YouTube فقط)
إجمالي الأرباح المقدّرة الناتجة من المعاملات، مثل المحتوى المدفوع والتمويل من المعجبين، مطروحًا منه أي عمليات ردّ أموال يحصّلها الشركاء.

مقاييس أداء الإعلان

estimated_youtube_ad_revenue
إجمالي الأرباح المقدَّرة بالدولار الأمريكي، من جميع الإعلانات التي باعها شركاء Google أو تلك التي باعها شركاء DoubleClick للنطاق الزمني والمنطقة اللذين تم اختيارهما يخضع إجمالي الأرباح لتسوية في نهاية الشهر، ولا يشمل الإعلانات التي يعرضها الشركاء. ويجب عدم الخلط بين إجمالي الأرباح والأرباح المقدَّرة أو صافي الأرباح التي تؤثّر في حصتك في الملكية واتفاقيات مشاركة الأرباح.
estimated_cpm
إجمالي الأرباح المقدَّرة لكلّ ألف ظهور للإعلان
ad_impressions
عدد مرات ظهور الإعلان التي تم التحقق منها
estimated_monetized_playbacks
عدد المرات التي شغّل فيها المشاهد الفيديو الخاص بك وظهرت فيه مرة ظهور واحدة على الأقل للإعلان يتم احتساب عملية تشغيل تحقّق الربح إذا تم عرض إعلان ما قبل التشغيل على المستخدم ثم توقف عن مشاهدة الإعلان قبل بدء الفيديو. الخطأ المقدَّر المتوقع لهذا الرقم هو ±2.0%.
estimated_playback_based_cpm
إجمالي الأرباح المقدَّرة لكلّ ألف عملية تشغيل