نماذج طلبات واجهة برمجة التطبيقات

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

مقاييس وقت المشاهدة اليومي لفيديوهات القناة

يسترجع هذا الطلب عدد المشاهدات اليومي ومقاييس وقت المشاهدة وعدد المشتركين الجدد في فيديوهات القناة. يعرض التقرير صفًا واحدًا من البيانات لكل يوم في النطاق الزمني المطلوب. يتم ترتيب الصفوف بترتيب زمني.

dimensions=day
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained
sort=day

مقاييس التعليقات التوضيحية اليومية الخاصة بفيديوهات القناة

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

dimensions=day
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
sort=day

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

عدد المشاهدات اليومية لقائمة التشغيل لإحدى القنوات

يسترجع هذا الطلب عدد المشاهدات اليومية (مقياس فيديو مجمّع)، ومقاييس مشاهدات قوائم التشغيل (مقياس داخل قائمة التشغيل)، وعدد مرات بدء تشغيل قوائم التشغيل، والدقائق المقدّرة التي تمّت مشاهدتها، والمشاهدات لكلّ مرة بدء تشغيل قائمة تشغيل في قناة المستخدم الذي سجّل الدخول. يتم ترتيب النتائج بترتيب زمني.

dimensions=day
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart
sort=day

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

مقاييس وقت المشاهدة حسب البلد لفيديوهات القناة

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

dimensions=country
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained
sort=-estimatedMinutesWatched

مقاييس التعليقات التوضيحية الخاصة ببلدان معيّنة في فيديوهات القناة

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

dimensions=country
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
sort=-annotationClickThroughRate

مقاييس خاصة بالمقاطعات في الولايات الأمريكية وواشنطن العاصمة

يتضمن هذا الطلب معلومات مفصّلة عن عدد المشاهدات وعدد دقائق المشاهدة المقدَّرة ومتوسّط مدة مشاهدة فيديوهات القناة حسب المقاطعة. تشمل البيانات الولايات الأمريكية ومقاطعة واشنطن العاصمة، ويتم ترتيب النتائج أبجديًا حسب رموز ISO 3166-2 للمقاطعات.

dimensions=province
metrics=views,estimatedMinutesWatched,averageViewDuration
filters=claimedStatus==claimed;country==US
sort=province

أهم 10 فيديوهات: الفيديوهات الأكثر مشاهدة في بلد معيّن

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

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

dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=country==US
maxResults=10
sort=-views

أهم 10 مدن في الولايات المتحدة حسب إجمالي عدد المشاهدات

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

    dimensions=city
metrics=views
filters=country==US
maxResults=10
sort=-views

أهم 10 مدن في الولايات المتحدة حسب إجمالي عدد المشاهدات لكل نوع من أنواع المحتوى

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

    dimensions=city,creatorContentType
metrics=views
filters=country==US
maxResults=10
sort=-views

أبرز 10 مدن في الولايات المتحدة حسب إجمالي وقت المشاهدة

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

    dimensions=city,day
metrics=estimatedWatchTime
filters=country==US
maxResults=10
sort=-estimatedWatchTime

أهم 10 فيديوهات: الفيديوهات الأكثر مشاهدة في أوروبا

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

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

dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=continent==150
maxResults=10
sort=-views

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

مقاييس وقت المشاهدة الخاصة بكل بلد لقوائم التشغيل في قناة معيّنة

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

dimensions=country
metrics=views,estimatedMinutesWatched,playlistStarts,averageTimeInPlaylist
sort=-estimatedMinutesWatched

أهم 10 قوائم تشغيل تم تشغيلها في الولايات المتحدة

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

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

dimensions=playlist
metrics=playlistStarts,views,estimatedMinutesWatched,averageViewDuration
filters=isCurated==1;country==US
maxResults=10
sort=-playlistStarts

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

أعداد المشاهدات ووقت المشاهدة من مواقع تشغيل مختلفة

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

dimensions=insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
sort=-views

عدد المشاهدات اليومية ووقت المشاهدة من مواقع تشغيل مختلفة

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

    dimensions=day,insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
filters=country==US
sort=day

أهم 10 مواقع إلكترونية تابعة لجهات خارجية تحقّق أكبر عدد من المشاهدات لفيديوهات مضمّنة

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

dimensions=insightPlaybackLocationDetail
metrics=views,estimatedMinutesWatched
filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED
maxResults=10
sort=-views

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

أعداد مشاهدات قوائم التشغيل ووقت المشاهدة من مواقع تشغيل مختلفة

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

