YouTube Analytics API: Channel Reports

تعرض هذه الصفحة التقارير التي يمكن لمالكي القنوات استردادها باستخدام YouTube Analytics API. تقدّم تقارير القناة مقاييس نشاط المستخدم لقناة محدّدة وتقيس بيانات مثل عدد مشاهدات الفيديو والتقييمات وعدد المشتركين.

  • توفّر تقارير الفيديو إحصاءات عن جميع أنشطة المستخدمين المرتبطة بفيديوهات القناة.
  • تقدّم تقارير قوائم التشغيل إحصاءات تتعلّق تحديدًا بمشاهدات الفيديوهات التي تحدث في سياق قائمة تشغيل.
  • تحتوي تقارير أداء الإعلانات على مقاييس مرتبطة بالإيرادات وأداء الإعلانات. تستخدِم هذه التقارير السمة adType لتجميع المقاييس استنادًا إلى أنواع الإعلانات التي تم عرضها أثناء تشغيل الفيديوهات. يوضّح قسم تقارير أداء الإعلانات نوعَي مقاييس أداء الإعلانات التي تتيحها واجهة برمجة التطبيقات.

استرداد تقرير

لاسترداد تقرير قناة، يجب ضبط قيمة المَعلمة ids في طلب البيانات من واجهة برمجة التطبيقات على إحدى القيم التالية:

  • channel==MINE – تعرض واجهة برمجة التطبيقات بيانات قناة على YouTube الخاصة بالمستخدم الذي تمّت مصادقته.

  • channel==CHANNEL_ID: اضبط CHANNEL_ID على معرّف القناة الفريد للقناة التي تريد استرداد البيانات منها. يجب أن يكون المستخدم الذي يوافق على الطلب هو مالك القناة.

    معرّف القناة هو حاليًا سلسلة تبدأ بالحرفين UC، ولكن قد يتغيّر تنسيقه. (يمكنك العثور على معرّف قناتك في صفحة إعدادات الحساب المتقدّمة لقناتك على YouTube، أو يمكنك استرداد معرّف قناتك آليًا باستخدام طريقة YouTube Data API's channels.list).

التفويض

يجب أن يتم السماح بإرسال جميع طلبات البيانات من YouTube Analytics API. يوضّح دليل التفويض كيفية استخدام بروتوكول OAuth 2.0 لاسترداد رموز التفويض المميزة.

تستخدم طلبات البيانات من YouTube Analytics API نطاقات الأذونات التالية:

المستويات
https://www.googleapis.com/auth/yt-analytics.readonly عرض تقارير "إحصاءات YouTube" للمحتوى في YouTube يوفّر هذا النطاق إمكانية الوصول إلى مقاييس نشاط المستخدمين، مثل عدد المشاهدات وعدد التقييمات.
https://www.googleapis.com/auth/yt-analytics-monetary.readonly عرض تقارير "إحصاءات YouTube" المالية للمحتوى في YouTube يتيح هذا النطاق الوصول إلى مقاييس نشاط المستخدمين وإلى مقاييس الأرباح المقدّرة وأداء الإعلانات.
https://www.googleapis.com/auth/youtube إدارة حسابك على YouTube في YouTube Analytics API، يستخدم مالكو القنوات هذا النطاق لإدارة مجموعات "إحصاءات YouTube" وعناصر المجموعات.
https://www.googleapis.com/auth/youtubepartner عرض وإدارة أصول YouTube والمحتوى المرتبط بها على YouTube في YouTube Analytics API، يستخدم مالكو المحتوى هذا النطاق لإدارة مجموعات "إحصاءات YouTube" وعناصر المجموعات.

ملاحظة: تتوفّر مقاييس الأرباح المقدَّرة وأداء الإعلان في تقارير القنوات. للوصول إلى هذه المقاييس، يجب أن يكون طلبك مصرحًا له باستخدام نطاق https://www.googleapis.com/auth/yt-analytics-monetary.readonly. بالإضافة إلى ذلك، يجب أن تكون قناة المستخدم الذي تمّت المصادقة عليه مشارِكة في "برنامج شركاء YouTube". سيؤدي طلب مقاييس مالية لقناة غير مشتركة في "برنامج شركاء YouTube" إلى ظهور الخطأ 403 Forbidden.

في جداول التقارير في هذه الصفحة، المقاييس التي تحمل علامة النجمة (*) هي مقاييس مالية تتطلّب هذا النطاق وحالة تحقيق الربح.

الفلاتر

تحدّد الجداول التي تشرح التقارير المتوافقة الفلاتر التي يمكن استخدامها لكل تقرير. في الجداول، تكون الفلاتر المعروضة بين قوسين اختيارية. على سبيل المثال، بالنسبة إلى خيار الفلترة video(,country)، يجب استخدام فلتر الفيديو، بينما يكون فلتر البلد اختياريًا.

تتيح واجهة برمجة التطبيقات أيضًا إمكانية تحديد قيم متعدّدة للفلترَين video وplaylist. في حال تحديد قيم متعدّدة لأحد هذه الفلاتر، يمكنك أيضًا إضافة هذا الفلتر إلى قائمة السمات التي تحدّدها للطلب. وينطبق ذلك حتى إذا لم يتم إدراج الفلتر كسمة متوافقة مع تقرير معيّن.

راجِع تعريف المَعلمة filters للحصول على شرح كامل حول كيفية فلترة نتائج واجهة برمجة التطبيقات بحثًا عن قيمة معيّنة أو مجموعة من القيم.

فهم جداول التقارير

يوضّح هذا القسم التنسيق والمصطلحات المستخدَمة في الجداول التي تحدّد التقارير التي تتيحها واجهة برمجة التطبيقات. يسرد الجدول التالي السمات والمقاييس والفلاتر المتوافقة مع تقرير الفيديو الخاص بتفاصيل التشغيل باستخدام سمة الوقت ومقياس averageViewPercentage.

المحتويات
الأبعاد:
استخدِم 0 أو أكثر creatorContentType وsubscribedStatus وyoutubeProduct
استخدام 0 أو 1 day، month
المقاييس:
استخدام 1 أو أكثر engagedViews وviews وredViews وestimatedMinutesWatched وestimatedRedMinutesWatched وaverageViewDuration وaverageViewPercentage
الفلاتر:
استخدام 0 أو 1 country وprovince وcontinent وsubContinent
استخدام 0 أو 1 video وgroup
استخدِم 0 أو أكثر subscribedStatus وyoutubeProduct

يحتوي الجدول على صفّين للسمات وصفّ واحد للمقاييس وثلاثة صفوف للفلاتر. بالنسبة إلى السمات والفلاتر، يمكن دمج القيم من كل صف في طلب بيانات من واجهة برمجة التطبيقات طالما أنّ عملية الدمج تتّبع قواعد الاستخدام الواردة في الجدول. على سبيل المثال، تتضمّن قيم المَعلمة dimensions الصالحة لهذا التقرير ما يلي:

  • dimensions=day
  • dimensions=day,subscribedStatus
  • dimensions=month,subscribedStatus,youtubeProduct
  • dimensions=month,youtubeProduct

ومع ذلك، قيمة المَعلمة day,month غير صالحة لأنّها تستخدم سمتَين مستندتَين إلى الوقت، ويجب أن يستخدم الطلب 0 أو 1.

في حين تحدّد جداول التقارير السمات والمقاييس والفلاتر المتوافقة، تفرض واجهة برمجة التطبيقات قيودًا على مستوى المَعلمات. يؤدي طلب البحث عن مجموعات غير متوافقة أو حصرية بشكل متبادل (مثل الجمع بين فلاتر جغرافية غير متوافقة أو حذف المَعلمات المطلوبة) إلى حدوث خطأ 400 badRequest في HTTP مع الرسالة The query is not supported. راجِع جداول التقارير الفردية في هذه الصفحة للاطّلاع على القيود المحدّدة التي تنطبق على كل تقرير.

مصطلحات جدول التقارير

تستخدِم الجداول المصطلحات التالية للإشارة إلى ما إذا كانت السمات مطلوبة أو اختيارية:

  • تشير هذه المصطلحات إلى أنّ القيمة مطلوبة:
    • مطلوب: يجب تضمين القيمة.
    • استخدام قيمة واحدة بالضبط: يجب تضمين قيمة واحدة من المجموعة.
    • استخدام قيمة واحدة أو أكثر: يمكنك تضمين أيّ من القيم في المجموعة أو جميعها، ولكن يجب تضمين قيمة واحدة على الأقل.
  • تشير هذه المصطلحات إلى أنّ القيمة اختيارية:
    • اختياري: يمكنك تضمين القيمة.
    • استخدام 0 أو 1: يمكنك تضمين قيمة واحدة من المجموعة.
    • استخدام 0 أو أكثر: يمكنك تضمين أي قيم أو جميع القيم من المجموعة.

تقارير الفيديو

الإحصاءات الأساسية

إحصاءات أساسية لنشاط المستخدم

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

المحتويات
الأبعاد:
[بدون]
المقاييس:
استخدام 1 أو أكثر engagedViews وviews وredViews وcomments وlikes وdislikes وvideosAddedToPlaylists وvideosRemovedFromPlaylists وshares وestimatedMinutesWatched وestimatedRedMinutesWatched وaverageViewDuration وaverageViewPercentage وannotationClickThroughRate وannotationCloseRate وannotationImpressions وannotationClickableImpressions وannotationClosableImpressions وannotationClicks وannotationCloses وcardClickRate وcardTeaserClickRate وcardImpressions وcardTeaserImpressions وcardClicks وcardTeaserClicks وsubscribersGained وsubscribersLost وestimatedRevenue* وestimatedAdRevenue
الفلاتر:
استخدام 0 أو 1 country وcontinent وsubContinent
استخدام 0 أو 1 video وgroup

إحصاءات أساسية لنشاط المستخدمين في الولايات الأمريكية

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

المحتويات
الأبعاد:
[بدون]
المقاييس:
استخدام 1 أو أكثر engagedViews وviews وredViews وestimatedMinutesWatched وestimatedRedMinutesWatched وaverageViewDuration وaverageViewPercentage وannotationClickThroughRate وannotationCloseRate وannotationImpressions وannotationClickableImpressions وannotationClosableImpressions وannotationClicks وannotationCloses وcardClickRate وcardTeaserClickRate وcardImpressions وcardTeaserImpressions وcardClicks وcardTeaserClicks
الفلاتر:
مطلوب province
استخدام 0 أو 1 video وgroup

مستندة إلى الوقت

نشاط المستخدم حسب البلد لفترات زمنية محدّدة

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

المحتويات
الأبعاد:
استخدام 1 بالضبط day، month
اختياري creatorContentType
المقاييس:
استخدام 1 أو أكثر engagedViews وviews وredViews وcomments وlikes وdislikes وvideosAddedToPlaylists وvideosRemovedFromPlaylists وshares وestimatedMinutesWatched وestimatedRedMinutesWatched وaverageViewDuration وaverageViewPercentage وannotationClickThroughRate وannotationCloseRate وannotationImpressions وannotationClickableImpressions وannotationClosableImpressions وannotationClicks وannotationCloses وcardClickRate وcardTeaserClickRate وcardImpressions وcardTeaserImpressions وcardClicks وcardTeaserClicks وsubscribersGained وsubscribersLost وuniques وestimatedRevenue* وestimatedAdRevenue* وgrossRevenue* وestimatedRedPartnerRevenue* وmonetizedPlaybacks* وplaybackBasedCpm* وadImpressions* وcpm*
الفلاتر:
استخدام 0 أو 1 country وcontinent وsubContinent
استخدام 0 أو 1 video وgroup

نشاط المستخدِمين في الولايات الأمريكية لفترات زمنية محدّدة

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

المحتويات
الأبعاد:
استخدام 1 بالضبط day، month
اختياري creatorContentType
المقاييس:
استخدام 1 أو أكثر engagedViews وviews وredViews وestimatedMinutesWatched وestimatedRedMinutesWatched وaverageViewDuration وaverageViewPercentage وannotationClickThroughRate وannotationCloseRate وannotationImpressions وannotationClickableImpressions وannotationClosableImpressions وannotationClicks وannotationCloses وcardClickRate وcardTeaserClickRate وcardImpressions وcardTeaserImpressions وcardClicks وcardTeaserClicks
الفلاتر:
مطلوب province
استخدام 0 أو 1 video وgroup

الموقع الجغرافي للمستخدم

نشاط المستخدِمين حسب البلد

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

المحتويات
الأبعاد:
مطلوب country
اختياري creatorContentType
المقاييس:
استخدام 1 أو أكثر engagedViews وviews وredViews وcomments وlikes وdislikes وvideosAddedToPlaylists وvideosRemovedFromPlaylists وshares وestimatedMinutesWatched وestimatedRedMinutesWatched وaverageViewDuration وaverageViewPercentage وannotationClickThroughRate وannotationCloseRate وannotationImpressions وannotationClickableImpressions وannotationClosableImpressions وannotationClicks وannotationCloses وcardClickRate وcardTeaserClickRate وcardImpressions وcardTeaserImpressions وcardClicks وcardTeaserClicks وsubscribersGained وsubscribersLost وestimatedRevenue* وestimatedAdRevenue
الفلاتر:
استخدام 0 أو 1 continent, subContinent
استخدام 0 أو 1 video وgroup

نشاط المستخدمين حسب المقاطعة

يقدّم هذا التقرير إحصاءات عن نشاط المستخدمين في الولايات الأمريكية ومقاطعة كولومبيا. بالنسبة إلى هذا التقرير، يجب ضبط قيمة المَعلمة filters على country==US.

المحتويات
الأبعاد:
مطلوب province
اختياري creatorContentType
المقاييس:
استخدام 1 أو أكثر engagedViews وviews وredViews وestimatedMinutesWatched وestimatedRedMinutesWatched وaverageViewDuration وaverageViewPercentage وannotationClickThroughRate وannotationCloseRate وannotationImpressions وannotationClickableImpressions وannotationClosableImpressions وannotationClicks وannotationCloses وcardClickRate وcardTeaserClickRate وcardImpressions وcardTeaserImpressions وcardClicks وcardTeaserClicks
الفلاتر:
مطلوب country==US
استخدام 0 أو 1 video وgroup

نشاط المستخدِمين حسب المدينة (أقل من أو يساوي 250 نتيجة)

ملاحظة: يتطلّب هذا التقرير ضبط المَعلمة maxResults على قيمة عدد صحيح تساوي 250 أو أقل. على عكس معظم التقارير الأخرى، يتطلّب هذا التقرير أيضًا تحديد قيمة لمعلَمة الطلب sort.

يقدّم هذا التقرير إحصاءات نشاط المستخدم حسب المدينة.

المحتويات
الأبعاد:
مطلوب city
استخدِم 0 أو أكثر creatorContentType وcountry وprovince وsubscribedStatus

ملاحظة: إذا أدرجت السمة province، عليك أيضًا استخدام الفلتر country==US.
استخدام 0 أو 1 day، month
المقاييس:
استخدام 1 أو أكثر engagedViews وviews وestimatedMinutesWatched وaverageViewDuration وaverageViewPercentage
الفلاتر:
استخدام 0 أو 1 country وprovince وcontinent وsubContinent
استخدام 0 أو 1 video وgroup
خيارات الترتيب: -views
-estimatedMinutesWatched

نشاط المستخدِمين حسب منطقة السوق المحدّدة

يقدّم هذا التقرير إحصاءات نشاط المستخدم حسب منطقة السوق المحدّدة (DMA). بالنسبة إلى هذا التقرير، عليك إما ضبط قيمة المَعلمة filters على country==US أو الفلترة حسب مقاطعة معيّنة (ولاية أمريكية).

المحتويات
الأبعاد:
مطلوب dma
استخدام 0 أو 1 day
month
creatorContentType
subscribedStatus
المقاييس:
استخدام 1 أو أكثر engagedViews
views
estimatedMinutesWatched
averageViewDuration
averageViewPercentage
الفلاتر:
استخدام 0 أو 1 country==US
province
استخدام 0 أو 1 فيديو
مجموعة
خيارات الترتيب: -views
-estimatedMinutesWatched

تفاصيل التشغيل

تقدّم تقارير تفاصيل التشغيل إحصاءات ذات صلة بسمات المشاهدة التالية:

  • هل كان الفيديو الذي شاهدته بثًا مباشرًا أم فيديو عند الطلب؟
  • هل كان المشاهد مشتركًا في القناة التي تملك الفيديو؟
  • على أي منتج من منتجات YouTube حدثت المشاهدة؟

ملاحظة: لا يمكن استخدام السمة liveOrOnDemand والفلتر مع المقياس averageViewPercentage. وبالتالي، يسرد كل قسم فرعي من الأقسام التالية تقريرَين. يتيح أحد التقارير استخدام السمة (والفلتر) liveOrOnDemand، بينما يتيح التقرير الآخر استخدام المقياس averageViewPercentage.

نشاط المستخدمين حسب حالة الاشتراك

يقدّم هذا التقرير مقاييس نشاط المستخدمين للمشاهدين المشتركين وغير المشتركين في القناة. يمكن تجميع الإحصاءات حسب الفترة الزمنية (اليوم أو الشهر)، ويمكن أيضًا فلترة التقرير حسب البلد أو القارة أو subContinent.

المحتويات
الأبعاد:
استخدِم 0 أو أكثر creatorContentType، subscribedStatus
استخدام 0 أو 1 day، month
المقاييس:
استخدام 1 أو أكثر engagedViews وviews وredViews وlikes وdislikes وvideosAddedToPlaylists وvideosRemovedFromPlaylists وshares وestimatedMinutesWatched وestimatedRedMinutesWatched وaverageViewDuration وaverageViewPercentage وannotationClickThroughRate وannotationCloseRate وannotationImpressions وannotationClickableImpressions وannotationClosableImpressions وannotationClicks وannotationCloses وcardClickRate وcardTeaserClickRate وcardImpressions وcardTeaserImpressions وcardClicks وcardTeaserClicks
الفلاتر:
استخدام 0 أو 1 country وcontinent وsubContinent
استخدام 0 أو 1 video وgroup
اختياري subscribedStatus

نشاط المستخدمين حسب حالة الاشتراك في المقاطعات

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

المحتويات
الأبعاد:
استخدِم 0 أو أكثر creatorContentType، subscribedStatus
استخدام 0 أو 1 day، month
المقاييس:
استخدام 1 أو أكثر engagedViews وviews وredViews وestimatedMinutesWatched وestimatedRedMinutesWatched وaverageViewDuration وaverageViewPercentage وannotationClickThroughRate وannotationCloseRate وannotationImpressions وannotationClickableImpressions وannotationClosableImpressions وannotationClicks وannotationCloses وcardClickRate وcardTeaserClickRate وcardImpressions وcardTeaserImpressions وcardClicks وcardTeaserClicks
الفلاتر:
استخدام 0 أو 1 video وgroup
استخدِم 0 أو أكثر province, subscribedStatus

تفاصيل التشغيل مع بُعد زمني اختياري

سمة الوقت – اليوم أو الشهر – اختيارية لهذه التقارير لأنّه بغض النظر عن ذلك، عليك استخدام مَعلمتَي الطلب startDate وendDate لتحديد النطاق الزمني الذي سيغطّيه التقرير. تشير السمة، إذا كانت متوفّرة، إلى أنّك تريد تجميع البيانات في التقرير حسب اليوم أو الشهر أو غير ذلك.

تفاصيل التشغيل مع بُعد زمني اختياري وإحصاءات liveOrOnDemand

يقدّم هذا التقرير إحصاءات تفصيلية حول عمليات التشغيل لفواصل زمنية محدّدة. يتيح استخدام السمة (والفلتر) liveOrOnDemand.

المحتويات
الأبعاد:
استخدِم 0 أو أكثر creatorContentType وliveOrOnDemand وsubscribedStatus وyoutubeProduct
استخدام 0 أو 1 day، month
المقاييس:
استخدام 1 أو أكثر engagedViews وviews وredViews وestimatedMinutesWatched وestimatedRedMinutesWatched وaverageViewDuration
الفلاتر:
استخدام 0 أو 1 country وprovince وcontinent وsubContinent
استخدام 0 أو 1 video وgroup
استخدِم 0 أو أكثر liveOrOnDemand وsubscribedStatus وyoutubeProduct
تفاصيل التشغيل مع سمة الوقت الاختيارية ومقياس averageViewPercentage

يقدّم هذا التقرير إحصاءات تفصيلية حول عمليات التشغيل لفواصل زمنية محدّدة. يتيح استخدام المقياس averageViewPercentage.

المحتويات
الأبعاد:
استخدِم 0 أو أكثر creatorContentType وsubscribedStatus وyoutubeProduct
استخدام 0 أو 1 day، month
المقاييس:
استخدام 1 أو أكثر engagedViews وviews وredViews وestimatedMinutesWatched وestimatedRedMinutesWatched وaverageViewDuration وaverageViewPercentage
الفلاتر:
استخدام 0 أو 1 country وprovince وcontinent وsubContinent
استخدام 0 أو 1 video وgroup
استخدِم 0 أو أكثر subscribedStatus وyoutubeProduct

تفاصيل التشغيل حسب البلد

تفاصيل التشغيل حسب البلد باستخدام إحصاءات liveOrOnDemand

يقدّم هذا التقرير إحصاءات مفصّلة عن عمليات التشغيل حسب البلد. يتيح استخدام السمة (والفلتر) liveOrOnDemand.

المحتويات
الأبعاد:
مطلوب country
استخدِم 0 أو أكثر creatorContentType وliveOrOnDemand وsubscribedStatus وyoutubeProduct
المقاييس:
استخدام 1 أو أكثر engagedViews وviews وredViews وestimatedMinutesWatched وestimatedRedMinutesWatched وaverageViewDuration
الفلاتر:
استخدام 0 أو 1 continent, subContinent
استخدام 0 أو 1 video وgroup
استخدِم 0 أو أكثر liveOrOnDemand وsubscribedStatus وyoutubeProduct
تفاصيل التشغيل حسب البلد باستخدام مقياس averageViewPercentage

يشبه التقرير التالي التقرير السابق. تضيف هذه السمة إمكانية استخدام المقياس averageViewPercentage، ولكنّها لا تتيح استخدام liveOrOnDemand كسمة أو فلتر.

المحتويات
الأبعاد:
مطلوب country
استخدِم 0 أو أكثر creatorContentType وsubscribedStatus وyoutubeProduct
المقاييس:
استخدام 1 أو أكثر engagedViews وviews وredViews وestimatedMinutesWatched وestimatedRedMinutesWatched وaverageViewDuration وaverageViewPercentage
الفلاتر:
استخدام 0 أو 1 continent, subContinent
استخدام 0 أو 1 video وgroup
استخدِم 0 أو أكثر subscribedStatus وyoutubeProduct

تفاصيل التشغيل حسب الدائرة

تفاصيل التشغيل حسب المقاطعة مع إحصاءات liveOrOnDemand

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

المحتويات
الأبعاد:
مطلوب province
استخدِم 0 أو أكثر creatorContentType وliveOrOnDemand وsubscribedStatus وyoutubeProduct
المقاييس:
استخدام 1 أو أكثر engagedViews وviews وredViews وestimatedMinutesWatched وestimatedRedMinutesWatched وaverageViewDuration
الفلاتر:
مطلوب البلد==US
استخدام 0 أو 1 video وgroup
استخدِم 0 أو أكثر liveOrOnDemand وsubscribedStatus وyoutubeProduct
تفاصيل التشغيل حسب الدائرة باستخدام مقياس averageViewPercentage

يشبه التقرير التالي التقرير السابق. تضيف هذه السمة إمكانية استخدام المقياس averageViewPercentage، ولكنّها لا تتيح استخدام liveOrOnDemand كسمة أو فلتر.

المحتويات
الأبعاد:
مطلوب province
استخدِم 0 أو أكثر creatorContentType وsubscribedStatus وyoutubeProduct
المقاييس:
استخدام 1 أو أكثر engagedViews وviews وredViews وestimatedMinutesWatched وestimatedRedMinutesWatched وaverageViewDuration وaverageViewPercentage
الفلاتر:
مطلوب البلد==US
استخدام 0 أو 1 video وgroup
استخدِم 0 أو أكثر subscribedStatus وyoutubeProduct

مواقع التشغيل

تقرير مواقع تشغيل الفيديو

يقدّم هذا التقرير إحصاءات ذات صلة بنوع الصفحة أو التطبيق حيث تمّت عمليات تشغيل الفيديو.

المحتويات
الأبعاد:
مطلوب insightPlaybackLocationType
استخدِم 0 أو أكثر creatorContentType وday وliveOrOnDemand وsubscribedStatus
المقاييس:
استخدام 1 أو أكثر engagedViews وviews وestimatedMinutesWatched
الفلاتر:
استخدام 0 أو 1 country وprovince وcontinent وsubContinent
استخدام 0 أو 1 video وgroup
استخدِم 0 أو أكثر liveOrOnDemand, subscribedStatus

تفاصيل موقع التشغيل (<= 25 نتيجة)

ملاحظة: يتطلّب هذا التقرير ضبط المَعلمة maxResults على قيمة عدد صحيح تساوي 25 أو أقل. على عكس معظم التقارير الأخرى، يتطلّب منك هذا التقرير أيضًا تحديد قيمة لمعلَمة الطلب sort.

يحدّد هذا التقرير مشغّلات الفيديو المضمّنة التي حقّقت أكبر عدد من المشاهدات أو وقت المشاهدة لفيديوهات القناة.

المحتويات
الأبعاد:
مطلوب insightPlaybackLocationDetail
اختياري creatorContentType
المقاييس:
استخدام 1 أو أكثر engagedViews وviews وestimatedMinutesWatched
الفلاتر:
مطلوب insightPlaybackLocationType==EMBEDDED
استخدام 0 أو 1 country وprovince وcontinent وsubContinent
استخدام 0 أو 1 video وgroup
استخدِم 0 أو أكثر liveOrOnDemand, subscribedStatus
خيارات الترتيب: -views
-estimatedMinutesWatched

مصادر الزيارات

مصدر الزيارات

يجمع هذا التقرير إحصاءات المشاهدة استنادًا إلى الطريقة التي وصل بها المشاهدون إلى محتوى الفيديو. على سبيل المثال، يحدّد عدد المشاهدات التي نتجت عن بحث على Google أو عن رابط يؤدي إلى فيديو ذي صلة.

ملاحظة: يعرض هذا التقرير خطأً إذا كان ناتج ضرب عدد الفيديوهات التي تم البحث عنها في عدد الأيام في النطاق الزمني أكبر من 50,000. على سبيل المثال، يمكن أن يطلب استعلام يسترد بيانات 500 معرّف فيديو بيانات لمدة 100 يوم كحد أقصى. لتقليل عدد الصفوف التي يعرضها الطلب، قسِّم طلب البحث إلى طلبات بحث متعددة تحدّد عددًا أقل من الفيديوهات أو اضبط نطاقات زمنية أقصر.

المحتويات
الأبعاد:
مطلوب insightTrafficSourceType
استخدِم 0 أو أكثر creatorContentType وday وliveOrOnDemand وsubscribedStatus
المقاييس:
استخدام 1 أو أكثر engagedViews وviews وestimatedMinutesWatched
الفلاتر:
استخدام 0 أو 1 country وprovince وcontinent وsubContinent
استخدام 0 أو 1 video وgroup
استخدِم 0 أو أكثر liveOrOnDemand, subscribedStatus

تفاصيل مصدر الزيارات (25 نتيجة أو أقل)

ملاحظة: يتطلّب هذا التقرير ضبط المَعلمة maxResults على قيمة عدد صحيح تساوي 25 أو أقل. على عكس معظم التقارير الأخرى، يتطلّب منك هذا التقرير أيضًا تحديد قيمة لمعلَمة الطلب sort.

يجمع هذا التقرير إحصاءات المشاهدة استنادًا إلى المواقع الإحالية التي حقّقت أكبر عدد من المشاهدات لمحتوى القناة. يتم تصنيف المواقع المُحيلة حسب نوع مصدر الزيارات، ويحدّد تعريف السمة insightTrafficSourceDetail مصادر الزيارات التي يتوفّر لها التقرير. على سبيل المثال، إذا ضبطت فلتر insightTrafficSourceType على ADVERTISING، سيعرض التقرير أنواع الإعلانات التي حقّقت أكبر عدد من المشاهدات أو وقت المشاهدة لمحتوى القناة.

المحتويات
الأبعاد:
مطلوب insightTrafficSourceDetail
اختياري creatorContentType
المقاييس:
استخدام 1 أو أكثر engagedViews وviews وestimatedMinutesWatched
الفلاتر:
مطلوب insightTrafficSourceType (راجِع الملاحظة أسفل الجدول)
استخدام 0 أو 1 country وprovince وcontinent وsubContinent
استخدام 0 أو 1 video وgroup
استخدِم 0 أو أكثر liveOrOnDemand, subscribedStatus
خيارات الترتيب: -views
-estimatedMinutesWatched

ملاحظة: لا يتوفّر هذا التقرير إلا لمصادر زيارات محدّدة. مصادر الزيارات VIDEO_REMIXES وNOTIFICATION وEND_SCREEN وCAMPAIGN_CARD وVIDEO_REMIXES وNO_LINK_EMBEDDED هي بعض المصادر غير المتوافقة.

نوع الجهاز ونظام التشغيل

نوع الجهاز

يجمع هذا التقرير إحصاءات المشاهدة استنادًا إلى الطريقة التي وصل بها المشاهدون إلى محتوى الفيديو الخاص بك. على سبيل المثال، يحدّد عدد المشاهدات التي حدثت على الأجهزة الجوّالة أو وحدات تحكّم الألعاب.

المحتويات
الأبعاد:
مطلوب deviceType
استخدِم 0 أو أكثر creatorContentType وday وliveOrOnDemand وsubscribedStatus وyoutubeProduct
المقاييس:
استخدام 1 أو أكثر engagedViews وviews وestimatedMinutesWatched
الفلاتر:
استخدام 0 أو 1 country وprovince وcontinent وsubContinent
استخدام 0 أو 1 video وgroup
استخدِم 0 أو أكثر operatingSystem وliveOrOnDemand وsubscribedStatus وyoutubeProduct

نظام التشغيل

يجمع هذا التقرير إحصاءات المشاهدة استنادًا إلى أنظمة التشغيل التي يستخدمها المشاهدون. على سبيل المثال، يحدّد عدد المشاهدات التي حدثت على أجهزة Android أو على أجهزة PlayStation.

المحتويات
الأبعاد:
مطلوب operatingSystem
استخدِم 0 أو أكثر creatorContentType وday وliveOrOnDemand وsubscribedStatus وyoutubeProduct
المقاييس:
استخدام 1 أو أكثر engagedViews وviews وestimatedMinutesWatched
الفلاتر:
استخدام 0 أو 1 country وprovince وcontinent وsubContinent
استخدام 0 أو 1 video وgroup
استخدِم 0 أو أكثر deviceType وliveOrOnDemand وsubscribedStatus وyoutubeProduct

نظام التشغيل ونوع الجهاز

يجمع هذا التقرير إحصاءات المشاهدة استنادًا إلى أنظمة التشغيل وأنواع الأجهزة التي يستخدمها المشاهدون. على سبيل المثال، يحدّد عدد المشاهدات التي حدثت على أجهزة Android اللوحية أو على أجهزة الكمبيوتر المكتبي التي تعمل بنظام التشغيل Windows.

المحتويات
الأبعاد:
مطلوب deviceType, operatingSystem
استخدِم 0 أو أكثر creatorContentType وday وliveOrOnDemand وsubscribedStatus وyoutubeProduct
المقاييس:
استخدام 1 أو أكثر engagedViews وviews وestimatedMinutesWatched
الفلاتر:
استخدام 0 أو 1 country وprovince وcontinent وsubContinent
استخدام 0 أو 1 video وgroup
استخدِم 0 أو أكثر liveOrOnDemand وsubscribedStatus وyoutubeProduct

الخصائص الديمغرافية للمشاهدين

يجمع هذا التقرير إحصاءات المشاهدة استنادًا إلى الفئة العمرية والجنس.

المحتويات
الأبعاد:
استخدام 1 أو أكثر ageGroup, gender
استخدِم 0 أو أكثر creatorContentType وliveOrOnDemand وsubscribedStatus
المقاييس:
استخدام 1 أو أكثر viewerPercentage
الفلاتر:
استخدام 0 أو 1 country وprovince وcontinent وsubContinent
استخدام 0 أو 1 video وgroup
استخدِم 0 أو أكثر liveOrOnDemand, subscribedStatus
ملاحظة: لا يتم تعديل قيم viewerPercentage في هذا التقرير لتناسب القيم المختلفة أو مجموعات القيم المختلفة لسمات تفاصيل التشغيل (subscribedStatus أو liveOrOnDemand أو youtubeProduct).

على سبيل المثال، يعرض التقرير الذي يستخدم السمة subscribedStatus بيانات viewerPercentage التي تصل إلى %100 للمشاهدات من المشتركين وبيانات viewerPercentage التي تصل إلى %100 للمشاهدات من غير المشتركين. (تبلغ القيمة الإجمالية لجميع حقول viewerPercentage في التقرير %200).

يمكنك استخدام الفلاتر للتأكّد من أنّ التقرير لا يحتوي إلا على بيانات viewerPercentage لقيمة واحدة (أو مجموعة من القيم) لسمات تفاصيل التشغيل.

التفاعل ومشاركة المحتوى

يقدّم هذا التقرير إحصاءات توضّح عدد المرات التي تمت فيها مشاركة فيديوهات القناة على مختلف منصات التواصل الاجتماعي.

المحتويات
الأبعاد:
مطلوب sharingService
استخدِم 0 أو أكثر creatorContentType، subscribedStatus
المقاييس:
استخدام 1 أو أكثر المشاركة
الفلاتر:
استخدام 0 أو 1 country وcontinent وsubContinent
استخدام 0 أو 1 video وgroup
اختياري subscribedStatus

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

يقيس هذا التقرير قدرة الفيديو على الاحتفاظ بالجمهور، ويعرض أيضًا عدد المرّات التي تمت فيها مشاهدة أجزاء معيّنة من الفيديو. تقيس السمة elapsedVideoTimeRatio مقدار الفيديو الذي تم تشغيله لقيم المقاييس ذات الصلة. يمكن تقسيم المقاييس إلى فئتَين:

  • الاحتفاظ بالجمهور

    توضّح هذه المقاييس مدى نجاح الفيديو في الاحتفاظ بالجمهور.

    • audienceWatchRatio هي نسبة تقارن عدد المرات التي تمت فيها مشاهدة جزء من الفيديو بإجمالي عدد مشاهدات الفيديو.
    • يعرض القسم relativeRetentionPerformance مدى احتفاظ الفيديو بالمشاهدين أثناء عمليات التشغيل مقارنةً بفيديوهات أخرى على YouTube ذات مدة مشابهة.
  • إحصاءات دقيقة حول المشاهدة

    تقدّم هذه المقاييس معلومات عن عدد المرات التي تمت فيها مشاهدة مقاطع معيّنة من الفيديو.

    • يشير startedWatching إلى عدد مرّات بدء المستخدمين بمشاهدة فيديو خلال مقطع معيّن من الفيديو.
    • يشير stoppedWatching إلى عدد مرّات توقّف المشاهدين عن مشاهدة فيديو خلال مقطع معيّن منه.
    • يشير totalSegmentImpressions إلى عدد المرات التي تمت فيها مشاهدة جزء معيّن من الفيديو.

ملاحظة: لا يتيح هذا التقرير تحديد قائمة قيم مفصولة بفاصلة لفلتر video، بل يجب أن تحدّد القيمة معرّف فيديو واحدًا.

المحتويات
الأبعاد:
مطلوب elapsedVideoTimeRatio
المقاييس:
استخدام 1 أو أكثر audienceWatchRatio
relativeRetentionPerformance
startedWatching
stoppedWatching
totalSegmentImpressions
الفلاتر:
مطلوب video
استخدِم 0 أو أكثر audienceType
subscribedStatus
youtubeProduct

المشاهدون المتزامنون (في أحداث البث المباشر)

يعرض هذا التقرير عدد المشاهدين المتزامنين في موضع معيّن لفيديو واحد يتم بثه مباشرةً. يحدّد الفلتر الفيديو. يمثّل سمة الموضع عادةً دقيقة واحدة.

المحتويات
الأبعاد:
استخدام 0 أو 1 livestreamPosition
المقاييس:
استخدام 1 أو أكثر averageConcurrentViewers
peakConcurrentViewers
الفلاتر:
مطلوب video

الفيديوهات الأفضل أداءً

ملاحظة: تتطلّب هذه التقارير ضبط المَعلمة maxResults على قيمة عدد صحيح تساوي 200 أو أقل. قبل 1 يناير 2013، لا تتوفّر البيانات إلا لأهم 10 فيديوهات. وعلى عكس معظم التقارير الأخرى، تتطلّب منك هذه التقارير أيضًا تحديد قيمة لمعلَمة الطلب sort.

أبرز الفيديوهات مع فلاتر إقليمية اختيارية (200 نتيجة أو أقل)

يعرض هذا التقرير قائمة بأهم الفيديوهات على القناة. يمكن فلترة التقرير لعرض الفيديوهات الأفضل أداءً حسب البلد أو القارة أو subContinent.

المحتويات
الأبعاد:
مطلوب video
اختياري creatorContentType
المقاييس:
استخدام 1 أو أكثر engagedViews وviews وredViews وcomments وlikes وdislikes وvideosAddedToPlaylists وvideosRemovedFromPlaylists وshares وestimatedMinutesWatched وestimatedRedMinutesWatched وaverageViewDuration وaverageViewPercentage وannotationClickThroughRate وannotationCloseRate وannotationImpressions وannotationClickableImpressions وannotationClosableImpressions وannotationClicks وannotationCloses وcardClickRate وcardTeaserClickRate وcardImpressions وcardTeaserImpressions وcardClicks وcardTeaserClicks وsubscribersGained وsubscribersLost وestimatedRevenue* وestimatedAdRevenue
الفلاتر:
استخدام 0 أو 1 country وcontinent وsubContinent
خيارات الترتيب: -views
-redViews
-estimatedRevenue
-estimatedRedPartnerRevenue
-estimatedMinutesWatched
-estimatedRedMinutesWatched
-subscribersGained
-subscribersLost

أبرز الفيديوهات حسب الولاية (أقل من أو يساوي 200 نتيجة)

يعرض هذا التقرير أبرز فيديوهات القناة في ولاية أمريكية معيّنة أو في مقاطعة كولومبيا. يُرجى العِلم أنّ هذا التقرير لا يتيح سوى مجموعة فرعية من المقاييس المتوفّرة في التقرير الخاص بكل بلد والموضّح أعلاه.

المحتويات
الأبعاد:
مطلوب video
اختياري creatorContentType
المقاييس:
استخدام 1 أو أكثر engagedViews وviews وredViews وestimatedMinutesWatched وestimatedRedMinutesWatched وaverageViewDuration وaverageViewPercentage وannotationClickThroughRate وannotationCloseRate وannotationImpressions وannotationClickableImpressions وannotationClosableImpressions وannotationClicks وannotationCloses وcardClickRate وcardTeaserClickRate وcardImpressions وcardTeaserImpressions وcardClicks وcardTeaserClicks
الفلاتر:
مطلوب province
اختياري subscribedStatus
خيارات الترتيب: -views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

أبرز الفيديوهات للمشاهدين المشتركين أو غير المشتركين(<= 200 نتيجة)

يعرض هذا التقرير أفضل فيديوهات القناة للمشاهدين المشتركين أو غير المشتركين. يمكن فلترة التقرير لعرض الفيديوهات الأفضل أداءً حسب البلد أو القارة أو subContinent. يتيح لك التقرير السابق استرداد الفيديوهات الأفضل أداءً في ولاية أمريكية معيّنة للمشاهدين المشتركين أو غير المشتركين، ولكنّه يتوافق مع عدد أقل من المقاييس مقارنةً بهذا التقرير.

المحتويات
الأبعاد:
مطلوب video
اختياري creatorContentType
المقاييس:
استخدام 1 أو أكثر engagedViews وviews وredViews وlikes وdislikes وvideosAddedToPlaylists وvideosRemovedFromPlaylists وshares وestimatedMinutesWatched وestimatedRedMinutesWatched وaverageViewDuration وaverageViewPercentage وannotationClickThroughRate وannotationCloseRate وannotationImpressions وannotationClickableImpressions وannotationClosableImpressions وannotationClicks وannotationCloses وcardClickRate وcardTeaserClickRate وcardImpressions وcardTeaserImpressions وcardClicks وcardTeaserClicks
الفلاتر:
اختياري subscribedStatus
استخدام 0 أو 1 country وcontinent وsubContinent
خيارات الترتيب: -views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

أهم الفيديوهات حسب منتج YouTube (أقل من أو يساوي 200 نتيجة)

يسرد هذا التقرير أهم الفيديوهات على القناة ويتيح استخدام فلاتر تفاصيل التشغيل والفلاتر الجغرافية. يشبه هذا التقرير التقرير السابق، ولكنّه يتيح عددًا أقل من المقاييس ويضيف إمكانية استخدام الفلتر youtubeProduct.

المحتويات
الأبعاد:
مطلوب video
اختياري creatorContentType
المقاييس:
استخدام 1 أو أكثر engagedViews وviews وredViews وestimatedMinutesWatched وestimatedRedMinutesWatched وaverageViewDuration وaverageViewPercentage
الفلاتر:
استخدام 0 أو 1 country وprovince وcontinent وsubContinent
استخدِم 0 أو أكثر subscribedStatus وyoutubeProduct
خيارات الترتيب: -views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

أبرز الفيديوهات مع فلاتر تفاصيل التشغيل (أقل من أو يساوي 200 نتيجة)

يعرض هذا التقرير أهم الفيديوهات في القناة، مع إمكانية الفلترة حسب أيّ من سمات تفاصيل التشغيل أو جميعها: liveOrOnDemand وsubscribedStatus وyoutubeProduct. على عكس التقرير السابق، يتيح هذا التقرير استخدام الفلتر liveOrOnDemand ولا يتيح استخدام المقياس averageViewPercentage.

المحتويات
الأبعاد:
مطلوب video
اختياري creatorContentType
المقاييس:
استخدام 1 أو أكثر engagedViews وviews وredViews وestimatedMinutesWatched وestimatedRedMinutesWatched وaverageViewDuration
الفلاتر:
استخدام 0 أو 1 country وprovince وcontinent وsubContinent
استخدِم 0 أو أكثر liveOrOnDemand وsubscribedStatus وyoutubeProduct
خيارات الترتيب: -views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

تقارير قوائم التشغيل

تحتوي تقارير قوائم التشغيل على مقاييس مرتبطة بنشاط المستخدمين المتعلق بالفيديوهات في قوائم التشغيل الخاصة بمالك القناة. يتوفّر إصداران من هذه التقارير، وتحتوي الأقسام التالية على وصف لكل إصدار:

مقاييس الفيديو المجمّعة

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

راجِع القسم مقاييس قوائم التشغيل المتوافقة للاطّلاع على قائمة بمقاييس الفيديو المجمّعة التي يتيحها YouTube.

مقاييس داخل قائمة التشغيل

تعكس هذه المقاييس نشاط المستخدمين وتفاعلهم في سياق صفحة قائمة التشغيل. تشمل هذه المقاييس مشاهدات كل الفيديوهات في قائمة التشغيل، بغض النظر عن القناة التي تملكها، ولكنها تحتسب فقط المشاهدات التي حدثت في سياق قائمة التشغيل.

مقاييس قوائم التشغيل المتاحة

المحتويات
مقاييس الفيديو المجمّعة engagedViews وviews وestimatedMinutesWatched وaverageViewDuration
مقاييس داخل قائمة التشغيل playlistViews وplaylistEstimatedMinutesWatched وplaylistAverageViewDuration وplaylistSaves وplaylistStarts وviewsPerPlaylistStart وaverageTimeInPlaylist

الإحصاءات الأساسية

يقدّم هذا التقرير إحصاءات حول تفاعلات المستخدمين مع الفيديوهات في قوائم تشغيل القناة. يمكنك فلترة التقرير لعرض بيانات قائمة تشغيل معيّنة فقط.

المحتويات
الأبعاد:
[بدون]
المقاييس:
استخدام 1 أو أكثر engagedViews وviews وestimatedMinutesWatched وaverageViewDuration وaverageTimeInPlaylist وplaylistAverageViewDuration وplaylistEstimatedMinutesWatched وplaylistSaves وplaylistStarts وplaylistViews وviewsPerPlaylistStart
الفلاتر:
استخدام 1 بالضبط قائمة التشغيل، المجموعة

مستندة إلى الوقت

يقدّم هذا التقرير إحصاءات حول تفاعلات المستخدمين مع الفيديوهات في قوائم تشغيل القناة. يمكنك فلترة التقرير لعرض بيانات قائمة تشغيل معيّنة فقط.

المحتويات
الأبعاد:
استخدام 1 بالضبط day، month
المقاييس:
استخدام 1 أو أكثر engagedViews وviews وestimatedMinutesWatched وaverageViewDuration وaverageTimeInPlaylist وplaylistAverageViewDuration وplaylistEstimatedMinutesWatched وplaylistSaves وplaylistStarts وplaylistViews وviewsPerPlaylistStart
الفلاتر:
استخدام 1 بالضبط قائمة التشغيل، المجموعة

الموقع الجغرافي للمستخدم

نشاط قوائم التشغيل حسب البلد

يقدّم هذا التقرير إحصاءات ذات صلة بالتفاعلات التي يجريها المستخدمون في بلد معيّن مع الفيديوهات في قوائم تشغيل القناة.

المحتويات
الأبعاد:
مطلوب country
المقاييس:
استخدام 1 أو أكثر engagedViews وviews وestimatedMinutesWatched وaverageViewDuration
الفلاتر:
استخدام 1 بالضبط قائمة التشغيل، المجموعة
استخدام 0 أو 1 continent, subContinent

نشاط قوائم التشغيل حسب الدائرة

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

المحتويات
الأبعاد:
مطلوب province
المقاييس:
استخدام 1 أو أكثر engagedViews وviews وestimatedMinutesWatched وaverageViewDuration
الفلاتر:
مطلوب البلد==US
استخدام 1 بالضبط قائمة التشغيل، المجموعة

مواقع التشغيل

يقدّم هذا التقرير إحصاءات ذات صلة بنوع الصفحة أو التطبيق حيث تم تشغيل فيديوهات قائمة التشغيل.

المحتويات
الأبعاد:
مطلوب insightPlaybackLocationType
المقاييس:
استخدام 1 أو أكثر engagedViews وviews وestimatedMinutesWatched وaverageViewDuration وaverageTimeInPlaylist وplaylistAverageViewDuration وplaylistEstimatedMinutesWatched وplaylistStarts وplaylistViews وviewsPerPlaylistStart
الفلاتر:
استخدام 1 بالضبط قائمة التشغيل، المجموعة

تفاصيل موقع التشغيل (<= 25 نتيجة)

ملاحظة: يتطلّب هذا التقرير ضبط المَعلمة maxResults على قيمة عدد صحيح تساوي 25 أو أقل. على عكس معظم التقارير الأخرى، يتطلّب منك هذا التقرير أيضًا تحديد قيمة لمعلَمة الطلب sort.

يحدّد هذا التقرير مشغّلات الفيديو المضمّنة التي حقّقت أكبر عدد من المشاهدات أو وقت المشاهدة لفيديوهات قوائم التشغيل في القناة.

المحتويات
الأبعاد:
مطلوب insightPlaybackLocationDetail
المقاييس:
استخدام 1 أو أكثر engagedViews وviews وestimatedMinutesWatched وaverageViewDuration وaverageTimeInPlaylist وplaylistAverageViewDuration وplaylistEstimatedMinutesWatched وplaylistStarts وplaylistViews وviewsPerPlaylistStart
الفلاتر:
مطلوب insightPlaybackLocationType==EMBEDDED
استخدام 1 بالضبط قائمة التشغيل، المجموعة
خيارات الترتيب: -playlistViews
-playlistEstimatedMinutesWatched
-playlistStarts

مصادر الزيارات

يجمع هذا التقرير إحصاءات المشاهدة استنادًا إلى الطريقة التي وصل بها المشاهدون إلى محتوى قائمة التشغيل. على سبيل المثال، يحدّد عدد المشاهدات التي نتجت عن بحث على Google.

المحتويات
الأبعاد:
مطلوب insightTrafficSourceType
المقاييس:
استخدام 1 أو أكثر engagedViews وviews وestimatedMinutesWatched وaverageViewDuration وaverageTimeInPlaylist وplaylistAverageViewDuration وplaylistEstimatedMinutesWatched وplaylistSaves وplaylistStarts وplaylistViews وviewsPerPlaylistStart
الفلاتر:
استخدام 1 بالضبط قائمة التشغيل، المجموعة

تفاصيل مصدر الزيارات (25 نتيجة أو أقل)

ملاحظة: يتطلّب هذا التقرير ضبط المَعلمة maxResults على قيمة عدد صحيح تساوي 25 أو أقل. على عكس معظم التقارير الأخرى، يتطلّب هذا التقرير أيضًا تحديد قيمة لمعلَمة الطلب sort.

يجمع هذا التقرير إحصاءات المشاهدة استنادًا إلى المواقع الإحالية التي جذبت أكبر عدد من المشاهدات للفيديوهات في قوائم تشغيل القناة. يتم تصنيف المواقع الإحالية حسب نوع مصدر الزيارات، ويحدّد تعريف السمة insightTrafficSourceDetail مصادر الزيارات التي يتوفّر لها التقرير.

على سبيل المثال، إذا ضبطت فلتر insightTrafficSourceType على ADVERTISING، سيعرض التقرير أنواع الإعلانات التي حقّقت أكبر عدد من المشاهدات أو أطول مدة مشاهدة لقوائم تشغيل القناة.

المحتويات
الأبعاد:
مطلوب insightTrafficSourceDetail
المقاييس:
استخدام 1 أو أكثر engagedViews وviews وestimatedMinutesWatched وaverageViewDuration وaverageTimeInPlaylist وplaylistAverageViewDuration وplaylistEstimatedMinutesWatched وplaylistSaves وplaylistStarts وplaylistViews وviewsPerPlaylistStart
الفلاتر:
مطلوب insightTrafficSourceType==ADVERTISING (أو قيمة مسموح بها أخرى)
استخدام 1 بالضبط قائمة التشغيل، المجموعة
خيارات الترتيب: -playlistViews
-playlistEstimatedMinutesWatched
-playlistStarts

ملاحظة: لا يتوفّر هذا التقرير إلا لمصادر زيارات محدّدة. مصادر الزيارات VIDEO_REMIXES وNOTIFICATION وEND_SCREEN وCAMPAIGN_CARD وVIDEO_REMIXES وNO_LINK_EMBEDDED هي بعض المصادر غير المتوافقة.

نوع الجهاز ونظام التشغيل

نوع الجهاز

يجمع هذا التقرير إحصاءات المشاهدة استنادًا إلى الطريقة التي عثر بها المشاهدون على الفيديوهات في قوائم التشغيل الخاصة بك. على سبيل المثال، يحدّد عدد المشاهدات التي حدثت على الأجهزة الجوّالة أو وحدات تحكّم الألعاب.

المحتويات
الأبعاد:
مطلوب deviceType
المقاييس:
استخدام 1 أو أكثر engagedViews وviews وestimatedMinutesWatched وaverageViewDuration وaverageTimeInPlaylist وplaylistAverageViewDuration وplaylistEstimatedMinutesWatched وplaylistStarts وplaylistViews وviewsPerPlaylistStart
الفلاتر:
استخدام 1 بالضبط قائمة التشغيل، المجموعة

نظام التشغيل

يجمع هذا التقرير إحصاءات المشاهدة استنادًا إلى أنظمة التشغيل التي يستخدمها المشاهدون. على سبيل المثال، يحدّد عدد المشاهدات التي حدثت على أجهزة Android أو على أجهزة PlayStation.

المحتويات
الأبعاد:
مطلوب operatingSystem
المقاييس:
استخدام 1 أو أكثر engagedViews وviews وestimatedMinutesWatched وaverageViewDuration وaverageTimeInPlaylist وplaylistAverageViewDuration وplaylistEstimatedMinutesWatched وplaylistStarts وplaylistViews وviewsPerPlaylistStart
الفلاتر:
استخدام 1 بالضبط قائمة التشغيل، المجموعة

نظام التشغيل ونوع الجهاز

يجمع هذا التقرير إحصاءات المشاهدة استنادًا إلى أنظمة التشغيل وأنواع الأجهزة التي يستخدمها المشاهدون. على سبيل المثال، يحدّد عدد المشاهدات التي حدثت على أجهزة Android اللوحية أو أجهزة الكمبيوتر المكتبي التي تعمل بنظام التشغيل Windows.

المحتويات
الأبعاد:
مطلوب deviceType, operatingSystem
المقاييس:
استخدام 1 أو أكثر engagedViews وviews وestimatedMinutesWatched وaverageViewDuration وaverageTimeInPlaylist وplaylistAverageViewDuration وplaylistEstimatedMinutesWatched وplaylistStarts وplaylistViews وviewsPerPlaylistStart
الفلاتر:
استخدام 1 بالضبط قائمة التشغيل، المجموعة

الخصائص الديمغرافية للمشاهدين

المحتويات
الأبعاد:
استخدام 1 أو أكثر ageGroup, gender
المقاييس:
مطلوب viewerPercentage
الفلاتر:
استخدام 1 بالضبط قائمة التشغيل، المجموعة

أهم قوائم التشغيل

ملاحظة: تتطلّب هذه التقارير ضبط المَعلمة maxResults على قيمة عدد صحيح تساوي 200 أو أقل. قبل 1 كانون الثاني (يناير) 2013، لا تتوفّر البيانات إلا لأبرز 10 قوائم تشغيل. وعلى عكس معظم التقارير الأخرى، تتطلّب منك هذه التقارير أيضًا تحديد قيمة لمعلَمة الطلب sort.

يعرض هذا التقرير أهم قوائم التشغيل في القناة استنادًا إلى معايير الفلترة والترتيب المحدّدة.

المحتويات
الأبعاد:
مطلوب قائمة التشغيل
المقاييس:
استخدام 1 أو أكثر averageTimeInPlaylist وplaylistAverageViewDuration وplaylistEstimatedMinutesWatched وplaylistSaves وplaylistStarts وplaylistViews وviewsPerPlaylistStart
خيارات الترتيب: -playlistViews
-playlistEstimatedMinutesWatched
-playlistStarts

تقارير العضوية

عمليات إلغاء العضوية

يقدّم هذا التقرير إحصاءات توضّح أسباب إلغاء المستخدمين لعضوياتهم في القناة.

المحتويات
الأبعاد:
استخدام 0 أو 1 membershipsCancellationSurveyReason
المقاييس:
مطلوب membershipsCancellationSurveyResponses

تقارير أداء الإعلان

ملاحظة: تتطلّب تقارير أداء الإعلانات رمز تفويض يمنح إذن الوصول إلى نطاق https://www.googleapis.com/auth/yt-analytics-monetary.readonly.

توفّر تقارير أداء الإعلانات مقاييس مستندة إلى مرات الظهور للإعلانات التي تم عرضها أثناء تشغيل الفيديوهات. تأخذ هذه المقاييس في الاعتبار كل مرة ظهور للإعلان، ويمكن أن يؤدي كل تشغيل للفيديو إلى تحقيق مرات ظهور متعددة.

مقاييس أداء الإعلانات المستندة إلى مرّات الظهور هي:

بالإضافة إلى ذلك، تتيح بعض تقارير الفيديو مقاييس أداء الإعلانات التالية المستندة إلى التشغيل. ومع ذلك، لا يتم تضمين هذه المقاييس في تقارير أداء الإعلانات.

أداء الإعلان حسب نوع الإعلان

المحتويات
الأبعاد:
مطلوب adType
اختياري day
المقاييس:
استخدام 1 أو أكثر grossRevenue وadImpressions وcpm
الفلاتر:
استخدام 0 أو 1 video وgroup
استخدام 0 أو 1 country وcontinent وsubContinent