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

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

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

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

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

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

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

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

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

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

الإحصاءات الأساسية لولايات الولايات المتحدة

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

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

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

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

المحتويات
الأبعاد:
استخدِم 1 فقط. day وmonth
اختياري creatorContentType
المقاييس:
استخدِم كلمة واحدة أو أكثر. 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
المقاييس:
استخدِم كلمة واحدة أو أكثر. مرّات المشاهدة و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* والأرباح لكل ألف ظهور*
الفلاتر:
استخدِم 1 فقط. video أو channel أو group أو مجموعة متوافقة من uploaderType وclaimedStatus
استخدِم 0 أو 1. continent، subContinent

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

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

المحتويات
الأبعاد:
مطلوب province
اختياري creatorContentType
المقاييس:
استخدِم كلمة واحدة أو أكثر. 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
المقاييس:
استخدِم كلمة واحدة أو أكثر. المشاهدات وestimatedMinutesWatched وaverageViewDuration وaverageViewPercentage
الفلاتر:
استخدِم 1 فقط. video أو channel أو group أو مجموعة متوافقة من uploaderType وclaimedStatus
استخدِم 0 أو 1. country وprovince وcontinent وsubContinent
خيارات الترتيب: -المشاهدات
-estimatedMinutesWatched

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

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

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

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

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

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

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

المحتويات
الأبعاد:
استخدِم 0 أو أكثر. creatorContentType وsubscribedStatus
استخدِم 0 أو 1. day وmonth
المقاييس:
استخدِم كلمة واحدة أو أكثر. مرّات المشاهدة وredViews وعدد المعجبين وعدد غير المعجبين وvideosAddedToPlaylists وvideosRemovedFromPlaylists وعدد المشاركات و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
المقاييس:
استخدِم كلمة واحدة أو أكثر. 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
المقاييس:
استخدِم كلمة واحدة أو أكثر. المشاهدات و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
المقاييس:
استخدِم كلمة واحدة أو أكثر. المشاهدات و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
المقاييس:
استخدِم كلمة واحدة أو أكثر. المشاهدات و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
المقاييس:
استخدِم كلمة واحدة أو أكثر. المشاهدات و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
المقاييس:
استخدِم كلمة واحدة أو أكثر. المشاهدات وredViews وestimatedMinutesWatched وestimatedRedMinutesWatched وaverageViewDuration
الفلاتر:
استخدِم 1 فقط. video أو channel أو group أو مجموعة متوافقة من uploaderType وclaimedStatus
مطلوب country==US
استخدِم 0 أو أكثر. liveOrOnDemand وsubscribedStatus وyoutubeProduct
تفاصيل التشغيل حسب المقاطعة باستخدام مقياس averageViewPercentage

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

نوع الجهاز

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

المحتويات
الأبعاد:
مطلوب deviceType
استخدِم 0 أو أكثر. creatorContentType وday وliveOrOnDemand وsubscribedStatus وyoutubeProduct
المقاييس:
استخدِم كلمة واحدة أو أكثر. المشاهدات و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
المقاييس:
استخدِم كلمة واحدة أو أكثر. المشاهدات و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
المقاييس:
استخدِم كلمة واحدة أو أكثر. المشاهدات و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
الفلاتر:
مطلوب فيديو
استخدِم 0 أو أكثر. audienceType وsubscribedStatus وyoutubeProduct

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ملاحظة
المحتويات
الأبعاد:
[بدون]
المقاييس:
استخدِم كلمة واحدة أو أكثر. المشاهدات وestimatedMinutesWatched وaverageViewDuration وaverageTimeInPlaylist وplaylistAverageViewDuration وplaylistEstimatedMinutesWatched وplaylistSaves وplaylistStarts وplaylistViews وviewsPerPlaylistStart
الفلاتر:
استخدِم 0 أو 1*. قائمة تشغيل أو مجموعة

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

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

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

إجراءات مقترَحة
المحتويات
الأبعاد:
استخدِم 1 فقط. day وmonth
المقاييس:
استخدِم كلمة واحدة أو أكثر. المشاهدات وestimatedMinutesWatched وaverageViewDuration وaverageTimeInPlaylist وplaylistAverageViewDuration وplaylistEstimatedMinutesWatched وplaylistSaves وplaylistStarts وplaylistViews وviewsPerPlaylistStart
الفلاتر:
استخدِم 0 أو 1*. قائمة تشغيل أو مجموعة

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

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

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

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

إجراءات مقترَحة
المحتويات
الأبعاد:
مطلوب country
المقاييس:
استخدِم كلمة واحدة أو أكثر. المشاهدات وestimatedMinutesWatched وaverageViewDuration
الفلاتر:
استخدِم 0 أو 1*. قائمة تشغيل أو مجموعة

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

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

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

إجراءات مقترَحة
المحتويات
الأبعاد:
مطلوب province
المقاييس:
استخدِم كلمة واحدة أو أكثر. المشاهدات وestimatedMinutesWatched وaverageViewDuration
الفلاتر:
مطلوب country==US
استخدِم 0 أو 1*. قائمة تشغيل أو مجموعة

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ملاحظة: يجب تحديد أحد هذين الفلترَين تحديدًا إذا تم طلب أي من مقاييس المشاهدات أو estimatedMinutesWatched أو averageViewDuration في التقرير.
اختياري channel
خيارات الترتيب: -playlistViews
-playlistEstimatedMinutesWatched
-playlistStarts
استخدام isCurated
المحتويات
الأبعاد:
مطلوب insightTrafficSourceDetail
المقاييس:
استخدِم كلمة واحدة أو أكثر. المشاهدات وestimatedMinutesWatched وplaylistStarts وviewsPerPlaylistStart وaverageTimeInPlaylist
الفلاتر:
مطلوب isCurated==1;insightTrafficSourceType
استخدِم 0 أو 1. country وprovince وcontinent وsubContinent
استخدِم 0 أو 1. قائمة تشغيل أو قناة أو مجموعة
اختياري subscribedStatus
خيارات الترتيب: -views
-estimatedMinutesWatched
-playlistStarts

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

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

نوع الجهاز المخصّص لقوائم التشغيل

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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