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، هذه هي قيمة سمة 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 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 (فلتر فقط)
رمز منطقة إحصائية تابع للأمم المتحدة تتيح واجهة برمجة التطبيقات القيم التالية:
القيم
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 صباحًا بالتوقيت الرسمي للمحيط الهادئ (التوقيت العالمي المنسق -7 أو التوقيت العالمي المنسق -8) وتنتهي في الساعة 11:59 مساءً بالتوقيت الرسمي للمحيط الهادئ في اليوم والشهر والسنة المحدّدين. ونتيجةً لذلك، تمثّل التواريخ التي يتم فيها ضبط الساعات للأمام وفقًا للتوقيت الصيفي فترة مدتها 23 ساعة، بينما تمثّل التواريخ التي يتم فيها ضبط الساعات للخلف فترة مدتها 25 ساعة.

تشير سمة الشهر إلى الفترة الزمنية التي تبدأ في الساعة 12:00 صباحًا بتوقيت المحيط الهادئ (التوقيت العالمي المنسق -7 أو التوقيت العالمي المنسق -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 باستخدام هذه القيمة.

  • 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) استثناء: يتم تضمين نشاط المستخدم الذي حدث في 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 الفيديو الذي تمّت إحالة المشاهد إليه.
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.
‫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.

يسرد الجدول التالي قيم السمات الصالحة:
خدمة المشاركة قيمة واجهة برمجة التطبيقات
Ameba AMEBA
بريد إلكتروني على Android ANDROID_EMAIL
تطبيق "رسائل Android" ANDROID_MESSENGER
المراسلة على Android ANDROID_MMS
BlackBerry Messenger BBM
Blogger BLOGGER
نسخ إلى الحافظة COPY_PASTE
Cyworld CYWORLD
Digg DIGG
Dropbox DROPBOX
تضمين EMBED
البريد الإلكتروني MAIL
Facebook FACEBOOK
Facebook Messenger FACEBOOK_MESSENGER
صفحات Facebook FACEBOOK_PAGES
Fotka FOTKA
Gmail GMAIL
goo GOO
‏Google+‎ GOOGLEPLUS
Go SMS GO_SMS
GroupMe GROUPME
Hangouts HANGOUTS
hi5 HI5
رسالة نصية من HTC HTC_MMS
البريد الوارد في Google INBOX
مربّع حوار نشاط نظام التشغيل iOS IOS_SYSTEM_ACTIVITY_DIALOG
KAKAO Story KAKAO_STORY
Kakao (Kakao Talk) KAKAO
Kik KIK
البريد الإلكتروني في LGE LGE_EMAIL
Line LINE
Linkedin LINKEDIN
لايفجورنال LIVEJOURNAL
menéame MENEAME
mixi MIXI
تطبيق Motorola Messaging MOTOROLA_MESSAGING
Myspace MYSPACE
Naver NAVER
المشاركة عن قرب NEARBY_SHARE
NUjij NUJIJ
Odnoklassniki (Одноклассники) ODNOKLASSNIKI
غير ذلك OTHER
Pinterest PINTEREST
Rakuten (楽天市場) RAKUTEN
reddit REDDIT
Skype SKYPE
Skyrock SKYBLOG
محادثات Sony SONY_CONVERSATIONS
StumbleUpon STUMBLEUPON
Telegram TELEGRAM
رسالة نصيّة TEXT_MESSAGE
Tuenti TUENTI
tumblr 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×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 – تعذّر على 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 لفلترة البيانات.