YouTube Analytics API: Channel Reports

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

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

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

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

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

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

  • channel==CHANNEL_ID – اضبط CHANNEL_ID على معرّف القناة الفريد للقناة التي تسترد بياناتها. يجب أن يكون المستخدم الذي يفوّض الطلب هو مالك القناة.

    معرّف القناة هو حاليًا سلسلة تبدأ بالحرفين UC، إلا أنّ تنسيقه عرضة للتغيير. (يمكنك العثور على معرّف قناتك في صفحة إعدادات الحساب المتقدّمة لقناتك على YouTube، أو يمكنك استرداد معرّف قناتك آليًا باستخدام طريقة channels.list YouTube Data API's).

التفويض

يجب الحصول على تفويض لجميع طلبات البيانات من YouTube Analytics API. يوضح دليل التفويض كيفية استخدام بروتوكول OAuth 2.0 لاسترداد رموز التفويض.

تستخدم طلبات البيانات من YouTube Analytics API نطاقات التفويض التالية:

المستويات
https://www.googleapis.com/auth/yt-analytics.readonly الاطّلاع على تقارير "إحصاءات YouTube" للمحتوى الخاص بك في YouTube يوفّر هذا النطاق إمكانية الوصول إلى مقاييس نشاط المستخدم، مثل عدد المشاهدات وأعداد التقييمات.
https://www.googleapis.com/auth/yt-analytics-monetary.readonly عرض تقارير "إحصاءات YouTube" المالية للمحتوى الخاص بك على YouTube يوفّر هذا النطاق إمكانية الوصول إلى مقاييس نشاط المستخدم والاطّلاع على الأرباح المقدّرة ومقاييس أداء الإعلانات.
https://www.googleapis.com/auth/youtube إدارة حسابك على YouTube في YouTube Analytics API، يستخدم مالكو القنوات هذا النطاق لإدارة مجموعات "إحصاءات YouTube" وعناصرها.
https://www.googleapis.com/auth/youtubepartner عرض وإدارة مواد العرض في YouTube والمحتوى المرتبط بها على YouTube في YouTube Analytics API، يستخدم مالكو المحتوى هذا النطاق لإدارة مجموعات "إحصاءات YouTube" وعناصرها.

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

فلاتر

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

الفهرس
الأبعاد:
[بدون]
المقاييس:
يمكنك استخدام عنصر واحد أو أكثر. <br class="ph-0-0=1="مَعلمة {2}-مَعلمة-لا تشملredViewsvideosAddedToPlaylistsvideosRemovedFromPlaylistsestimatedMinutesWatchedestimatedRedMinutesWatchedaverageViewDurationaverageViewPercentageannotationClickThroughRateannotationCloseRateannotationImpressionsannotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClickssubscribersGainedsubscribersLostestimatedRevenueestimatedAdRevenuegrossRevenueestimatedRedPartnerRevenuemonetizedPlaybacksplaybackBasedCpmadImpressions
الفلاتر
استخدِم 0 أو 1 البلد وقارة وsubContinent
استخدِم 0 أو 1 فيديو أو مجموعة

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

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

الفهرس
الأبعاد:
[بدون]
المقاييس:
يمكنك استخدام عنصر واحد أو أكثر. views ، redViews ، estimatedMinutesWatched estimatedRedMinutesWatched، averageViewDuration، averageViewPercentage، annotationClickThroughRate، annotationCloseRate، annotationImpressions،annotationImpressions،annotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClicks
الفلاتر
مطلوبة province
استخدِم 0 أو 1 فيديو أو مجموعة

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

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

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

الفهرس
الأبعاد:
استخدام قيمة واحدة بالضبط يوم، شهر
اختياري creatorContentType
المقاييس:
يمكنك استخدام عنصر واحد أو أكثر. {viewviews,redViews,comments, likes, dislikes, videosAddedToPlaylists, videosRemovedFromPlaylists, shares, estimatedMinutesWatched,estimatedRedMinutesWatched,videosلغات, videosRemovedFromPlaylists, shares, estimatedMinutesWatched,}notlikesViewers, videosRemovedFrom ينظر, shares, estimatedMinutesWatched, }‘ ستُعرض ما يلي:videosAddedToPlaylists.averageViewDurationaverageViewPercentageannotationClickThroughRateannotationCloseRateannotationImpressionsannotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClickssubscribersGainedsubscribersLostestimatedRevenueestimatedAdRevenuegrossRevenueestimatedRedPartnerRevenuemonetizedPlaybacksplaybackBasedCpmadImpressions
الفلاتر
استخدِم 0 أو 1 البلد وقارة وsubContinent
استخدِم 0 أو 1 فيديو أو مجموعة

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

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

