YouTube Analytics API: Channel Reports

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

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

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

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

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

  • استبدِل channel==CHANNEL_ID بـ 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 حاليًا إذن الوصول إلى البيانات النقدية في هذه التقارير.

الفلاتر

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

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

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

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

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

المحتويات
الأبعاد:
استخدِم 0 أو أكثر creatorContentType وsubscribedStatus وyoutubeProduct
استخدِم 0 أو 1 day، month
المقاييس:
استخدام رقم واحد أو أكثر 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.

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

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

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

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

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

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

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

المحتويات
الأبعاد:
[بدون]
المقاييس:
استخدام رقم واحد أو أكثر 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* وgrossRevenue* وestimatedRedPartnerRevenue* وmonetizedPlaybacks* وplaybackBasedCpm* وadImpressions* وcpm*
الفلاتر:
استخدِم 0 أو 1 country وcontinent وsubContinent
استخدِم 0 أو 1 video وgroup

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

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

المحتويات
الأبعاد:
[بدون]
المقاييس:
استخدام رقم واحد أو أكثر 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
المقاييس:
استخدام رقم واحد أو أكثر 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
المقاييس:
استخدام رقم واحد أو أكثر 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
المقاييس:
استخدام رقم واحد أو أكثر 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* وgrossRevenue* وestimatedRedPartnerRevenue* وmonetizedPlaybacks* وplaybackBasedCpm* وadImpressions* وcpm*
الفلاتر:
استخدِم 0 أو 1 continent, subContinent
استخدِم 0 أو 1 video وgroup

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

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

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

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

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

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

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

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

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

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

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

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

المحتويات
الأبعاد:
مطلوب insightPlaybackLocationDetail
اختياري creatorContentType
المقاييس:
استخدام رقم واحد أو أكثر 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
المقاييس:
استخدام رقم واحد أو أكثر 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
المقاييس:
استخدام رقم واحد أو أكثر 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
المقاييس:
استخدام رقم واحد أو أكثر 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
المقاييس:
استخدام رقم واحد أو أكثر 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
المقاييس:
استخدام رقم واحد أو أكثر engagedViews وviews وestimatedMinutesWatched
الفلاتر:
استخدِم 0 أو 1 country وprovince وcontinent وsubContinent
استخدِم 0 أو 1 video وgroup
استخدِم 0 أو أكثر liveOrOnDemand وsubscribedStatus وyoutubeProduct

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

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

المحتويات
الأبعاد:
استخدام رقم واحد أو أكثر ageGroup، gender
استخدِم 0 أو أكثر creatorContentType وliveOrOnDemand وsubscribedStatus
المقاييس:
استخدام رقم واحد أو أكثر 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
المقاييس:
استخدام رقم واحد أو أكثر الأسهم
الفلاتر:
استخدِم 0 أو 1 country وcontinent وsubContinent
استخدِم 0 أو 1 video وgroup
اختياري subscribedStatus

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

المحتويات
الأبعاد:
مطلوب video
اختياري creatorContentType
المقاييس:
استخدام رقم واحد أو أكثر 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* وgrossRevenue* وestimatedRedPartnerRevenue* وmonetizedPlaybacks* وplaybackBasedCpm* وadImpressions* وcpm*
الفلاتر:
استخدِم 0 أو 1 country وcontinent وsubContinent
خيارات الترتيب: -views
-redViews
-estimatedRevenue
-estimatedRedPartnerRevenue
-estimatedMinutesWatched
-estimatedRedMinutesWatched
-subscribersGained
-subscribersLost

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

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

المحتويات
الأبعاد:
مطلوب video
اختياري creatorContentType
المقاييس:
استخدام رقم واحد أو أكثر 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
المقاييس:
استخدام رقم واحد أو أكثر 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
المقاييس:
استخدام رقم واحد أو أكثر 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
المقاييس:
استخدام رقم واحد أو أكثر 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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

تفاصيل مصدر الزيارات (<= 25 نتيجة)

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

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

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

المحتويات
الأبعاد:
مطلوب insightTrafficSourceDetail
المقاييس:
استخدام رقم واحد أو أكثر 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
المقاييس:
استخدام رقم واحد أو أكثر engagedViews وviews وestimatedMinutesWatched وaverageViewDuration وaverageTimeInPlaylist وplaylistAverageViewDuration وplaylistEstimatedMinutesWatched وplaylistStarts وplaylistViews وviewsPerPlaylistStart
الفلاتر:
استخدام 1 بالضبط قائمة تشغيل أو مجموعة

نظام التشغيل

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

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

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

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

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

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

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

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

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

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

المحتويات
الأبعاد:
مطلوب قائمة التشغيل
المقاييس:
استخدام رقم واحد أو أكثر 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
المقاييس:
استخدام رقم واحد أو أكثر grossRevenue وadImpressions وcpm
الفلاتر:
استخدِم 0 أو 1 video وgroup
استخدِم 0 أو 1 country وcontinent وsubContinent