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" نطاقات التفويض التالية:

المستويات
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
المقاييس:
استخدِم كلمة واحدة أو أكثر. المشاهدات وredViews وestimatedMinutesWatched وestimatedRedMinutesWatched وaverageViewDuration وaverageViewPercentage
الفلاتر:
استخدِم 0 أو 1. country وprovince وcontinent وsubContinent
استخدِم 0 أو 1. فيديو، مجموعة
استخدِم 0 أو أكثر. ‫subscribedStatus وyoutubeProduct

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

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

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

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

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

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

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

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

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

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

المحتويات
الأبعاد:
[بدون]
المقاييس:
استخدِم كلمة واحدة أو أكثر. مرّات المشاهدة وredViews والتعليقات والمعجبون وغير المعجبون وvideosAddedToPlaylists وvideosRemovedFromPlaylists والمشاركات و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* والأرباح لكل ألف ظهور*
الفلاتر:
استخدِم 0 أو 1. country وcontinent وsubContinent
استخدِم 0 أو 1. فيديو، مجموعة

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

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

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

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

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

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

المحتويات
الأبعاد:
استخدِم 1 فقط. اليوم، الشهر
اختياري creatorContentType
المقاييس:
استخدِم كلمة واحدة أو أكثر. مرّات المشاهدة وredViews والتعليقات والمعجبون وغير المعجبون وvideosAddedToPlaylists وvideosRemovedFromPlaylists والمشاركات و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* والأرباح لكل ألف ظهور*
الفلاتر:
استخدِم 0 أو 1. country وcontinent وsubContinent
استخدِم 0 أو 1. فيديو، مجموعة

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

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

المحتويات
الأبعاد:
استخدِم 1 فقط. اليوم، الشهر
اختياري creatorContentType
المقاييس:
استخدِم كلمة واحدة أو أكثر. views وredViews وestimatedMinutesWatched وestimatedRedMinutesWatched وaverageViewDuration وaverageViewPercentage وannotationClickThroughRate وannotationCloseRate وannotationImpressions وannotationClickableImpressions وannotationClosableImpressions وannotationClicks وannotationCloses وcardClickRate وcardTeaserClickRate وcardImpressions وcardTeaserImpressions وcardClicks وcardTeaserClicks
الفلاتر:
مطلوب province
استخدِم 0 أو 1. فيديو، مجموعة

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

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

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

المحتويات
الأبعاد:
مطلوب country
اختياري creatorContentType
المقاييس:
استخدِم كلمة واحدة أو أكثر. مرّات المشاهدة وredViews والتعليقات والمعجبون وغير المعجبون وvideosAddedToPlaylists وvideosRemovedFromPlaylists والمشاركات و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* والأرباح لكل ألف ظهور*
الفلاتر:
استخدِم 0 أو 1. continent، subContinent
استخدِم 0 أو 1. فيديو، مجموعة

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

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

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

نشاط المستخدِمين حسب المدينة (<= 250 نتيجة)

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

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

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

ملاحظة: في حال تضمين السمة province، يجب أيضًا استخدام الفلتر country==US.
استخدِم 0 أو 1. اليوم، الشهر
المقاييس:
استخدِم كلمة واحدة أو أكثر. المشاهدات وestimatedMinutesWatched وaverageViewDuration وaverageViewPercentage
الفلاتر:
استخدِم 0 أو 1. country وprovince وcontinent وsubContinent
استخدِم 0 أو 1. فيديو، مجموعة
خيارات الترتيب: -المشاهدات
-estimatedMinutesWatched

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

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

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

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

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

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

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

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

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

المحتويات
الأبعاد:
استخدِم 0 أو أكثر. ‫creatorContentType وsubscribedStatus
استخدِم 0 أو 1. اليوم، الشهر
المقاييس:
استخدِم كلمة واحدة أو أكثر. مرّات المشاهدة وredViews وعدد المعجبين وعدد غير المعجبين وvideosAddedToPlaylists وvideosRemovedFromPlaylists وعدد المشاركات وestimatedMinutesWatched وestimatedRedMinutesWatched وaverageViewDuration وaverageViewPercentage وannotationClickThroughRate وannotationCloseRate وannotationImpressions وannotationClickableImpressions وannotationClosableImpressions وannotationClicks وannotationCloses وcardClickRate وcardTeaserClickRate وcardImpressions وcardTeaserImpressions وcardClicks وcardTeaserClicks
الفلاتر:
استخدِم 0 أو 1. country وcontinent وsubContinent
استخدِم 0 أو 1. فيديو، مجموعة
اختياري subscribedStatus

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

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

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