الفهرس
الأبعاد:
استخدام قيمة واحدة بالضبط يوم، شهر
اختياري creatorContentType
المقاييس:
يمكنك استخدام عنصر واحد أو أكثر. views ، redViews ، estimatedMinutesWatched estimatedRedMinutesWatched، averageViewDuration، averageViewPercentage، annotationClickThroughRate، annotationCloseRate، annotationImpressions،annotationImpressions،annotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClicks
الفلاتر
مطلوبة province
استخدِم 0 أو 1 فيديو أو مجموعة

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

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

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

الفهرس
الأبعاد:
مطلوبة country
اختياري creatorContentType
المقاييس:
يمكنك استخدام عنصر واحد أو أكثر. <br class="ph-0-0=1="مَعلمة {2}-مَعلمة-لا تشملredViewsvideosAddedToPlaylistsvideosRemovedFromPlaylistsestimatedMinutesWatchedestimatedRedMinutesWatchedaverageViewDurationaverageViewPercentageannotationClickThroughRateannotationCloseRateannotationImpressionsannotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClickssubscribersGainedsubscribersLostestimatedRevenueestimatedAdRevenuegrossRevenueestimatedRedPartnerRevenuemonetizedPlaybacksplaybackBasedCpmadImpressions
الفلاتر
استخدِم 0 أو 1 قارة وsubContinent
استخدِم 0 أو 1 فيديو أو مجموعة

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

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

الفهرس
الأبعاد:
مطلوبة province
اختياري creatorContentType
المقاييس:
يمكنك استخدام عنصر واحد أو أكثر. views ، redViews ، estimatedMinutesWatched estimatedRedMinutesWatched، averageViewDuration، averageViewPercentage، annotationClickThroughRate، annotationCloseRate، annotationImpressions،annotationImpressions،annotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClicks
الفلاتر
مطلوبة البلد==US
استخدِم 0 أو 1 فيديو أو مجموعة

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

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

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

الفهرس
الأبعاد:
مطلوبة city
استخدِم 0 أو أكثر creatorContentType، البلد، الإقليم، subscribedStatus

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

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

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

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

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

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

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

الفهرس
الأبعاد:
استخدِم 0 أو أكثر creatorContentType، subscribedStatus
استخدِم 0 أو 1 يوم، شهر
المقاييس:
يمكنك استخدام عنصر واحد أو أكثر. views ، redViews ، likes ، dislikes، videosAddedToPlaylists، videosRemovedFromPlaylists، shares، estimatedMinutesWatched، estimatedRedMinutesWatched,averageViewDurationaverageViewPercentageannotationClickThroughRateannotationCloseRateannotationImpressionsannotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClicks
الفلاتر
استخدِم 0 أو 1 البلد وقارة وsubContinent
استخدِم 0 أو 1 فيديو أو مجموعة
اختياري subscribedStatus

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

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

الفهرس
الأبعاد:
استخدِم 0 أو أكثر creatorContentType، subscribedStatus
استخدِم 0 أو 1 يوم، شهر
المقاييس:
يمكنك استخدام عنصر واحد أو أكثر. views ، redViews ، estimatedMinutesWatched estimatedRedMinutesWatched، averageViewDuration، averageViewPercentage، annotationClickThroughRate، annotationCloseRate، annotationImpressions،annotationImpressions،annotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClicks
الفلاتر
استخدِم 0 أو 1 فيديو أو مجموعة
استخدِم 0 أو أكثر الإقليم، subscribedStatus

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ملاحظة: لا يتوفّر هذا التقرير إلّا لمصادر زيارات محدَّدة. على سبيل المثال، لا يحتوي مصدر الزيارات NO_LINK_EMBEDDED على تفاصيل إضافية، وبالتالي لا يتيح استخدام هذا التقرير. يُرجى الاطّلاع على تعريف insightTrafficSourceType لمعرفة تفاصيل عن مصادر الزيارات التي تتوافق مع هذا التقرير.

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

نوع الجهاز

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

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

نظام التشغيل

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

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

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

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

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

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

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

