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 معرّف.

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

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

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

country (سمة أساسية)
البلد المرتبط بالمقاييس في صف التقرير قيمة السمة هي رمز بلد مكوّن من حرفَين وفقًا لمعيار 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.
continent (فلتر فقط)
رمز منطقة إحصائية تابع للأمم المتحدة (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) في اليوم الأول من الشهر والسنة المحدّدَين.

day (سمة أساسية)
عند استخدام هذه السمة، يتم تجميع البيانات في التقرير على أساس يومي ويحتوي كل صف على بيانات ليوم واحد. ويمكنك استخدام سمات أخرى لتقسيم البيانات بشكل أكبر. على سبيل المثال، يمكن لتقرير مصدر الزيارات تجميع إحصاءات المشاهدة اليومية استنادًا إلى الطريقة التي يصل بها المستخدمون إلى فيديوهاتك. This is a core dimension and is subject to the Deprecation Policy.
month (سمة أساسية)
يتم تجميع البيانات في التقرير حسب الشهر التقويمي. كما هو الحال مع التقارير اليومية، يمكنك استخدام فلاتر أخرى لتقسيم البيانات بشكل أكبر. في التقرير، يتم إدراج التواريخ بتنسيق 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 باستخدام هذه القيمة.

  • IMMERSIVE_LIVE_FEED – تصف البيانات المشاهدات التي تمّت على خلاصة البث المباشر بالوضع العمودي.

  • MOBILE: تصف البيانات المشاهدات التي حدثت على موقع YouTube الإلكتروني المتوافق مع الأجهزة الجوّالة أو على عملاء واجهة برمجة التطبيقات المعتمَدين في YouTube، بما في ذلك الأجهزة الجوّالة.

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

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

  • ‫SHORTS_FEED: تصف البيانات المشاهدات التي تمّت في خلاصة YouTube Shorts.

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

  • ‫YT_OTHER: تصف البيانات المشاهدات التي لم يتم تصنيفها بطريقة أخرى.

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

أمثلة

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

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

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

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

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

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

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

يسرد الجدول التالي قيم السمة:
القيمة الوصف
LIVE_STREAM المحتوى المعروض كان بثًا مباشرًا على YouTube.
SHORTS كان المحتوى الذي تمّت مشاهدته فيديو YouTube 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). استثناء: يتم تضمين نشاط المستخدم الذي حدث في YouTube Music قبل 1 مارس 2021 في CORE.
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 الفيديو الذي تمّت إحالة المشاهد منه.
  • ‫WATCH_WITH: تمت إحالة مشاهدات الفيديو من بث يتضمّن تعليقات صوتية لصانع المحتوى أو بث "المشاهدة مع الآخرين". إذا أجريت الفلترة استنادًا إلى مصدر الزيارات هذا، يحدّد الحقل 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: المشاهدات الواردة من الفيديوهات في الصفحة المقصودة لملفات البودكاست
    • ‫sdig: المشاهدات الناتجة من الرسائل الإلكترونية التي تتضمّن آخر الأخبار حول الاشتراكات
    • ‫uploaded: المشاهدات من عناصر uploaded في خلاصات "الاشتراكات" على الصفحة الرئيسية
    • ‫/: المشاهدات الأخرى الواردة من صفحة YouTube الرئيسية
    • /my_subscriptions: المشاهدات الناتجة من صفحات اشتراكاتي الخاصة بالمستخدمين على YouTube
  • YT_CHANNEL: صفحة القناة التي شاهد فيها المستخدمون الفيديو
  • YT_OTHER_PAGE: صفحة YouTube التي انتقل منها المشاهدون إلى الفيديو
  • ‫YT_SEARCH: عبارة البحث التي وجّهت المشاهدين إلى الفيديو
  • ‫VIDEO_REMIXES: الفيديو الذي أدّى إلى تحقيق المشاهدات
  • ‫WATCH_WITH: الفيديو الذي أدّى إلى تحقيق المشاهدات

أمثلة

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

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

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

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

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

الأجهزة

deviceType
تحدّد هذه السمة نوع الجهاز الذي تمت مشاهدة الفيديو عليه. تحدّد القائمة التالية أنواع الأجهزة التي تعرض واجهة برمجة التطبيقات بياناتها. يمكنك أيضًا استخدام السمة deviceType كفلتر لحصر تقرير نظام التشغيل على البيانات الخاصة بنوع معيّن من الأجهزة فقط.
  • DESKTOP
  • GAME_CONSOLE
  • MOBILE
  • TABLET
  • TV
  • AUTOMOTIVE
  • WEARABLE
  • 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 (سمة أساسية)
تحدّد هذه السمة الفئة العمرية للمستخدمين الذين سجّلوا الدخول والمرتبطين ببيانات التقرير، وتشمل المستخدمين الذين يقدّر YouTube أنّ عمرهم أقل من 18 عامًا. تستخدم واجهة برمجة التطبيقات الفئات العمرية التالية:
  • 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.
gender (سمة أساسية)
تحدّد هذه السمة جنس المستخدمين الذين سجّلوا الدخول والمرتبطين ببيانات التقرير. القيم الصالحة هي 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.