تفاصيل التشغيل مع سمة الوقت الاختيارية

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

تفاصيل التشغيل مع سمة الوقت الاختيارية وإحصاءات liveOrOnDemand

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

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

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

المحتويات
الأبعاد:
استخدِم 0 أو أكثر. ‫creatorContentType وsubscribedStatus وyoutubeProduct
استخدِم 0 أو 1. day وmonth
المقاييس:
استخدِم كلمة واحدة أو أكثر. المشاهدات وredViews وestimatedMinutesWatched وestimatedRedMinutesWatched وaverageViewDuration وaverageViewPercentage
الفلاتر:
استخدِم 0 أو 1. country وprovince وcontinent وsubContinent
استخدِم 0 أو 1. فيديو، مجموعة
استخدِم 0 أو أكثر. ‫subscribedStatus وyoutubeProduct

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

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

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

المحتويات
الأبعاد:
مطلوب country
استخدِم 0 أو أكثر. ‫creatorContentType وliveOrOnDemand وsubscribedStatus وyoutubeProduct
المقاييس:
استخدِم كلمة واحدة أو أكثر. المشاهدات وredViews وestimatedMinutesWatched وestimatedRedMinutesWatched وaverageViewDuration
الفلاتر:
استخدِم 0 أو 1. continent، subContinent
استخدِم 0 أو 1. فيديو، مجموعة
استخدِم 0 أو أكثر. ‫liveOrOnDemand وsubscribedStatus وyoutubeProduct
تفاصيل التشغيل حسب البلد باستخدام مقياس averageViewPercentage

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

المحتويات
الأبعاد:
مطلوب country
استخدِم 0 أو أكثر. ‫creatorContentType وsubscribedStatus وyoutubeProduct
المقاييس:
استخدِم كلمة واحدة أو أكثر. المشاهدات وredViews وestimatedMinutesWatched وestimatedRedMinutesWatched وaverageViewDuration وaverageViewPercentage
الفلاتر:
استخدِم 0 أو 1. continent، subContinent
استخدِم 0 أو 1. فيديو، مجموعة
استخدِم 0 أو أكثر. ‫subscribedStatus وyoutubeProduct

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

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

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

المحتويات
الأبعاد:
مطلوب province
استخدِم 0 أو أكثر. ‫creatorContentType وliveOrOnDemand وsubscribedStatus وyoutubeProduct
المقاييس:
استخدِم كلمة واحدة أو أكثر. المشاهدات وredViews وestimatedMinutesWatched وestimatedRedMinutesWatched وaverageViewDuration
الفلاتر:
مطلوب country==US
استخدِم 0 أو 1. فيديو، مجموعة
استخدِم 0 أو أكثر. ‫liveOrOnDemand وsubscribedStatus وyoutubeProduct
تفاصيل التشغيل حسب المقاطعة باستخدام مقياس averageViewPercentage

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

المحتويات
الأبعاد:
مطلوب province
استخدِم 0 أو أكثر. ‫creatorContentType وsubscribedStatus وyoutubeProduct
المقاييس:
استخدِم كلمة واحدة أو أكثر. المشاهدات وredViews وestimatedMinutesWatched وestimatedRedMinutesWatched وaverageViewDuration وaverageViewPercentage
الفلاتر:
مطلوب country==US
استخدِم 0 أو 1. فيديو، مجموعة
استخدِم 0 أو أكثر. ‫subscribedStatus وyoutubeProduct

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

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

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

المحتويات
الأبعاد:
مطلوب insightPlaybackLocationType
استخدِم 0 أو أكثر. ‫creatorContentType وday وliveOrOnDemand وsubscribedStatus
المقاييس:
استخدِم كلمة واحدة أو أكثر. المشاهدات وestimatedMinutesWatched
الفلاتر:
استخدِم 0 أو 1. country وprovince وcontinent وsubContinent
استخدِم 0 أو 1. فيديو، مجموعة
استخدِم 0 أو أكثر. ‫liveOrOnDemand وsubscribedStatus

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

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

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