dimensions=insightPlaybackLocationType
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews
sort=-playlistStarts

أعداد المشاهدات اليومية لقوائم التشغيل ووقت المشاهدة من مواقع تشغيل مختلفة

يسترجع طلب البحث هذا عمليات بدء تشغيل قوائم التشغيل اليومية وعدد المشاهدات (مقياس فيديو مجمّع) ومشاهدات قوائم التشغيل (مقياس في قائمة التشغيل) ووقت المشاهدة المقدَّر في الولايات المتحدة لقوائم تشغيل قناة معيّنة. يتم تجميع النتائج حسب اليوم لكل نوع من الصفحات أو التطبيقات التي حدثت فيها مشاهدات قوائم التشغيل. يتم ترتيب النتائج بترتيب زمني.

dimensions=day,insightPlaybackLocationType
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews
filters=country==US
sort=day

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

إبداءات الإعجاب وعدم الإعجاب حسب نوع المحتوى

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

dimensions=creatorContentType
metrics=likes,dislikes

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

عدد المشاهدات ووقت المشاهدة من مصادر زيارات مختلفة في بلد معيّن

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

dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=country==US

عدد المشاهدات ووقت المشاهدة اليومي من مصادر الزيارات المختلفة

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

dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched
sort=day

أهم 10 عبارات بحث في YouTube تجذب أكبر عدد من الزيارات إلى فيديو معيّن

يسترد طلب البحث هذا عبارات البحث العشر التي حققت أكبر عدد من المشاهدات من نتائج بحث YouTube لفيديو محدد واحد أو أكثر. يتم ترتيب النتائج تنازليًا حسب عدد المشاهدات. يُرجى العِلم أنّه لتنفيذ هذا الطلب في "مستكشف واجهات برمجة التطبيقات"، عليك استبدال السلسلة VIDEO_ID في قيمة المَعلمة filters بقائمة مفصولة بفواصل تضمّ ما يصل إلى 500 معرّف فيديو.

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

dimensions=insightTrafficSourceDetail
metrics=views
filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH
maxResults=10
sort=-views

أهم 10 مواقع إلكترونية خارجية تجذب أكبر عدد من الزيارات إلى فيديو معيّن

يسترجع هذا الطلب المواقع الإلكترونية الخارجية العشرة التي حققت أكبر عدد من المشاهدات لفيديو أو مجموعة فيديوهات معيّنة. يتم ترتيب النتائج تنازليًا حسب وقت المشاهدة المقدَّر. يُرجى العِلم أنّه لتنفيذ هذا الطلب في "مستكشف واجهات برمجة التطبيقات"، عليك استبدال السلسلة VIDEO_ID في قيمة المَعلمة filters بقائمة مفصولة بفواصل تضم ما يصل إلى 500 معرّف فيديو للفيديوهات التي حمّلتها.

dimensions=insightTrafficSourceDetail
metrics=estimatedMinutesWatched,views
filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL
maxResults=25
sort=-estimatedMinutesWatched

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

أعداد مشاهدات قوائم التشغيل ووقت المشاهدة من مصادر زيارات مختلفة في بلد معيّن

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

dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatchedplaylistStarts,playlistViews
filters=country==US

عدد مشاهدات قائمة التشغيل ووقت المشاهدة يوميًا من مصادر زيارات مختلفة

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

dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews
sort=day

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

المقاييس اليومية لأنواع الأجهزة لنظام التشغيل Android

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

dimensions=day,deviceType
metrics=estimatedMinutesWatched,views
filters=operatingSystem==ANDROID
sort=day

مقاييس نظام التشغيل اليومي للأجهزة الجوّالة

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

dimensions=day,operatingSystem
metrics=estimatedMinutesWatched,views
filters=deviceType==MOBILE
sort=day

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

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

dimensions=day,operatingSystem,deviceType
metrics=estimatedMinutesWatched,views
sort=day

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

مقاييس نوع الجهاز اليومية لمشاهدات قوائم التشغيل على نظام التشغيل Android

يسترد طلب البحث هذا عدد المشاهدات اليومية (مقياس فيديو مجمّع) وعدد مشاهدات قائمة التشغيل (مقياس ضمن قائمة التشغيل) ووقت المشاهدة المقدّر على أجهزة Android لقوائم التشغيل الخاصة بقناة معيّنة. يتم agrupar los resultados por día para cada tipo de dispositivo donde se produjeron las reproducciones de la lista de reproducción. يتم ترتيب النتائج بترتيب زمني.

