Metrics

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

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

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

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

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

لمزيد من المعلومات، اطّلِع على قائمة واجهات برمجة تطبيقات 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.

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

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

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

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

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

مقاييس إلغاء العضوية

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_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
إجمالي الإيرادات المقدَّرة لكلّ ألف عملية تشغيل