الفهرس
الأبعاد:
يمكنك استخدام عنصر واحد أو أكثر. ageGroup وgender
استخدِم 0 أو أكثر creatorContentType، liveOrOnDemand، subscribedStatus
المقاييس:
يمكنك استخدام عنصر واحد أو أكثر. viewerPercentage
الفلاتر
استخدِم 0 أو 1 البلد والإقليم والقارة وsubContinent
استخدِم 0 أو 1 فيديو أو مجموعة
استخدِم 0 أو أكثر liveOrOnDemand وsubscribedStatus
ملاحظة: لا تتم تسوية قيم viewerPercentage في هذا التقرير مع القيم أو مجموعات القيم المختلفة لسمات تفاصيل التشغيل (subscribedStatus أو liveOrOnDemand أو youtubeProduct).

على سبيل المثال، يعرض تقرير يستخدم سمة subscribedStatus البيانات viewerPercentageviewerPercentage (تبلغ القيمة الإجمالية لجميع حقول viewerPercentage في التقرير 200 في المئة.)

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

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

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

الفهرس
الأبعاد:
مطلوبة sharingService
استخدِم 0 أو أكثر creatorContentType، subscribedStatus
المقاييس:
يمكنك استخدام عنصر واحد أو أكثر. مشاركة
الفلاتر
استخدِم 0 أو 1 البلد وقارة وsubContinent
استخدِم 0 أو 1 فيديو أو مجموعة
اختياري subscribedStatus

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

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

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

الفهرس
الأبعاد:
مطلوبة elapsedVideoTimeRatio
اختياري creatorContentType
المقاييس:
يمكنك استخدام عنصر واحد أو أكثر. audienceWatchRatio، relativeRetentionPerformance
الفلاتر
مطلوبة فيديو
استخدِم 0 أو أكثر audienceType وsubscribedStatus وyoutubeProduct

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

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

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

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

الفهرس
الأبعاد:
مطلوبة فيديو
اختياري creatorContentType
المقاييس:
يمكنك استخدام عنصر واحد أو أكثر. <br class="ph-0-0=1="مَعلمة {2}-مَعلمة-لا تشملredViewsvideosAddedToPlaylistsvideosRemovedFromPlaylistsestimatedMinutesWatchedestimatedRedMinutesWatchedaverageViewDurationaverageViewPercentageannotationClickThroughRateannotationCloseRateannotationImpressionsannotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClickssubscribersGainedsubscribersLostestimatedRevenueestimatedAdRevenuegrossRevenueestimatedRedPartnerRevenuemonetizedPlaybacksplaybackBasedCpmadImpressions
الفلاتر
استخدِم 0 أو 1 البلد وقارة وsubContinent
خيارات الترتيب: -views
-redViews
-estimatedRevenue
-estimatedRedPartnerRevenue
-estimatedMinutesWatched
-estimatedRedMinutesWatched
-subscribersGained
-subscribersLost

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

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

الفهرس
الأبعاد:
مطلوبة فيديو
اختياري creatorContentType
المقاييس:
يمكنك استخدام عنصر واحد أو أكثر. views ، redViews ، estimatedMinutesWatched estimatedRedMinutesWatched، averageViewDuration، averageViewPercentage، annotationClickThroughRate، annotationCloseRate، annotationImpressions،annotationImpressions،annotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClicks
الفلاتر
مطلوبة province
اختياري subscribedStatus
خيارات الترتيب: -views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

أبرز الفيديوهات للمشاهدين المشتركين أو غير المشتركين(<= 200 نتيجة)

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

الفهرس
الأبعاد:
مطلوبة فيديو
اختياري creatorContentType
المقاييس:
يمكنك استخدام عنصر واحد أو أكثر. views ، redViews ، likes ، dislikes، videosAddedToPlaylists، videosRemovedFromPlaylists، shares، estimatedMinutesWatched، estimatedRedMinutesWatched,averageViewDurationaverageViewPercentageannotationClickThroughRateannotationCloseRateannotationImpressionsannotationClickableImpressionsannotationClosableImpressionsannotationClicksannotationClosescardClickRatecardTeaserClickRatecardImpressionscardTeaserImpressionscardClickscardTeaserClicks
الفلاتر
اختياري subscribedStatus
استخدِم 0 أو 1 البلد وقارة وsubContinent
خيارات الترتيب: -views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

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

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

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

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

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

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

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

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

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

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

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

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

