تعرض هذه الصفحة نماذج من طلبات البيانات من YouTube Analytics API. يصف كل مثال بإيجاز التقرير الذي يتم استرداده، ثم يعرض قيم مَعلمات dimensions وmetrics وfilters وsort المقابلة. (تحدّد مستندات تقارير القنوات وتقارير مالك المحتوى التقارير المتوافقة مع واجهة برمجة التطبيقات).
يرتبط كل مثال بمستكشف Google APIs ويملأه بالقيم المعروضة. تستخدِم الأمثلة أيضًا تاريخَي البدء والانتهاء التلقائيَين (YYYY-MM-DD) وهما 2023-09-01 و2024-03-31.
بعد الربط بـ "مستكشف واجهات برمجة التطبيقات"، عليك تحديد القناة أو مالك المحتوى الذي تريد استرداد التقارير الخاصة به. سيعمل مستكشف واجهات برمجة التطبيقات على تعبئة قيمة المعلمة ids إما channel==MINE أو contentOwner==CONTENT_OWNER_ID، بناءً على طلب البحث الذي نقرت عليه. بالنسبة إلى تقارير القنوات، يمكنك تغيير MINE إلى معرّف قناة المستخدم الذي تمت مصادقته. بالنسبة إلى تقارير مالكي المحتوى، يجب استبدال CONTENT_OWNER_ID برقم تعريف مالك المحتوى الخاص بك.
يجب أيضًا أن تتم مصادقتك على أنك القناة المحددة أو مالك المحتوى كي يتمكن مستكشف واجهات برمجة التطبيقات من تفويض طلبات واجهة برمجة التطبيقات باستخدام OAuth 2.0.
ترتيب الطلبات حسب مكوّنات أو مقاييس متعدّدة
تتيح واجهة برمجة التطبيقات إمكانية ترتيب بيانات الردود باستخدام سمات أو مقاييس متعدّدة. على سبيل المثال، يسترد الطلب أدناه بيانات مصدر الزيارات اليومية لفيديوهات قناة معيّنة. يحدّد كل صف في مجموعة النتائج عدد المشاهدات ووقت المشاهدة المقدَّر الذي نشأت من نوع معيّن من مصادر الزيارات (مثل EXT_URL) في يوم معيّن.
dimensions=day,insightTrafficSourceType metrics=views,estimatedWatchTime sort=day,-views
في الرد، يتم ترتيب النتائج حسب التسلسل الزمني. ضمن مجموعة النتائج لكل يوم، يتم ترتيب النتائج تنازليًا حسب عدد المشاهدات. وبالتالي، يحتوي الصف الأول في مجموعة النتائج على بيانات لمصدر الزيارات الذي حقّق أكبر عدد من المشاهدات في اليوم الأول من النطاق الزمني المطلوب. ويحتوي الصف الثاني على بيانات لمصدر الزيارات الذي نتج عنه أكبر عدد من المشاهدات في اليوم الأول.
تقارير القنوات
تقارير الفيديوهات
إجمالي عدد المشاهدات ووقت المشاهدة المقدَّر وغير ذلك على قناة معيّنة
يسترجع طلب البحث هذا مقاييس مجمّعة لمحتوى القناة. يعرض التقرير صفًا واحدًا من البيانات التي تحتوي على القيم الإجمالية لكل مقياس مطلوب خلال النطاق الزمني المحدّد.
metrics=views,comments,likes,dislikes,estimatedMinutesWatched,averageViewDuration
عدد المشاهدات لقناة معيّنة (وغيرها) في بلد معيّن
يعرض طلب البحث هذا مقاييس لبلد معيّن للفيديوهات في القناة. يعرض التقرير صفًا واحدًا من البيانات التي تحتوي على القيم الإجمالية لكل مقياس مطلوب خلال النطاق الزمني المحدّد.
metrics=views,comments,likes,dislikes,estimatedMinutesWatched filters=country==US
أبرز 10 فيديوهات: الفيديوهات الأكثر مشاهدةً على القناة
يعرض طلب البحث هذا الفيديوهات العشرة الأكثر مشاهدة في القناة، وذلك من خلال قياس عدد دقائق المشاهدة المقدّرة خلال النطاق الزمني المحدد. يتم ترتيب النتائج تنازليًا حسب عدد دقائق المشاهدة المقدّرة.
ملاحظة: يتطلب منك هذا التقرير تحديد قيمة لمعلمة طلب sort وضبط المعلمة maxResults على قيمة عدد صحيح تبلغ 10 أو أقل.
dimensions=video metrics=estimatedMinutesWatched,views,likes,subscribersGained maxResults=10 sort=-estimatedMinutesWatched
أهم 10: نِسب النقر إلى الظهور للتعليقات التوضيحية للفيديوهات الأكثر مشاهدة في القناة
يسترد هذا الطلب عدد المشاهدات ونِسب النقر إلى الظهور على التعليقات التوضيحية ومعدلات إغلاق التعليقات التوضيحية ومرات ظهور التعليقات التوضيحية للفيديوهات العشرة الأكثر مشاهدة على القناة. ويتم ترتيب النتائج بترتيب تنازلي حسب عدد المشاهدات، ما يعني أنّ الفيديو سيظهر أولاً في قائمة الفيديوهات الأكثر مشاهدة.
ملاحظة: يتطلب منك هذا التقرير تحديد قيمة لمعلمة طلب sort وضبط المعلمة maxResults على قيمة عدد صحيح تبلغ 10 أو أقل.
dimensions=video metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions maxResults=10 sort=-views
تقارير قوائم التشغيل
إجمالي عدد مشاهدات قائمة التشغيل على قناة معيّنة
يسترد هذا الطلب إجمالي عدد مرات بدء قائمة التشغيل، وعدد دقائق المشاهدة المقدّرة وعدد المشاهدات (مقياس فيديو مجمّع)، وعدد مشاهدات قائمة التشغيل (مقياس ضمن قائمة التشغيل) وعدد المشاهدات لكل مرة تم فيها بدء قائمة تشغيل لقوائم التشغيل في قناة المستخدم الذي تمت المصادقة عليه.
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart
إحصاءات حول قائمة تشغيل معيّنة
يسترد هذا الطلب إجمالي عدد مرات بدء قائمة التشغيل، وعدد دقائق المشاهدة المقدّرة، وعدد المشاهدات (مقياس مجمّع للفيديوهات)،
وعدد مشاهدات قائمة التشغيل (مقياس ضمن قائمة التشغيل)،
وعدد المشاهدات لكل مرة تم فيها بدء قائمة تشغيل لقائمة تشغيل معيّنة. يُرجى العِلم أنّه لتنفيذ طلب البحث هذا في مستكشف واجهات برمجة التطبيقات، يجب استبدال السلسلة PLAYLIST_ID في قيمة المعلَمة filters برقم تعريف قائمة التشغيل لقائمة تشغيل في قناة المستخدم الذي تمت المصادقة عليه.
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart filters=playlist==PLAYLIST_ID
لاسترداد إحصاءات مجمّعة لقوائم تشغيل متعدّدة، يمكنك أيضًا استبدال السلسلة PLAYLIST_ID بقائمة مفصولة بفواصل تتضمّن ما يصل إلى 500 معرّف قائمة تشغيل لقوائم تشغيل في قناة المستخدم الذي تمت المصادقة عليه.
أهمّ 10: قوائم التشغيل الأكثر مشاهدة على القناة
يعرض طلب البحث هذا قوائم التشغيل الـ 10 الأكثر مشاهدة للقناة، وذلك من خلال قياسها من خلال عدد مشاهدات قائمة التشغيل خلال النطاق الزمني المحدد. وتسترجع أيضًا مقاييس أخرى متعددة لقوائم التشغيل، مثل عدد المرات التي بدأ فيها المستخدمون تشغيل كل قائمة تشغيل ومتوسّط الوقت الذي شاهد فيه المستخدم الفيديوهات في قائمة التشغيل بعد بدئها. يتم ترتيب النتائج تنازليًا حسب مشاهدات قائمة التشغيل.
ملاحظة: بما أنّ هذا التقرير يستخدم السمة playlist، عليك تحديد قيمة لمَعلمة طلب sort وكذلك ضبط المَعلمة maxResults على قيمة عدد صحيح تبلغ 10 أو أقلّ.
dimensions=playlist metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts,averageTimeInPlaylist,playlistSaves maxResults=10 sort=-playlistViews
تقارير الفيديوهات
مقاييس وقت المشاهدة اليومية لفيديوهات القناة
يعرض طلب البحث هذا عدد المشاهدات اليومية ومقاييس وقت المشاهدة وأعداد المشتركين الجدد لفيديوهات القناة. يعرض التقرير صفًا واحدًا من البيانات لكل يوم في النطاق الزمني المطلوب. يتمّ ترتيب الصفوف حسب التسلسل الزمني.
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 على أجهزة 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
تقارير مالك المحتوى
تقارير الفيديوهات
إجمالي عدد المشاهدات ووقت المشاهدة المقدَّر وغير ذلك لكل المحتوى المطالَب بملكيته
يسترد طلب البحث هذا مقاييس مجمّعة للمحتوى الذي طالب مالك المحتوى بملكيته. يعرض التقرير صفًا واحدًا من البيانات التي تحتوي على القيم الإجمالية لكل مقياس مطلوب خلال النطاق الزمني المحدّد.
metrics=views,comments,likes,dislikes,estimatedMinutesWatched,averageViewDuration filters=claimedStatus==claimed
عدد المشاهدات الخاص بالبلد (وغيره) لكل الفيديوهات التي يتمّ تحميلها ذاتيًا
يسترجع طلب البحث هذا مقاييس لبلد معيّن للفيديوهات التي حمّلها مالك المحتوى. يعرض التقرير صفًا واحدًا من البيانات التي تحتوي على القيم الإجمالية لكل مقياس مطلوب خلال النطاق الزمني المحدّد.
metrics=views,comments,likes,dislikes,shares filters=uploaderType==self;country==FR
إجمالي عدد المشاهدات (وغير ذلك) لكل المحتوى التابع لجهة خارجية والذي تمّت المطالبة بملكيته
يسترجع طلب البحث هذا مقاييس مجمّعة للفيديوهات التي طالب مالك المحتوى بملكيتها ولم يحمّلها. يعرض التقرير صفًا واحدًا من البيانات التي تحتوي على القيم الإجمالية لكل مقياس مطلوب خلال النطاق الزمني المحدّد.
metrics=views,comments,likes,dislikes,shares filters=uploaderType==thirdParty;claimedStatus==claimed
إجمالي عدد المشاهدات (وغيرها) لكل المحتوى الذي تم تحميله ذاتيًا
يسترد طلب البحث هذا مقاييس مجمّعة للفيديوهات التي حمّلها مالك المحتوى. يعرض التقرير صفًا واحدًا من البيانات التي تحتوي على القيم الإجمالية لكل مقياس مطلوب خلال النطاق الزمني المحدّد.
metrics=views,comments,likes,dislikes,estimatedMinutesWatched filters=uploaderType==self
إجمالي عدد المشاهدات (وغير ذلك) لكل المحتوى الذي تم تحميله ذاتيًا والمطالب بملكيته
يسترد طلب البحث هذا مقاييس مجمّعة للفيديوهات التي حمّلها مالك المحتوى وطالب بملكيتها أيضًا. يعرض التقرير صفًا واحدًا من البيانات التي تحتوي على القيم الإجمالية لكل مقياس مطلوب خلال النطاق الزمني المحدّد.
metrics=views,comments,likes,dislikes,estimatedMinutesWatched filters=uploaderType==self;claimedStatus==claimed
أبرز 10 فيديوهات: الفيديوهات الأكثر مشاهدة لدى مالك المحتوى
يسترجع طلب البحث هذا الفيديوهات العشرة الأكثر مشاهدة، وذلك من خلال قياس عدد المشاهدات خلال النطاق الزمني المحدد الذي حمّله مالك المحتوى. يتم ترتيب النتائج تنازليًا حسب عدد المشاهدات.
dimensions=video metrics=views,estimatedMinutesWatched,estimatedRevenue,estimatedAdRevenue,monetizedPlaybacks,adImpressions filters=uploaderType==self maxResults=10 sort=-views
أبرز 10 فيديوهات، الفيديوهات الأكثر مشاهدة لدى مالك المحتوى
يعرض طلب البحث هذا الفيديوهات العشرة الأكثر مشاهدة، وذلك حسب عدد دقائق المشاهدة المقدَّرة خلال النطاق الزمني المحدّد الذي حمّله مالك المحتوى. يتم ترتيب النتائج تنازليًا حسب عدد دقائق المشاهدة المقدّرة.
dimensions=video metrics=estimatedMinutesWatched,averageViewDuration,averageViewPercentage,views,subscribersGained filters=uploaderType==self maxResults=10 sort=-estimatedMinutesWatched
أهم 10 – الفيديوهات الأكثر مشاهدةً على قناة مالك المحتوى
يسترجع طلب البحث هذا مقاطع الفيديو العشرة الأكثر مشاهدة لقناة معينة أو مجموعة من القنوات التي يديرها مالك المحتوى. يتم ترتيب النتائج تنازليًا حسب عدد المشاهدات. يُرجى العِلم أنّه لتنفيذ هذا الطلب في "مستكشف واجهات برمجة التطبيقات"، عليك استبدال السلسلة CHANNEL_ID في قيمة المَعلمة filters بقائمة مفصولة بفواصل تتضمّن ما يصل إلى 500 معرّف قناة لقنواتك.
dimensions=video metrics=views filters=channel==CHANNEL_ID maxResults=10 sort=-views
أهم 10: نِسب النقر إلى الظهور للتعليقات التوضيحية للفيديوهات الأكثر مشاهدة في القناة
يسترد هذا الطلب عدد المشاهدات ونِسب النقر إلى الظهور على التعليقات التوضيحية ومعدلات إغلاق التعليقات التوضيحية ومرات ظهور التعليقات التوضيحية للفيديوهات العشرة الأكثر مشاهدة في قناة معيّنة أو مجموعة قنوات محدّدة. ويتم ترتيب النتائج بترتيب تنازلي حسب عدد المشاهدات، ما يعني أنّ الفيديو سيظهر أولاً في قائمة الفيديوهات الأكثر مشاهدة. يُرجى العِلم أنّه لتنفيذ هذا الطلب في "مستكشف واجهات برمجة التطبيقات"، عليك استبدال السلسلة CHANNEL_ID في قيمة المَعلمة filters بقائمة مفصولة بفواصل تتضمّن ما يصل إلى 500 معرّف قناة لقنواتك.
dimensions=video metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions filters=channel==CHANNEL_ID maxResults=10 sort=-views
تقارير قوائم التشغيل
مشاهدات قائمة التشغيل لقنوات مالك المحتوى
يسترد هذا الطلب إجمالي عدد مرات بدء قائمة التشغيل وعدد دقائق المشاهدة المقدّرة لقائمة التشغيل وعدد مشاهدات قائمة التشغيل وعدد المشاهدات لكل مرة تم فيها بدء قائمة تشغيل لقوائم التشغيل في قنوات مالك المحتوى. لا يحسب
المقياس playlistViews سوى عدد مرات مشاهدة الفيديو التي حدثت في سياق
قائمة التشغيل. بما أنّ جميع المقاييس المطلوبة هي مقاييس مضمّنة في قائمة التشغيل، لا يجب أن يتضمّن الطلب أيضًا فلتر قائمة التشغيل أو المجموعة.
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart
إحصاءات حول قائمة تشغيل معيّنة
يسترد هذا الطلب إجمالي عدد مرات بدء قائمة التشغيل، وعدد دقائق المشاهدة المقدّرة، وعدد المشاهدات (مقياس مجمّع للفيديوهات)،
وعدد مشاهدات قائمة التشغيل (مقياس ضمن قائمة التشغيل)،
وعدد المشاهدات لكل مرة تم فيها بدء قائمة تشغيل لقائمة تشغيل معيّنة. يُرجى العِلم أنّه لتنفيذ طلب البحث هذا في مستكشف واجهات برمجة التطبيقات، يجب استبدال السلسلة PLAYLIST_ID في قيمة المعلَمة filters برقم تعريف قائمة التشغيل لقائمة تشغيل في إحدى قنوات مالك المحتوى.
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart filters=playlist==PLAYLIST_ID
لاسترداد إحصاءات مجمّعة لقوائم تشغيل متعدّدة، يمكنك أيضًا استبدال السلسلة PLAYLIST_ID بقائمة مفصولة بفواصل تضمّ ما يصل إلى 500 معرّف قوائم تشغيل لقوائم تشغيل في قنوات مالك المحتوى.
تقارير الفيديوهات
مقاييس وقت المشاهدة اليومية للمحتوى الذي حمّلتَه ذاتيًا
يعرض طلب البحث هذا مقاييس وقت المشاهدة اليومية، بالإضافة إلى عدد المشاهدات وعدد عمليات التشغيل التي تحقّق الربح ومرّات الظهور للفيديوهات التي حمّلها مالك المحتوى. يعرض التقرير صفًا واحدًا من البيانات لكل يوم في النطاق الزمني المطلوب، ويتم ترتيب الصفوف بترتيب زمني.
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