dimensions=day,deviceType
metrics=views,estimatedMinutesWatched,playlistViews
filters=operatingSystem==ANDROID
sort=day

المقاييس اليومية لنظام التشغيل لمشاهدات قوائم التشغيل على الأجهزة الجوّالة

يسترجع هذا الطلب المشاهدات اليومية (مقياس فيديو مجمّع) ومشاهدات قوائم التشغيل (مقياس في قائمة التشغيل) ووقت المشاهدة المقدَّر على الأجهزة الجوّالة لقوائم تشغيل قناة معيّنة. يتم agrupar النتائج حسب اليوم لكل نظام تشغيل تم تسجيل مشاهدات قائمة التشغيل عليه. يتم ترتيب النتائج بترتيب زمني.

dimensions=day,operatingSystem
metrics=views,estimatedMinutesWatched
filters=deviceType==MOBILE
sort=day

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

الخصائص الديمغرافية للمشاهدين في كاليفورنيا (الفئة العمرية والجنس)

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

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=province==US-CA
sort=gender,ageGroup

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

الخصائص الديمغرافية لمشاهدي قائمة التشغيل في كاليفورنيا (الفئة العمرية والجنس)

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

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=province==US-CA
sort=gender,ageGroup

مشاركة المقاييس المجمَّعة حسب الخدمة التي تمت مشاركة الفيديوهات فيها

يسترجع هذا الطلب عدد المرّات التي استخدم فيها المستخدمون الزر Share لمشاركة فيديوهات قناة معيّنة. يتم تجميع النتائج حسب خدمة المشاركة (Google+ وTwitter وما إلى ذلك) وترتيبها تنازليًا حسب عدد المشاركات.

dimensions=sharingService
metrics=shares
sort=-shares

مقاييس الاحتفاظ بالجمهور لفيديو معيّن

يقيس هذا التقرير قدرة الفيديو على الاحتفاظ بالجمهور. لا يمكن استرداد التقرير إلا لفيديوه واحد في كل مرة. لتنفيذ طلب البحث هذا في "مستكشف واجهات برمجة التطبيقات"، يجب استبدال السلسلة VIDEO_ID في قيمة المَعلمة filters بمعرّف الفيديو لأحد الفيديوهات التي حمّلتها. يُرجى العلم أنّ تقارير الاحتفاظ بالجمهور لا تتيح إمكانية تحديد قيم متعدّدة للفلترة video.

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

يُرجى العِلم أنّ بيانات فلتر audienceType متاحة اعتبارًا من 25 أيلول (سبتمبر) 2013. ولن تعرض واجهة برمجة التطبيقات بيانات طلبات البحث التي تستخدِم الفلتر لمحاولة استرداد البيانات من تواريخ سابقة. تعمل طلبات البحث التي لا تستخدِم الفلتر لأي تاريخ بعد 1 تموز (يوليو) 2008.

dimensions=elapsedVideoTimeRatio
metrics=audienceWatchRatio,relativeRetentionPerformance
filters=video==VIDEO_ID;audienceType==ORGANIC

مقاييس أرباح القناة وأداء الإعلانات

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

metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks

مقاييس الأداء اليومي للأرباح والإعلانات

يستردّ هذا الطلب مقاييس الأرباح اليومية والأداء الإعلاني للقناة.

dimensions=day
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks

مقاييس أداء الإعلانات والأرباح الخاصة بالبلد

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

dimensions=country
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
sort=-estimatedRevenue

أهم 10 فيديوهات حقّقت أعلى نسبة من الأرباح

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

dimensions=video
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
maxResults=10
sort=-estimatedRevenue

مقاييس أداء الإعلانات لأنواع الإعلانات المختلفة

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

dimensions=adType
metrics=grossRevenue,adImpressions,cpm
filters=claimedStatus==claimed
sort=-adType

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

مقاييس وقت المشاهدة اليومي للمحتوى الذي حمّلته بنفسك

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

dimensions=day
metrics=estimatedMinutesWatched,averageViewPercentage,views,monetizedPlaybacks,adImpressions
filters=uploaderType==self
sort=day

مقاييس التعليقات التوضيحية للمحتوى الذي تمّت المطالبة بملكيته

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

dimensions=day
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
filters=claimedStatus==claimed
sort=day

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

عدد المشاهدات اليومية لقائمة التشغيل لدى مالك المحتوى

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

dimensions=day
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart
sort=day

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

