تحدّد هذه المقالة المقاييس التي تستردّها واجهة برمجة التطبيقات لإعداد التقارير في YouTube. تستردّ واجهة برمجة التطبيقات هذه تقارير البيانات المجمّعة التي تتضمّن بيانات "إحصاءات YouTube" لقناة أو مالك محتوى.
المقاييس هي قياسات فردية لنشاط المستخدم أو أداء الإعلان أو الإيرادات المقدَّرة. تشمل مقاييس نشاط المستخدم بيانات مثل عدد مشاهدات الفيديو وتقييماته (إبداءات الإعجاب وعدم الإعجاب).
المقاييس الأساسية
في حين أنّ واجهة برمجة التطبيقات لإعداد التقارير في YouTube تخضع لسياسة الإيقاف المحدّدة في بنود الخدمة، لا تخضع المقاييس غير الأساسية (والسمات غير الأساسية) لهذه السياسة. في التعريفات الواردة في هذه الصفحة، يتم تحديد أي مقياس أساسي بشكل صريح على أنّه كذلك.
تعرض القائمة أدناه المقاييس الأساسية لواجهة برمجة التطبيقات. أيّ من هذه المقاييس التي تُستخدم أيضًا في واجهة برمجة تطبيقات إحصاءات YouTube هي أيضًا مقاييس أساسية في واجهة برمجة التطبيقات هذه.
annotation_click_through_rateannotation_close_rateaverage_view_duration_secondscommentsdislikesengaged_viewsestimated_partner_revenuelikessharessubscribers_gainedsubscribers_lostviews_percentageviewswatch_time_minutes
يمكنك الاطّلاع على قائمة واجهات برمجة تطبيقات YouTube الخاضعة لسياسة الإيقاف لمزيد من المعلومات.
عرض المقاييس
- engaged_views (مقياس أساسي)
- عدد المرّات التي تمت فيها مشاهدة فيديوهات القناة بعد الإطار الأول، أو نقر فيها المستخدم أو ضغط على زر التشغيل
- 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، يستبعد هذا المقياس الزيارات الناتجة من المقاطع المتكرّرة .
مقاييس التفاعل
- comments (مقياس أساسي)
- عدد المرّات التي علّق فيها المستخدمون على فيديو لمزيد من المعلومات، يُرجى زيارة مركز مساعدة YouTube. This is a core metric and is subject to the Deprecation Policy.
- likes (مقياس أساسي)
- عدد المرّات التي أبدى فيها المستخدمون إعجابهم بفيديو من خلال تقييمه إيجابيًا This is a core metric and is subject to the Deprecation Policy.
- dislikes (مقياس أساسي)
- عدد المرّات التي أبدى فيها المستخدمون عدم إعجابهم بفيديو من خلال تقييمه سلبيًا 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)
- عدد المرّات التي حفظ فيها المستخدمون قائمة تشغيل يُرجى زيارة مركز مساعدة YouTube لمزيد من المعلومات عن قوائم التشغيل المحفوظة. يعرض هذا المقياس عددًا مطلقًا، ما يعني أنّه إذا حفظ مستخدم قائمة تشغيل ثم أزالها من قائمة قوائم التشغيل المحفوظة ثم حفظها مرة أخرى، ستعرض قيمة المقياس أنّه تمت إضافة عمليتَي حفظ لقائمة التشغيل.
- playlist_saves_removed (متاحة فقط في واجهة برمجة التطبيقات لإعداد التقارير في YouTube)
- عدد المرّات التي أزال فيها المستخدمون قائمة التشغيل من قوائم التشغيل المحفوظة يعرض هذا المقياس عددًا مطلقًا، ما يعني أنّه إذا حفظ مستخدم قائمة تشغيل ثم أزالها من قائمة قوائم التشغيل المحفوظة ثم حفظها مرة أخرى ثم أزالها مرة أخرى، ستعرض قيمة المقياس أنّه تمت إزالة عمليتَي حفظ لقائمة التشغيل.
مقاييس التعليقات التوضيحية
- 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)
- إجمالي الأرباح المقدَّرة (صافي الإيرادات) من الإعلانات المباعة في المزاد من خلال AdSense للنطاق الزمني والمنطقة المحددين كان اسم هذا المقياس سابقًا
estimated_partner_ad_sense_revenue. - estimated_partner_ad_reserved_revenue (متاحة فقط في واجهة برمجة التطبيقات لإعداد التقارير في YouTube)
- إجمالي الأرباح المقدَّرة (صافي الإيرادات) من الإعلانات المحجوزة والمباعة من خلال DoubleClick (DCLK) وغيره من مصادر YouTube المبيعة كان اسم هذا المقياس سابقًا
estimated_partner_double_click_revenue. - estimated_partner_red_revenue (متاحة فقط في واجهة برمجة التطبيقات لإعداد التقارير في YouTube)
- إجمالي الأرباح المقدَّرة (صافي الإيرادات) من الاشتراكات في 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
- إجمالي الإيرادات المقدَّرة لكل ألف عملية تشغيل