Dimensions

يحدّد هذا المستند السمات المتوافقة مع YouTube Analytics API. تتيح واجهة برمجة التطبيقات هذه استخدام طلبات البحث المستهدفة في الوقت الفعلي لإنشاء تقارير مخصّصة في "إحصاءات YouTube".

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

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

لاسترجاع تقرير طلب بحث، عليك استدعاء طريقة reports.query في YouTube Analytics API. يمكنك استخدام المَعلمة dimensions في طلبك لتحديد السمات التي ستستخدمها YouTube لاحتساب قيم المقاييس في التقارير.

السمات الأساسية

على الرغم من أنّ YouTube Analytics API تخضع لسياسة الإيقاف النهائي المنصوص عليها في بنود الخدمة، لا تخضع السمات غير الأساسية (والمقاييس غير الأساسية) لهذه السياسة. في التعريفات الواردة في هذه الصفحة، يتمّ تحديد أيّ سمة أساسية بشكلٍ صريح على أنّها كذلك.

تحدِّد القائمة التالية السمات الأساسية لواجهة برمجة التطبيقات.

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

فلاتر

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

في طلب استرداد تقرير أداء طلبات البحث، تحدِّد معلَمة طلب filters الاختيارية قيم السمات التي تريد فلترة بياناتها. على سبيل المثال، لاسترداد مقاييس نشاط المستخدِم لأوروبا، يمكنك ضبط قيمة المَعلمة filters على continent==150.

ملاحظة مهمة: يجب أن تتم فلترة البيانات في طلبات البيانات من واجهة برمجة التطبيقات لاسترداد تقارير مالكي المحتوى باستخدام إحدى سمات جهة إعداد التقارير أو باستخدام مجموعة متوافقة من السمتَين claimedStatus وuploaderType.

الأبعاد

تحدّد الأقسام التالية السمات المستخدَمة في تقارير طلبات البحث في واجهة برمجة تطبيقات YouTube Analytics. ويتم استخدام هذه السمات في تقريرَي القناة ومالك المحتوى، ما لم يُذكر خلاف ذلك. ويتم أيضًا تحديد السمات التي لا يمكن استخدامها إلّا كفلاتر.

المراجِع

تتوافق هذه السمات مع الموارد التي يديرها مالكو القنوات والمحتوى على YouTube:

ملاحظة: تتيح لك واجهة برمجة التطبيقات تحديد قيم متعدّدة للسمات video وplaylist وchannel عند استخدامها كفلاتر. لإجراء ذلك، اضبط قيمة المعلَمة filters على قائمة مفصولة بفواصل لمعرّفات الفيديوهات أو قائمة التشغيل أو القنوات التي يجب فلترة استجابة واجهة برمجة التطبيقات لها. يمكن أن تحدِّد قيمة المَعلمة ما يصل إلى 500 رقم تعريف.

الفيديو (السمة الأساسية)
معرّف فيديو على YouTube في YouTube Data API، هذه هي قيمة السمة id لمورد video. This is a core dimension and is subject to the Deprecation Policy.
قائمة التشغيل
معرّف قائمة تشغيل على YouTube في YouTube Data API، هذه هي قيمة السمة id لمورد playlist.
القناة (السمة الأساسية) (تُستخدَم فقط في تقارير مالكي المحتوى)
رقم تعريف قناة على YouTube في YouTube Data API، هذه هي قيمة السمة id لمورد channel. This is a core dimension and is subject to the Deprecation Policy.

غالبًا ما يتمّ استخدام السمة channel في تقارير مالكي المحتوى لأنّ هذه التقارير تجمع عادةً بيانات لقنوات متعدّدة.
المجموعة (الفلتر فقط)
رقم تعريف مجموعة في "إحصاءات YouTube" يمكنك استرداد هذه القيمة باستخدام طريقة groups.list في واجهة برمجة تطبيقات YouTube Analytics. عند استخدام الفلتر "group"، ستتضمّن استجابة واجهة برمجة التطبيقات بيانات لكل الفيديوهات أو قوائم التشغيل أو القنوات في المجموعة المعنيّة.

أمثلة

تستخدِم نماذج الطلبات التالية سمات أو فلاتر كيانات إعداد التقارير:

  • أمثلة على القنوات

    • الإحصاءات الأساسية
      • أبرز 10 فيديوهات: الفيديوهات الأكثر مشاهدةً على القناة
      • أهم 10: نِسب النقر إلى الظهور للتعليقات التوضيحية للفيديوهات الأكثر مشاهدة في القناة
      • إحصاءات حول قائمة تشغيل معيّنة
      • أهمّ 10: قوائم التشغيل الأكثر مشاهدة على القناة
    • الموقع الجغرافي
      • أبرز 10 – الفيديوهات الأكثر مشاهدة في بلد معيّن
      • أهم 10 – الفيديوهات الأكثر مشاهدة في أوروبا

  • أمثلة مالك المحتوى

    • الإحصاءات الأساسية
      • أهم 10 - فيديوهات أكثر مشاهدة لدى مالك محتوى
      • أهم 10 فيديوهات - الفيديوهات الأكثر مشاهدة لدى مالك المحتوى
      • أهم 10 - الفيديوهات الأكثر مشاهدة على قناة مالك المحتوى
      • أهم 10: نِسب النقر إلى الظهور للتعليقات التوضيحية للفيديوهات الأكثر مشاهدة في القناة
      • أهم 10: قوائم التشغيل الأكثر مشاهدة لدى مالك المحتوى
    • الموقع الجغرافي
      • أهم 10 - الفيديوهات الأكثر مشاهدة في أوروبا لدى مالك المحتوى
      • أبرز 10 قوائم تشغيل – قوائم التشغيل الأكثر بدءاً في الولايات المتحدة