مقاييس وقت المشاهدة الخاصة بالبلد للمحتوى الذي يحمّله المستخدمون بأنفسهم

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

dimensions=country
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,estimatedRevenue,estimatedAdRevenue,grossRevenue
filters=uploaderType==self
sort=-estimatedMinutesWatched

مقاييس التعليقات التوضيحية الخاصة بكل بلد للمحتوى الذي يحمّله المستخدم بنفسه

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

dimensions=country
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
filters=uploaderType==self
sort=-annotationClickThroughRate

مقاييس خاصة بالمقاطعات في الولايات الأمريكية وواشنطن العاصمة

يعرض هذا الطلب تفاصيل حسب المقاطعات حول عدد المشاهدات والدقائق المقدَّرة التي تمّت مشاهدتها ومتوسّط مدّة المشاهدة للفيديوهات التي طالب بها مالك المحتوى. تشمل البيانات الولايات الأمريكية ومقاطعة واشنطن العاصمة، ويتم ترتيب النتائج أبجديًا حسب رموز ISO 3166-2 للمقاطعات.

dimensions=province
metrics=views,estimatedMinutesWatched,averageViewDuration
filters=claimedStatus==claimed;country==US
sort=province

أهم 10 مدن في الولايات المتحدة حسب إجمالي عدد المشاهدات

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

    dimensions=city
metrics=views
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-views

أبرز 10 مدن في الولايات المتحدة حسب إجمالي عدد المشاهدات لكل نوع محتوى

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

    dimensions=city,creatorContentType
metrics=views
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-views

أبرز 10 مدن في الولايات المتحدة حسب إجمالي وقت المشاهدة

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

    dimensions=city,day
metrics=estimatedWatchTime
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-estimatedWatchTime

أهم 10 - الفيديوهات الأكثر مشاهدة في أوروبا

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

dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=claimedStatus==claimed;filters=continent==150
maxResults=10
sort=-estimatedMinutesWatched

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

مقاييس وقت المشاهدة الخاصة ببلدان معيّنة لقوائم تشغيل مالك المحتوى

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

dimensions=country
metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts,averageTimeInPlaylist
sort=-playlistEstimatedMinutesWatched

أهم 10 قوائم تشغيل تم تشغيلها في الولايات المتحدة

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

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

dimensions=playlist
metrics=playlistStarts,playlistViews,playlistEstimatedMinutesWatched,playlistAverageViewDuration
filters=country==US
maxResults=10
sort=-playlistStarts

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

إبداءات الإعجاب وعدم الإعجاب حسب نوع المحتوى

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

dimensions=creatorContentType
metrics=likes,dislikes
filters=channel==CHANNEL_ID

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

أعداد المشاهدات ووقت المشاهدة من مواقع تشغيل مختلفة

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

dimensions=insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
filters=channel==CHANNEL_ID
sort=-views

عدد المشاهدات اليومية ووقت المشاهدة من مواقع تشغيل مختلفة

يسترجع هذا الطلب عدد المشاهدات اليومية ووقت المشاهدة المقدَّر في الولايات المتحدة للفيديوهات التي تم تحميلها على قناة معيّنة أو مجموعة قنوات معيّنة. يتم تجميع النتائج حسب اليوم لكل نوع من الصفحات أو التطبيقات التي حدثت فيها عمليات تشغيل الفيديو. يتم ترتيب النتائج بترتيب زمني عكسي. يُرجى العِلم أنّه لتنفيذ هذا الطلب في "مستكشف واجهات برمجة التطبيقات"، عليك استبدال السلسلة CHANNEL_ID في قيمة المَعلمة filters بقائمة مفصولة بفواصل تضم ما يصل إلى 500 معرّف قناة لقنواتك.

dimensions=day,insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
filters=country==US;channel==CHANNEL_ID
sort=-day

أبرز 10 مواقع إلكترونية تابعة لجهات خارجية تحقّق أكبر عدد من المشاهدات لفيديو مضمّن

يسترجع هذا الطلب عدد المشاهدات ووقت المشاهدة المقدَّر لفيديو معيّن أو مجموعة فيديوهات. يتم تجميع النتائج حسب الموقع الإلكتروني التابع لجهة خارجية الذي تم تضمين الفيديو فيه. يتم ترتيب النتائج تنازليًا حسب عدد المشاهدات. يُرجى العِلم أنّه لتنفيذ هذا الطلب في "مستكشف واجهات برمجة التطبيقات"، عليك استبدال السلسلة VIDEO_ID في قيمة المَعلمة filters بقائمة مفصولة بفواصل تضم ما يصل إلى 500 معرّف فيديو للفيديوهات التي حمّلتها.

