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

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

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

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

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

المحتويات
الأبعاد:
[بدون]
المقاييس:
استخدام رقم واحد أو أكثر ‫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

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

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

المحتويات
الأبعاد:
[بدون]
المقاييس:
استخدام رقم واحد أو أكثر ‫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
المقاييس:
استخدام رقم واحد أو أكثر ‫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
المقاييس:
استخدام رقم واحد أو أكثر ‫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
المقاييس:
استخدام رقم واحد أو أكثر ‫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
المقاييس:
استخدام رقم واحد أو أكثر ‫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

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

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

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

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

ملاحظة: إذا أدرجت السمة province، عليك أيضًا استخدام الفلتر country==US.
استخدِم 0 أو 1 day، month
المقاييس:
استخدام رقم واحد أو أكثر ‫engagedViews وviews وestimatedMinutesWatched وaverageViewDuration وaverageViewPercentage
الفلاتر:
استخدام 1 بالضبط video أو channel أو group أو مجموعة متوافقة من uploaderType وclaimedStatus
استخدِم 0 أو 1 country وprovince وcontinent وsubContinent
خيارات الترتيب: -engagedViews
-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
الفلاتر:
استخدام 1 بالضبط video أو channel أو group أو مجموعة متوافقة من uploaderType وclaimedStatus
استخدِم 0 أو 1 country وcontinent وsubContinent
اختياري 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
الفلاتر:
استخدام 1 بالضبط video أو channel أو group أو مجموعة متوافقة من uploaderType وclaimedStatus
مطلوب province
اختياري subscribedStatus

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

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

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

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

المحتويات
الأبعاد:
استخدِم 0 أو أكثر ‫creatorContentType وliveOrOnDemand وsubscribedStatus وyoutubeProduct
استخدِم 0 أو 1 day، month
المقاييس:
استخدام رقم واحد أو أكثر ‫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
المقاييس:
استخدام رقم واحد أو أكثر ‫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
المقاييس:
استخدام رقم واحد أو أكثر ‫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
المقاييس:
استخدام رقم واحد أو أكثر ‫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
المقاييس:
استخدام رقم واحد أو أكثر ‫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
المقاييس:
استخدام رقم واحد أو أكثر ‫engagedViews وviews وredViews وestimatedMinutesWatched وestimatedRedMinutesWatched وaverageViewDuration وaverageViewPercentage
الفلاتر:
استخدام 1 بالضبط video أو channel أو group أو مجموعة متوافقة من uploaderType وclaimedStatus
مطلوب البلد==US
استخدِم 0 أو أكثر subscribedStatus وyoutubeProduct

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

المحتويات
الأبعاد:
مطلوب video
اختياري creatorContentType
المقاييس:
استخدام رقم واحد أو أكثر ‫engagedViews وviews وredViews وestimatedMinutesWatched وestimatedRedMinutesWatched وaverageViewDuration
الفلاتر:
استخدام 1 بالضبط قناة أو مجموعة متوافقة من 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

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

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

المحتويات
الأبعاد:
[بدون]
المقاييس:
استخدام رقم واحد أو أكثر ‫engagedViews وviews وestimatedMinutesWatched وaverageViewDuration وaverageTimeInPlaylist وplaylistAverageViewDuration وplaylistEstimatedMinutesWatched وplaylistSaves وplaylistStarts وplaylistViews وviewsPerPlaylistStart
الفلاتر:
استخدام 0 أو 1* playlist، group

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

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

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

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

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

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

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

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

المحتويات
الأبعاد:
مطلوب country
المقاييس:
استخدام رقم واحد أو أكثر ‫engagedViews وviews وestimatedMinutesWatched وaverageViewDuration
الفلاتر:
استخدام 0 أو 1* playlist، group

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

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

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

المحتويات
الأبعاد:
مطلوب province
المقاييس:
استخدام رقم واحد أو أكثر ‫engagedViews وviews وestimatedMinutesWatched وaverageViewDuration
الفلاتر:
مطلوب البلد==US
استخدام 0 أو 1* playlist، group

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

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

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

المحتويات
الأبعاد:
مطلوب insightPlaybackLocationType
المقاييس:
استخدام رقم واحد أو أكثر ‫engagedViews وviews وestimatedMinutesWatched وaverageViewDuration وaverageTimeInPlaylist وplaylistAverageViewDuration وplaylistEstimatedMinutesWatched وplaylistStarts وplaylistViews وviewsPerPlaylistStart
الفلاتر:
استخدام 0 أو 1* playlist، group

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

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

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

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

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

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

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

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

المحتويات
الأبعاد:
مطلوب insightTrafficSourceType
المقاييس:
استخدام رقم واحد أو أكثر ‫engagedViews وviews وestimatedMinutesWatched وaverageViewDuration وaverageTimeInPlaylist وplaylistAverageViewDuration وplaylistEstimatedMinutesWatched وplaylistSaves وplaylistStarts وplaylistViews وviewsPerPlaylistStart
الفلاتر:
استخدام 0 أو 1* playlist، group

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

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

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

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

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

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

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

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

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

المحتويات
الأبعاد:
مطلوب operatingSystem
المقاييس:
استخدام رقم واحد أو أكثر ‫engagedViews وviews وestimatedMinutesWatched وaverageViewDuration وaverageTimeInPlaylist وplaylistAverageViewDuration وplaylistEstimatedMinutesWatched وplaylistStarts وplaylistViews وviewsPerPlaylistStart
الفلاتر:
استخدام 0 أو 1* playlist، group

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

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

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

المحتويات
الأبعاد:
مطلوب deviceType وoperatingSystem
المقاييس:
استخدام رقم واحد أو أكثر ‫engagedViews وviews وestimatedMinutesWatched وaverageViewDuration وaverageTimeInPlaylist وplaylistAverageViewDuration وplaylistEstimatedMinutesWatched وplaylistStarts وplaylistViews وviewsPerPlaylistStart
الفلاتر:
استخدام 0 أو 1* playlist، group

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

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

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

المحتويات
الأبعاد:
استخدام رقم واحد أو أكثر ageGroup، gender
المقاييس:
مطلوب viewerPercentage
الفلاتر:
استخدام 0 أو 1* playlist، group

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

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

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

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

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

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

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

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

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

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

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

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

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

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