المناطق الجغرافية

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

البلد (السمة الأساسية)
البلد المرتبط بالمقاييس الواردة في صف التقرير. قيمة السمة هي رمز بلد مكوّن من حرفَين وفقًا لمعيار ISO-3166-1، مثل US أو CN (الصين) أو FR (فرنسا). يُستخدم رمز البلد ZZ للإبلاغ عن المقاييس التي تعذّر على YouTube تحديد البلد المرتبط بها. This is a core dimension and is subject to the Deprecation Policy.
province
الولاية أو المنطقة الأمريكية المرتبطة بالمقاييس الواردة في صف التقرير قيمة السمة هي رمز ISO 3166-2 يحدّد إحدى الولايات الأمريكية أو مقاطعة كولومبيا، مثل US-MI (ميشيغان) أو US-TX (تكساس). يُستخدم رمز المقاطعة US-ZZ للإبلاغ عن المقاييس التي تعذّر على YouTube تحديد الولاية المرتبطة بها في الولايات المتحدة. عندما يتضمّن طلب بيانات من واجهة برمجة التطبيقات province في قيمة المعلَمة dimensions، يجب أن يحصر الطلب أيضًا البيانات في الولايات المتحدة من خلال تضمين country==US في قيمة المعلَمة filters.

ملاحظة: لا تتوافق هذه السمة مع قيم ISO 3166-2 التي تحدّد المناطق النائية للولايات المتحدة لأنّ هذه المناطق لها أيضًا رموز البلدان وفقًا لمعيار ISO 3166-1. ولا يدعم أيضًا التقسيمات الفرعية لبلدان أخرى غير الولايات المتحدة.

city
المدينة المقدَّرة المرتبطة بالمقاييس الواردة في صف التقرير. تتوفّر بيانات هذه السمة للتواريخ التي تبدأ في 1 كانون الثاني (يناير) 2022.
قارة (الفلتر فقط)
رمز منطقة إحصائي للأمم المتحدة. تتيح واجهة برمجة التطبيقات استخدام القيم التالية:
القيم
002 أفريقيا
019 الأمريكتان (أمريكا الشمالية وأمريكا اللاتينية وأمريكا الجنوبية ومنطقة البحر الكاريبي)
142 آسيا
150 أوروبا
009 أوقيانوسيا
لا يمكن استخدام هذه السمة إلّا لفلترة البيانات. لاستخدام هذه السمة، اضبط قيمة المعلَمة filters على continent==REGION_CODE، مع تحديد قيمة REGION_CODE من القائمة أعلاه.
subContinent (الفلتر فقط)
رمز منطقة إحصائي خاص بالأمم المتحدة يحدِّد منطقة جغرافية فرعية. تسرد شعبة الإحصاءات بالأمم المتحدة المناطق الفرعية إلى جانب البلدان التي تربطها بكل منطقة.

لا يمكن استخدام هذه السمة إلّا لفلترة البيانات. لاستخدام هذه السمة، اضبط قيمة المعلَمة filters على subContinent==REGION_CODE، مع تحديد قيمة REGION_CODE من قائمة UN.

أمثلة

تستخدِم نماذج الطلبات التالية سمات أو فلاتر جغرافية:

  • أمثلة على القنوات

    • الإحصاءات الأساسية: عدد المشاهدات لبلد معيّن (وغير ذلك) لقناة معيّنة
    • الموقع الجغرافي
      • مقاييس وقت المشاهدة لفيديوهات القناة حسب البلد
      • مقاييس التعليقات التوضيحية المرتبطة ببلدان محددة في فيديوهات القناة
      • المقاييس المتعلّقة بالمقاطعة في الولايات الأمريكية وواشنطن العاصمة
      • مقاييس وقت المشاهدة لقوائم التشغيل في قناة معيّنة
      • أبرز 10 قوائم تشغيل – قوائم التشغيل الأكثر بدءاً في الولايات المتحدة
    • موقع التشغيل: عدد المشاهدات اليومي ووقت المشاهدة من مواقع تشغيل مختلفة
    • مصدر الزيارات: عدد المشاهدات ووقت المشاهدة من مصادر زيارات مختلفة في بلد معيّن
    • الخصائص الديمغرافية: الخصائص الديمغرافية للمشاهدين في كاليفورنيا (الفئة العمرية والجنس)
    • الفيديوهات الأفضل أداءً
      • أبرز 10 – الفيديوهات الأكثر مشاهدة في بلد معيّن
      • أهم 10 – الفيديوهات الأكثر مشاهدة في أوروبا

  • أمثلة مالك المحتوى

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

الفترات الزمنية

تشير هذه السمات إلى أنّ التقرير يجب أن يجمع البيانات استنادًا إلى فترة زمنية معيّنة، مثل يوم أو أسبوع أو شهر. تُحدِّد مَعلمات الطلب startDate وendDate الفترة الزمنية التي يتضمّن التقرير بيانات لها. تجدر الإشارة إلى أنّ التقرير يعرض البيانات حتى اليوم الأخير الذي تتوفّر له جميع المقاييس المحدّدة في الطلب وقت إجراء طلب البحث. يتم إدراج التواريخ في التقارير بالتنسيق YYYY-MM-DD.