dimensions=insightPlaybackLocationDetail
metrics=views,estimatedMinutesWatched
filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED
maxResults=10
sort=-views

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

أعداد مشاهدات قوائم التشغيل ووقت المشاهدة من مواقع تشغيل مختلفة

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

dimensions=insightPlaybackLocationType
metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts
sort=-playlistStarts

أعداد مشاهدات قوائم التشغيل ووقت المشاهدة من مواقع تشغيل مختلفة

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

dimensions=day,insightPlaybackLocationType
metrics=playlistStarts,playlistViews,playlistEstimatedMinutesWatched
filters=country==US

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

عدد المشاهدات ووقت المشاهدة من مصادر زيارات مختلفة

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

dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=uploaderType==self

أعداد المشاهدات اليومية ووقت المشاهدة من مصادر زيارات مختلفة

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

dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=uploaderType==self
sort=-day

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

أهم 10 عبارات بحث في YouTube تجذب أكبر عدد من الزيارات إلى فيديو معيّن

يسترجع طلب البحث هذا عبارات البحث العشر التي حققت أكبر عدد من المشاهدات من نتائج البحث على YouTube لفيديو أو مجموعة فيديوهات معيّنة. يتم ترتيب النتائج تنازليًا حسب عدد المشاهدات. يُرجى العِلم أنّه لتنفيذ هذا الطلب في "مستكشف واجهات برمجة التطبيقات"، عليك استبدال السلسلة VIDEO_ID في قيمة المَعلمة filters بقائمة مفصولة بفواصل تضم ما يصل إلى 500 معرّف فيديو للفيديوهات التي حمّلتها.

dimensions=insightTrafficSourceDetail
metrics=views
filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH
maxResults=10
sort=-views

أهم 10 مواقع إلكترونية خارجية تجذب أكبر عدد من الزيارات إلى فيديو معيّن

يسترد طلب البحث هذا مواقع الويب الخارجية العشرة التي حققت أكبر عدد من المشاهدات من نتائج بحث Google لفيديو معين أو مجموعة مقاطع فيديو. يتم ترتيب النتائج تنازليًا حسب وقت المشاهدة المقدَّر. يُرجى العِلم أنّه لتنفيذ هذا الطلب في "مستكشف واجهات برمجة التطبيقات"، عليك استبدال السلسلة VIDEO_ID في قيمة المَعلمة filters بقائمة مفصولة بفواصل تضم ما يصل إلى 500 معرّف فيديو للفيديوهات التي حمّلتها.

dimensions=insightTrafficSourceDetail
metrics=estimatedMinutesWatched,views
filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL
maxResults=25
sort=-estimatedMinutesWatched

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

أعداد مشاهدات قوائم التشغيل ووقت المشاهدة من مصادر زيارات مختلفة في بلد معيّن

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

dimensions=insightTrafficSourceType
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched
filters=country==US

أعداد مشاهدات قوائم التشغيل ووقت المشاهدة من مصادر زيارات مختلفة

يسترجع هذا الطلب مشاهدات قوائم التشغيل وعدد مرات بدء تشغيلها ووقت المشاهدة المقدَّر لها في قوائم التشغيل على قناة واحدة أو أكثر من قنوات مالك المحتوى. يتم تجميع المقاييس حسب مصدر الزيارات. يُرجى العِلم أنّه لتنفيذ هذا الطلب في "مستكشف واجهات برمجة التطبيقات"، عليك استبدال السلسلة CHANNEL_ID في قيمة المَعلمة filters بقائمة مفصولة بفواصل تتضمّن ما يصل إلى 500 معرّف قناة لقنواتك.

dimensions=day,insightTrafficSourceType
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched
filters=channel==CHANNEL_ID

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

المقاييس اليومية لأنواع الجهاز الخاصة بالفيديوهات التي تمّت المطالبة بملكيتها

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

dimensions=day,deviceType
metrics=estimatedMinutesWatched,views
filters=claimedStatus==claimed
sort=day

المقاييس اليومية لنظام التشغيل للفيديوهات التي تمّت المطالبة بملكيتها والتي تمت مشاهدتها على الأجهزة الجوّالة

