Dimensions

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

يحدّد هذا المستند السمات التي تتوافق مع YouTube Reporting API. تستردّ واجهة برمجة التطبيقات هذه التقارير المجمّعة التي تتضمّن بيانات "إحصاءات YouTube" لقناة أو مالك محتوى.

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

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

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

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

تحدِّد القائمة التالية السمات الأساسية لواجهة برمجة التطبيقات. وجميعها أيضًا سمات أساسية في YouTube Analytics API.

• age_group
• channel_id
• country_code
• date
• gender
• sharing_service
• uploader_type
• video_id

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

الأبعاد

تحدِّد الأقسام التالية السمات المستخدَمة في التقارير المجمّعة لواجهة برمجة التطبيقات YouTube Reporting API. ما لم يُذكر خلاف ذلك، يتم استخدام هذه السمات في كلّ من تقريرَي القناة ومالك المحتوى.

الموارد

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

• video_id
• playlist_id
• channel_id
• asset_id

video_id (سمة أساسية)

معرّف فيديو على YouTube في YouTube Data API، هذه هي قيمة سمة id لمورد video. This is a core dimension and is subject to the Deprecation Policy.

playlist_id

رقم تعريف قائمة تشغيل على YouTube في YouTube Data API، هذه هي قيمة سمة id لمورد playlist.

channel_id (السمة الأساسية)

معرّف قناة على YouTube في YouTube Data API، هذه هي قيمة سمة id لمورد channel. This is a core dimension and is subject to the Deprecation Policy.

‫asset_id (يُستخدَم فقط في تقارير مالكي المحتوى)

معرّف مادة عرض مُدارة في نظام Content ID في YouTube تمثّل مادة العرض حقوق الملكية الفكرية في هذا النظام. على موقع YouTube الإلكتروني، يمكنك العثور على معرّفات مواد العرض في نظام "إدارة المحتوى" في YouTube. ويمكنك أيضًا استردادها باستخدام YouTube Content ID API.

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

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

country_code (سمة أساسية)

البلد المرتبط بالمقاييس في صف التقرير قيمة السمة هي رمز بلد مكوّن من حرفَين وفقًا لمعيار ISO-3166-1، مثل US أو CN (الصين) أو FR (فرنسا). يُستخدَم رمز البلد ZZ لإعداد تقارير عن المقاييس التي لم تتمكّن YouTube من تحديد البلد المرتبط بها. This is a core dimension and is subject to the Deprecation Policy.

province_code

الولاية أو المنطقة في الولايات المتحدة المرتبطة بالمقاييس في صف التقرير قيمة السمة هي رمز ISO 3166-2 الذي يحدّد إحدى الولايات الأمريكية أو مقاطعة كولومبيا، مثل US-MI (ميشيغان) أو US-TX (تكساس). يُستخدَم رمز المقاطعة US-ZZ لإعداد تقارير عن المقاييس التي لم تتمكّن YouTube من تحديد الولاية الأمريكية المرتبطة بها.

ملاحظة: لا تتيح هذه السمة استخدام قيم معيار ISO 3166-2 التي تحدّد المناطق البعيدة في الولايات المتحدة، لأنّ هذه المناطق لها أيضًا رموز بلدان خاصة بها وفقًا لمعيار ISO 3166-1. ولا تتيح أيضًا تقسيمات البلدان الأخرى غير الولايات المتحدة.

الفترات الزمنية

‫date (سمة أساسية)

تحدِّد هذه السمة التاريخ المرتبط بالمقاييس في كل صف من صفوف التقرير. في تقارير التحميل المُجمَّع، يشير التاريخ إلى الفترة التي تبدأ في الساعة 12:00 صباحًا بالتوقيت المحيط الهادئ وتنتهي في 11:59 مساءً بالتوقيت المحيط الهادئ في اليوم والشهر والسنة المحدّدين. استنادًا إلى الوقت من السنة، يكون توقيت المحيط الهادئ إما التوقيت العالمي المنسق -7 أو التوقيت العالمي المنسق -8.

تجدر الإشارة إلى أنّه على الرغم من أنّ التواريخ تشير عادةً إلى فترة مدتها 24 ساعة، فإنّ التواريخ التي يتم فيها ضبط الساعات للأمام وفقًا للتوقيت الصيفي تشير إلى فترة مدتها 23 ساعة، بينما تشير التواريخ التي يتم فيها ضبط الساعات خلفًا إلى فترة مدتها 25 ساعة. This is a core dimension and is subject to the Deprecation Policy.

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

تقدِّم هذه السمات إحصاءات عن الصفحة أو التطبيق الذي حدث فيه نشاط المستخدِم.

playback_location_type

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

القيم
0	ترتبط البيانات بالنشاط الذي تمّ في صفحة مشاهدة الفيديو على YouTube أو في تطبيق رسمي من تطبيقات YouTube، مثل تطبيق YouTube لأجهزة Android.
1	ترتبط البيانات بالنشاط الذي حدث على موقع إلكتروني أو تطبيق آخر تم تضمين الفيديو فيه باستخدام رمز تضمين