ملاحظة مهمة: تشير جميع التواريخ إلى الفترة الزمنية التي تبدأ من الساعة 12:00 صباحًا بتوقيت المحيط الهادئ (UTC-7 أو UTC-8) وتنتهي في الساعة 11:59 مساءً بتوقيت المحيط الهادئ في اليوم والشهر والسنة المحدَّدين. ونتيجة لذلك، فإن التواريخ التي يتم فيها تعديل التوقيت وفقًا بالتوقيت الصيفي تمثل فترة 23 ساعة، والتواريخ التي يتم فيها تعديل التوقيت بالعكس تمثل فترة 25 ساعة.

يشير البُعد الشهر إلى الفترة الزمنية التي تبدأ في الساعة 12:00 صباحًا بتوقيت المحيط الهادئ (UTC-7 أو UTC-8) في أول يوم من الشهر والسنة المحدَّدين.

اليوم (السمة الأساسية)
عند استخدام هذه السمة، يتم تجميع البيانات في التقرير يوميًا ويحتوي كل صف على بيانات ليوم واحد. ويمكنك استخدام سمات أخرى لتقسيم البيانات بشكل أكبر. على سبيل المثال، قد يجمع تقرير مصادر الزيارات إحصاءات المشاهدة اليومية استنادًا إلى طريقة وصول المستخدمين إلى فيديوهاتك. This is a core dimension and is subject to the Deprecation Policy.
الشهر (السمة الأساسية)
يتم تجميع البيانات الواردة في التقرير حسب الشهر التقويمي. كما هو الحال مع التقارير اليومية، يمكنك استخدام الفلاتر الأخرى لتقسيم البيانات بصورةٍ أكبر. يتم إدراج التواريخ في التقرير بالتنسيق YYYY-MM.

ملاحظة: إذا كان طلب البحث من واجهة برمجة التطبيقات يستخدم السمة month، يجب ضبط المعلمتَين start-date وend-date على أول يوم من الشهر. This is a core dimension and is subject to the Deprecation Policy.

أمثلة

تستخدِم طلبات النماذج التالية سمات أو فلاتر زمنية:

  • أمثلة على القنوات

    • الاستناد إلى الوقت
      • مقاييس وقت المشاهدة اليومية لفيديوهات القناة
      • مقاييس التعليقات التوضيحية اليومية للفيديوهات على القناة
      • عدد المشاهدات اليومية لقائمة التشغيل لإحدى القنوات
    • موقع التشغيل: عدد المشاهدات اليومي ووقت المشاهدة من مواقع تشغيل مختلفة
    • مصدر الزيارات: يعرض عدد المشاهدات اليومي ووقت المشاهدة من مصادر زيارات مختلفة.
    • الجهاز/نظام التشغيل
      • مقاييس نوع الجهاز اليومية لنظام التشغيل Android
      • مقاييس نظام التشغيل اليومية للأجهزة الجوّالة
      • مقاييس نظام التشغيل ونوع الجهاز اليومي

  • أمثلة مالك المحتوى

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

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

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

insightPlaybackLocationType
يتم تجميع البيانات في التقرير استنادًا إلى نوع الصفحة أو التطبيق الذي حدثت فيه عمليات تشغيل الفيديو. القيم المحتمَلة لهذه السمة هي:

  • BROWSE – تشير البيانات إلى المشاهدات التي تمّت على الصفحة الرئيسية أو الشاشة الرئيسية في YouTube أو في خلاصة اشتراكات المستخدم أو في ميزة أخرى في التصفّح على YouTube.

  • CHANNEL – تصف البيانات عدد المشاهدات التي تمّت لصفحة قناة معيّنة.

  • EMBEDDED – تصف البيانات عدد المشاهدات التي تمّت على موقع إلكتروني أو تطبيق آخر كان الفيديو مضمّنًا فيه باستخدام <iframe> أو <object>.

  • EXTERNAL_APP – تصف البيانات عدد المشاهدات التي تمّت من خلال تطبيق تابع لجهة خارجية، حيث تم تشغيل الفيديو بطريقة أخرى غير <iframe> أو <object> المضمَّن. على سبيل المثال، سيتم تصنيف عمليات التشغيل في التطبيقات التي تستخدم YouTube Android Player API باستخدام هذه القيمة.

  • MOBILE – تشير البيانات إلى عدد المشاهدات التي تمّت على موقع YouTube الإلكتروني للأجهزة الجوّالة أو في برامج YouTube API المعتمَدة، بما في ذلك الأجهزة الجوّالة.

    ابتداءً من 10 أيلول (سبتمبر) 2013، سنتوقف عن تصنيف عمليات التشغيل ضمن تقارير "إحصاءات YouTube" ضمن فئة MOBILE تشغيل. قد تبقى القيمة في التقارير لأنّ البيانات القديمة لا تزال تندرج ضمن تلك الفئة. ومع ذلك، بعد هذا التاريخ، يتم تصنيف عمليات التشغيل على الأجهزة الجوّالة ضمن عمليات تشغيل WATCH أو EMBEDDED أو EXTERNAL_APP بناءً على نوع التطبيق الذي تتم فيه عمليات التشغيل.

  • SEARCH – تشير البيانات إلى عدد المشاهدات التي تمّت مباشرةً على صفحة نتائج البحث في YouTube.

  • WATCH – تشير البيانات إلى عدد المشاهدات التي تمّت على صفحة مشاهدة الفيديو على YouTube أو في تطبيق YouTube الرسمي، مثل تطبيق YouTube لأجهزة Android.

  • YT_OTHER – تصف البيانات المشاهدات غير المصنَّفة.

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

