YouTube Analytics API: Content Owner Reports

ملاحظة: Content owner reports are only accessible to YouTube content partners who participate in the YouTube Partner Program.

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

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

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

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

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

لاسترداد تقرير خاص بمالك المحتوى، استدعِ طريقة reports.query في واجهة برمجة التطبيقات واضبط قيمة المَعلمة ids في طلب البيانات من واجهة برمجة التطبيقات على contentOwner==OWNER_NAME، حيث يشير OWNER_NAME إلى رقم تعريف مالك المحتوى. في حال عدم التأكّد من القيمة، يُرجى سؤال مدير الشركاء.

التفويض

يجب أن يتم السماح بإرسال جميع طلبات البيانات من 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 أو السمة channel أو مجموعة متوافقة من السمتَين claimedStatus وuploaderType. (يتم إدراج المجموعات المتوافقة في تعريف السمة uploaderType).

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

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

راجِع تعريف المَعلمة 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.

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

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

  • تشير هذه المصطلحات إلى أنّ القيمة مطلوبة:
    • مطلوب: يجب تضمين القيمة.
    • استخدام قيمة واحدة بالضبط: يجب تضمين قيمة واحدة من المجموعة.
    • استخدام قيمة واحدة أو أكثر: يمكنك تضمين أيّ من القيم في المجموعة أو جميعها، ولكن يجب تضمين قيمة واحدة على الأقل.
  • تشير هذه المصطلحات إلى أنّ القيمة اختيارية:
    • اختياري: يمكنك تضمين القيمة.
    • استخدام 0 أو 1: يمكنك تضمين قيمة واحدة من المجموعة.
    • استخدام 0 أو أكثر: يمكنك تضمين أي قيم أو جميع القيم من المجموعة.
ملاحظة مهمة: يجب أن تفلتر جميع طلبات البيانات من واجهة برمجة التطبيقات لاسترداد تقارير الفيديوهات الخاصة بمالك المحتوى البيانات باستخدام السمة video أو السمة channel أو السمة group أو مجموعة متوافقة من السمتَين claimedStatus وuploaderType. (لا تتيح بعض التقارير كل هذه الخيارات). المجموعات المتوافقة، والتي يتم إدراجها أيضًا في تعريف السمة uploaderType، هي:
  • uploaderType==self
  • claimedStatus==claimed
  • claimedStatus==claimed;uploaderType==self
  • claimedStatus==claimed;uploaderType==thirdParty

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

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

الإحصاءات الأساسية (بما في ذلك عدد المشتركين)

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

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

إحصاءات أساسية خاصة بالولايات الأمريكية

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

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

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

النشاط خلال الفترات الزمنية

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

المحتويات
الأبعاد:
استخدام 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*
الفلاتر:
استخدام 1 بالضبط video أو channel أو group أو مجموعة متوافقة من uploaderType وclaimedStatus
استخدام 0 أو 1 country وcontinent وsubContinent

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

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

المحتويات
الأبعاد:
استخدام 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
الفلاتر:
استخدام 1 بالضبط video أو channel أو group أو مجموعة متوافقة من uploaderType وclaimedStatus
مطلوب province

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

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

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

المحتويات
الأبعاد:
مطلوب 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* وgrossRevenue* وestimatedRedPartnerRevenue* وmonetizedPlaybacks* وplaybackBasedCpm* وadImpressions* وcpm*
الفلاتر:
استخدام 1 بالضبط video أو channel أو group أو مجموعة متوافقة من uploaderType وclaimedStatus
استخدام 0 أو 1 continent, subContinent

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

يقدّم هذا التقرير إحصاءات عن نشاط المستخدمين في الولايات الأمريكية ومقاطعة كولومبيا. بالنسبة إلى هذا التقرير، يجب ضبط قيمة المَعلمة 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
الفلاتر:
استخدام 1 بالضبط video أو channel أو group أو مجموعة متوافقة من uploaderType وclaimedStatus
مطلوب country==US

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

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

  • هل كان الفيديو الذي شاهدته بثًا مباشرًا أم فيديو عند الطلب؟
  • هل كان المشاهد مشتركًا في القناة التي تملك الفيديو؟
  • على أي منتج من منتجات 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
الفلاتر:
استخدام 1 بالضبط video أو channel أو group أو مجموعة متوافقة من uploaderType وclaimedStatus
استخدام 0 أو 1 country وcontinent وsubContinent
اختياري 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
الفلاتر:
استخدام 1 بالضبط video أو channel أو group أو مجموعة متوافقة من uploaderType وclaimedStatus
مطلوب province
اختياري subscribedStatus

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

المحتويات
الأبعاد:
مطلوب insightTrafficSourceDetail
اختياري creatorContentType
المقاييس:
استخدام 1 أو أكثر engagedViews وviews وestimatedMinutesWatched
الفلاتر:
استخدام 1 بالضبط video أو channel أو group أو مجموعة متوافقة من uploaderType وclaimedStatus
مطلوب insightTrafficSourceType (راجِع الملاحظة أدناه الجدول)
استخدام 0 أو 1 country وprovince وcontinent وsubContinent
استخدام 0 أو أكثر liveOrOnDemand, subscribedStatus
خيارات الترتيب: -engagedViews
-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
الفلاتر:
استخدام 1 بالضبط video أو channel أو group أو مجموعة متوافقة من uploaderType وclaimedStatus
استخدام 0 أو 1 country وprovince وcontinent وsubContinent
استخدام 0 أو أكثر operatingSystem وliveOrOnDemand وsubscribedStatus وyoutubeProduct