المحتويات
الأبعاد:
مطلوب insightPlaybackLocationDetail
اختياري creatorContentType
المقاييس:
استخدِم كلمة واحدة أو أكثر. المشاهدات وestimatedMinutesWatched
الفلاتر:
مطلوب insightPlaybackLocationType==EMBEDDED
استخدِم 0 أو 1. country وprovince وcontinent وsubContinent
استخدِم 0 أو 1. فيديو، مجموعة
استخدِم 0 أو أكثر. ‫liveOrOnDemand وsubscribedStatus
خيارات الترتيب: -المشاهدات
-estimatedMinutesWatched

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

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

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

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

المحتويات
الأبعاد:
مطلوب insightTrafficSourceType
استخدِم 0 أو أكثر. ‫creatorContentType وday وliveOrOnDemand وsubscribedStatus
المقاييس:
استخدِم كلمة واحدة أو أكثر. المشاهدات وestimatedMinutesWatched
الفلاتر:
استخدِم 0 أو 1. country وprovince وcontinent وsubContinent
استخدِم 0 أو 1. فيديو، مجموعة
استخدِم 0 أو أكثر. ‫liveOrOnDemand وsubscribedStatus

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

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

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

المحتويات
الأبعاد:
مطلوب insightTrafficSourceDetail
اختياري creatorContentType
المقاييس:
استخدِم كلمة واحدة أو أكثر. المشاهدات وestimatedMinutesWatched
الفلاتر:
مطلوب insightTrafficSourceType (راجِع الملاحظة أدناه الجدول)
استخدِم 0 أو 1. country وprovince وcontinent وsubContinent
استخدِم 0 أو 1. فيديو، مجموعة
استخدِم 0 أو أكثر. ‫liveOrOnDemand وsubscribedStatus
خيارات الترتيب: -المشاهدات
-estimatedMinutesWatched

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

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

نوع الجهاز

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

المحتويات
الأبعاد:
مطلوب deviceType
استخدِم 0 أو أكثر. ‫creatorContentType وday وliveOrOnDemand وsubscribedStatus وyoutubeProduct
المقاييس:
استخدِم كلمة واحدة أو أكثر. المشاهدات وestimatedMinutesWatched
الفلاتر:
استخدِم 0 أو 1. country وprovince وcontinent وsubContinent
استخدِم 0 أو 1. فيديو، مجموعة
استخدِم 0 أو أكثر. ‫operatingSystem وliveOrOnDemand وsubscribedStatus وyoutubeProduct

نظام التشغيل

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

المحتويات
الأبعاد:
مطلوب operatingSystem
استخدِم 0 أو أكثر. ‫creatorContentType وday وliveOrOnDemand وsubscribedStatus وyoutubeProduct
المقاييس:
استخدِم كلمة واحدة أو أكثر. المشاهدات وestimatedMinutesWatched
الفلاتر:
استخدِم 0 أو 1. country وprovince وcontinent وsubContinent
استخدِم 0 أو 1. فيديو، مجموعة
استخدِم 0 أو أكثر. ‫deviceType وliveOrOnDemand وsubscribedStatus وyoutubeProduct

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

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

المحتويات
الأبعاد:
مطلوب ‫deviceType وoperatingSystem
استخدِم 0 أو أكثر. ‫creatorContentType وday وliveOrOnDemand وsubscribedStatus وyoutubeProduct
المقاييس:
استخدِم كلمة واحدة أو أكثر. المشاهدات وestimatedMinutesWatched
الفلاتر:
استخدِم 0 أو 1. country وprovince وcontinent وsubContinent
استخدِم 0 أو 1. فيديو، مجموعة
استخدِم 0 أو أكثر. ‫liveOrOnDemand وsubscribedStatus وyoutubeProduct

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

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

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

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

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

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

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

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

  • إحصاءات دقيقة حول المشاهدة

    تقدّم هذه المقاييس معلومات عن عدد المرات التي تمت فيها مشاهدة أجزاء معيّنة من الفيديو.

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

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

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

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

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

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

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

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

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

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

