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

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

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

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

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 مدن في الولايات المتحدة حسب إجمالي عدد المشاهدات

يسترد هذا الاستعلام قائمة مدن الولايات المتحدة العشرة التي حققت أكبر عدد من مرات مشاهدة محتوى القناة خلال النطاق الزمني المحدد. يمكن تعديل طلب البحث لطلب بيانات لبلد آخر من خلال اختيار قيمة صالحة أخرى لهذا الفلتر. وبالمثل، يمكن تعديل طلب البحث لاسترداد البيانات الخاصة بشبه قارة، مثل أوروبا الغربية أو جنوب شرق آسيا، وذلك باستخدام فلتر 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 - الفيديوهات الأكثر مشاهدة في أوروبا

يسترد هذا الطلب الفيديوهات العشرة الأكثر مشاهدة على القناة في أوروبا، وفقًا لعدد المشاهدات خلال النطاق الزمني المحدّد. يمكن تعديل طلب البحث لطلب بيانات لقارة أخرى من خلال اختيار قيمة صالحة أخرى لهذا الفلتر. وبالمثل، يمكن تعديل طلب البحث لاسترداد البيانات الخاصة بشبه قارة، مثل أوروبا الغربية أو جنوب شرق آسيا، وذلك باستخدام فلتر 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 لقوائم التشغيل التابعة لقناةٍ معيّنة. النتائج هي مجمّعة حسب اليوم لكل نوع من الأجهزة التي سجّلت مشاهدات قائمة التشغيل فيها. تظهر النتائج مرتّبة حسب التسلسل الزمني.

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

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

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

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

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

أهمّ 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