أمثلة

تستخدم نماذج الطلبات التالية أبعاد موقع التشغيل:

  • أمثلة على القنوات

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

  • أمثلة مالك المحتوى

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

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

creatorContentType
تحدِّد هذه السمة نوع المحتوى المرتبط بمقاييس نشاط المستخدم في صف البيانات. تتوفّر بيانات هذه السمة للتواريخ التي تبدأ في 1 كانون الثاني (يناير) 2019.

يسرد الجدول التالي قيم السمات:
القيم
LIVE_STREAM المحتوى الذي تمّت مشاهدته كان بثًا مباشرًا على YouTube.
SHORTS المحتوى الذي تمّت مشاهدته كان فيديو Shorts.
STORY المحتوى الذي تمّت مشاهدته كان قصة على YouTube.
VIDEO_ON_DEMAND المحتوى الذي تمت مشاهدته كان فيديو على YouTube لا يندرج ضمن إحدى قيم السمات الأخرى.
UNSPECIFIED نوع محتوى المحتوى المعروض غير معروف.
liveOrOnDemand
تشير هذه السمة إلى ما إذا كانت مقاييس نشاط المستخدم في صف البيانات مرتبطة بمشاهدات بث مباشر. تتوفّر بيانات هذه السمة لتواريخ تبدأ من 1 نيسان (أبريل) 2014.

يسرد الجدول التالي قيم السمات:
القيم
LIVE تصف بيانات الصف نشاط المستخدم الذي حدث أثناء بث مباشر.
ON_DEMAND تصف بيانات الصف نشاط المستخدم الذي لم يحدث خلال بث مباشر.
subscribedStatus
تشير هذه السمة إلى ما إذا كانت مقاييس نشاط المستخدم في صف البيانات مرتبطة بالمشاهدين الذين اشتركوا في القناة التي تعرض الفيديو أو قائمة التشغيل. القيمتان المحتملتان هما SUBSCRIBED وUNSUBSCRIBED.

يُرجى العلم أنّ قيمة السمة تكون دقيقة اعتبارًا من وقت حدوث نشاط المستخدم. على سبيل المثال، لنفترض أنّ مستخدمًا لم يشترك في قناة وشاهد إحدى الفيديوهات في تلك القناة، ثمّ اشترك في القناة وشاهد فيديو آخر، وكل ذلك في اليوم نفسه. يشير تقرير القناة إلى أنّ قيمة subscribedStatus هي SUBSCRIBED لإحدى المشاهدات في إحدى المشاهدات، بينما تبلغ قيمة subscribedStatus UNSUBSCRIBED لكل مشاهدة.
youtubeProduct
تحدِّد هذه السمة خدمة YouTube التي حدث عليها نشاط المستخدم. تتوفّر بيانات هذه السمة اعتبارًا من 18 تموز (يوليو) 2015.

يسرد الجدول التالي قيم السمات:
القيم
CORE نشاط المستخدم الذي لم يحدث في أحد تطبيقات YouTube المتخصصة (YouTube Gaming أو YouTube Kids أو YouTube Music) استثناء: يشمل CORE نشاط المستخدم الذي تم إجراؤه في YouTube Music قبل 1 آذار (مارس) 2021.
GAMING حدث نشاط المستخدم على YouTube Gaming.
KIDS حدث نشاط المستخدم في YouTube Kids.
MUSIC حدث نشاط المستخدم في YouTube Music في 1 آذار (مارس) 2021 أو بعد هذا التاريخ. تم تضمين البيانات السابقة لتاريخ 1 آذار (مارس) 2021 في CORE. ولا يتم تسجيل بيانات في الوقت الفعلي.
UNKNOWN حدث نشاط المستخدم قبل 18 تموز (يوليو) 2015.

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

