يحدّد هذا المستند السمات المتوافقة مع YouTube Analytics API. تتيح واجهة برمجة التطبيقات هذه استخدام طلبات البحث المستهدفة في الوقت الفعلي لإنشاء تقارير مخصّصة في "إحصاءات YouTube".
السمات هي معايير شائعة تُستخدَم لتجميع البيانات، مثل تاريخ حدوث نشاط المستخدم أو البلد الذي يقيم فيه المستخدمون.
ويحدِّد كلّ تقرير طلب بحث السمات التي يتيحها. على سبيل المثال، عند استرداد نشاط المستخدم حسب الوقت، يمكنك اختيار الفترة الزمنية التي سيتم الإبلاغ عن البيانات خلالها: اليوم أو الشهر. في أي تقرير، يحتوي كل صف من البيانات على مجموعة فريدة من قيم السمات.
لاسترجاع تقرير طلب بحث، عليك استدعاء طريقة reports.query
في YouTube Analytics API. يمكنك استخدام المَعلمة dimensions
في طلبك لتحديد السمات التي ستستخدمها YouTube لاحتساب قيم المقاييس في التقارير.
السمات الأساسية
على الرغم من أنّ YouTube Analytics API تخضع لسياسة الإيقاف النهائي المنصوص عليها في بنود الخدمة، لا تخضع السمات غير الأساسية (والمقاييس غير الأساسية) لهذه السياسة. في التعريفات الواردة في هذه الصفحة، يتمّ تحديد أيّ سمة أساسية بشكلٍ صريح على أنّها كذلك.
تحدِّد القائمة التالية السمات الأساسية لواجهة برمجة التطبيقات.
يمكنك الاطّلاع على قائمة واجهات برمجة تطبيقات YouTube الخاضعة لسياسة الإيقاف للحصول على مزيد من المعلومات.
فلاتر
تتيح جميع تقارير طلبات البحث استخدام الفلاتر. تحدِّد الفلاتر قيم السمات التي يجب أن تتوفّر في مجموعة البيانات التي تم استردادها. وبناءً على ذلك، فإنّها تحدّ من استجابة واجهة برمجة التطبيقات لتتضمّن فقط البيانات التي تطابق قيمة معيّنة أو مجموعة معيّنة من القيم. على سبيل المثال، بدلاً من استرداد مقاييس نشاط المستخدم لجميع البلدان، يمكنك استخدام فلتر لاسترداد البيانات لبلد معيّن فقط.
في طلب استرداد تقرير أداء طلبات البحث، تحدِّد معلَمة طلب filters
الاختيارية قيم السمات التي تريد فلترة بياناتها. على سبيل المثال، لاسترداد مقاييس نشاط المستخدِم لأوروبا، يمكنك ضبط قيمة المَعلمة filters
على continent==150
.
ملاحظة مهمة: يجب أن تتم فلترة البيانات في طلبات البيانات من واجهة برمجة التطبيقات لاسترداد تقارير مالكي المحتوى باستخدام إحدى سمات جهة إعداد التقارير أو باستخدام مجموعة متوافقة من السمتَين claimedStatus
وuploaderType
.
الأبعاد
تحدّد الأقسام التالية السمات المستخدَمة في تقارير طلبات البحث في واجهة برمجة تطبيقات YouTube Analytics. ويتم استخدام هذه السمات في تقريرَي القناة ومالك المحتوى، ما لم يُذكر خلاف ذلك. ويتم أيضًا تحديد السمات التي لا يمكن استخدامها إلّا كفلاتر.
المراجِع
تتوافق هذه السمات مع الموارد التي يديرها مالكو القنوات والمحتوى على YouTube:
ملاحظة: تتيح لك واجهة برمجة التطبيقات تحديد قيم متعدّدة للسمات video
وplaylist
وchannel
عند استخدامها كفلاتر. لإجراء ذلك، اضبط قيمة المعلَمة filters
على قائمة مفصولة بفواصل لمعرّفات الفيديوهات أو قائمة التشغيل أو القنوات التي يجب فلترة استجابة واجهة برمجة التطبيقات لها. يمكن أن تحدِّد قيمة المَعلمة ما يصل إلى 500 رقم تعريف.
- الفيديو (السمة الأساسية)
- معرّف فيديو على YouTube في YouTube Data API، هذه هي قيمة السمة
id
لموردvideo
. This is a core dimension and is subject to the Deprecation Policy. - قائمة التشغيل
- معرّف قائمة تشغيل على YouTube في YouTube Data API، هذه هي قيمة السمة
id
لموردplaylist
. - القناة (السمة الأساسية) (تُستخدَم فقط في تقارير مالكي المحتوى)
- رقم تعريف قناة على YouTube في YouTube Data API، هذه هي قيمة السمة
id
لموردchannel
. This is a core dimension and is subject to the Deprecation Policy.
غالبًا ما يتمّ استخدام السمةchannel
في تقارير مالكي المحتوى لأنّ هذه التقارير تجمع عادةً بيانات لقنوات متعدّدة. - المجموعة (الفلتر فقط)
- رقم تعريف مجموعة في "إحصاءات YouTube" يمكنك استرداد هذه القيمة باستخدام طريقة
groups.list
في واجهة برمجة تطبيقات YouTube Analytics. عند استخدام الفلتر "group
"، ستتضمّن استجابة واجهة برمجة التطبيقات بيانات لكل الفيديوهات أو قوائم التشغيل أو القنوات في المجموعة المعنيّة.
أمثلة
تستخدِم نماذج الطلبات التالية سمات أو فلاتر كيانات إعداد التقارير:
أمثلة على القنوات
-
الإحصاءات الأساسية
- أبرز 10 فيديوهات: الفيديوهات الأكثر مشاهدةً على القناة
- أهم 10: نِسب النقر إلى الظهور للتعليقات التوضيحية للفيديوهات الأكثر مشاهدة في القناة
- إحصاءات حول قائمة تشغيل معيّنة
- أهمّ 10: قوائم التشغيل الأكثر مشاهدة على القناة
-
الموقع الجغرافي
- أبرز 10 – الفيديوهات الأكثر مشاهدة في بلد معيّن
- أهم 10 – الفيديوهات الأكثر مشاهدة في أوروبا
-
الإحصاءات الأساسية
أمثلة مالك المحتوى
-
الإحصاءات الأساسية
- أهم 10 - فيديوهات أكثر مشاهدة لدى مالك محتوى
- أهم 10 فيديوهات - الفيديوهات الأكثر مشاهدة لدى مالك المحتوى
- أهم 10 - الفيديوهات الأكثر مشاهدة على قناة مالك المحتوى
- أهم 10: نِسب النقر إلى الظهور للتعليقات التوضيحية للفيديوهات الأكثر مشاهدة في القناة
- أهم 10: قوائم التشغيل الأكثر مشاهدة لدى مالك المحتوى
-
الموقع الجغرافي
- أهم 10 - الفيديوهات الأكثر مشاهدة في أوروبا لدى مالك المحتوى
- أبرز 10 قوائم تشغيل – قوائم التشغيل الأكثر بدءاً في الولايات المتحدة
-
الإحصاءات الأساسية
المناطق الجغرافية
تحدِّد هذه السمات منطقة جغرافية مرتبطة بنشاط المستخدِم أو أداء الإعلان أو مقاييس الأرباح المقدَّرة.
- البلد (السمة الأساسية)
- البلد المرتبط بالمقاييس الواردة في صف التقرير. قيمة السمة هي رمز بلد مكوّن من حرفَين وفقًا لمعيار ISO-3166-1، مثل
US
أوCN
(الصين) أوFR
(فرنسا). يُستخدم رمز البلدZZ
للإبلاغ عن المقاييس التي تعذّر على YouTube تحديد البلد المرتبط بها. This is a core dimension and is subject to the Deprecation Policy. - province
- الولاية أو المنطقة الأمريكية المرتبطة بالمقاييس الواردة في صف التقرير قيمة السمة هي رمز ISO 3166-2 يحدّد إحدى الولايات الأمريكية أو مقاطعة كولومبيا، مثل
US-MI
(ميشيغان) أوUS-TX
(تكساس). يُستخدم رمز المقاطعةUS-ZZ
للإبلاغ عن المقاييس التي تعذّر على YouTube تحديد الولاية المرتبطة بها في الولايات المتحدة. عندما يتضمّن طلب بيانات من واجهة برمجة التطبيقاتprovince
في قيمة المعلَمةdimensions
، يجب أن يحصر الطلب أيضًا البيانات في الولايات المتحدة من خلال تضمينcountry==US
في قيمة المعلَمةfilters
.ملاحظة: لا تتوافق هذه السمة مع قيم ISO 3166-2 التي تحدّد المناطق النائية للولايات المتحدة لأنّ هذه المناطق لها أيضًا رموز البلدان وفقًا لمعيار ISO 3166-1. ولا يدعم أيضًا التقسيمات الفرعية لبلدان أخرى غير الولايات المتحدة.
- city
- المدينة المقدَّرة المرتبطة بالمقاييس الواردة في صف التقرير. تتوفّر بيانات هذه السمة للتواريخ التي تبدأ في 1 كانون الثاني (يناير) 2022.
- قارة (الفلتر فقط)
-
رمز منطقة إحصائي للأمم المتحدة. تتيح واجهة برمجة التطبيقات استخدام القيم التالية:
القيم 002
أفريقيا 019
الأمريكتان (أمريكا الشمالية وأمريكا اللاتينية وأمريكا الجنوبية ومنطقة البحر الكاريبي) 142
آسيا 150
أوروبا 009
أوقيانوسيا filters
علىcontinent==REGION_CODE
، مع تحديد قيمةREGION_CODE
من القائمة أعلاه. - subContinent (الفلتر فقط)
-
رمز منطقة إحصائي خاص بالأمم المتحدة يحدِّد منطقة جغرافية فرعية. تسرد شعبة الإحصاءات بالأمم المتحدة المناطق الفرعية إلى جانب البلدان التي تربطها بكل منطقة.
لا يمكن استخدام هذه السمة إلّا لفلترة البيانات. لاستخدام هذه السمة، اضبط قيمة المعلَمة
filters
علىsubContinent==REGION_CODE
، مع تحديد قيمةREGION_CODE
من قائمة UN.
أمثلة
تستخدِم نماذج الطلبات التالية سمات أو فلاتر جغرافية:
أمثلة على القنوات
- الإحصاءات الأساسية: عدد المشاهدات لبلد معيّن (وغير ذلك) لقناة معيّنة
-
الموقع الجغرافي
- مقاييس وقت المشاهدة لفيديوهات القناة حسب البلد
- مقاييس التعليقات التوضيحية المرتبطة ببلدان محددة في فيديوهات القناة
- المقاييس المتعلّقة بالمقاطعة في الولايات الأمريكية وواشنطن العاصمة
- مقاييس وقت المشاهدة لقوائم التشغيل في قناة معيّنة
- أبرز 10 قوائم تشغيل – قوائم التشغيل الأكثر بدءاً في الولايات المتحدة
- موقع التشغيل: عدد المشاهدات اليومي ووقت المشاهدة من مواقع تشغيل مختلفة
- مصدر الزيارات: عدد المشاهدات ووقت المشاهدة من مصادر زيارات مختلفة في بلد معيّن
- الخصائص الديمغرافية: الخصائص الديمغرافية للمشاهدين في كاليفورنيا (الفئة العمرية والجنس)
-
الفيديوهات الأفضل أداءً
- أبرز 10 – الفيديوهات الأكثر مشاهدة في بلد معيّن
- أهم 10 – الفيديوهات الأكثر مشاهدة في أوروبا
أمثلة مالك المحتوى
- الإحصاءات الأساسية: عدد المشاهدات في بلد معيّن (وغير ذلك) لكل الفيديوهات التي حمّلتها ذاتيًا
-
الموقع الجغرافي
- مقاييس وقت المشاهدة للمحتوى الذي حمّلته ذاتيًا في بلد محدَّد
- مقاييس التعليقات التوضيحية الخاصة بالبلد للمحتوى الذي تم تحميله ذاتيًا
- المقاييس المتعلّقة بالمقاطعة في الولايات الأمريكية وواشنطن العاصمة
- مقاييس وقت المشاهدة لقوائم التشغيل التي أنشأها مالك المحتوى في بلد معيّن
- أبرز 10 قوائم تشغيل – قوائم التشغيل الأكثر بدءاً في الولايات المتحدة
- موقع التشغيل: عدد المشاهدات اليومي ووقت المشاهدة من مواقع تشغيل مختلفة
- الخصائص الديمغرافية: الخصائص الديمغرافية للمشاهدين في كاليفورنيا (الفئة العمرية والجنس)
- الفيديوهات الأفضل أداءً: أبرز 10 فيديوهات، وهي الفيديوهات الأكثر مشاهدة في أوروبا من مالك المحتوى.
- الأرباح/أداء الإعلان: مقاييس الأرباح وأداء الإعلانات الخاصة بكل بلد
الفترات الزمنية
تشير هذه السمات إلى أنّ التقرير يجب أن يجمع البيانات استنادًا إلى فترة زمنية معيّنة، مثل يوم أو أسبوع أو شهر. تُحدِّد مَعلمات الطلب startDate
وendDate
الفترة الزمنية التي يتضمّن التقرير بيانات لها. تجدر الإشارة إلى أنّ التقرير يعرض البيانات حتى اليوم الأخير الذي تتوفّر له جميع المقاييس المحدّدة في الطلب وقت إجراء طلب البحث. يتم إدراج التواريخ في التقارير بالتنسيق YYYY-MM-DD
.
ملاحظة مهمة: تشير جميع التواريخ إلى الفترة الزمنية التي تبدأ من الساعة 12:00 صباحًا بتوقيت المحيط الهادئ (UTC-7 أو UTC-8) وتنتهي في الساعة 11:59 مساءً بتوقيت المحيط الهادئ في اليوم والشهر والسنة المحدَّدين. ونتيجة لذلك، فإن التواريخ التي يتم فيها تعديل التوقيت وفقًا بالتوقيت الصيفي تمثل فترة 23 ساعة، والتواريخ التي يتم فيها تعديل التوقيت بالعكس تمثل فترة 25 ساعة.
يشير البُعد الشهر إلى الفترة الزمنية التي تبدأ في الساعة 12:00 صباحًا بتوقيت المحيط الهادئ (UTC-7 أو UTC-8) في أول يوم من الشهر والسنة المحدَّدين.
- اليوم (السمة الأساسية)
- عند استخدام هذه السمة، يتم تجميع البيانات في التقرير يوميًا ويحتوي كل صف على بيانات ليوم واحد. ويمكنك استخدام سمات أخرى لتقسيم البيانات بشكل أكبر. على سبيل المثال، قد يجمع تقرير مصادر الزيارات إحصاءات المشاهدة اليومية استنادًا إلى طريقة وصول المستخدمين إلى فيديوهاتك. This is a core dimension and is subject to the Deprecation Policy.
- الشهر (السمة الأساسية)
- يتم تجميع البيانات الواردة في التقرير حسب الشهر التقويمي. كما هو الحال مع التقارير اليومية، يمكنك استخدام الفلاتر الأخرى لتقسيم البيانات بصورةٍ أكبر. يتم إدراج التواريخ في التقرير بالتنسيق
YYYY-MM
.
ملاحظة: إذا كان طلب البحث من واجهة برمجة التطبيقات يستخدم السمةmonth
، يجب ضبط المعلمتَينstart-date
وend-date
على أول يوم من الشهر. This is a core dimension and is subject to the Deprecation Policy.
أمثلة
تستخدِم طلبات النماذج التالية سمات أو فلاتر زمنية:
أمثلة على القنوات
-
الاستناد إلى الوقت
- مقاييس وقت المشاهدة اليومية لفيديوهات القناة
- مقاييس التعليقات التوضيحية اليومية للفيديوهات على القناة
- عدد المشاهدات اليومية لقائمة التشغيل لإحدى القنوات
- موقع التشغيل: عدد المشاهدات اليومي ووقت المشاهدة من مواقع تشغيل مختلفة
- مصدر الزيارات: يعرض عدد المشاهدات اليومي ووقت المشاهدة من مصادر زيارات مختلفة.
-
الجهاز/نظام التشغيل
- مقاييس نوع الجهاز اليومية لنظام التشغيل Android
- مقاييس نظام التشغيل اليومية للأجهزة الجوّالة
- مقاييس نظام التشغيل ونوع الجهاز اليومي
-
الاستناد إلى الوقت
أمثلة مالك المحتوى
-
الاستناد إلى الوقت
- مقاييس وقت المشاهدة اليومية للمحتوى الذي حمّلتَه ذاتيًا
- مقاييس التعليقات التوضيحية للمحتوى المطالَب بملكيته
- عدد المشاهدات اليومية لقائمة التشغيل لمالك المحتوى
- موقع التشغيل: عدد المشاهدات اليومي ووقت المشاهدة من مواقع تشغيل مختلفة
- مصدر الزيارات: يعرض عدد المشاهدات اليومي ووقت المشاهدة من مصادر زيارات مختلفة.
-
الجهاز/نظام التشغيل
- مقاييس نوع الجهاز اليومي للفيديوهات التي تمت المطالبة بملكيتها
- مقاييس نظام التشغيل اليومي للفيديوهات التي تمت المطالبة بملكيتها والمعروضة على الأجهزة الجوّالة
- مقاييس نظام التشغيل ونوع الجهاز اليومي
- الأرباح/أداء الإعلان: مقاييس الأرباح اليومية وأداء الإعلان
-
الاستناد إلى الوقت
مواقع التشغيل
توفِّر هذه السمات إحصاءات عن الصفحة أو التطبيق الذي حدث فيه نشاط المستخدِم.
- insightPlaybackLocationType
-
يتم تجميع البيانات في التقرير استنادًا إلى نوع الصفحة أو التطبيق الذي حدثت فيه عمليات تشغيل الفيديو. القيم المحتمَلة لهذه السمة هي:
-
BROWSE
– تشير البيانات إلى المشاهدات التي تمّت على الصفحة الرئيسية أو الشاشة الرئيسية في YouTube أو في خلاصة اشتراكات المستخدم أو في ميزة أخرى في التصفّح على YouTube. -
CHANNEL
– تصف البيانات عدد المشاهدات التي تمّت لصفحة قناة معيّنة. -
EMBEDDED
– تصف البيانات عدد المشاهدات التي تمّت على موقع إلكتروني أو تطبيق آخر كان الفيديو مضمّنًا فيه باستخدام<iframe>
أو<object>
. -
EXTERNAL_APP
– تصف البيانات عدد المشاهدات التي تمّت من خلال تطبيق تابع لجهة خارجية، حيث تم تشغيل الفيديو بطريقة أخرى غير<iframe>
أو<object>
المضمَّن. على سبيل المثال، سيتم تصنيف عمليات التشغيل في التطبيقات التي تستخدم YouTube Android Player API باستخدام هذه القيمة. -
MOBILE
– تشير البيانات إلى عدد المشاهدات التي تمّت على موقع YouTube الإلكتروني للأجهزة الجوّالة أو في برامج YouTube API المعتمَدة، بما في ذلك الأجهزة الجوّالة.ابتداءً من 10 أيلول (سبتمبر) 2013، سنتوقف عن تصنيف عمليات التشغيل ضمن تقارير "إحصاءات YouTube" ضمن فئة
MOBILE
تشغيل. قد تبقى القيمة في التقارير لأنّ البيانات القديمة لا تزال تندرج ضمن تلك الفئة. ومع ذلك، بعد هذا التاريخ، يتم تصنيف عمليات التشغيل على الأجهزة الجوّالة ضمن عمليات تشغيلWATCH
أوEMBEDDED
أوEXTERNAL_APP
بناءً على نوع التطبيق الذي تتم فيه عمليات التشغيل. -
SEARCH
– تشير البيانات إلى عدد المشاهدات التي تمّت مباشرةً على صفحة نتائج البحث في YouTube. -
WATCH
– تشير البيانات إلى عدد المشاهدات التي تمّت على صفحة مشاهدة الفيديو على YouTube أو في تطبيق YouTube الرسمي، مثل تطبيق YouTube لأجهزة Android. -
YT_OTHER
– تصف البيانات المشاهدات غير المصنَّفة.
-
- insightPlaybackLocationDetail
- يتم تجميع البيانات استنادًا إلى الصفحة التي يتوفّر فيها المشغّل. تجدر الإشارة إلى أنّ هذا التقرير لا يتوفّر إلّا لعدد المشاهدات التي تمّت في المشغّلات المضمّنة، ويحدّد المشغّلات المضمّنة التي أدّت إلى أكبر عدد من المشاهدات لفيديو معيّن. وبالتالي، يوفر عرضًا أكثر دقة من تقرير مواقع التشغيل من خلال تحديد عناوين URL أو التطبيقات المرتبطة بأهم المشغلات المضمنة.
أمثلة
تستخدم نماذج الطلبات التالية أبعاد موقع التشغيل:
أمثلة على القنوات
-
موقع التشغيل
- عدد المشاهدات ووقت المشاهدة من مواقع تشغيل مختلفة
- عدد المشاهدات اليومي ووقت المشاهدة من مواقع تشغيل مختلفة
- أهم 10: مواقع إلكترونية تابعة لجهات خارجية تسجّل أكبر عدد من المشاهدات لفيديو مضمّن
- عدد مشاهدات قائمة التشغيل ووقت المشاهدة من مواقع تشغيل مختلفة
- عدد مشاهدات قائمة التشغيل ووقت المشاهدة اليومي من مواقع تشغيل مختلفة
-
موقع التشغيل
أمثلة مالك المحتوى
-
موقع التشغيل
- عدد المشاهدات ووقت المشاهدة من مواقع تشغيل مختلفة
- عدد المشاهدات اليومي ووقت المشاهدة من مواقع تشغيل مختلفة
- أهم 10: مواقع إلكترونية تابعة لجهات خارجية تسجّل أكبر عدد من المشاهدات لفيديو مضمّن
- عدد مشاهدات قائمة التشغيل ووقت المشاهدة من مواقع تشغيل مختلفة
- عدد مشاهدات قائمة التشغيل ووقت المشاهدة اليومي من مواقع تشغيل مختلفة
-
موقع التشغيل
تفاصيل التشغيل
- creatorContentType
- تحدِّد هذه السمة نوع المحتوى المرتبط بمقاييس نشاط المستخدم في صف البيانات. تتوفّر بيانات هذه السمة للتواريخ التي تبدأ في 1 كانون الثاني (يناير) 2019.
يسرد الجدول التالي قيم السمات:
القيم LIVE_STREAM
المحتوى الذي تمّت مشاهدته كان بثًا مباشرًا على YouTube. SHORTS
المحتوى الذي تمّت مشاهدته كان فيديو Shorts. STORY
المحتوى الذي تمّت مشاهدته كان قصة على YouTube. VIDEO_ON_DEMAND
المحتوى الذي تمت مشاهدته كان فيديو على YouTube لا يندرج ضمن إحدى قيم السمات الأخرى. UNSPECIFIED
نوع محتوى المحتوى المعروض غير معروف. - liveOrOnDemand
- تشير هذه السمة إلى ما إذا كانت مقاييس نشاط المستخدم في صف البيانات مرتبطة بمشاهدات بث مباشر. تتوفّر بيانات هذه السمة لتواريخ تبدأ من 1 نيسان (أبريل) 2014.
يسرد الجدول التالي قيم السمات:
القيم LIVE
تصف بيانات الصف نشاط المستخدم الذي حدث أثناء بث مباشر. ON_DEMAND
تصف بيانات الصف نشاط المستخدم الذي لم يحدث خلال بث مباشر. - subscribedStatus
- تشير هذه السمة إلى ما إذا كانت مقاييس نشاط المستخدم في صف البيانات مرتبطة بالمشاهدين الذين اشتركوا في القناة التي تعرض الفيديو أو قائمة التشغيل.
القيمتان المحتملتان هما
SUBSCRIBED
وUNSUBSCRIBED
.
يُرجى العلم أنّ قيمة السمة تكون دقيقة اعتبارًا من وقت حدوث نشاط المستخدم. على سبيل المثال، لنفترض أنّ مستخدمًا لم يشترك في قناة وشاهد إحدى الفيديوهات في تلك القناة، ثمّ اشترك في القناة وشاهد فيديو آخر، وكل ذلك في اليوم نفسه. يشير تقرير القناة إلى أنّ قيمةsubscribedStatus
هيSUBSCRIBED
لإحدى المشاهدات في إحدى المشاهدات، بينما تبلغ قيمةsubscribedStatus
UNSUBSCRIBED
لكل مشاهدة. - youtubeProduct
- تحدِّد هذه السمة خدمة YouTube التي حدث عليها نشاط المستخدم. تتوفّر بيانات هذه السمة اعتبارًا من 18 تموز (يوليو) 2015.
يسرد الجدول التالي قيم السمات:
القيم CORE
نشاط المستخدم الذي لم يحدث في أحد تطبيقات YouTube المتخصصة (YouTube Gaming أو YouTube Kids أو YouTube Music) استثناء: يشمل CORE
نشاط المستخدم الذي تم إجراؤه في YouTube Music قبل 1 آذار (مارس) 2021.GAMING
حدث نشاط المستخدم على YouTube Gaming. KIDS
حدث نشاط المستخدم في YouTube Kids. MUSIC
حدث نشاط المستخدم في YouTube Music في 1 آذار (مارس) 2021 أو بعد هذا التاريخ. تم تضمين البيانات السابقة لتاريخ 1 آذار (مارس) 2021 في CORE
. ولا يتم تسجيل بيانات في الوقت الفعلي.UNKNOWN
حدث نشاط المستخدم قبل 18 تموز (يوليو) 2015.
مصادر الزيارات
- insightTrafficSourceType
- يتم تجميع البيانات في التقرير استنادًا إلى نوع المُحيل الذي يصف الطريقة التي وصل بها المستخدمون إلى الفيديو. القيم المتاحة لهذه السمة هي:
ADVERTISING
: تمّت الإشارة إلى الفيديو من خلال إعلان. في حال الفلترة استنادًا إلى مصدر الزيارات هذا، سيحدِّد الحقلinsightTrafficSourceDetail
نوع الإعلان.ANNOTATION
: وصل المشاهدون إلى الفيديو من خلال النقر على تعليق توضيحي في فيديو آخر.CAMPAIGN_CARD
– المشاهدات التي نشأت من الفيديوهات التي حمّلها المستخدمون وتمت المطالبة بملكيتها، والتي استخدمها مالك المحتوى للترويج للمحتوى الذي تمت مشاهدته. مصدر الزيارات هذا غير متوافق إلا مع تقارير مالكي المحتوى.END_SCREEN
– تمّت إحالة المشاهدات من شاشة النهاية لفيديو آخر.EXT_URL
– تمت إحالة مشاهدات الفيديو من رابط على موقع إلكتروني آخر. في حال الفلترة استنادًا إلى مصدر الزيارات هذا، سيحدِّد الحقلinsightTrafficSourceDetail
صفحة الويب. يشمل مصدر الزيارات هذا إحالات من نتائج "بحث Google".HASHTAGS
: المشاهدات الواردة من صفحات الهاشتاغ المتوفرة عند الطلب أو صفحات Shorts المحوريةLIVE_REDIRECT
: تمّت الإشارة إلى مشاهدات الفيديو من عمليات إعادة التوجيه المباشرة.NO_LINK_EMBEDDED
– كان الفيديو مضمّنًا على موقع إلكتروني آخر عند مشاهدته.NO_LINK_OTHER
– لم تحدّد YouTube مُحيلاً للزيارات. وتشمل هذه الفئة الزيارات المباشرة إلى فيديو بالإضافة إلى الزيارات التي تتم على تطبيقات الأجهزة الجوّالة.NOTIFICATION
– تمت إحالة مشاهدات الفيديو من رسالة إلكترونية أو إشعار من YouTube.PLAYLIST
– عدد مشاهدات الفيديو أثناء تشغيله كجزء من قائمة تشغيل وهو يشمل عدد الزيارات الواردة من صفحة قائمة التشغيل.PRODUCT_PAGE
: تمت إحالة مشاهدات الفيديو من صفحة "منتج".PROMOTED
– تمت إحالة مرات مشاهدة الفيديو من إعلان ترويجي غير مدفوع على YouTube، مثل صفحة "الفيديوهات البارزة" على YouTube.RELATED_VIDEO
– تمت إحالة مشاهدات الفيديو من بيانات فيديو ذي صلة على صفحة مشاهدة فيديو أخرى. في حال الفلترة استنادًا إلى مصدر الزيارات هذا، سيحدّد الحقلinsightTrafficSourceDetail
معرّف الفيديو لذلك الفيديو.SHORTS
: تتم الإشارة إلى المستخدم من خلال التمرير سريعًا عموديًا من الفيديو السابق في تجربة مشاهدة فيديوهات Shorts.SOUND_PAGE
: المشاهدات الواردة من صفحات Shorts المحورية للمحتوى الصوتيSUBSCRIBER
– تمت إحالة مرات مشاهدة الفيديو من الخلاصات على صفحة YouTube الرئيسية أو من ميزات اشتراك YouTube. في حال الفلترة استنادًا إلى مصدر الزيارات هذا، سيحدِّد الحقلinsightTrafficSourceDetail
العناصر في خلاصة الصفحة الرئيسية أو الصفحة الأخرى التي تمت إحالة المشاهدات منها.YT_CHANNEL
– عدد مرات مشاهدة الفيديو التي تم تسجيلها من صفحة قناة وفي حال الفلترة استنادًا إلى مصدر الزيارات هذا، سيحدِّد الحقلinsightTrafficSourceDetail
معرّف القناة لتلك القناة.YT_OTHER_PAGE
– تمت إحالة مشاهدات الفيديو من رابط آخر غير نتيجة بحث أو رابط فيديو ذي صلة ظهر على صفحة YouTube. في حال الفلترة استنادًا إلى مصدر الزيارات هذا، سيحدِّد الحقلinsightTrafficSourceDetail
الصفحة.YT_SEARCH
– تمت إحالة مشاهدات الفيديو من نتائج بحث YouTube. وفي حال الفلترة استنادًا إلى مصدر الزيارات هذا، سيحدّد الحقلinsightTrafficSourceDetail
عبارة البحث.VIDEO_REMIXES
: تمّت الإشارة إلى مشاهدات الفيديو من رابط إنشاء الريمكس في مشغّل فيديوهات Shorts. في حال إجراء الفلترة استنادًا إلى مصدر الزيارات هذا، سيحدّد الحقلinsightTrafficSourceDetail
الفيديو الذي تمت إحالة المُشاهد منه.
- insightTrafficSourceDetail
- يتم تجميع البيانات في التقرير بالاستناد إلى المُحيلين الذين حقّقوا أكبر عدد من المشاهدات لفيديو معيّن ونوع معيّن من مصادر الزيارات. تحدِّد القائمة التالية مصادر الزيارات التي يتوفّر لها هذا التقرير. بالنسبة إلى كل مصدر زيارات، تحدِّد القائمة المعلومات التي توفّرها السمة
insightTrafficSourceDetail
.ADVERTISING
: نوع الإعلان الذي أدّى إلى عدد المشاهدات القيم المتاحة:- إعلان جذب من نوع "انقر للتشغيل"
- إعلان جذب
- الإعلانات على شبكة بحث Google
- إعلان فيديو على الصفحة الرئيسية
- إعلان محجوز أثناء عرض الفيديو قابل للتخطي
- TrueView ضمن البحث وضمن العرض
- إعلان قابل للتخطي أثناء عرض الفيديو
- إعلانات YouTube غير المصنفة
- حائط فيديو
CAMPAIGN_CARD
: الفيديو الذي تمّت المطالبة بملكيته والذي وجّه المشاهدين إلى الفيديو المحدّد في التقريرEND_SCREEN
: الفيديو الذي وجّه المشاهدين إلى الفيديو المحدّد في التقريرEXT_URL
: الموقع الإلكتروني الذي أحال المشاهدين إلى الفيديوHASHTAGS
: الهاشتاغ الذي أدّى إلى زيادة عدد المشاهداتNOTIFICATION
– البريد الإلكتروني أو الإشعار الذي أحال الزيارات.RELATED_VIDEO
– الفيديو ذو الصلة الذي وجّه المشاهدين إلى الفيديو الذي يتناوله التقريرSOUND_PAGE
– الفيديو الذي أدّى إلى عدد المشاهداتSUBSCRIBER
– عنصر خلاصة الصفحة الرئيسية أو ميزة الاشتراك على YouTube التي وجّهت المشاهدين إلى الفيديو الذي يتناوله التقرير. في ما يلي القيم الصالحة:activity
– المشاهدات الواردة من العناصر في خلاصات اشتراك الصفحة الرئيسية والناتجة عن نشاط قناة بدون تحميل وغير ذلكblogged
– المشاهدات الواردة من العناصر في خلاصات "اشتراك الصفحة الرئيسية" الناتجة عن روابط من أهم المدونات.mychannel
: المشاهدات الواردة من عناصر في خلاصات أخرى مُدرَجة في الصفحة الرئيسية، مثل "المعجبون" و"سجلّ المشاهدة" و "المشاهدة لاحقًا"podcasts
– المشاهدات التي تنشأ من السلع في صفحة "Google بودكاست" المقصودة.sdig
– المشاهدات التي تنشأ من الرسائل الإلكترونية لتحديث الاشتراك.uploaded
– المشاهدات الواردة منuploaded
عنصر في خلاصات "الاشتراكات" على الصفحة الرئيسية./
– مشاهدات أخرى مصدرها صفحة YouTube الرئيسية/my_subscriptions
– المشاهدات الناتجة من صفحات اشتراكاتي للمستخدمين على YouTube.
YT_CHANNEL
: صفحة القناة التي شاهد فيها المستخدمون الفيديوYT_OTHER_PAGE
– صفحة YouTube التي تمت إحالة المشاهدين منها إلى الفيديو.YT_SEARCH
: هي عبارة البحث التي وجّهت المشاهدين إلى الفيديو.VIDEO_REMIXES
– الفيديو الذي أدّى إلى عدد المشاهدات
أمثلة
تستخدِم النماذج التالية سمات مصادر الزيارات:
أمثلة على القنوات
-
مصدر الزيارات
- عدد المشاهدات ووقت المشاهدة من مصادر زيارات مختلفة في بلد معيّن
- عدد المشاهدات اليومي ووقت المشاهدة من مصادر زيارات مختلفة
- أهم 10: عبارات بحث على YouTube تجذب أكبر عدد من الزيارات لفيديو معيّن
- أهم 10: عبارات بحث على Google التي تجذب أكبر عدد من الزيارات لفيديو معيّن
- عدد مشاهدات قائمة التشغيل ووقت المشاهدة من مصادر زيارات مختلفة في بلد معيّن
- عدد مرات مشاهدة قائمة التشغيل ووقت المشاهدة اليومي من مصادر زيارات مختلفة
-
مصدر الزيارات
أمثلة مالك المحتوى
-
مصدر الزيارات
- عدد المشاهدات ووقت المشاهدة من مصادر زيارات مختلفة
- عدد المشاهدات اليومي ووقت المشاهدة من مصادر زيارات مختلفة
- أهم 10: عبارات بحث على YouTube تجذب أكبر عدد من الزيارات لفيديو معيّن
- أهم 10: عبارات بحث على Google التي تجذب أكبر عدد من الزيارات لفيديو معيّن
- عدد مشاهدات قائمة التشغيل ووقت المشاهدة من مصادر زيارات مختلفة في بلد معيّن
- عدد مرات مشاهدة قائمة التشغيل ووقت المشاهدة اليومي من مصادر زيارات مختلفة
-
مصدر الزيارات
الأجهزة
- deviceType
- تحدِّد هذه السمة شكل الجهاز الذي تمت المشاهدة عليه.
تحدد القائمة التالية أنواع الأجهزة التي تعرض واجهة برمجة التطبيقات بيانات لها. يمكنك أيضًا استخدام السمة
deviceType
كفلتر لحصر تقرير نظام التشغيل بأنّه يتضمّن بيانات لنوع معيّن من الأجهزة فقط.DESKTOP
GAME_CONSOLE
MOBILE
TABLET
TV
UNKNOWN_PLATFORM
- operatingSystem
- تحدِّد هذه السمة نظام برنامج الجهاز الذي حدثت عليه المشاهدة.
تحدد القائمة التالية أنظمة التشغيل التي تعرض واجهة برمجة التطبيقات بيانات لها. يمكنك أيضًا استخدام
operatingSystem
كفلتر لحصر تقرير نوع الجهاز على بيانات نظام تشغيل محدَّد فقط.ANDROID
BADA
BLACKBERRY
CHROMECAST
DOCOMO
FIREFOX
HIPTOP
IOS
KAIOS
LINUX
MACINTOSH
MEEGO
NINTENDO_3DS
OTHER
PLAYSTATION
PLAYSTATION_VITA
REALMEDIA
SMART_TV
SYMBIAN
TIZEN
VIDAA
WEBOS
WII
WINDOWS
WINDOWS_MOBILE
XBOX
أمثلة
تستخدِم نماذج الطلبات التالية أبعاد الجهاز:
أمثلة على القنوات
-
الجهاز/نظام التشغيل
- مقاييس نوع الجهاز اليومية لنظام التشغيل Android
- مقاييس نظام التشغيل اليومية للأجهزة الجوّالة
- مقاييس نظام التشغيل ونوع الجهاز اليومي
- مقاييس نوع الجهاز اليومية لمشاهدات قوائم التشغيل على نظام التشغيل Android
- مقاييس نظام التشغيل اليومية لمشاهدات قائمة التشغيل على الأجهزة الجوّالة
-
الجهاز/نظام التشغيل
أمثلة مالك المحتوى
-
الجهاز/نظام التشغيل
- مقاييس نوع الجهاز اليومي للفيديوهات التي تمت المطالبة بملكيتها
- مقاييس نظام التشغيل اليومي للفيديوهات التي تمت المطالبة بملكيتها والمعروضة على الأجهزة الجوّالة
- مقاييس نظام التشغيل ونوع الجهاز اليومي
- مقاييس نوع الجهاز اليومية لمشاهدات قوائم التشغيل على نظام التشغيل Android
- مقاييس نظام التشغيل اليومية لمشاهدات قائمة التشغيل على الأجهزة الجوّالة
-
الجهاز/نظام التشغيل
الخصائص الديمغرافية
تساعدك سمات الخصائص الديمغرافية على فهم توزيع جمهورك حسب الفئة العمرية والجنس. يحتوي مركز مساعدة YouTube على معلومات إضافية حول بيانات الخصائص الديمغرافية في تقارير YouTube Analytics.
- ageGroup (السمة الأساسية)
- تحدِّد هذه السمة الفئة العمرية للمستخدمين المسجّلين الدخول والمرتبطين ببيانات التقرير. تستخدم واجهة برمجة التطبيقات الفئات العمرية التالية:
- age13-17
- age18-24
- age25-34
- age35-44
- age45-54
- age55-64
- age65-
- الجنس (السمة الأساسية)
- تحدِّد هذه السمة جنس المستخدمين الذين سجّلوا دخولهم والمرتبطين ببيانات التقرير.
القيم الصالحة هي
female
وmale
وuser_specified
. This is a core dimension and is subject to the Deprecation Policy.
أمثلة
تستخدِم نماذج الطلبات التالية سمات ديمغرافية:
أمثلة على القنوات
-
الخصائص الديمغرافية
- الخصائص الديمغرافية للمشاهدين في كاليفورنيا (الفئة العمرية والجنس)
- الخصائص الديمغرافية لمشاهدي قائمة التشغيل في كاليفورنيا (الفئة العمرية والجنس)
-
الخصائص الديمغرافية
أمثلة مالك المحتوى
-
الخصائص الديمغرافية
- الخصائص الديمغرافية للمشاهدين في كاليفورنيا (الفئة العمرية والجنس)
- الخصائص الديمغرافية لمشاهدي قائمة التشغيل في كاليفورنيا (الفئة العمرية والجنس)
-
الخصائص الديمغرافية
التفاعل ومشاركة المحتوى
- sharingService (السمة الأساسية)
- تحدِّد هذه السمة الخدمة التي تم استخدامها لمشاركة الفيديوهات. يمكن مشاركة الفيديوهات على موقع YouTube (أو عبر مشغّل YouTube) باستخدام الزر "مشاركة". This is a core dimension and is subject to the Deprecation Policy.
يوضّح الجدول التالي قيم السمات الصالحة:
خدمة المشاركة قيمة واجهة برمجة التطبيقات Ameba AMEBA
البريد الإلكتروني على Android ANDROID_EMAIL
مراسلة Android ANDROID_MESSENGER
المراسلة على Android ANDROID_MMS
Blackberry Messenger BBM
Blogger BLOGGER
نسخ إلى الحافظة COPY_PASTE
عالم Cyworld CYWORLD
بدفن الجزء السفلي DIGG
Dropbox DROPBOX
تضمين EMBED
البريد الإلكتروني MAIL
Facebook FACEBOOK
Facebook Messenger FACEBOOK_MESSENGER
صفحات Facebook FACEBOOK_PAGES
فوتكا FOTKA
Gmail GMAIL
goo GOO
Google+ GOOGLEPLUS
إرسال رسالة SMS GO_SMS
GroupMe GROUPME
Hangouts HANGOUTS
hi5 HI5
رسالة نصية من HTC HTC_MMS
البريد الوارد في Google INBOX
مربّع حوار نشاط نظام iOS IOS_SYSTEM_ACTIVITY_DIALOG
قصة KAKAO KAKAO_STORY
Kakao (Kakao Talk) KAKAO
كيك KIK
البريد الإلكتروني لـ LGE LGE_EMAIL
سطر LINE
LinkedIn LINKEDIN
LiveJournal LIVEJOURNAL
مينيم MENEAME
mixi MIXI
خدمة المراسلة من Motorola MOTOROLA_MESSAGING
Myspace MYSPACE
Naver NAVER
المشاركة عن قرب NEARBY_SHARE
NUjij NUJIJ
Odnoklassniki (Оноклассники) ODNOKLASSNIKI
غير ذلك OTHER
Pinterest PINTEREST
Rakuten (楽天▼場) RAKUTEN
Reddit REDDIT
Skype SKYPE
سكاي روك SKYBLOG
محادثات Sony SONY_CONVERSATIONS
StumbleUpon STUMBLEUPON
Telegram TELEGRAM
الرسائل النصية TEXT_MESSAGE
تونتي TUENTI
tumblr. TUMBLR
Twitter TWITTER
غير معروف UNKNOWN
رسائل Verizon VERIZON_MMS
Viber VIBER
VKontakte (تجنُّب Контакте) VKONTAKTE
WeChat WECHAT
Weibo WEIBO
WhatsApp WHATS_APP
ويكوب WYKOP
Yahoo! اليابان YAHOO
YouTube Gaming YOUTUBE_GAMING
YouTube Kids YOUTUBE_KIDS
YouTube Music YOUTUBE_MUSIC
YouTube TV YOUTUBE_TV
اطّلِع على مستندات المساعدة للحصول على مزيد من المعلومات.
أمثلة
تستخدم نماذج الطلبات التالية أبعادًا اجتماعية:
أمثلة على القنوات
- الشبكات الاجتماعية: مقاييس المشاركة المجمَّعة حسب الخدمة التي تمت مشاركة الفيديوهات فيها
أمثلة مالك المحتوى
- الشبكات الاجتماعية: مقاييس المشاركة المجمَّعة حسب الخدمة التي تمت مشاركة الفيديوهات فيها
الاحتفاظ بالجمهور
- elapsedVideoTimeRatio
- تحدّد هذه السمة نسبة الجزء المنقضي من الفيديو إلى مدة الفيديو. تُستخدَم سمات ومقاييس الاحتفاظ بالجمهور لقياس الاحتفاظ بالجمهور بمرور الوقت، والسمة
elapsedVideoTimeRatio
هي قياس الوقت. على سبيل المثال، تشير القيمة0.4
إلى أنّ بيانات التقرير المناسبة تعرض بيانات الاحتفاظ بالمستخدمين بعد انقضاء 40 في المئة من الفيديو.
تعرض واجهة برمجة التطبيقات 100 نقطة بيانات لكل فيديو بقيم نسبة تتراوح بين0.01
و1.0
. الأوقات التي يتم فيها قياس البيانات أثناء تشغيل الفيديو تكون متباعدة بشكل متساوٍ لكل فيديو. وهذا يعني أنه بالنسبة إلى فيديو مدته دقيقتان، يكون الفاصل الزمني بين نقاط البيانات 1.2 ثانية. ولكن بالنسبة إلى فيديو مدته ساعتان، يكون الفاصل الزمني بين نقاط البيانات 72 ثانية. تشير قيمة السمة إلى النهاية الحصرية للفاصل الزمني. - audienceType (filter فقط)
- تحدِّد قيمة السمة نوع الزيارات المرتبطة ببيانات التقرير.
القيمتان المسموح بإدراجهما هما
ORGANIC
وAD_INSTREAM
وAD_INDISPLAY
. يمكنك الانتقال إلى مركز مساعدة YouTube للحصول على تفسيرات حول أنواع مصادر الزيارات هذه.
يُرجى العلم أنّ بيانات فلترaudienceType
أصبحت متوفّرة اعتبارًا من 25 أيلول (سبتمبر) 2013. لا تعرض واجهة برمجة التطبيقات بيانات لطلبات البحث التي تستخدم الفلتر لمحاولة استرداد البيانات من تواريخ سابقة. الاستعلامات التي لا تستخدم عامل التصفية تعمل لأي تاريخ بعد 1 يوليو 2008.
أمثلة
تستخدِم نماذج الطلبات التالية سمات الاحتفاظ بالجمهور:
أمثلة على القنوات
- الاحتفاظ بالجمهور: مقاييس الاحتفاظ بالجمهور لفيديو معيّن
أمثلة مالك المحتوى
- الاحتفاظ بالجمهور: مقاييس الاحتفاظ بالجمهور لفيديو معيّن
أداء الإعلان
- adType
- تُستخدَم السمة
adType
في تقارير أداء الإعلانات، وتجمع المقاييس المطلوبة استنادًا إلى أنواع الإعلانات التي تم عرضها أثناء تشغيل الفيديوهات. توضّح القائمة التالية قيم السمات المحتملة. يمكنك الانتقال إلى مركز مساعدة YouTube للحصول على مزيد من المعلومات حول أشكال الإعلانات على YouTube.
-
auctionBumperInstream
– إعلانات فيديو غير قابلة للتخطّي، يتم عرضها عبر المزاد، وتصل مدتها إلى 6 ثوانٍ، يجب عرضها قبل مشاهدة الفيديو. -
auctionDisplay
– وسائط متعددة تفاعلية أو إعلان مصوّر يظهر إما كتراكب في أسفل مشغّل الفيديو، أو كوحدة إعلانية بحجم 300×250 على صفحة مشاهدة الفيديو، أو كمزيج من الاثنين معًا. عند تشغيل التراكب، يتم إغلاقه تلقائيًا بعد عرضه لفترة معينة من الوقت، ويمكن للمستخدم إغلاق التراكب أيضًا. وفي حال عرض تراكب وإعلان بانر معًا، يتمّ احتساب كل إعلان كمرّة ظهور منفصلة. -
auctionInstream
: إعلانات فيديو غير قابلة للتخطّي يتم عرضها قبل الفيديو الرئيسي أو خلاله أو بعده -
auctionTrueviewInslate
: يختار المشاهد أحد إعلانات الفيديو المتعددة من بين مجموعة من الاختيارات المعروضة قبل الفيديو. See the TrueView documentation for more information. -
auctionTrueviewInstream
– إعلانات فيديو قابلة للتخطّي يتم عرضها قبل الفيديو الرئيسي أو خلاله اطّلِع على مستندات TrueView للحصول على مزيد من المعلومات. -
auctionUnknown
– إعلان تم شراؤه عبر مزاد AdWords ولكن لم يتم تصنيفه ضمن أحد أنواع الإعلانات الأخرى. -
reservedBumperInstream
– إعلانات فيديو غير قابلة للتخطّي، يتم بيعها على أساس الحجز، ولا تزيد مدتها عن 6 ثوانٍ، يجب أن يشاهدها المستخدم ليتمكّن من مشاهدة الفيديو -
reservedClickToPlay
– إعلان فيديو يجب أن ينقر عليه المستخدم لبدء التشغيل يتم تسجيل مرة ظهور للإعلان في أي وقت تظهر فيه الوحدة الإعلانية "انقر للتشغيل"، بصرف النظر عما إذا كان المستخدم قد بدأ عملية تشغيل أم لا. ويتم بيعها على أساس الحجز. -
reservedDisplay
– وسائط متعددة تفاعلية أو إعلان مصوّر يظهر إما كتراكب في أسفل مشغّل الفيديو، أو كوحدة إعلانية بحجم 300×250 على صفحة مشاهدة الفيديو، أو كمزيج من الاثنين معًا. عند تشغيل التراكب، يتم إغلاقه تلقائيًا بعد عرضه لفترة معينة من الوقت، ويمكن للمستخدم إغلاق التراكب أيضًا. وفي حال عرض تراكب وإعلان بانر معًا، يتمّ احتساب كل إعلان كمرّة ظهور منفصلة. -
reservedInstream
– إعلانات فيديو غير قابلة للتخطّي يتمّ إدراجها قبل الفيديو الرئيسي أو أثناءه أو بعده -
reservedInstreamSelect
-
reservedMasthead
– إعلان كبير يمكن أن يتضمّن عناصر فيديو وعناصر رسومية يظهر على الصفحة الرئيسية. -
reservedUnknown
– إعلان تم بيعه على أساس محجوز ولا يمكن تصنيفه في أحد أنواع الإعلانات الأخرى. -
unknown
– لم نتمكّن من تصنيف نوع الإعلان هذا.
-
أمثلة
تستردّ نماذج التقارير التالية مقاييس أداء الإعلانات أو الأرباح:
أمثلة على القنوات
-
الأرباح/الإعلانات
- مقاييس أرباح القناة وأداء الإعلانات
- مقاييس أداء الإعلانات والأرباح اليومية
- مقاييس أداء الإعلانات والأرباح في بلدان محدّدة
- أهم 10: الفيديوهات التي حقّقت أعلى الأرباح
- مقاييس أداء الإعلان لأنواع الإعلانات المختلفة
-
الأرباح/الإعلانات
أمثلة مالك المحتوى
-
الأرباح/الإعلانات
- مقاييس أداء الإعلانات والأرباح للمحتوى المطالَب بملكيته
- مقاييس أداء الإعلانات والأرباح اليومية
- مقاييس أداء الإعلانات والأرباح في بلدان محدّدة
- أهم 10: الفيديوهات التي حقّقت أعلى الأرباح
- مقاييس أداء الإعلان لأنواع الإعلانات المختلفة
-
الأرباح/الإعلانات
قوائم التشغيل
- isCurated (الفلتر فقط)
- يشير هذا الفلتر إلى أنّ الطلب يسترد البيانات حول عدد مشاهدات الفيديو التي تم الحصول عليها في سياق قائمة تشغيل.
أمثلة
كل نماذج الطلبات التي تسترد تقارير قوائم التشغيل تستخدم الفلتر isCurated
.
سمات مالك المحتوى
تتوفّر السمات التالية فقط لتقارير مالكي المحتوى.
- ClaimStatus (تُستخدَم فقط في تقارير مالكي المحتوى)
- تتيح لك هذه السمة الإشارة إلى أنّ الردّ من واجهة برمجة التطبيقات يجب أن يتضمن فقط مقاييس للمحتوى المُطالَب بملكيته. القيمة الوحيدة الصالحة لهذه السمة هي
claimed
. إذا كانت المَعلمةfilters
تحصر طلب البحث علىclaimedStatus==claimed
، ستسترد واجهة برمجة التطبيقات بيانات المحتوى الذي تمّت المطالبة بملكيته فقط. يقدّم الجدول الوارد في تعريف السمةuploaderType
مزيدًا من التفاصيل حول كيفية استخدام هذه السمة.
- القائم بالتحميل (السمة الأساسية) (يُستخدم فقط في تقارير مالكي المحتوى)
- تتيح لك هذه السمة تحديد ما إذا كان يجب أن يتضمّن ردّ واجهة برمجة التطبيقات مقاييس للمحتوى الذي حمّله مالك المحتوى المحدَّد و/أو المحتوى الذي حمّلته جهات خارجية، مثل الفيديوهات التي حمّلها المستخدمون. القيمتان الصالحتان هما
self
وthirdParty
. هذه سمة أساسية وتخضع لسياسة الإيقاف.
يعرض الجدول أدناه التركيبات المتوافقة للسمتَينclaimedStatus
وuploaderType
، وكلاهما مستخدَم في مَعلمةfilters
:
قيمة claimedStatus
قيمة uploaderType
الوصف [لم يتم الضبط] ذاتي استرداد بيانات "إحصاءات YouTube" للمحتوى المُطالَب بملكيته وغير المُطالَب بملكيته والذي حمّله مالك المحتوى تمت المطالبة بملكيته [لم يتم الضبط] استرداد بيانات المحتوى المُطالَب بملكيته والذي حمّله مالك المحتوى أو جهة خارجية تمت المطالبة بملكيته ذاتي يسترد بيانات المحتوى الذي تمت المطالبة بملكيته وحمّله مالك المحتوى. تمت المطالبة بملكيته thirdParty يسترد البيانات للمحتوى المُطالَب بملكيته والذي حمّلته جهة خارجية.
أمثلة
يستخدم العديد من نماذج طلبات البيانات من واجهة برمجة التطبيقات لتقارير مالكي المحتوى مجموعة متوافقة من السمتَين claimedStatus
وuploaderType
لفلترة البيانات.