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

أمثلة

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

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

    • مصدر الزيارات
      • عدد المشاهدات ووقت المشاهدة من مصادر زيارات مختلفة في بلد معيّن
      • عدد المشاهدات اليومي ووقت المشاهدة من مصادر الزيارات المختلفة
      • أهم 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 (السمة الأساسية)
تحدّد هذه السمة الفئة العمرية للمستخدِمين الذين سجّلوا الدخول والمرتبطين ببيانات التقرير. تستخدِم واجهة برمجة التطبيقات الفئات العمرية التالية:
  • 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 Messenger 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 INBOX
مربّع حوار نشاط نظام التشغيل iOS IOS_SYSTEM_ACTIVITY_DIALOG
KAKAO Story KAKAO_STORY
Kakao (Kakao Talk) KAKAO
Kik KIK
LGE Email LGE_EMAIL
Line LINE
Linkedin LINKEDIN
لايفجورنال LIVEJOURNAL
menéame 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 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 لفلترة البيانات.