المحتويات
الأبعاد:
مطلوب فيديو
اختياري creatorContentType
المقاييس:
استخدِم كلمة واحدة أو أكثر. مرّات المشاهدة وredViews والتعليقات والمعجبون وغير المعجبون وvideosAddedToPlaylists وvideosRemovedFromPlaylists والمشاركات و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* والأرباح لكل ألف ظهور*
الفلاتر:
استخدِم 0 أو 1. country وcontinent وsubContinent
خيارات الترتيب: -views
-redViews
-estimatedRevenue
-estimatedRedPartnerRevenue
-estimatedMinutesWatched
-estimatedRedMinutesWatched
-subscribersGained
-subscribersLost

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

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

المحتويات
الأبعاد:
مطلوب فيديو
اختياري creatorContentType
المقاييس:
استخدِم كلمة واحدة أو أكثر. 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. يتيح لك التقرير السابق استرداد أهم الفيديوهات في ولاية أمريكية معيّنة للمشاهدين المشتركين أو غير المشتركين في قناتك، ولكنه يتضمّن عددًا أقل من المقاييس مقارنةً بهذا التقرير.

المحتويات
الأبعاد:
مطلوب فيديو
اختياري creatorContentType
المقاييس:
استخدِم كلمة واحدة أو أكثر. مرّات المشاهدة وredViews وعدد المعجبين وعدد غير المعجبين وvideosAddedToPlaylists وvideosRemovedFromPlaylists وعدد المشاركات و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.

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

أهمّ الفيديوهات التي تتضمّن فلاتر تفاصيل التشغيل (<= 200 نتيجة)

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

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

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

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

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

توضِّح ملاحظة التحذير التالية التغييرات بين نسختَي التقرير بمزيد من التفصيل.

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

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

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

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

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

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

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

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

استخدام isCurated
المحتويات
الأبعاد:
[بدون]
المقاييس:
استخدِم كلمة واحدة أو أكثر. المشاهدات وredViews وestimatedMinutesWatched وestimatedRedMinutesWatched وaverageViewDuration وplaylistStarts وviewsPerPlaylistStart وaverageTimeInPlaylist
الفلاتر:
مطلوب isCurated==1
استخدِم 0 أو 1. قائمة تشغيل، مجموعة
استخدِم 0 أو 1. country وprovince وcontinent وsubContinent
استخدِم 0 أو أكثر. ‫subscribedStatus وyoutubeProduct

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

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

استخدام isCurated
المحتويات
الأبعاد:
استخدِم 1 فقط. day وmonth
استخدِم 0 أو أكثر. ‫subscribedStatus وyoutubeProduct
المقاييس:
استخدِم كلمة واحدة أو أكثر. المشاهدات وredViews وestimatedMinutesWatched وestimatedRedMinutesWatched وaverageViewDuration وplaylistStarts وviewsPerPlaylistStart وaverageTimeInPlaylist
الفلاتر:
مطلوب isCurated==1
استخدِم 0 أو 1. قائمة تشغيل، مجموعة
استخدِم 0 أو 1. country وprovince وcontinent وsubContinent
استخدِم 0 أو أكثر. ‫subscribedStatus وyoutubeProduct

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

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

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

استخدام isCurated
المحتويات
الأبعاد:
مطلوب country
استخدِم 0 أو أكثر. ‫subscribedStatus وyoutubeProduct
المقاييس:
استخدِم كلمة واحدة أو أكثر. المشاهدات وredViews وestimatedMinutesWatched وestimatedRedMinutesWatched وaverageViewDuration وplaylistStarts وviewsPerPlaylistStart وaverageTimeInPlaylist
الفلاتر:
مطلوب isCurated==1
استخدِم 0 أو 1. قائمة تشغيل، مجموعة
استخدِم 0 أو 1. continent، subContinent
استخدِم 0 أو أكثر. ‫subscribedStatus وyoutubeProduct

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

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

