تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تعرض هذه الصفحة تقارير يمكن لمالكي القنوات استردادها باستخدام YouTube Analytics API. توفر تقارير القناة مقاييس نشاط المستخدم لقناة محددة، وتقيس مقاييس مثل عدد مرات مشاهدة الفيديو والتقييمات وعدد الاشتراكات.
تقدّم تقارير الفيديو إحصاءات حول كل أنشطة المستخدم المرتبطة بفيديوهات القناة.
تقدّم تقارير قوائم التشغيل إحصاءات مرتبطة على وجه التحديد بمشاهدات الفيديو التي تتم في سياق قائمة تشغيل.
تحتوي تقارير أداء الإعلان على مقاييس ذات صلة بالأرباح وأداء الإعلان. ويستخدمون السمة adType لتجميع المقاييس استنادًا إلى أنواع الإعلانات التي تم عرضها خلال عمليات تشغيل الفيديو. يوضّح قسم تقارير أداء الإعلان نوعَي مقاييس أداء الإعلانات المتوافقة مع واجهة برمجة التطبيقات.
استرداد تقرير
لاسترداد تقرير قناة، يجب ضبط قيمة المعلَمة ids في طلب البيانات من واجهة برمجة التطبيقات على إحدى القيم التالية:
channel==MINE – تعرض واجهة برمجة التطبيقات بيانات قناة المستخدم على YouTube التي تمت المصادقة عليها.
channel==CHANNEL_ID – اضبط CHANNEL_ID على معرّف القناة الفريد للقناة التي تسترد بياناتها. يجب أن يكون المستخدم الذي يفوّض الطلب هو مالك القناة.
معرّف القناة هو حاليًا سلسلة تبدأ بالحرفين UC، إلا أنّ تنسيقه عرضة للتغيير. (يمكنك العثور على معرّف قناتك في صفحة إعدادات الحساب المتقدّمة لقناتك على YouTube، أو يمكنك استرداد معرّف قناتك آليًا باستخدام طريقة channels.listYouTube Data API's).
التفويض
يجب الحصول على تفويض لجميع طلبات البيانات من YouTube Analytics API. يوضح دليل التفويض كيفية استخدام بروتوكول OAuth 2.0 لاسترداد رموز التفويض.
تستخدم طلبات البيانات من YouTube Analytics API نطاقات التفويض التالية:
الاطّلاع على تقارير "إحصاءات YouTube" للمحتوى الخاص بك في YouTube يوفّر هذا النطاق إمكانية الوصول إلى مقاييس نشاط المستخدم، مثل عدد المشاهدات وأعداد التقييمات.
عرض تقارير "إحصاءات YouTube" المالية للمحتوى الخاص بك على YouTube يوفّر هذا النطاق إمكانية الوصول إلى مقاييس نشاط المستخدم والاطّلاع على الأرباح المقدّرة ومقاييس أداء الإعلانات.
https://www.googleapis.com/auth/youtube
إدارة حسابك على YouTube في YouTube Analytics API، يستخدم مالكو القنوات هذا النطاق لإدارة مجموعات "إحصاءات YouTube" وعناصرها.
https://www.googleapis.com/auth/youtubepartner
عرض وإدارة مواد العرض في YouTube والمحتوى المرتبط بها على YouTube في YouTube Analytics API، يستخدم مالكو المحتوى هذا النطاق لإدارة مجموعات "إحصاءات YouTube" وعناصرها.
ملاحظة: لا تتوفّر حاليًا مقاييس الأرباح وأداء الإعلانات في تقارير القنوات. ونتيجةً لذلك، لا يمنح نطاق https://www.googleapis.com/auth/yt-analytics-monetary.readonly حاليًا إمكانية الوصول إلى البيانات المالية في تلك التقارير.
فلاتر
تحدّد الجداول التي تشرح التقارير المتوافقة الفلاتر التي يمكن استخدامها لكل تقرير. في الجداول، تكون الفلاتر الظاهرة بين قوسين اختيارية. على سبيل المثال، بالنسبة إلى خيار الفلترة video(,country)، يكون فلتر الفيديو مطلوبًا وفلتر البلد اختياريًا.
وتتيح واجهة برمجة التطبيقات أيضًا إمكانية تحديد قيم متعدّدة للفلترَين video وplaylist. في حال تحديد قيم متعدّدة لأحد هذه الفلاتر، يمكنك أيضًا إضافة هذا الفلتر إلى قائمة السمات التي تحدِّدها للطلب. ينطبق ذلك حتى إذا لم يكن الفلتر مُدرَجًا كسمة متاحة لتقرير معيّن.
يمكنك الاطّلاع على تعريف معلَمة filters للحصول على شرح كامل حول كيفية فلترة نتائج واجهة برمجة التطبيقات الخاصة بقيمة معيّنة أو مجموعة من القيم.
فهم جداول التقارير
يشرح هذا القسم التنسيق والمصطلحات المستخدَمة في الجداول التي تحدّد التقارير المتوافقة مع واجهة برمجة التطبيقات. يسرد الجدول أدناه السمات والمقاييس والفلاتر المتوافقة مع تقرير الفيديو الخاص بتفاصيل التشغيل باستخدام السمة الزمنية والمقياس averageViewPercentage.
يحتوي الجدول على صفَين للسمات، وصف واحد للمقاييس، وثلاثة صفوف للفلاتر. بالنسبة إلى
السمات والفلاتر، يمكن دمج القيم من كل صف في طلب من واجهة برمجة التطبيقات ما دامت
المجموعة تتّبع قواعد الاستخدام الواردة في الجدول. على سبيل المثال، تتضمّن قيم مَعلمات dimensions الصالحة لهذا التقرير ما يلي:
dimensions=day
dimensions=day,liveOrOnDemand
dimensions=month,subscribedStatus,youtubeProduct
dimensions=month,youtubeProduct
مع ذلك، فإنّ قيمة المَعلمة day,month غير صالحة لأنّها تستخدِم سمتَين يستندتَين إلى الوقت،
ولكن يمكن أن يستخدم الطلب 0 أو 1. في هذه الحالة، تعرض قيمة المعلَمة
subscribedStatus,youtubeProduct تقريرًا، ولكن لا يتم
تجميع المقاييس حسب اليوم أو الأسبوع أو الشهر أو غير ذلك (يتم توثيق هذا التقرير بشكل منفصل في المستندات).
مصطلحات جدول التقارير
تستخدم الجداول المصطلحات التالية لتوضيح ما إذا كانت السمات مطلوبة أو اختيارية:
تشير هذه المصطلحات إلى أنّ القيمة مطلوبة:
مطلوب: يجب تضمين القيمة.
استخدِم القيمة 1 بالضبط: عليك تضمين قيمة واحدة من المجموعة.
استخدام 1 أو أكثر: يمكنك تضمين أي من القيم أو جميعها من المجموعة، ولكن يجب تضمين قيمة واحدة على الأقل.
وتعني هذه المصطلحات أنّ القيمة اختيارية:
اختياري: يتوفّر لك خيار تضمين القيمة.
استخدام 0 أو 1: يتوفّر لك خيار تضمين قيمة واحدة من المجموعة.
استخدام 0 أو أكثر: يمكنك تضمين أيٍّ من القيم من المجموعة أو جميعها.
تقارير الفيديوهات
الإحصاءات الأساسية
إحصاءات نشاط المستخدم الأساسية
يقدّم هذا التقرير إحصاءات مرتبطة بإجراءات المستخدمين على قناة معيّنة. يمكنك فلترة التقرير بحيث يعرض البيانات الخاصة بفيديو معيّن أو بلد معيّن فقط.
إحصاءات أساسية حول نشاط المستخدم في الولايات الأمريكية
يقدم هذا التقرير إحصاءات لإحدى الولايات الأمريكية أو مقاطعة كولومبيا. تجدر الإشارة إلى أنّ هذا التقرير يتيح فقط مجموعة فرعية من المقاييس المتوفرة في التقرير الخاص بالبلد والموضّح أعلاه.
يقدم هذا التقرير إحصاءات مرتبطة بإجراءات المستخدم على قناة لفترات زمنية محددة. يمكنك فلترة التقرير بحيث يعرض البيانات الخاصة بفيديو معيّن أو بلد معيّن فقط.
نشاط المستخدم في الولايات الأمريكية لفترات زمنية محدّدة
يقدِّم هذا التقرير إحصاءات ذات صلة بنشاط المستخدِم في ولاية أمريكية معيَّنة أو مقاطعة كولومبيا. تجدر الإشارة إلى أنّ هذا التقرير يتيح فقط مجموعة فرعية من المقاييس المتوفرة في التقرير الخاص بالبلد والموضّح أعلاه.
ملاحظة: يتطلب منك هذا التقرير ضبط المعلمة maxResults على قيمة عدد صحيح تبلغ 250 أو أقل. على عكس معظم التقارير الأخرى، يتطلب منك هذا التقرير أيضًا تحديد قيمة لمَعلمة طلب sort.
يقدم هذا التقرير إحصاءات نشاط المستخدم حسب المدينة.
يوفّر هذا التقرير مقاييس نشاط المستخدم للمشاهدين المشتركين وغير المشتركين في القناة. يمكن تجميع الإحصاءات حسب الفترة الزمنية (اليوم أو الشهر)، ويمكن أيضًا فلترة التقرير حسب البلد أو القارة أو subContinent.
يوفّر هذا التقرير مقاييس نشاط المستخدم للمشاهدين المشتركين وغير المشتركين في الولايات الأمريكية أو مقاطعة كولومبيا. يعرض هذا التقرير مقاييس أقل من التقرير السابق.
تُعدّ سمة الوقت، وهي اليوم أو الشهر، اختيارية لهذه التقارير، لأنّه عليك استخدام مَعلمتَي الطلب startDate وendDate لتحديد النطاق الزمني الذي سيغطّيه التقرير. تشير السمة، إن توفّرت، إلى أنّك تريد تجميع البيانات في التقرير حسب اليوم أو الشهر أو غير ذلك.
تفاصيل التشغيل مع سمة زمنية اختيارية وإحصاءات liveOrOnDemand
يقدّم هذا التقرير إحصاءات مفصّلة للتشغيل لفترات زمنية محدّدة. تتيح هذه الصفحة استخدام السمة liveOrOnDemand (والفلتر).
ملاحظة: يتطلب منك هذا التقرير ضبط المعلمة maxResults على قيمة عدد صحيح تبلغ 25 أو أقل. على عكس معظم التقارير الأخرى، يتطلب منك هذا التقرير أيضًا تحديد قيمة لمَعلمة طلب sort.
يحدد هذا التقرير مشغّلات الفيديو المضمّنة التي أدّت إلى أكبر عدد من المشاهدات أو وقت المشاهدة لفيديوهات القناة.
يجمع هذا التقرير إحصاءات المشاهدة استنادًا إلى الطريقة التي وصل بها المشاهدون إلى محتوى الفيديو الخاص بك. على سبيل المثال، يحدّد عدد المشاهدات الناتجة من بحث على Google أو من رابط يؤدي إلى فيديو ذي صلة.
ملاحظة: يتطلب منك هذا التقرير ضبط المعلمة maxResults على قيمة عدد صحيح تبلغ 25 أو أقل. على عكس معظم التقارير الأخرى، يتطلب منك هذا التقرير أيضًا تحديد قيمة لمَعلمة طلب sort.
يجمّع هذا التقرير إحصاءات المشاهدة استنادًا إلى المُحيلين الذين حقّقوا أكبر عدد من المشاهدات لمحتوى القناة. ويتم تصنيف المُحيلين حسب نوع مصدر الزيارات، في حين يُحدِّد تعريف السمة insightTrafficSourceDetail مصادر الزيارات التي يتوفّر لها التقرير. على سبيل المثال، في حال ضبط الفلتر insightTrafficSourceType على ADVERTISING، سيعرِض التقرير أنواع الإعلانات التي أدّت إلى أكبر عدد من المشاهدات أو وقت المشاهدة لمحتوى القناة.
ملاحظة: لا يتوفّر هذا التقرير إلّا لمصادر زيارات محدَّدة. على سبيل المثال، لا يحتوي مصدر الزيارات NO_LINK_EMBEDDED على تفاصيل إضافية، وبالتالي لا يتيح استخدام هذا التقرير. يُرجى الاطّلاع على تعريف insightTrafficSourceType لمعرفة تفاصيل عن مصادر الزيارات التي تتوافق مع هذا التقرير.
نوع الجهاز ونظام التشغيل
نوع الجهاز
يجمع هذا التقرير إحصاءات المشاهدة استنادًا إلى الطريقة التي وصل بها المشاهدون إلى محتوى الفيديو الخاص بك. على سبيل المثال، يحدِّد عدد المشاهدات على الأجهزة الجوّالة أو وحدات تحكّم الألعاب.
يجمّع هذا التقرير إحصاءات المشاهدة استنادًا إلى أنظمة التشغيل وأنواع الأجهزة التي يستخدمها المشاهدون. على سبيل المثال، يحدد هذا المقياس عدد مرات المشاهدة التي حدثت على أجهزة Android اللوحية أو أجهزة سطح المكتب التي تعمل بنظام Windows.
يقيس هذا التقرير قدرة الفيديو على الاحتفاظ بجمهوره. تقيس السمة elapsedVideoTimeRatio المدة المنقضية من الفيديو بالنسبة إلى قيم المقياس المقابلة. يوفّر المقياسان audienceWatchRatio وrelativeRetentionPerformance قياسَين يوضّحان مدى احتفاظ الفيديو بالجمهور. تمثّل القيمة الأولى قيمة مطلقة، بينما تعرض الثانية مستوى أداء الفيديو مقارنةً بالفيديوهات الأخرى ذات المدة المشابهة على YouTube.
ملاحظة: لا تتيح تقارير الاحتفاظ بالجمهور إمكانية تحديد قائمة قيم مفصولة بفواصل لفلتر video. يجب أن تحدّد القيمة معرّف فيديو واحدًا.
ملاحظة: تتطلب منك هذه التقارير ضبط المعلمة maxResults على قيمة عدد صحيح تبلغ 200 أو أقل. تتوفّر بيانات أبرز 10 فيديوهات فقط قبل 1 كانون الثاني (يناير) 2013. وعلى عكس معظم التقارير الأخرى، تتطلّب منك هذه التقارير أيضًا تحديد قيمة لمَعلمة طلب sort.
الفيديوهات الأفضل أداءً التي تم تطبيق فلاتر اختيارية عليها في المنطقة (<= 200 نتيجة)
يعرض هذا التقرير الفيديوهات الأفضل أداءً في القناة. يمكن فلترة التقرير لعرض أبرز الفيديوهات حسب البلد أو القارة أو subContinent.
يعرض هذا التقرير الفيديوهات الأفضل أداءً على القناة في ولاية أمريكية معيّنة أو مقاطعة كولومبيا. تجدر الإشارة إلى أنّ هذا التقرير يتيح فقط مجموعة فرعية من المقاييس المتوفرة في التقرير الخاص بالبلد والموضّح أعلاه.
أبرز الفيديوهات للمشاهدين المشتركين أو غير المشتركين(<= 200 نتيجة)
يعرض هذا التقرير أبرز الفيديوهات في القناة للمشاهدين المشتركين أو غير المشتركين فيها. يمكن فلترة التقرير لعرض أبرز الفيديوهات حسب البلد أو القارة أو subContinent. يتيح لك التقرير السابق الاطّلاع على أبرز الفيديوهات في ولاية أمريكية معيّنة للمشاهدين المشتركين أو غير المشتركين في قناتك، ولكنّه يوفّر مقاييس أقل من تلك الواردة في هذا التقرير.
الفيديوهات الأفضل أداءً حسب منتج YouTube (<= 200 نتيجة)
يعرض هذا التقرير الفيديوهات الأفضل أداءً في القناة ويتضمّن تفاصيل التشغيل والفلاتر الجغرافية. هذا التقرير مشابه للتقرير السابق، ولكنّه يتيح استخدام مقاييس أقلّ ويضيف إمكانية استخدام فلتر youtubeProduct.
تحتوي تقارير قوائم التشغيل على مقاييس مرتبطة بنشاط المستخدم ذي الصلة بالفيديوهات في قوائم التشغيل
الخاصة بمالك القناة. يتوفّر إصداران من هذه التقارير، وتحتوي الأقسام التالية على وصف لكل نسخة لكل تقرير متاح:
تصف علامة التبويب مقترَحة في كل قسم التنسيق المفضّل لطلب البيانات من واجهة برمجة التطبيقات
لاسترداد التقرير ذي الصلة. تتيح التقارير المقترَحة استخدام مجموعة موسّعة من المقاييس التي تتضمّن مقاييس الفيديوهات المجمّعة والمقاييس المضمّنة في قائمة التشغيل. ولا يستخدم تنسيق الطلب هذا السمة isCurated.
تصف علامة التبويب استخدام isCurated في كل قسم تنسيقًا قديمًا لطلب البيانات من واجهة برمجة التطبيقات يجب استخدام السمة isCurated. تتيح هذه التقارير استخدام
المقاييس المضمّنة في قائمة التشغيل فقط. يُرجى العلم أنّه تم إيقاف السمة
isCurated نهائيًا في جميع التقارير. وتوضّح ملاحظة التحذير أدناه الجدول الزمني للإيقاف النهائي.
توضِّح الملاحظة التحذيرية التالية التغييرات بين النسختَين من التقرير بمزيد من التفصيل.
مقاييس الفيديو المجمَّعة
تعرض هذه المقاييس مقاييس نشاط المستخدم ومرات الظهور المجمّعة لكل الفيديوهات المضمّنة في قائمة التشغيل والمملوكة أيضًا للقناة التي تملكها. ولا يتم احتساب مقاييس الفيديوهات
التي تملكها قنوات أخرى عند التجميع. نتيجةً لذلك، إذا أنشأت قناة
قائمة تشغيل تتضمّن فقط فيديوهات تملكها قنوات أخرى، لن تقدّم التقارير حول قوائم التشغيل هذه
قيمًا لهذه المقاييس.
وتعكس هذه المقاييس نشاط المستخدم وتفاعله في سياق صفحة قائمة التشغيل. وتشمل هذه
المقاييس عدد مشاهدات كل الفيديوهات في قائمة التشغيل بغض النظر عن القناة التي تملكها، ولكنّها
تُحتسب فقط عدد المشاهدات التي حدثت في سياق قائمة التشغيل.
يقدّم هذا التقرير إحصاءات مرتبطة بتفاعلات المستخدمين مع الفيديوهات في قوائم التشغيل
على القناة. يمكنك فلترة التقرير بحيث لا يعرض سوى بيانات قائمة تشغيل معيّنة.
يقدّم هذا التقرير إحصاءات مرتبطة بتفاعلات المستخدمين مع الفيديوهات في قوائم التشغيل
على القناة. يمكنك فلترة التقرير بحيث لا يعرض سوى بيانات قائمة تشغيل معيّنة.
يقدّم هذا التقرير إحصاءات حول نشاط قوائم التشغيل في الولايات الأمريكية ومقاطعة كولومبيا.
بالنسبة إلى هذا التقرير، عليك فلترة النتائج لعرض البيانات الخاصة بالولايات المتحدة فقط.
ملاحظة: يتطلب منك هذا التقرير ضبط المعلمة maxResults على قيمة عدد صحيح تبلغ 25 أو أقل. على عكس معظم التقارير الأخرى، يتطلب منك هذا التقرير أيضًا تحديد قيمة لمَعلمة طلب sort.
يحدّد هذا التقرير مشغّلات الفيديو المضمّنة التي أدّت إلى أكبر عدد من المشاهدات أو وقت المشاهدة
للفيديوهات في قوائم التشغيل في القناة.
يجمع هذا التقرير إحصاءات المشاهدة استنادًا إلى كيفية وصول المشاهدين إلى محتوى قائمة التشغيل.
على سبيل المثال، يحدد هذا الرقم عدد المشاهدات التي نتجت من بحث على Google.
ملاحظة: يتطلب هذا التقرير ضبط المعلمة maxResults على قيمة عدد صحيح تبلغ 25 أو أقل. على عكس معظم التقارير الأخرى، يتطلب منك هذا التقرير أيضًا تحديد قيمة لمعلَمة طلب sort.
يجمّع هذا التقرير إحصاءات المشاهدة استنادًا إلى المُحيلين الذين جلبوا أكبر عدد من المشاهدات
للفيديوهات في قوائم التشغيل في القناة. يتم تصنيف المُحيلين حسب نوع مصدر الزيارات، ويحدّد تعريف السمة insightTrafficSourceDetail مصادر الزيارات التي يتوفّر لها التقرير.
على سبيل المثال، في حال ضبط فلتر insightTrafficSourceType
على ADVERTISING، سيسرد التقرير أنواع الإعلانات التي أدت إلى أكبر عدد
من المشاهدات أو وقت المشاهدة لقوائم التشغيل في القناة.
ملاحظة: لا يتوفّر هذا التقرير إلّا لمصادر زيارات محدَّدة. على سبيل المثال، لا يحتوي مصدر الزيارات NO_LINK_EMBEDDED على تفاصيل إضافية، وبالتالي لا يتيح استخدام هذا التقرير. يُرجى الاطّلاع على تعريف insightTrafficSourceType لمعرفة تفاصيل عن مصادر الزيارات التي تتوافق مع هذا التقرير.
نوع الجهاز ونظام التشغيل
نوع الجهاز
يجمّع هذا التقرير إحصاءات المشاهدة استنادًا إلى كيفية وصول المشاهدين إلى الفيديوهات في
قوائم التشغيل الخاصة بك. على سبيل المثال، يحدّد عدد المشاهدات على الأجهزة الجوّالة أو وحدات تحكّم الألعاب.
يجمع هذا التقرير إحصاءات المشاهدة استنادًا إلى أنظمة تشغيل المشاهدين. على سبيل المثال، يحدد التقرير عدد المشاهدات التي تمت على أجهزة Android أو PlayStation.
يجمّع هذا التقرير إحصاءات المشاهدة استنادًا إلى أنظمة التشغيل وأنواع الأجهزة التي يستخدمها المشاهدون.
على سبيل المثال، يحدِّد عدد المشاهدات على الأجهزة اللوحية التي تعمل بنظام التشغيل Android أو أجهزة الكمبيوتر المكتبي التي تعمل بنظام التشغيل Windows.
على سبيل المثال، يعرض التقرير الذي يستخدم السمة subscribedStatus بيانات viewerPercentage مع إضافة ما يصل إلى 100 في المئة لبيانات المشاهدات المشتركين وviewerPercentage مع إضافة نسبة تصل إلى 100 لغير المشتركين. (تبلغ القيمة الإجمالية لجميع حقول viewerPercentage في التقرير 200 في المئة.)
ملاحظة: تتطلب منك هذه التقارير ضبط المعلمة maxResults على قيمة عدد صحيح تبلغ 200 أو أقل. تتوفّر بيانات أهم 10 قوائم تشغيل فقط قبل 1 كانون الثاني (يناير) 2013. وعلى عكس معظم التقارير الأخرى، تتطلّب منك هذه التقارير أيضًا تحديد قيمة لمَعلمة طلب sort.
يعرض هذا التقرير أهم قوائم التشغيل في القناة استنادًا إلى معايير الفلترة والترتيب المحدّدة.
ملاحظة: تتطلب تقارير أداء الإعلان رمزًا مميزًا للتفويض يمنح إمكانية الوصول إلى نطاق https://www.googleapis.com/auth/yt-analytics-monetary.readonly.
تقدّم تقارير أداء الإعلانات مقاييس مستندة إلى مرات الظهور للإعلانات التي تم عرضها أثناء تشغيل الفيديوهات. تأخذ هذه المقاييس في الحسبان كل مرة ظهور للإعلان، ويمكن أن تؤدي كل عملية تشغيل لفيديو إلى مرات ظهور متعددة.
في ما يلي مقاييس أداء الإعلانات المستندة إلى مرات الظهور:
بالإضافة إلى ذلك، تتيح بعض تقارير الفيديوهات مقاييس أداء الإعلانات التالية المستندة إلى التشغيل. ومع ذلك، لا يتم تضمين هذه المقاييس في تقارير أداء الإعلانات.