يمكنك مراجعة القسم مقاييس قوائم التشغيل المتوافقة للاطّلاع على قائمة بمقاييس الفيديو المجمّعة المتوافقة مع YouTube.

المقاييس في قائمة التشغيل

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

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

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

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

باستخدام isCurated
الفهرس
الأبعاد:
[بدون]
المقاييس:
يمكنك استخدام عنصر واحد أو أكثر. views وredViews وestimatedMinutesWatched وestimatedRedMinutesWatched وaverageViewDuration وplaylistStarts وviewsPerPlaylistStart وaverageTimeInPlaylist
الفلاتر
مطلوبة isCurated==1
استخدِم 0 أو 1 playlist وgroup
استخدِم 0 أو 1 البلد والإقليم والقارة وsubContinent
استخدِم 0 أو أكثر subscribedStatus، youtubeProduct

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

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

مقترَح
الفهرس
الأبعاد:
استخدام قيمة واحدة بالضبط يوم، شهر
المقاييس:
يمكنك استخدام عنصر واحد أو أكثر. مشاهدات، وestimatedMinutesWatched، وaverageViewDuration، وaverageTimeInPlaylist، وplaylistAverageViewDuration، وplaylistEstimatedMinutesWatched، وplaylistSaves، وplaylistStarts، وplaylistViews، وviewsPerPlaylistStart
الفلاتر
استخدام قيمة واحدة بالضبط playlist وgroup
باستخدام isCurated
الفهرس
الأبعاد:
استخدام قيمة واحدة بالضبط يوم، شهر
استخدِم 0 أو أكثر subscribedStatus، youtubeProduct
المقاييس:
يمكنك استخدام عنصر واحد أو أكثر. views وredViews وestimatedMinutesWatched وestimatedRedMinutesWatched وaverageViewDuration وplaylistStarts وviewsPerPlaylistStart وaverageTimeInPlaylist
الفلاتر
مطلوبة isCurated==1
استخدِم 0 أو 1 playlist وgroup
استخدِم 0 أو 1 البلد والإقليم والقارة وsubContinent
استخدِم 0 أو أكثر subscribedStatus، youtubeProduct

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

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

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

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

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

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

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

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

باستخدام isCurated
الفهرس
الأبعاد:
مطلوبة insightPlaybackLocationType
استخدِم 0 أو أكثر اليوم، subscribedStatus
المقاييس:
يمكنك استخدام عنصر واحد أو أكثر. مشاهدة، وestimatedMinutesWatched، وplaylistStarts، وviewsPerPlaylistStart، وaverageTimeInPlaylist
الفلاتر
مطلوبة isCurated==1
استخدِم 0 أو 1 playlist وgroup
استخدِم 0 أو 1 البلد والإقليم والقارة وsubContinent
اختياري subscribedStatus

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

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

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

مقترَح
الفهرس
الأبعاد:
مطلوبة insightPlaybackLocationDetail
المقاييس:
يمكنك استخدام عنصر واحد أو أكثر. مشاهدات، وestimatedMinutesWatched، وaverageViewDuration، وaverageTimeInPlaylist، وplaylistAverageViewDuration، وplaylistEstimatedMinutesWatched، وplaylistStarts، وplaylistViews، وviewsPerPlaylistStart
الفلاتر
مطلوبة insightPlaybackLocationType==EMBEDDED
استخدام قيمة واحدة بالضبط playlist وgroup
خيارات الترتيب: -playlistViews
-playlistEstimatedMinutesWatched
-playlistStarts
باستخدام isCurated
الفهرس
الأبعاد:
مطلوبة insightPlaybackLocationDetail
المقاييس:
يمكنك استخدام عنصر واحد أو أكثر. مشاهدة، وestimatedMinutesWatched، وplaylistStarts، وviewsPerPlaylistStart، وaverageTimeInPlaylist
الفلاتر
مطلوبة isCurated==1;insightPlaybackLocationType==EMBEDDED
استخدِم 0 أو 1 playlist وgroup
استخدِم 0 أو 1 البلد والإقليم والقارة وsubContinent
اختياري subscribedStatus
خيارات الترتيب: -views
-estimatedMinutesWatched
-playlistStarts

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

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

