Dimensions

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

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

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

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

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

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

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

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

الفلاتر

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

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

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

الأبعاد

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

الموارد

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

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

الفيديو (السمة الأساسية)
معرّف فيديو على YouTube في YouTube Data API، هذه هي قيمة video الخاص بالمورد id. 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 بشكل متكرر في تقارير مالكي المحتوى لأن هذه التقارير تجمع عادةً بيانات لقنوات متعددة.
group (الفلتر فقط)
رقم تعريف مجموعة "إحصاءات YouTube". يمكنك استرداد هذه القيمة باستخدام طريقة groups.list في YouTube Analytics API. عند استخدام الفلتر 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. ولا توفّر أيضًا التقسيمات الفرعية لبلدان أخرى غير الولايات المتحدة.

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

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

أمثلة

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

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

    • الإحصاءات الأساسية: عدد المشاهدات الخاص بالبلد (وغيرها) لقناة معيّنة
    • الموقع الجغرافي
      • مقاييس وقت المشاهدة حسب البلد لفيديوهات القناة
      • مقاييس التعليقات التوضيحية حسب البلد لفيديوهات القناة
      • المقاييس الخاصة بالمقاطعة للولايات الأمريكية وواشنطن العاصمة
      • مقاييس وقت المشاهدة الخاصة بالبلد لقوائم التشغيل في القناة
      • أبرز 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، لم يعُد يتم تصنيف عمليات التشغيل ضمن عمليات تشغيل MOBILE في تقارير "إحصاءات YouTube". قد تبقى القيمة في التقارير لأنّ البيانات القديمة لا تزال تندرج ضمن تلك الفئة. ولكن بعد هذا التاريخ، سيتم تصنيف عمليات التشغيل على الأجهزة الجوّالة ضمن عمليات التشغيل على الأجهزة الجوّالة إما 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 المحورية لعلامة الهاشتاغ في 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 ضمن البحث وضمن العرض
    • TrueView ضمن البث
    • إعلانات YouTube غير المصنفة
    • حائط فيديو
  • CAMPAIGN_CARD – الفيديو الذي تمّت المطالبة بملكيته والذي وجّه المشاهدين إلى الفيديو المحدّد في التقرير
  • END_SCREEN – الفيديو الذي وجّه المشاهدين إلى الفيديو المحدّد في التقرير
  • EXT_URL – الموقع الإلكتروني الذي أحال المشاهدين إلى الفيديو.
  • HASHTAGS – علامة الهاشتاغ التي أدّت إلى تحقيق المشاهدات
  • NOTIFICATION – الرسالة الإلكترونية أو الإشعار الذي أحال الزيارات.
  • RELATED_VIDEO – الفيديو ذو الصلة الذي وجّه المشاهدين إلى الفيديو الذي يتناوله التقرير.
  • SOUND_PAGE – الفيديو الذي حقّق عدد مشاهدات
  • SUBSCRIBER – عنصر خلاصة الصفحة الرئيسية أو ميزة الاشتراك في YouTube التي وجّهت المشاهدين إلى الفيديو الذي يتناوله التقرير القيم الصالحة هي:
    • activity – المشاهدات من العناصر في خلاصات اشتراك الصفحة الرئيسية الناتجة عن نشاط قناة ليس تحميلاً أو نشاطًا غير اجتماعي، بما في ذلك عمليات إبداء الإعجاب والوضع المفضّل ومشاركات النشرات وعمليات الإضافة إلى قوائم التشغيل.
    • blogged – مشاهدات من عناصر في خلاصات اشتراك الصفحة الرئيسية ناتجة عن روابط من أهم المدونات
    • mychannel – المشاهدات من العناصر في الخلاصات الأخرى المدرجة في الصفحة الرئيسية، مثل "المعجبون"، "سجل المشاهدة" و"المشاهدة لاحقًا".
    • podcasts – المشاهدات الناتجة من العناصر في صفحة "ملفات البودكاست" المقصودة
    • 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
بدفن الجزء السفلي DIGG
Dropbox DROPBOX
تضمين EMBED
البريد الإلكتروني MAIL
Facebook FACEBOOK
Facebook Messenger FACEBOOK_MESSENGER
صفحات Facebook FACEBOOK_PAGES
فوتكا FOTKA
Gmail GMAIL
غو 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 KIK
بريد LGE الإلكتروني LGE_EMAIL
سطر LINE
LinkedIn LINKEDIN
لايفجورنال 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
Skyrock SKYBLOG
محادثات سوني SONY_CONVERSATIONS
StumbleUpon STUMBLEUPON
Telegram TELEGRAM
الرسائل النصية TEXT_MESSAGE
Tuenti TUENTI
تمبلر. TUMBLR
Twitter TWITTER
غير معروف UNKNOWN
رسائل Verizon VERIZON_MMS
Viber VIBER
VKontakte (سينКонтакте) VKONTAKTE
WeChat WECHAT
Weibo WEIBO
WhatsApp WHATS_APP
Wykop WYKOP
Yahoo! اليابان YAHOO
YouTube لألعاب الفيديو 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 (الفلتر فقط)
تحدِّد قيمة السمة نوع الزيارات المرتبطة ببيانات التقرير. والقيم المسموح بإدراجها هي ORGANIC وAD_INSTREAM وAD_INDISPLAY. يمكنك الانتقال إلى مركز مساعدة YouTube للحصول على تفسيرات لهذه الأنواع من مصادر الزيارات.

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

أمثلة

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

البث المباشر

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

عمليات إلغاء العضوية

membershipsCancellationSurveyReason
عدد الاستطلاعات التي أكملها مستخدمو YouTube الذين ألغوا عضويتهم في القناة قناة محددة خلال الفترة المشمولة بالتقارير. يسرد الجدول التالي قيم السمات الصالحة:
قيمة واجهة برمجة التطبيقات الشرح
UNKNOWN لم يكمل المستخدم الاستبيان.
DISLIKE_PERKS لم تعجب المستخدم مزايا العضوية.
PERKS_NOT_DELIVERED أشار المستخدم إلى أنّه لم يتم تسليم مزايا العضوية التي وعدت بها.
CANNOT_ACCESS_PERKS تعذّر على المستخدم الاستفادة من المزايا.
NO_LONGER_INTERESTED لم يعُد المستخدم مهتمًا بالعضوية في القناة.
FEEL_UNAPPRECIATED شعر المستخدم أنّ عضويته في القناة لا يقدّره.
FINANCIAL_REASONS تم إلغاء المستخدم لأسباب مالية.
JOIN_LIMITED_TIME كان المستخدم يريد الانضمام لفترة محدودة فقط.
OTHER كان لدى المستخدم سبب آخر للإلغاء.

أداء الإعلان

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

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

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

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

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

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

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

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

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

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

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

  • reservedInstreamSelect

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

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

  • unknown – تعذّر على YouTube تصنيف نوع الإعلان هذا.

أمثلة

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

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

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

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

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

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

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

أمثلة

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

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

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

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

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

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

أمثلة

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