يسترجع هذا الطلب عدد المشاهدات اليومية ووقت المشاهدة المقدَّر حسب نظام التشغيل لمشاهدات الفيديوهات التي طالب مالك محتوى محدّد بملكية حقوقها والتي تمّت على الأجهزة الجوّالة. يتم تجميع النتائج حسب اليوم لكل نظام تشغيل حدثت فيه عمليات تشغيل الفيديو. تظهر النتائج مرتّبة حسب التسلسل الزمني.

dimensions=day,operatingSystem
metrics=estimatedMinutesWatched,views
filters=claimedStatus==claimed;deviceType==MOBILE
sort=day

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

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

dimensions=day,operatingSystem,deviceType
metrics=estimatedMinutesWatched,views
sort=day

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

مقاييس نوع الجهاز لعمليات مشاهدة قوائم التشغيل على نظام التشغيل Android

يسترد طلب البحث هذا عدد مشاهدات قائمة التشغيل ووقت المشاهدة المقدّر لقائمة التشغيل على أجهزة Android الخاصة بقوائم التشغيل في قناة واحدة أو أكثر من قنوات مالك المحتوى. يتم عرض النتائج المتعلّقة بكل نوع من أنواع الأجهزة التي حدثت فيها مشاهدات قائمة التشغيل. يُرجى العِلم أنّه لتنفيذ هذا الطلب في "مستكشف واجهات برمجة التطبيقات"، يجب استبدال السلسلة CHANNEL_ID في قيمة المَعلمة filters بقائمة مفصولة بفواصل تضم ما يصل إلى 500 معرّف قناة لقنواتك.

dimensions=deviceType
metrics=playlistViews,playlistEstimatedMinutesWatched
filters=channel==CHANNEL_ID;operatingSystem==ANDROID

مقاييس نظام التشغيل لمشاهدات قوائم التشغيل على الأجهزة الجوّالة

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

dimensions=operatingSystem
metrics=views,estimatedMinutesWatched
filters=deviceType==MOBILE

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

الخصائص الديمغرافية للمشاهدين في كاليفورنيا (الفئة العمرية والجنس)

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

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=claimedStatus==claimed;province==US-CA
sort=gender,ageGroup

مقاييس المشاركة المجمّعة حسب الخدمة التي تمت مشاركة الفيديوهات فيها

يسترجع هذا الطلب عدد المرّات التي استخدم فيها المستخدمون الزر Share لمشاركة الفيديوهات التي حمّلها مالك المحتوى. ويتم تجميع النتائج حسب خدمة المشاركة (Google+ وTwitter وغير ذلك) وترتيبها تنازليًا حسب عدد المشاركات.

dimensions=sharingService
metrics=shares
filters=uploaderType==self
sort=-shares

مقاييس الاحتفاظ بالجمهور لفيديو معيّن

يقيس هذا التقرير قدرة الفيديو على الاحتفاظ بالجمهور. لا يمكن استرداد التقرير إلا لفيديوه واحد في كل مرة. يُرجى العِلم أنّه لتنفيذ هذا الطلب في "مستكشف واجهات برمجة التطبيقات"، عليك استبدال السلسلة VIDEO_ID في قيمة المَعلمة filters بمعرّف أحد فيديوهاتك المحمَّلة. يُرجى العلم أنّ تقارير الاحتفاظ بالجمهور لا تتيح إمكانية تحديد قيم متعدّدة للفلترة video.

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

يُرجى العِلم أنّ بيانات فلتر audienceType متاحة اعتبارًا من 25 أيلول (سبتمبر) 2013. لن تعرض واجهة برمجة التطبيقات بيانات طلبات البحث التي تستخدِم الفلتر لمحاولة استرداد البيانات من تواريخ سابقة. تعمل طلبات البحث التي لا تستخدم الفلتر لأي تاريخ بعد 1 تموز (يوليو) 2008.

dimensions=elapsedVideoTimeRatio
metrics=audienceWatchRatio,relativeRetentionPerformance
filters=video==VIDEO_ID;audienceType==ORGANIC

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

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

metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed

مقاييس الأداء اليومي للأرباح والإعلانات

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

dimensions=day
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed

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

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

dimensions=country
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed
sort=-estimatedRevenue

أهمّ 10 فيديوهات: الفيديوهات التي حقّقت أعلى نسبة من الأرباح

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

dimensions=video
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed
maxResults=10
sort=-estimatedRevenue

مقاييس أداء الإعلانات لأنواع الإعلانات المختلفة

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

dimensions=adType
metrics=grossRevenue,adImpressions,cpm
filters=claimedStatus==claimed
sort=-adType