يسرد الجدول التالي قيم السمات الصالحة:
خدمة المشاركة قيمة واجهة برمجة التطبيقات
Allo ALLO
Ameba AMEBA
البريد الإلكتروني على Android ANDROID_EMAIL
Android Messenger ANDROID_MESSENGER
المراسلة على Android ANDROID_MMS
مربّع حوار المشاركة في نظام Android ANDROID_SYSTEM_SHARE_DIALOG
Blackberry Messenger BBM
الحصول على تفاعل BLIND_REACT
Blogger BLOGGER
نسخ إلى الحافظة COPY_PASTE
Cyworld CYWORLD
Digg DIGG
مربّع حوار مباشر حول نشاط النظام DIRECT_SYSTEM_ACTIVITY_DIALOG
Discord DISCORD
رمز الاستجابة السريعة المعروض DISPLAYED_QR_CODE
Dropbox DROPBOX
تضمين EMBED
البريد الإلكتروني MAIL
Facebook FACEBOOK
Lite FACEBOOK_LITE
Facebook Messenger FACEBOOK_MESSENGER
صفحات Facebook FACEBOOK_PAGES
المشاركة مع مجموعة على Facebook FACEBOOK_SHARE_TO_GROUP
قصص Facebook FACEBOOK_STORIES
Fotka FOTKA
Gmail GMAIL
goo GOO
تطبيق Google GOOGLE_APP
Google Chat GOOGLE_CHAT
متصفح Google Chrome GOOGLE_CHROME
Google Inbox INBOX
Google Keep GOOGLE_KEEP
Google+‎ GOOGLEPLUS
Go SMS GO_SMS
GroupMe GROUPME
Hangouts HANGOUTS
hi5 HI5
رسالة نصية من HTC HTC_MMS
IMO IMO
Instagram INSTAGRAM
قصص Instagram INSTAGRAM_STORIES
رابط الدعوة (Android) INVITE_LINK_ANDROID
رابط الدعوة (iOS) INVITE_LINK_IOS
دعوة متعاونين إلى قائمة التشغيل INVITE_PLAYLIST_COLLABORATORS
مربّع حوار نشاط نظام iOS IOS_SYSTEM_ACTIVITY_DIALOG
KAKAO Story KAKAO_STORY
Kakao (Kakao Talk) KAKAO
رسائل KaiOS KAIOS_MESSAGES
Kik KIK
LGE Email LGE_EMAIL
Line LINE
LinkedIn LINKEDIN
لايفجورنال LIVEJOURNAL
النسخ واللصق في "خرائط Google" MAPS_COPY_PASTE
المشاركة المباشرة في Meet MEET_LIVE_SHARING
menéame MENEAME
mixi MIXI
Motorola Messaging MOTOROLA_MESSAGING
Myspace MYSPACE
Naver NAVER
المشاركة عن قرب NEARBY_SHARE
NUjij NUJIJ
Odnoklassniki (Одноклассники) ODNOKLASSNIKI
غير ذلك OTHER
Pinterest PINTEREST
Quick Share QUICK_SHARE
Quick Share (Samsung) QUICK_SHARE_SAMSUNG
‫Rakuten (楽天市場) RAKUTEN
reddit REDDIT
ريمكس REMIX
Samsung Messages SAMSUNG_MESSAGES
Samsung Notes SAMSUNG_NOTES
الحفظ في معرض الصور على الجهاز SAVE_TO_DEVICE_PHOTOS
مشاركة محتوى بلا إعلانات SHARE_AD_FREE
المشاركة مع كاميرا Snapchat SHARE_TO_SNAPCHAT_CAMERA
المشاركة مع الأطفال SHARE_WITH_KIDS
Skype SKYPE
Skyrock SKYBLOG
Snapchat SNAPCHAT
Sony Conversations SONY_CONVERSATIONS
StumbleUpon STUMBLEUPON
Telegram TELEGRAM
رسالة نصيّة TEXT_MESSAGE
Tuenti TUENTI
tumblr. TUMBLR
Twitter TWITTER
غير معروف UNKNOWN
رسائل Verizon VERIZON_MMS
Viber VIBER
VKontakte (ВКонтакте) VKONTAKTE
مربّع حوار نشاط النظام على الويب WEB_SYSTEM_ACTIVITY_DIALOG
WeChat WECHAT
Weibo WEIBO
WhatsApp WHATS_APP
واتساب للأعمال WHATS_APP_BUSINESS
Wykop WYKOP
Yahoo! اليابان YAHOO
منشور في "المنتدى" على YouTube YOUTUBE_COMMUNITY_POST
إعادة نشر مشاركة في "المنتدى" على YouTube YOUTUBE_COMMUNITY_REPOST
YouTube لألعاب الفيديو YOUTUBE_GAMING
YouTube Kids YOUTUBE_KIDS
YouTube Mango YOUTUBE_MANGO
YouTube Music YOUTUBE_MUSIC
معاينة ميزة مشاركة محتوى YouTube Music على Snapchat YTM_SHARE_TO_SNAPCHAT_PREVIEW
ميزة "الشاشة الخضراء" في YouTube Shorts YOUTUBE_SHORTS_GREEN_SCREEN
YouTube TV YOUTUBE_TV
المشاهدة مع الأصدقاء على YouTube YOUTUBE_WATCH_WITH_FRIENDS

لمزيد من المعلومات، يُرجى الاطّلاع على مستندات المساعدة.

أمثلة

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

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

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

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

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

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

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

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

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

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

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

  • reservedInstreamSelect

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

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

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

أمثلة

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

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

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

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

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

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

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

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

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

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

أمثلة

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