باستخدام isCurated
الفهرس
الأبعاد:
مطلوبة insightTrafficSourceType
استخدِم 0 أو أكثر اليوم، subscribedStatus
المقاييس:
يمكنك استخدام عنصر واحد أو أكثر. مشاهدة، وestimatedMinutesWatched، وplaylistStarts، وviewsPerPlaylistStart، وaverageTimeInPlaylist
الفلاتر
مطلوبة isCurated==1
استخدِم 0 أو 1 playlist وgroup
استخدِم 0 أو 1 البلد والإقليم والقارة وsubContinent
اختياري subscribedStatus

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

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

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

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

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

ملاحظة: لا يتوفّر هذا التقرير إلّا لمصادر زيارات محدَّدة. على سبيل المثال، لا يحتوي مصدر الزيارات NO_LINK_EMBEDDED على تفاصيل إضافية، وبالتالي لا يتيح استخدام هذا التقرير. يُرجى الاطّلاع على تعريف insightTrafficSourceType لمعرفة تفاصيل عن مصادر الزيارات التي تتوافق مع هذا التقرير.

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

نوع الجهاز

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

باستخدام isCurated
الفهرس
الأبعاد:
مطلوبة deviceType
استخدِم 0 أو أكثر day، subscribedStatus، youtubeProduct
المقاييس:
يمكنك استخدام عنصر واحد أو أكثر. مشاهدة، وestimatedMinutesWatched، وplaylistStarts، وviewsPerPlaylistStart، وaverageTimeInPlaylist
الفلاتر
مطلوبة isCurated==1
استخدِم 0 أو 1 playlist وgroup
استخدِم 0 أو 1 البلد والإقليم والقارة وsubContinent
استخدِم 0 أو أكثر operatingSystem وsubscribedStatus وyoutubeProduct

نظام التشغيل

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

باستخدام isCurated
الفهرس
الأبعاد:
مطلوبة operatingSystem
استخدِم 0 أو أكثر day، subscribedStatus، youtubeProduct
المقاييس:
يمكنك استخدام عنصر واحد أو أكثر. مشاهدة، وestimatedMinutesWatched، وplaylistStarts، وviewsPerPlaylistStart، وaverageTimeInPlaylist
الفلاتر
مطلوبة isCurated==1
استخدِم 0 أو 1 playlist وgroup
استخدِم 0 أو 1 البلد والإقليم والقارة وsubContinent
استخدِم 0 أو أكثر deviceType وsubscribedStatus وyoutubeProduct

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

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

باستخدام isCurated
الفهرس
الأبعاد:
مطلوبة deviceType، operatingSystem
استخدِم 0 أو أكثر day، subscribedStatus، youtubeProduct
المقاييس:
يمكنك استخدام عنصر واحد أو أكثر. مشاهدة، وestimatedMinutesWatched، وplaylistStarts، وviewsPerPlaylistStart، وaverageTimeInPlaylist
الفلاتر
مطلوبة isCurated==1
استخدِم 0 أو 1 playlist وgroup
استخدِم 0 أو 1 البلد والإقليم والقارة وsubContinent
استخدِم 0 أو أكثر subscribedStatus، youtubeProduct

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

مقترَح
الفهرس
الأبعاد:
يمكنك استخدام عنصر واحد أو أكثر. ageGroup وgender
المقاييس:
مطلوبة viewerPercentage
الفلاتر
استخدام قيمة واحدة بالضبط playlist وgroup
باستخدام isCurated
الفهرس
الأبعاد:
يمكنك استخدام عنصر واحد أو أكثر. ageGroup وgender
استخدِم 0 أو أكثر subscribedStatus
المقاييس:
مطلوبة viewerPercentage
الفلاتر
مطلوبة isCurated==1
استخدِم 0 أو 1 playlist وgroup
استخدِم 0 أو 1 البلد والإقليم والقارة وsubContinent
اختياري subscribedStatus
ملاحظة: إنّ قيم viewerPercentage في هذا التقرير لم تتم تسويتها مع القيم المختلفة لسمة subscribedStatus الخاصة بتفاصيل التشغيل.

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

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

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

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

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

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

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

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

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

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

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

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

الفهرس
الأبعاد:
مطلوبة adType
اختياري يوم
المقاييس:
يمكنك استخدام عنصر واحد أو أكثر. grossRevenue وadImpressions والتكلفة لكل ألف ظهور
الفلاتر
استخدِم 0 أو 1 فيديو أو مجموعة
استخدِم 0 أو 1 البلد وقارة وsubContinent