insightTrafficSourceType
يتم تجميع البيانات في التقرير استنادًا إلى نوع المُحيل الذي يصف الطريقة التي وصل بها المستخدمون إلى الفيديو. القيم المتاحة لهذه السمة هي:
  • ADVERTISING: تمّت الإشارة إلى الفيديو من خلال إعلان. في حال الفلترة استنادًا إلى مصدر الزيارات هذا، سيحدِّد الحقل insightTrafficSourceDetail نوع الإعلان.
  • ANNOTATION: وصل المشاهدون إلى الفيديو من خلال النقر على تعليق توضيحي في فيديو آخر.
  • CAMPAIGN_CARD – المشاهدات التي نشأت من الفيديوهات التي حمّلها المستخدمون وتمت المطالبة بملكيتها، والتي استخدمها مالك المحتوى للترويج للمحتوى الذي تمت مشاهدته. مصدر الزيارات هذا غير متوافق إلا مع تقارير مالكي المحتوى.
  • END_SCREEN – تمّت إحالة المشاهدات من شاشة النهاية لفيديو آخر.
  • EXT_URL – تمت إحالة مشاهدات الفيديو من رابط على موقع إلكتروني آخر. في حال الفلترة استنادًا إلى مصدر الزيارات هذا، سيحدِّد الحقل insightTrafficSourceDetail صفحة الويب. يشمل مصدر الزيارات هذا إحالات من نتائج "بحث Google".
  • HASHTAGS: المشاهدات الواردة من صفحات الهاشتاغ المتوفرة عند الطلب أو صفحات Shorts المحورية
  • LIVE_REDIRECT: تمّت الإشارة إلى مشاهدات الفيديو من عمليات إعادة التوجيه المباشرة.
  • NO_LINK_EMBEDDED – كان الفيديو مضمّنًا على موقع إلكتروني آخر عند مشاهدته.
  • NO_LINK_OTHER – لم تحدّد YouTube مُحيلاً للزيارات. وتشمل هذه الفئة الزيارات المباشرة إلى فيديو بالإضافة إلى الزيارات التي تتم على تطبيقات الأجهزة الجوّالة.
  • NOTIFICATION – تمت إحالة مشاهدات الفيديو من رسالة إلكترونية أو إشعار من YouTube.
  • PLAYLIST – عدد مشاهدات الفيديو أثناء تشغيله كجزء من قائمة تشغيل وهو يشمل عدد الزيارات الواردة من صفحة قائمة التشغيل.
  • PRODUCT_PAGE: تمت إحالة مشاهدات الفيديو من صفحة "منتج".
  • PROMOTED – تمت إحالة مرات مشاهدة الفيديو من إعلان ترويجي غير مدفوع على YouTube، مثل صفحة "الفيديوهات البارزة" على YouTube.
  • RELATED_VIDEO – تمت إحالة مشاهدات الفيديو من بيانات فيديو ذي صلة على صفحة مشاهدة فيديو أخرى. في حال الفلترة استنادًا إلى مصدر الزيارات هذا، سيحدّد الحقل insightTrafficSourceDetail معرّف الفيديو لذلك الفيديو.
  • SHORTS: تتم الإشارة إلى المستخدم من خلال التمرير سريعًا عموديًا من الفيديو السابق في تجربة مشاهدة فيديوهات Shorts.
  • SOUND_PAGE: المشاهدات الواردة من صفحات Shorts المحورية للمحتوى الصوتي
  • SUBSCRIBER – تمت إحالة مرات مشاهدة الفيديو من الخلاصات على صفحة YouTube الرئيسية أو من ميزات اشتراك YouTube. في حال الفلترة استنادًا إلى مصدر الزيارات هذا، سيحدِّد الحقل insightTrafficSourceDetail العناصر في خلاصة الصفحة الرئيسية أو الصفحة الأخرى التي تمت إحالة المشاهدات منها.
  • YT_CHANNEL – عدد مرات مشاهدة الفيديو التي تم تسجيلها من صفحة قناة وفي حال الفلترة استنادًا إلى مصدر الزيارات هذا، سيحدِّد الحقل insightTrafficSourceDetail معرّف القناة لتلك القناة.
  • YT_OTHER_PAGE – تمت إحالة مشاهدات الفيديو من رابط آخر غير نتيجة بحث أو رابط فيديو ذي صلة ظهر على صفحة YouTube. في حال الفلترة استنادًا إلى مصدر الزيارات هذا، سيحدِّد الحقل insightTrafficSourceDetail الصفحة.
  • YT_SEARCH – تمت إحالة مشاهدات الفيديو من نتائج بحث YouTube. وفي حال الفلترة استنادًا إلى مصدر الزيارات هذا، سيحدّد الحقل insightTrafficSourceDetail عبارة البحث.
  • VIDEO_REMIXES: تمّت الإشارة إلى مشاهدات الفيديو من رابط إنشاء الريمكس في مشغّل فيديوهات Shorts. في حال إجراء الفلترة استنادًا إلى مصدر الزيارات هذا، سيحدّد الحقل insightTrafficSourceDetail الفيديو الذي تمت إحالة المُشاهد منه.
insightTrafficSourceDetail
يتم تجميع البيانات في التقرير بالاستناد إلى المُحيلين الذين حقّقوا أكبر عدد من المشاهدات لفيديو معيّن ونوع معيّن من مصادر الزيارات. تحدِّد القائمة التالية مصادر الزيارات التي يتوفّر لها هذا التقرير. بالنسبة إلى كل مصدر زيارات، تحدِّد القائمة المعلومات التي توفّرها السمة insightTrafficSourceDetail.
  • ADVERTISING: نوع الإعلان الذي أدّى إلى عدد المشاهدات القيم المتاحة:
    • إعلان جذب من نوع "انقر للتشغيل"
    • إعلان جذب
    • الإعلانات على شبكة بحث Google
    • إعلان فيديو على الصفحة الرئيسية
    • إعلان محجوز أثناء عرض الفيديو قابل للتخطي
    • TrueView ضمن البحث وضمن العرض
    • إعلان قابل للتخطي أثناء عرض الفيديو
    • إعلانات YouTube غير المصنفة
    • حائط فيديو
  • CAMPAIGN_CARD: الفيديو الذي تمّت المطالبة بملكيته والذي وجّه المشاهدين إلى الفيديو المحدّد في التقرير
  • END_SCREEN: الفيديو الذي وجّه المشاهدين إلى الفيديو المحدّد في التقرير
  • EXT_URL: الموقع الإلكتروني الذي أحال المشاهدين إلى الفيديو
  • HASHTAGS: الهاشتاغ الذي أدّى إلى زيادة عدد المشاهدات
  • NOTIFICATION – البريد الإلكتروني أو الإشعار الذي أحال الزيارات.
  • RELATED_VIDEO – الفيديو ذو الصلة الذي وجّه المشاهدين إلى الفيديو الذي يتناوله التقرير
  • SOUND_PAGE – الفيديو الذي أدّى إلى عدد المشاهدات
  • SUBSCRIBER – عنصر خلاصة الصفحة الرئيسية أو ميزة الاشتراك على YouTube التي وجّهت المشاهدين إلى الفيديو الذي يتناوله التقرير. في ما يلي القيم الصالحة:
    • activity – المشاهدات الواردة من العناصر في خلاصات اشتراك الصفحة الرئيسية والناتجة عن نشاط قناة بدون تحميل وغير ذلك
    • blogged – المشاهدات الواردة من العناصر في خلاصات "اشتراك الصفحة الرئيسية" الناتجة عن روابط من أهم المدونات.
    • mychannel: المشاهدات الواردة من عناصر في خلاصات أخرى مُدرَجة في الصفحة الرئيسية، مثل "المعجبون" و"سجلّ المشاهدة" و "المشاهدة لاحقًا"
    • podcasts – المشاهدات التي تنشأ من السلع في صفحة "Google بودكاست" المقصودة.
    • sdig – المشاهدات التي تنشأ من الرسائل الإلكترونية لتحديث الاشتراك.
    • uploaded – المشاهدات الواردة من uploaded عنصر في خلاصات "الاشتراكات" على الصفحة الرئيسية.
    • / – مشاهدات أخرى مصدرها صفحة YouTube الرئيسية
    • /my_subscriptions – المشاهدات الناتجة من صفحات اشتراكاتي للمستخدمين على YouTube.
  • YT_CHANNEL: صفحة القناة التي شاهد فيها المستخدمون الفيديو
  • YT_OTHER_PAGE – صفحة YouTube التي تمت إحالة المشاهدين منها إلى الفيديو.
  • YT_SEARCH: هي عبارة البحث التي وجّهت المشاهدين إلى الفيديو.
  • VIDEO_REMIXES – الفيديو الذي أدّى إلى عدد المشاهدات

