Metrics

يحدِّد هذا المستند المقاييس التي تسترجعها YouTube Reporting API. تستردّ واجهة برمجة التطبيقات هذه تقارير البيانات المجمّعة التي تتضمّن بيانات "إحصاءات 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% من هؤلاء المشاهدين شاهدوا المقطع مرّتين.

مقاييس إلغاء الاشتراكات

membershipsCancellationSurveyResponses
عدد الاستطلاعات التي أكملها مستخدمو YouTube الذين ألغوا اشتراكهم الداعم في قناة معيّنة خلال الفترة المشمولة بالتقرير

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

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

تعرض واجهة YouTube Reporting API جميع أرقام الأرباح المُقدّرة بالدولار الأمريكي.
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_sense_revenue (متاحة فقط في YouTube Reporting API)
إجمالي الأرباح المقدَّرة (صافي الأرباح) من إعلانات AdSense التي يتم بيعها من خلال مزاد الإعلانات في النطاق الزمني والمنطقة المحدّدَين.
estimated_partner_ad_reserved_revenue (متاحة فقط في YouTube Reporting API)
إجمالي الأرباح المقدّرة (صافي الإيرادات) من الإعلانات المحجوزة والمباعة من خلال DoubleClick‏ (DCLK) وغيرها من المصادر التي تبيع إعلاناتها على YouTube. كان اسم هذا المقياس في السابق estimated_partner_double_click_revenue.
estimated_partner_double_click_revenue (متاحة في YouTube Reporting API فقط)
إجمالي الأرباح المقدَّرة (الأرباح الصافية) من الإعلانات المُباعة المحجوزة من خلال DoubleClick (DCLK) وغيرها من المصادر المُباعة في YouTube.
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
إجمالي الأرباح المقدَّرة لكلّ ألف عملية تشغيل