نظام التشغيل

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

المحتويات
الأبعاد:
مطلوب 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* وgrossRevenue* وestimatedRedPartnerRevenue* وmonetizedPlaybacks* وplaybackBasedCpm* وadImpressions* وcpm*
الفلاتر:
استخدام 1 بالضبط channel أو مجموعة متوافقة من uploaderType وclaimedStatus
استخدام 0 أو 1 country وcontinent وsubContinent
خيارات الترتيب: -engagedViews
-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
الفلاتر:
استخدام 1 بالضبط channel أو مجموعة متوافقة من uploaderType وclaimedStatus
مطلوب province
خيارات الترتيب: -engagedViews
-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
الفلاتر:
استخدام 1 بالضبط channel أو مجموعة متوافقة من uploaderType وclaimedStatus
اختياري subscribedStatus
استخدام 0 أو 1 country وcontinent وsubContinent
خيارات الترتيب: -engagedViews
-views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

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

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

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

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

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

المحتويات
الأبعاد:
مطلوب video
اختياري creatorContentType
المقاييس:
استخدام 1 أو أكثر engagedViews وviews وredViews وestimatedMinutesWatched وestimatedRedMinutesWatched وaverageViewDuration
الفلاتر:
استخدام 1 بالضبط channel أو مجموعة متوافقة من uploaderType وclaimedStatus
استخدام 0 أو 1 country وprovince وcontinent وsubContinent
استخدام 0 أو أكثر liveOrOnDemand وsubscribedStatus وyoutubeProduct
خيارات الترتيب: -engagedViews
-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
الفلاتر:
استخدام 0 أو 1* قائمة التشغيل أو المجموعة

ملاحظة: يجب تحديد أحد الفلترَين فقط إذا تم طلب أي من المقاييس views أو estimatedMinutesWatched أو averageViewDuration في التقرير.
اختياري channel

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

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

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

ملاحظة: يجب تحديد أحد الفلترَين فقط إذا تم طلب أي من المقاييس views أو estimatedMinutesWatched أو averageViewDuration في التقرير.
اختياري channel

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

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

يقدّم هذا التقرير إحصاءات قوائم التشغيل حسب البلد.

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

ملاحظة: يجب تحديد أحد الفلترَين فقط إذا تم طلب أي من المقاييس views أو estimatedMinutesWatched أو averageViewDuration في التقرير.
استخدام 0 أو 1 continent, subContinent
اختياري channel

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

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

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

ملاحظة: يجب تحديد أحد الفلترَين فقط إذا تم طلب أي من المقاييس views أو estimatedMinutesWatched أو averageViewDuration في التقرير.
اختياري channel

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

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

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

ملاحظة: يجب تحديد أحد الفلترَين فقط إذا تم طلب أي من المقاييس views أو estimatedMinutesWatched أو averageViewDuration في التقرير.
اختياري channel

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

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

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

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

ملاحظة: يجب تحديد أحد الفلترَين فقط إذا تم طلب أي من المقاييس views أو estimatedMinutesWatched أو averageViewDuration في التقرير.
اختياري channel
خيارات الترتيب: -playlistViews
-playlistEstimatedMinutesWatched
-playlistStarts

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

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

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

ملاحظة: يجب تحديد أحد الفلترَين فقط إذا تم طلب أي من المقاييس views أو estimatedMinutesWatched أو averageViewDuration في التقرير.
اختياري channel

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

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

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

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

ملاحظة: يجب تحديد أحد الفلترَين فقط إذا تم طلب أي من المقاييس views أو estimatedMinutesWatched أو averageViewDuration في التقرير.
اختياري channel
خيارات الترتيب: -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
الفلاتر:
استخدام 0 أو 1* قائمة التشغيل أو المجموعة

ملاحظة: يجب تحديد أحد الفلترَين فقط إذا تم طلب أي من المقاييس views أو estimatedMinutesWatched أو averageViewDuration في التقرير.
اختياري channel

نظام التشغيل لقوائم التشغيل

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

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

ملاحظة: يجب تحديد أحد الفلترَين فقط إذا تم طلب أي من المقاييس views أو estimatedMinutesWatched أو averageViewDuration في التقرير.
اختياري channel

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

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

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

ملاحظة: يجب تحديد أحد الفلترَين فقط إذا تم طلب أي من المقاييس views أو estimatedMinutesWatched أو averageViewDuration في التقرير.
اختياري channel

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

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

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

ملاحظة: يجب تحديد أحد الفلترَين فقط إذا تم طلب أي من المقاييس views أو estimatedMinutesWatched أو averageViewDuration في التقرير.
اختياري channel
ملاحظة: لا يتم تعديل قيم viewerPercentage في هذا التقرير لتناسب القيم المختلفة أو مجموعات القيم المختلفة لأبعاد تفاصيل التشغيل (subscribedStatus وyoutubeProduct).

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

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

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

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

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

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

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

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

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

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

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

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

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