أمثلة

تستخدِم النماذج التالية سمات مصادر الزيارات:

  • أمثلة على القنوات

    • مصدر الزيارات
      • عدد المشاهدات ووقت المشاهدة من مصادر زيارات مختلفة في بلد معيّن
      • عدد المشاهدات اليومي ووقت المشاهدة من مصادر زيارات مختلفة
      • أهم 10: عبارات بحث على YouTube تجذب أكبر عدد من الزيارات لفيديو معيّن
      • أهم 10: عبارات بحث على Google التي تجذب أكبر عدد من الزيارات لفيديو معيّن
      • عدد مشاهدات قائمة التشغيل ووقت المشاهدة من مصادر زيارات مختلفة في بلد معيّن
      • عدد مرات مشاهدة قائمة التشغيل ووقت المشاهدة اليومي من مصادر زيارات مختلفة

  • أمثلة مالك المحتوى

    • مصدر الزيارات
      • عدد المشاهدات ووقت المشاهدة من مصادر زيارات مختلفة
      • عدد المشاهدات اليومي ووقت المشاهدة من مصادر زيارات مختلفة
      • أهم 10: عبارات بحث على YouTube تجذب أكبر عدد من الزيارات لفيديو معيّن
      • أهم 10: عبارات بحث على Google التي تجذب أكبر عدد من الزيارات لفيديو معيّن
      • عدد مشاهدات قائمة التشغيل ووقت المشاهدة من مصادر زيارات مختلفة في بلد معيّن
      • عدد مرات مشاهدة قائمة التشغيل ووقت المشاهدة اليومي من مصادر زيارات مختلفة

الأجهزة

deviceType
تحدِّد هذه السمة شكل الجهاز الذي تمت المشاهدة عليه. تحدد القائمة التالية أنواع الأجهزة التي تعرض واجهة برمجة التطبيقات بيانات لها. يمكنك أيضًا استخدام السمة deviceType كفلتر لحصر تقرير نظام التشغيل بأنّه يتضمّن بيانات لنوع معيّن من الأجهزة فقط.
  • DESKTOP
  • GAME_CONSOLE
  • MOBILE
  • TABLET
  • TV
  • UNKNOWN_PLATFORM
operatingSystem
تحدِّد هذه السمة نظام برنامج الجهاز الذي حدثت عليه المشاهدة. تحدد القائمة التالية أنظمة التشغيل التي تعرض واجهة برمجة التطبيقات بيانات لها. يمكنك أيضًا استخدام operatingSystem كفلتر لحصر تقرير نوع الجهاز على بيانات نظام تشغيل محدَّد فقط.
  • ANDROID
  • BADA
  • BLACKBERRY
  • CHROMECAST
  • DOCOMO
  • FIREFOX
  • HIPTOP
  • IOS
  • KAIOS
  • LINUX
  • MACINTOSH
  • MEEGO
  • NINTENDO_3DS
  • OTHER
  • PLAYSTATION
  • PLAYSTATION_VITA
  • REALMEDIA
  • SMART_TV
  • SYMBIAN
  • TIZEN
  • VIDAA
  • WEBOS
  • WII
  • WINDOWS
  • WINDOWS_MOBILE
  • XBOX

أمثلة

تستخدِم نماذج الطلبات التالية أبعاد الجهاز:

  • أمثلة على القنوات

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

  • أمثلة مالك المحتوى

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

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

تساعدك سمات الخصائص الديمغرافية على فهم توزيع جمهورك حسب الفئة العمرية والجنس. يحتوي مركز مساعدة YouTube على معلومات إضافية حول بيانات الخصائص الديمغرافية في تقارير YouTube Analytics.

ageGroup (السمة الأساسية)
تحدِّد هذه السمة الفئة العمرية للمستخدمين المسجّلين الدخول والمرتبطين ببيانات التقرير. تستخدم واجهة برمجة التطبيقات الفئات العمرية التالية:
  • age13-17
  • age18-24
  • age25-34
  • age35-44
  • age45-54
  • age55-64
  • age65-