استخدام isCurated
المحتويات
الأبعاد:
مطلوب province
المقاييس:
استخدِم كلمة واحدة أو أكثر. المشاهدات وredViews وestimatedMinutesWatched وestimatedRedMinutesWatched وaverageViewDuration وplaylistStarts وviewsPerPlaylistStart وaverageTimeInPlaylist
الفلاتر:
مطلوب isCurated==1;country==US
استخدِم 0 أو 1. قائمة تشغيل، مجموعة
استخدِم 0 أو أكثر. ‫subscribedStatus وyoutubeProduct

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

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

استخدام isCurated
المحتويات
الأبعاد:
مطلوب insightPlaybackLocationType
استخدِم 0 أو أكثر. day، subscribedStatus
المقاييس:
استخدِم كلمة واحدة أو أكثر. المشاهدات وestimatedMinutesWatched وplaylistStarts وviewsPerPlaylistStart وaverageTimeInPlaylist
الفلاتر:
مطلوب isCurated==1
استخدِم 0 أو 1. قائمة تشغيل، مجموعة
استخدِم 0 أو 1. country وprovince وcontinent وsubContinent
اختياري subscribedStatus

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

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

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

ملاحظة
المحتويات
الأبعاد:
مطلوب insightPlaybackLocationDetail
المقاييس:
استخدِم كلمة واحدة أو أكثر. المشاهدات وestimatedMinutesWatched وaverageViewDuration وaverageTimeInPlaylist وplaylistAverageViewDuration وplaylistEstimatedMinutesWatched وplaylistStarts وplaylistViews وviewsPerPlaylistStart
الفلاتر:
مطلوب insightPlaybackLocationType==EMBEDDED
استخدِم 1 فقط. قائمة تشغيل، مجموعة
خيارات الترتيب: -playlistViews
-playlistEstimatedMinutesWatched
-playlistStarts
استخدام isCurated
المحتويات
الأبعاد:
مطلوب insightPlaybackLocationDetail
المقاييس:
استخدِم كلمة واحدة أو أكثر. المشاهدات وestimatedMinutesWatched وplaylistStarts وviewsPerPlaylistStart وaverageTimeInPlaylist
الفلاتر:
مطلوب isCurated==1;insightPlaybackLocationType==EMBEDDED
استخدِم 0 أو 1. قائمة تشغيل، مجموعة
استخدِم 0 أو 1. country وprovince وcontinent وsubContinent
اختياري subscribedStatus
خيارات الترتيب: -views
-estimatedMinutesWatched
-playlistStarts

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

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

استخدام isCurated
المحتويات
الأبعاد:
مطلوب insightTrafficSourceType
استخدِم 0 أو أكثر. day، subscribedStatus
المقاييس:
استخدِم كلمة واحدة أو أكثر. المشاهدات وestimatedMinutesWatched وplaylistStarts وviewsPerPlaylistStart وaverageTimeInPlaylist
الفلاتر:
مطلوب isCurated==1
استخدِم 0 أو 1. قائمة تشغيل، مجموعة
استخدِم 0 أو 1. country وprovince وcontinent وsubContinent
اختياري subscribedStatus

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

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

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

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

إجراءات مقترَحة
المحتويات
الأبعاد:
مطلوب insightTrafficSourceDetail
المقاييس:
استخدِم كلمة واحدة أو أكثر. المشاهدات وestimatedMinutesWatched وaverageViewDuration وaverageTimeInPlaylist وplaylistAverageViewDuration وplaylistEstimatedMinutesWatched وplaylistSaves وplaylistStarts وplaylistViews وviewsPerPlaylistStart
الفلاتر:
مطلوب insightTrafficSourceType==ADVERTISING (أو قيمة أخرى متوافقة)
استخدِم 1 فقط. قائمة تشغيل، مجموعة
خيارات الترتيب: -playlistViews
-playlistEstimatedMinutesWatched
-playlistStarts
استخدام isCurated
المحتويات
الأبعاد:
مطلوب insightTrafficSourceDetail
المقاييس:
استخدِم كلمة واحدة أو أكثر. المشاهدات وestimatedMinutesWatched وplaylistStarts وviewsPerPlaylistStart وaverageTimeInPlaylist
الفلاتر:
مطلوب isCurated==1;insightTrafficSourceType==ADVERTISING (أو قيمة أخرى متوافقة)
استخدِم 0 أو 1. قائمة تشغيل، مجموعة
استخدِم 0 أو 1. country وprovince وcontinent وsubContinent
اختياري subscribedStatus
خيارات الترتيب: -views
-estimatedMinutesWatched
-playlistStarts

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

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

نوع الجهاز

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

استخدام isCurated
المحتويات
الأبعاد:
مطلوب deviceType
استخدِم 0 أو أكثر. ‫day وsubscribedStatus وyoutubeProduct
المقاييس:
استخدِم كلمة واحدة أو أكثر. المشاهدات وestimatedMinutesWatched وplaylistStarts وviewsPerPlaylistStart وaverageTimeInPlaylist
الفلاتر:
مطلوب isCurated==1
استخدِم 0 أو 1. قائمة تشغيل، مجموعة
استخدِم 0 أو 1. country وprovince وcontinent وsubContinent
استخدِم 0 أو أكثر. ‫operatingSystem وsubscribedStatus وyoutubeProduct

نظام التشغيل

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

استخدام isCurated
المحتويات
الأبعاد:
مطلوب operatingSystem
استخدِم 0 أو أكثر. ‫day وsubscribedStatus وyoutubeProduct
المقاييس:
استخدِم كلمة واحدة أو أكثر. المشاهدات وestimatedMinutesWatched وplaylistStarts وviewsPerPlaylistStart وaverageTimeInPlaylist
الفلاتر:
مطلوب isCurated==1
استخدِم 0 أو 1. قائمة تشغيل، مجموعة
استخدِم 0 أو 1. country وprovince وcontinent وsubContinent
استخدِم 0 أو أكثر. ‫deviceType وsubscribedStatus وyoutubeProduct

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

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

استخدام isCurated
المحتويات
الأبعاد:
مطلوب ‫deviceType وoperatingSystem
استخدِم 0 أو أكثر. ‫day وsubscribedStatus وyoutubeProduct
المقاييس:
استخدِم كلمة واحدة أو أكثر. المشاهدات وestimatedMinutesWatched وplaylistStarts وviewsPerPlaylistStart وaverageTimeInPlaylist
الفلاتر:
مطلوب isCurated==1
استخدِم 0 أو 1. قائمة تشغيل، مجموعة
استخدِم 0 أو 1. country وprovince وcontinent وsubContinent
استخدِم 0 أو أكثر. ‫subscribedStatus وyoutubeProduct

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

استخدام isCurated
المحتويات
الأبعاد:
استخدِم كلمة واحدة أو أكثر. ‫ageGroup وgender
استخدِم 0 أو أكثر. subscribedStatus
المقاييس:
مطلوب viewerPercentage
الفلاتر:
مطلوب isCurated==1
استخدِم 0 أو 1. قائمة تشغيل، مجموعة
استخدِم 0 أو 1. country وprovince وcontinent وsubContinent
اختياري subscribedStatus
ملاحظة: لا يتم توحيد قيم viewerPercentage في هذا التقرير لقيم مختلفة لسمة تفاصيل التشغيل subscribedStatus.

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

يمكنك استخدام الفلاتر للتأكّد من أنّ التقرير لا يحتوي إلا على بيانات viewerPercentage لقيمة واحدة من سمات subscribedStatus.

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

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

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

استخدام isCurated
المحتويات
الأبعاد:
مطلوب قائمة تشغيل
المقاييس:
استخدِم كلمة واحدة أو أكثر. المشاهدات وredViews وestimatedMinutesWatched وestimatedRedMinutesWatched وaverageViewDuration وplaylistStarts وviewsPerPlaylistStart وaverageTimeInPlaylist
الفلاتر:
مطلوب isCurated==1
استخدِم 0 أو 1. country وprovince وcontinent وsubContinent
استخدِم 0 أو أكثر. playlist وsubscribedStatus وyoutubeProduct
خيارات الترتيب: -views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched
-playlistStarts

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

عمليات إلغاء الاشتراكات

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

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

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

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

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

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

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

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

المحتويات
الأبعاد:
مطلوب adType
اختياري day
المقاييس:
استخدِم كلمة واحدة أو أكثر. ‫grossRevenue وadImpressions وcpm
الفلاتر:
استخدِم 0 أو 1. فيديو، مجموعة
استخدِم 0 أو 1. country وcontinent وsubContinent