This is a core dimension and is subject to the Deprecation Policy.
الجنس (السمة الأساسية)
تحدِّد هذه السمة جنس المستخدمين الذين سجّلوا دخولهم والمرتبطين ببيانات التقرير. القيم الصالحة هي female وmale وuser_specified. This is a core dimension and is subject to the Deprecation Policy.

أمثلة

تستخدِم نماذج الطلبات التالية سمات ديمغرافية:

  • أمثلة على القنوات

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

  • أمثلة مالك المحتوى

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

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

sharingService (السمة الأساسية)
تحدِّد هذه السمة الخدمة التي تم استخدامها لمشاركة الفيديوهات. يمكن مشاركة الفيديوهات على موقع YouTube (أو عبر مشغّل YouTube) باستخدام الزر "مشاركة". This is a core dimension and is subject to the Deprecation Policy.

يوضّح الجدول التالي قيم السمات الصالحة:
خدمة المشاركة قيمة واجهة برمجة التطبيقات
Ameba AMEBA
البريد الإلكتروني على Android ANDROID_EMAIL
مراسلة Android ANDROID_MESSENGER
المراسلة على Android ANDROID_MMS
Blackberry Messenger BBM
Blogger BLOGGER
نسخ إلى الحافظة COPY_PASTE
عالم Cyworld CYWORLD
بدفن الجزء السفلي DIGG
Dropbox DROPBOX
تضمين EMBED
البريد الإلكتروني MAIL
Facebook FACEBOOK
Facebook Messenger FACEBOOK_MESSENGER
صفحات Facebook FACEBOOK_PAGES
فوتكا FOTKA
Gmail GMAIL
goo GOO
‏Google+‎ GOOGLEPLUS
إرسال رسالة SMS GO_SMS
GroupMe GROUPME
Hangouts HANGOUTS
hi5 HI5
رسالة نصية من HTC HTC_MMS
البريد الوارد في Google INBOX
مربّع حوار نشاط نظام iOS IOS_SYSTEM_ACTIVITY_DIALOG
قصة KAKAO KAKAO_STORY
Kakao (Kakao Talk) KAKAO
كيك KIK
البريد الإلكتروني لـ LGE LGE_EMAIL
سطر LINE
LinkedIn LINKEDIN
LiveJournal LIVEJOURNAL
مينيم MENEAME
mixi MIXI
خدمة المراسلة من Motorola MOTOROLA_MESSAGING
Myspace MYSPACE
Naver NAVER
المشاركة عن قرب NEARBY_SHARE
NUjij NUJIJ
Odnoklassniki (Оноклассники) ODNOKLASSNIKI
غير ذلك OTHER
Pinterest PINTEREST
Rakuten (楽天▼場) RAKUTEN
Reddit REDDIT
Skype SKYPE
سكاي روك SKYBLOG
محادثات Sony SONY_CONVERSATIONS
StumbleUpon STUMBLEUPON
Telegram TELEGRAM
الرسائل النصية TEXT_MESSAGE
تونتي TUENTI
tumblr. TUMBLR
Twitter TWITTER
غير معروف UNKNOWN
رسائل Verizon VERIZON_MMS
Viber VIBER
VKontakte (تجنُّب Контакте) VKONTAKTE
WeChat WECHAT
Weibo WEIBO
WhatsApp WHATS_APP
ويكوب WYKOP
Yahoo! اليابان YAHOO
YouTube Gaming YOUTUBE_GAMING
YouTube Kids YOUTUBE_KIDS
YouTube Music YOUTUBE_MUSIC
YouTube TV YOUTUBE_TV

اطّلِع على مستندات المساعدة للحصول على مزيد من المعلومات.

أمثلة

تستخدم نماذج الطلبات التالية أبعادًا اجتماعية:

  • أمثلة على القنوات

  • أمثلة مالك المحتوى

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

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

تعرض واجهة برمجة التطبيقات 100 نقطة بيانات لكل فيديو بقيم نسبة تتراوح بين 0.01 و1.0. الأوقات التي يتم فيها قياس البيانات أثناء تشغيل الفيديو تكون متباعدة بشكل متساوٍ لكل فيديو. وهذا يعني أنه بالنسبة إلى فيديو مدته دقيقتان، يكون الفاصل الزمني بين نقاط البيانات 1.2 ثانية. ولكن بالنسبة إلى فيديو مدته ساعتان، يكون الفاصل الزمني بين نقاط البيانات 72 ثانية. تشير قيمة السمة إلى النهاية الحصرية للفاصل الزمني.
audienceType (filter فقط)
تحدِّد قيمة السمة نوع الزيارات المرتبطة ببيانات التقرير. القيمتان المسموح بإدراجهما هما ORGANIC وAD_INSTREAM وAD_INDISPLAY. يمكنك الانتقال إلى مركز مساعدة YouTube للحصول على تفسيرات حول أنواع مصادر الزيارات هذه.

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

أمثلة

تستخدِم نماذج الطلبات التالية سمات الاحتفاظ بالجمهور:

أداء الإعلان

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

  • auctionBumperInstream – إعلانات فيديو غير قابلة للتخطّي، يتم عرضها عبر المزاد، وتصل مدتها إلى 6 ثوانٍ، يجب عرضها قبل مشاهدة الفيديو.

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

  • auctionInstream: إعلانات فيديو غير قابلة للتخطّي يتم عرضها قبل الفيديو الرئيسي أو خلاله أو بعده

  • auctionTrueviewInslate: يختار المشاهد أحد إعلانات الفيديو المتعددة من بين مجموعة من الاختيارات المعروضة قبل الفيديو. See the TrueView documentation for more information.

  • auctionTrueviewInstream – إعلانات فيديو قابلة للتخطّي يتم عرضها قبل الفيديو الرئيسي أو خلاله اطّلِع على مستندات TrueView للحصول على مزيد من المعلومات.

  • auctionUnknown – إعلان تم شراؤه عبر مزاد AdWords ولكن لم يتم تصنيفه ضمن أحد أنواع الإعلانات الأخرى.

  • reservedBumperInstream – إعلانات فيديو غير قابلة للتخطّي، يتم بيعها على أساس الحجز، ولا تزيد مدتها عن 6 ثوانٍ، يجب أن يشاهدها المستخدم ليتمكّن من مشاهدة الفيديو

  • reservedClickToPlay – إعلان فيديو يجب أن ينقر عليه المستخدم لبدء التشغيل يتم تسجيل مرة ظهور للإعلان في أي وقت تظهر فيه الوحدة الإعلانية "انقر للتشغيل"، بصرف النظر عما إذا كان المستخدم قد بدأ عملية تشغيل أم لا. ويتم بيعها على أساس الحجز.

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

  • reservedInstream – إعلانات فيديو غير قابلة للتخطّي يتمّ إدراجها قبل الفيديو الرئيسي أو أثناءه أو بعده

  • reservedInstreamSelect

  • reservedMasthead – إعلان كبير يمكن أن يتضمّن عناصر فيديو وعناصر رسومية يظهر على الصفحة الرئيسية.

  • reservedUnknown – إعلان تم بيعه على أساس محجوز ولا يمكن تصنيفه في أحد أنواع الإعلانات الأخرى.

  • unknown – لم نتمكّن من تصنيف نوع الإعلان هذا.

أمثلة

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

  • أمثلة على القنوات

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

  • أمثلة مالك المحتوى

    • الأرباح/الإعلانات
      • مقاييس أداء الإعلانات والأرباح للمحتوى المطالَب بملكيته
      • مقاييس أداء الإعلانات والأرباح اليومية
      • مقاييس أداء الإعلانات والأرباح في بلدان محدّدة
      • أهم 10: الفيديوهات التي حقّقت أعلى الأرباح
      • مقاييس أداء الإعلان لأنواع الإعلانات المختلفة

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

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

أمثلة

كل نماذج الطلبات التي تسترد تقارير قوائم التشغيل تستخدم الفلتر isCurated.

سمات مالك المحتوى

تتوفّر السمات التالية فقط لتقارير مالكي المحتوى.

ملاحظة مهمة: يجب أن تتم فلترة البيانات في طلبات البيانات من واجهة برمجة التطبيقات لاسترداد تقارير مالكي المحتوى باستخدام إحدى السمات التالية:
  • video
  • channel
  • مجموعة مسموح بها من السمتَين claimedStatus وuploaderType على النحو المحدّد أدناه.
ClaimStatus (تُستخدَم فقط في تقارير مالكي المحتوى)
تتيح لك هذه السمة الإشارة إلى أنّ الردّ من واجهة برمجة التطبيقات يجب أن يتضمن فقط مقاييس للمحتوى المُطالَب بملكيته. القيمة الوحيدة الصالحة لهذه السمة هي claimed. إذا كانت المَعلمة filters تحصر طلب البحث على claimedStatus==claimed، ستسترد واجهة برمجة التطبيقات بيانات المحتوى الذي تمّت المطالبة بملكيته فقط. يقدّم الجدول الوارد في تعريف السمة uploaderType مزيدًا من التفاصيل حول كيفية استخدام هذه السمة.
القائم بالتحميل (السمة الأساسية) (يُستخدم فقط في تقارير مالكي المحتوى)
تتيح لك هذه السمة تحديد ما إذا كان يجب أن يتضمّن ردّ واجهة برمجة التطبيقات مقاييس للمحتوى الذي حمّله مالك المحتوى المحدَّد و/أو المحتوى الذي حمّلته جهات خارجية، مثل الفيديوهات التي حمّلها المستخدمون. القيمتان الصالحتان هما self وthirdParty. هذه سمة أساسية وتخضع لسياسة الإيقاف.

يعرض الجدول أدناه التركيبات المتوافقة للسمتَين claimedStatus وuploaderType، وكلاهما مستخدَم في مَعلمة filters:

قيمة claimedStatus قيمة uploaderType الوصف
[لم يتم الضبط] ذاتي استرداد بيانات "إحصاءات YouTube" للمحتوى المُطالَب بملكيته وغير المُطالَب بملكيته والذي حمّله مالك المحتوى
تمت المطالبة بملكيته [لم يتم الضبط] استرداد بيانات المحتوى المُطالَب بملكيته والذي حمّله مالك المحتوى أو جهة خارجية
تمت المطالبة بملكيته ذاتي يسترد بيانات المحتوى الذي تمت المطالبة بملكيته وحمّله مالك المحتوى.
تمت المطالبة بملكيته thirdParty يسترد البيانات للمحتوى المُطالَب بملكيته والذي حمّلته جهة خارجية.

أمثلة

يستخدم العديد من نماذج طلبات البيانات من واجهة برمجة التطبيقات لتقارير مالكي المحتوى مجموعة متوافقة من السمتَين claimedStatus وuploaderType لفلترة البيانات.