ملاحظة:Content owner reports are only accessible to YouTube content partners who participate in the YouTube Partner Program.
تعرض هذه الصفحة التقارير التي يمكن لمالكي المحتوى استردادها باستخدام YouTube Analytics API. تحتوي تقارير مالك المحتوى على مقاييس للقنوات المرتبطة بحساب مالك محتوى محدّد على YouTube. المقاييس هي قياسات فردية لنشاط المستخدِم أو أداء الإعلان أو الأرباح المقدّرة.
تحتوي تقارير الفيديوهات على مقاييس نشاط المستخدمين وأداء الإعلانات والأرباح المقدَّرة للفيديوهات على قنوات مالك المحتوى.
تقدّم تقارير قوائم التشغيل إحصاءات مرتبطة بشكل خاص بمشاهدات الفيديوهات التي تحدث في سياق قائمة تشغيل. تستخدِم تقارير قوائم التشغيل العديد من السمات والفلاتر نفسها المستخدَمة في تقارير الفيديوهات.
تتضمّن تقارير أداء الإعلانات مقاييس مرتبطة بالأرباح وأداء الإعلانات. وتستخدِم هذه المقاييس سمة adType لتجميع المقاييس استنادًا إلى أنواع الإعلانات التي تم عرضها أثناء تشغيل الفيديوهات. يوضّح قسم تقارير أداء الإعلانات النوعَين من مقاييس أداء الإعلانات التي تتيحها واجهة برمجة التطبيقات.
استرداد تقرير
لاسترداد تقرير مالك محتوى، يمكنك استدعاء طريقة reports.query في واجهة برمجة التطبيقات وضبط قيمة المَعلمة ids في طلب البيانات من واجهة برمجة التطبيقات على contentOwner==OWNER_NAME، حيث يحدّد OWNER_NAME رقم تعريف مالك المحتوى. إذا لم تكن متأكدًا من القيمة، يُرجى سؤال مدير الشركاء.
التفويض
يجب أن يتم السماح بإرسال جميع طلبات البيانات من YouTube Analytics API. يوضّح دليل التفويض كيفية استخدام بروتوكول OAuth 2.0 لاسترداد الرموز المميّزة للتفويض.
تستخدِم طلبات البيانات من "واجهة برمجة تطبيقات YouTube Analytics" نطاقات التفويض التالية:
عرض تقارير "إحصاءات YouTube" المالية للمحتوى في YouTube يمنح هذا النطاق إمكانية الوصول إلى مقاييس نشاط المستخدِم ومقاييس الأرباح المقدَّرة وأداء الإعلانات.
https://www.googleapis.com/auth/youtube
إدارة حسابك على YouTube في YouTube Analytics API، يستخدم مالكو القنوات هذا النطاق لإدارة المجموعات والعناصر المجمّعة في "إحصاءات YouTube".
https://www.googleapis.com/auth/youtubepartner
عرض وإدارة مواد عرض YouTube والمحتوى المرتبط بها على YouTube في YouTube Analytics API، يستخدم مالكو المحتوى هذا النطاق لإدارة مجموعات "إحصاءات YouTube" والعناصر المجمّعة.
ملاحظة: تتطلّب المقاييس التي تم وضع علامة النجمة عليها (*) رمز مميّزًا للترخيص يمنح إذن الوصول إلى نطاق https://www.googleapis.com/auth/yt-analytics-monetary.readonly.
الفلاتر
يجب أن تصفّر جميع طلبات البيانات من واجهة برمجة التطبيقات لاسترداد تقارير مالكي المحتوى البيانات باستخدام سمة video أو سمة channel أو سمة isCurated أو مجموعة متوافقة من سمتَي claimedStatus وuploaderType. (يتم إدراج المجموعات المتوافقة في تعريف سمة uploaderType).
تحدِّد الجداول التي توضّح التقارير المتوافقة الفلاتر التي يمكن استخدامها لأي تقرير معيّن. في الأوصاف، تكون الفلاتر المعروضة بين قوسين اختيارية. على سبيل المثال، إذا كان التقرير يسرد video(,country) كخيار فلترة، يمكن فلترة التقرير لتضمين بيانات فيديو معيّن فقط أو لتضمين بيانات فيديو معيّن في بلد معيّن فقط.
تتيح واجهة برمجة التطبيقات أيضًا إمكانية تحديد قيم متعدّدة لفلاتر video وplaylist وchannel. في حال تحديد قيم متعدّدة لأحد هذه الفلاتر، يمكنك أيضًا إضافة هذا الفلتر إلى قائمة السمات التي تحدّدها للطلب. وينطبق ذلك حتى إذا لم يكن الفلتر مُدرَجًا كسمة متوافقة لتقرير معيّن.
اطّلِع على تعريف المَعلمة filters للحصول على شرح كامل لكيفية فلترة نتائج واجهة برمجة التطبيقات للحصول على قيمة معيّنة أو مجموعة من القيم.
فهم جداول التقارير
يوضّح هذا القسم التنسيق والمصطلحات المستخدَمة في الجداول التي تحدّد التقارير التي تتوافق مع واجهة برمجة التطبيقات. يسرد الجدول التالي السمات والمقاييس والفلاتر المتوافقة مع
تقرير تفاصيل التشغيل الخاص بالفيديوهات باستخدام سمة الوقت ومقياس averageViewPercentage.
يحتوي الجدول على صفَّين للسمات وصف واحد للمقاييس وثلاثة صفوف للفلاتر. بالنسبة إلى
السمات والفلاتر، يمكن دمج القيم من كل صف في طلب واجهة برمجة التطبيقات ما دامت
التركيبة تلتزم بقواعد الاستخدام الواردة في الجدول. على سبيل المثال، تشمل قيم مَعلمة dimensions
الصالحة لهذا التقرير ما يلي:
dimensions=day
dimensions=day,subscribedStatus
dimensions=month,subscribedStatus,youtubeProduct
dimensions=month,youtubeProduct
ومع ذلك، قيمة المَعلمة day,month غير صالحة لأنّها تستخدِم سمتَين مستندتَين إلى الوقت، ويجب أن يستخدِم الطلب القيمة 0 أو 1.
مصطلحات جدول التقارير
تستخدِم الجداول المصطلحات التالية للإشارة إلى ما إذا كانت السمات مطلوبة أو اختيارية:
تشير هذه المصطلحات إلى أنّ تقديم قيمة مطلوب:
مطلوبة: يجب تضمين القيمة.
استخدام قيمة واحدة بالضبط: يجب تضمين قيمة واحدة من المجموعة.
استخدام قيمة واحدة أو أكثر: يمكنك تضمين أي قيمة أو كل القيم من المجموعة، ولكن يجب تضمين قيمة واحدة على الأقل.
تشير هذه المصطلحات إلى أنّ القيمة اختيارية:
اختياري: يمكنك تضمين القيمة.
استخدام 0 أو 1: يمكنك تضمين قيمة واحدة من المجموعة.
استخدام 0 أو أكثر: يمكنك تضمين أي قيمة أو كل القيم من المجموعة.
ملاحظة مهمة: يجب أن تشمل جميع طلبات البيانات من واجهة برمجة التطبيقات لاسترداد تقارير الفيديوهات الخاصة بمالك المحتوى
فلترة البيانات باستخدام سمة video أو سمة channel أو سمة group
أو مجموعة متوافقة من سمتَي claimedStatus وuploaderType. (لا تتيح بعض التقارير جميع هذه الخيارات). في ما يلي التركيبات المتوافقة التي
يتم إدراجها أيضًا في تعريف السمة uploaderType:
uploaderType==self
claimedStatus==claimed
claimedStatus==claimed;uploaderType==self
claimedStatus==claimed;uploaderType==thirdParty
تقارير الفيديو
الإحصاءات الأساسية
الإحصاءات الأساسية (بما في ذلك أعداد المشتركين)
يوفّر هذا التقرير إحصاءات ذات صلة بإجراءات المستخدمين على جميع قنوات مالك المحتوى. يمكنك فلترة التقرير لعرض بيانات فيديو أو بلد معيّنَين فقط. ويمكن أيضًا استخدامها لاسترداد إحصاءات المحتوى الذي تمّت المطالبة بملكيته فقط، بما في ذلك المحتوى الذي تمّت المطالبة بملكيته والذي حمّله مالك المحتوى أو جهات خارجية أو كليهما.
يوفّر هذا التقرير إحصاءات عن ولاية أمريكية معيّنة أو مقاطعة كولومبيا. يُرجى العلم أنّ هذا التقرير يتيح استخدام مجموعة فرعية فقط من المقاييس المتاحة في التقرير الخاص بكل بلد والموضّح أعلاه.
يوفّر هذا التقرير إحصاءات ذات صلة بإجراءات المستخدمين على جميع قنوات مالك المحتوى خلال فترات زمنية محدّدة. يمكنك فلترة التقرير لعرض بيانات فيديو أو بلد معيّنَين فقط.
نشاط المستخدِمين في الولايات الأمريكية لفترات زمنية معيّنة
يوفّر هذا التقرير إحصاءات عن ولاية أمريكية معيّنة أو مقاطعة كولومبيا. يُرجى العلم أنّ هذا التقرير يتيح استخدام مجموعة فرعية فقط من المقاييس المتاحة في التقرير الخاص بكل بلد والموضّح أعلاه.
يوفّر هذا التقرير إحصاءات عن نشاط المستخدمين في الولايات الأمريكية ومقاطعة كولومبيا. بالنسبة إلى هذا التقرير، يجب ضبط قيمة المَعلمة filters على country==US.
ملاحظة: يتطلّب هذا التقرير ضبط المَعلمة maxResults على قيمة عددية تبلغ 250 أو أقل. على عكس معظم التقارير الأخرى، يتطلّب منك هذا التقرير أيضًا تحديد قيمة لمَعلمة الطلب sort.
يوفّر هذا التقرير إحصاءات عن نشاط المستخدِمين حسب المدينة.
يقدّم هذا التقرير مقاييس نشاط المستخدمين للمشاهدين المشتركين وغير المشتركين في القناة. يمكن تجميع الإحصاءات حسب الفترة الزمنية (اليوم أو الشهر)، ويمكن أيضًا فلترة التقرير حسب البلد أو القارة أو subContinent.
يقدّم هذا التقرير مقاييس نشاط المستخدمين للمشاهدين المشتركين وغير المشتركين في الولايات الأمريكية أو مقاطعة كولومبيا. يتيح هذا التقرير عددًا أقل من المقاييس مقارنةً بالتقرير السابق.
سمة الوقت، أي اليوم أو الشهر، اختيارية لهذه التقارير لأنّه عليك استخدام مَعلمتَي الطلب startDate وendDate على أي حال لتحديد النطاق الزمني الذي سيغطيه التقرير. تشير السمة، في حال توفّرها، إلى أنّك تريد تجميع البيانات في التقرير حسب اليوم أو الشهر أو غير ذلك.
تفاصيل التشغيل مع سمة الوقت الاختيارية وإحصاءات liveOrOnDemand
يوفّر هذا التقرير إحصاءات تفصيلية عن التشغيل لفترات زمنية محدّدة. وهي تتيح استخدام السمة (والفلتر) liveOrOnDemand.
التقرير التالي مشابه للتقرير السابق. وتضيف هذه الميزة إمكانية استخدام المقياس averageViewPercentage، ولكنّها لا تتيح استخدام liveOrOnDemand كسمة أو فلتر.
التقرير التالي مشابه للتقرير السابق. وتضيف هذه الميزة إمكانية استخدام المقياس averageViewPercentage، ولكنّها لا تتيح استخدام liveOrOnDemand كسمة أو فلتر.
ملاحظة: يتطلّب هذا التقرير ضبط المَعلمة maxResults على قيمة عددية تبلغ 25 أو أقل. على عكس معظم التقارير الأخرى، يتطلّب منك هذا التقرير أيضًا تحديد قيمة لمَعلمة الطلب sort.
يحدِّد هذا التقرير مشغّلات الفيديو المضمّنة التي حقّقت أكبر عدد من المشاهدات أو وقت المشاهدة لمحتوى مالك المحتوى. عند استرداد هذا التقرير، يجب ضبط فلتر insightPlaybackLocationType على EMBEDDED.
يجمع هذا التقرير إحصاءات المشاهدة استنادًا إلى الطريقة التي وصل بها المشاهدون إلى محتوى
الفيديو الخاص بك. على سبيل المثال، يحدّد عدد المشاهدات الناتجة عن بحث على Google أو من
رابط يؤدي إلى فيديو ذي صلة.
ملاحظة: يعرض هذا التقرير خطأ إذا كان حاصل ضرب
عدد الفيديوهات التي تمّ البحث عنها × عدد الأيام في النطاق الزمني يتجاوز 50,000. على سبيل المثال، يمكن أن يطلب استعلام
يستردّ بيانات 500 معرّف فيديو بيانات لمدة 100 يوم كحدّ أقصى. لتقليل
عدد الصفوف التي يعرضها الطلب، يمكنك تقسيم طلبك إلى طلبات متعددة تحدّد عددًا أقل من
الفيديوهات أو تضبط نطاقات زمنية أقصر.
ملاحظة: يتطلّب هذا التقرير ضبط المَعلمة maxResults على قيمة عددية تبلغ 25 أو أقل. على عكس معظم التقارير الأخرى، يتطلّب منك هذا التقرير أيضًا تحديد قيمة لمَعلمة الطلب sort.
يجمع هذا التقرير إحصاءات المشاهدة استنادًا إلى المُحيلِين الذين حقّقوا أكبر عدد من المشاهدات لمحتوى مالك القناة. يتم تصنيف المُحيلِين حسب نوع مصدر الزيارات، ويحدِّد تعريف سمة insightTrafficSourceDetail مصادر الزيارات التي يتوفّر لها التقرير. على سبيل المثال، في حال ضبط الفلتر insightTrafficSourceType على ADVERTISING، سيُدرج التقرير أنواع الإعلانات التي حقّقت أكبر عدد من المشاهدات أو وقت المشاهدة لمحتوى مالك المحتوى.
ملاحظة: لا يتوفّر هذا التقرير إلّا لمصادر زيارات محدّدة. VIDEO_REMIXES وNOTIFICATION وEND_SCREEN وCAMPAIGN_CARD وVIDEO_REMIXES وNO_LINK_EMBEDDED هي بعض مصادر الزيارات غير المتوافقة.
نوع الجهاز ونظام التشغيل
نوع الجهاز
يجمع هذا التقرير إحصاءات المشاهدة استنادًا إلى نوع الجهاز الذي كان يستخدمه المشاهدون أثناء مشاهدة فيديوهاتك. على سبيل المثال، يحدِّد عدد المشاهدات التي حدثت على الأجهزة اللوحية أو أجهزة تشغيل الألعاب.
يجمع هذا التقرير إحصاءات المشاهدة استنادًا إلى أنظمة التشغيل التي يستخدمها المشاهدون. على سبيل المثال، يحدِّد عدد المشاهدات التي حدثت على أجهزة Android أو على أجهزة PlayStation.
يجمع هذا التقرير إحصاءات المشاهدة استنادًا إلى أنظمة التشغيل وأنواع الأجهزة لدى المشاهدين. على سبيل المثال، يحدِّد عدد المشاهدات التي حدثت على أجهزة Android اللوحية أو على أجهزة الكمبيوتر المكتبي التي تعمل بنظام التشغيل Windows.
على سبيل المثال،
إذا كان التقرير يستخدِم سمة subscribedStatus، سيعرض بيانات viewerPercentage
التي تبلغ نسبتها 100% للمشاهدات التي اشتركت فيها القناة و بيانات viewerPercentage التي تبلغ نسبتها
100% للمشاهدات التي لم تشترك فيها القناة. (تبلغ القيمة الإجمالية لجميع حقول viewerPercentage في
التقرير %200).
يقيس هذا التقرير قدرة الفيديو على الاحتفاظ بالجمهور. تقيس سمة elapsedVideoTimeRatio المدة التي مرّت من الفيديو لقيم المقاييس المقابلة. يقدّم مقياسا audienceWatchRatio وrelativeRetentionPerformance قياسَين يوضّحان مدى قدرة الفيديو على الاحتفاظ بالجمهور. والقيمة الأولى هي قيمة مطلقة، بينما تعرض القيمة الثانية مستوى أداء الفيديو مقارنةً بالفيديوهات الأخرى على YouTube ذات المدة نفسها.
ملاحظة: لا تتيح تقارير "الاحتفاظ بالجمهور" إمكانية تحديد قائمة قيم مفصولة بفواصل لفلترة video، بل يجب أن تحدّد القيمة معرّف فيديو واحدًا.
ملاحظة: تتطلّب هذه التقارير ضبط المَعلمة maxResults على قيمة عددية تبلغ 200 أو أقل. لا تتوفّر بيانات عن الفترة قبل 1 كانون الثاني (يناير) 2013 إلا لأهم 10 فيديوهات. على عكس معظم التقارير الأخرى، تتطلّب هذه التقارير أيضًا منك تحديد قيمة لمَعلمة الطلب sort.
أهم الفيديوهات بشكل عام أو حسب البلد أو القارة أو شبه القارة (<= 200 نتيجة)
يسرد هذا التقرير أهم فيديوهات مالك المحتوى استنادًا إلى معايير الفلترة والترتيب المحدّدة.
أبرز الفيديوهات بشكل عام حسب الولاية في الولايات المتحدة (<= 200 نتيجة)
يعرض هذا التقرير أهم فيديوهات مالك المحتوى في ولاية أمريكية معيّنة أو مقاطعة كولومبيا. يُرجى العلم أنّ هذا التقرير يتيح استخدام مجموعة فرعية فقط من المقاييس المتاحة في التقرير الخاص بكل بلد والموضّح أعلاه.
أبرز الفيديوهات للمشتركين أو غير المشتركين(<= 200 نتيجة)
يعرض هذا التقرير أهم الفيديوهات للمشتركين وغير المشتركين في قناتك. يمكن فلترة التقرير لعرض أهم الفيديوهات حسب البلد أو القارة أو subContinent. يتيح لك التقرير السابق استرداد أهم الفيديوهات في ولاية أمريكية معيّنة للمشاهدين المشتركين أو غير المشتركين في قناتك، ولكنه يتضمّن عددًا أقل من المقاييس مقارنةً بهذا التقرير.
يسرد هذا التقرير أهم الفيديوهات ويتيح استخدام فلاتر جغرافية وتفاصيل التشغيل. يشبه هذا التقرير التقرير السابق، ولكنه يتيح استخدام مقاييس أقل ويضيف إمكانية استخدام فلتر youtubeProduct.
أهمّ الفيديوهات التي تتضمّن فلاتر تفاصيل التشغيل (<= 200 نتيجة)
يعرض هذا التقرير أهم فيديوهات مالك المحتوى، ويتم الفلترة حسب سمة واحدة أو أكثر من سمات تفاصيل التشغيل: liveOrOnDemand وsubscribedStatus وyoutubeProduct. يتيح التقرير أيضًا الفلترة حسب المنطقة.
تحتوي تقارير قوائم التشغيل على مقاييس مرتبطة بنشاط المستخدمين في ما يتعلق بالفيديوهات المضمّنة في قوائم تشغيل مالك القناة. يتوفّر تقريران من هذه التقارير، ولكل تقرير متوفّر، يحتوي
كل قسم من الأقسام التالية على وصف لكل إصدار:
توضّح علامة التبويب مُقترَح في كل قسم تنسيق طلب البيانات من واجهة برمجة التطبيقات المفضّل ل retrieving استرداد التقرير المقابل. تتيح التقارير المقترَحة مجموعة موسّعة من المقاييس
التي تتضمّن كلّ من مقاييس الفيديو المجمّعة و
مقاييس قائمة التشغيل. لا يستخدم تنسيق الطلب هذا سمة
isCurated.
توضّح علامة التبويب استخدام isCurated في كل قسم تنسيقًا قديمًا لطلب البيانات من واجهة برمجة التطبيقات
يكون فيه سمة isCurated مطلوبة. تتيح هذه التقارير استخدام
مقاييس داخل قائمة التشغيل فقط. يُرجى العلم أنّه تم إيقاف سمة
isCurated نهائيًا في جميع التقارير. توضِّح ملاحظة التحذير أدناه
جدول الإيقاف النهائي.
توضِّح ملاحظة التحذير التالية التغييرات بين نسختَي التقرير بمزيد من التفصيل.
مقاييس الفيديو المجمّعة
تقدّم هذه المقاييس مقاييس نشاط المستخدِمين ومرّات الظهور التي يتم تجميعها لجميع الفيديوهات
في قائمة التشغيل التي تملكها القناة أيضًا. لا يتم احتساب مقاييس الفيديوهات
التي تملكها قنوات أخرى في عملية التجميع. نتيجةً لذلك، إذا أنشأت قناة
قائمة تشغيل تتضمّن فيديوهات تملكها قنوات أخرى فقط، لن تقدّم تقارير قوائم التشغيل هذه
قيمًا لهذه المقاييس.
تعكس هذه المقاييس نشاط المستخدمين وتفاعلهم في سياق صفحة قائمة التشغيل. وتشمل هذه المقاييس مشاهدات كل الفيديوهات في قائمة التشغيل، بغض النظر عن القناة التي تملكها، ولكنها لا تحتسب سوى المشاهدات التي حدثت في سياق قائمة التشغيل.
يوفّر هذا التقرير إحصاءات متعلّقة بتفاعلات المستخدمين مع الفيديوهات في قوائم التشغيل الخاصة
بقنوات مالك المحتوى على فترات زمنية محدّدة. يمكنك فلترة التقرير لعرض بيانات قائمة تشغيل أو قناة معيّنة فقط.
يقدّم هذا التقرير إحصاءات عن نشاط قوائم التشغيل في الولايات الأمريكية ومقاطعة كولومبيا. بالنسبة إلى هذا التقرير، يمكنك تضمين country==US في قيمة المَعلمة filters.
ملاحظة: يتطلّب هذا التقرير ضبط المَعلمة maxResults على قيمة عددية تبلغ 25 أو أقل. على عكس معظم التقارير الأخرى، يتطلّب منك هذا التقرير أيضًا تحديد قيمة لمَعلمة الطلب sort.
يحدِّد هذا التقرير مشغّلات الفيديو المضمّنة التي حقّقت أكبر عدد من المشاهدات أو وقت المشاهدة لقوائم التشغيل الخاصة بصاحب المحتوى.
يجمع هذا التقرير إحصاءات المشاهدة استنادًا إلى الطريقة التي وصل بها المشاهدون إلى محتوى قائمة التشغيل. على سبيل المثال، يحدِّد عدد المشاهدات الناتجة عن بحث على Google أو صفحة قناة.
ملاحظة: يتطلّب هذا التقرير ضبط المَعلمة maxResults على قيمة عددية تبلغ 25 أو أقل. على عكس معظم التقارير الأخرى، يتطلّب منك هذا التقرير أيضًا تحديد قيمة لمَعلمة الطلب sort.
يجمع هذا التقرير إحصاءات المشاهدة استنادًا إلى المُحيلِين الذين حقّقوا أكبر عدد من المشاهدات لقوائم تشغيل مالك المحتوى. يتم تصنيف المُحيلِين حسب نوع مصدر الزيارات، ويحدِّد تعريف سمة insightTrafficSourceDetail مصادر الزيارات التي يتوفّر لها التقرير. على سبيل المثال، في حال ضبط الفلتر insightTrafficSourceType على ADVERTISING، سيُدرج التقرير أنواع الإعلانات التي حقّقت أكبر عدد من المشاهدات أو وقت المشاهدة لقوائم التشغيل الخاصة بمالك المحتوى.
ملاحظة: لا يتوفّر هذا التقرير إلّا لمصادر زيارات محدّدة. VIDEO_REMIXES وNOTIFICATION وEND_SCREEN وCAMPAIGN_CARD وVIDEO_REMIXES وNO_LINK_EMBEDDED هي بعض مصادر الزيارات غير المتوافقة.
نوع الجهاز ونظام التشغيل
نوع الجهاز المخصّص لقوائم التشغيل
يجمع هذا التقرير إحصاءات المشاهدة استنادًا إلى نوع الجهاز الذي استخدمه المشاهدون لمشاهدة محتوى قائمة التشغيل. على سبيل المثال، يحدّد عدد المشاهدات التي حدثت على الأجهزة الجوّالة أو وحدات تحكّم الألعاب.
يجمع هذا التقرير إحصاءات المشاهدة استنادًا إلى أنظمة التشغيل التي يستخدمها المشاهدون. على سبيل المثال، يحدِّد هذا المقياس عدد مشاهدات قوائم التشغيل التي حدثت على أجهزة Android أو على أجهزة PlayStation.
نظام التشغيل ونوع الجهاز المخصّصَين لقوائم التشغيل
يجمع هذا التقرير إحصاءات المشاهدة استنادًا إلى أنظمة التشغيل وأنواع الأجهزة لدى المشاهدين. على سبيل المثال، يحدِّد عدد مشاهدات قوائم التشغيل التي حدثت على أجهزة Android اللوحية أو على أجهزة الكمبيوتر المكتبي التي تعمل بنظام التشغيل Windows.
على سبيل المثال، يعرض التقرير الذي يستخدِم سمة subscribedStatus بيانات viewerPercentage التي تبلغ نسبتها 100% لمشاهدات المحتوى الذي اشتركت فيه القناة و بيانات viewerPercentage التي تبلغ نسبتها 100% لمشاهدات المحتوى الذي لم تشترك فيه القناة. (تبلغ القيمة الإجمالية لجميع حقول viewerPercentage في التقرير %200).
يمكنك استخدام الفلاتر للتأكّد من أنّ التقرير لا يحتوي إلا على بيانات viewerPercentage لقيمة واحدة (أو مجموعة من القيم) لسمات تفاصيل التشغيل.
أهم قوائم التشغيل
ملاحظة: تتطلّب هذه التقارير ضبط المَعلمة maxResults على قيمة عددية تبلغ 200 أو أقل. لا تتوفّر بيانات قبل 1 كانون الثاني (يناير) 2013 إلا لأبرز 10 قوائم تشغيل. على عكس معظم التقارير الأخرى، تتطلّب هذه التقارير أيضًا منك تحديد قيمة لمَعلمة الطلب sort.
يسرد هذا التقرير أهم قوائم التشغيل الخاصة بمالك المحتوى استنادًا إلى معايير الفلترة والترتيب المحدّدة.
ملاحظة: تتطلّب تقارير أداء الإعلانات الحصول على رمز مميّز للإذن يمنح إذن الوصول إلى نطاق https://www.googleapis.com/auth/yt-analytics-monetary.readonly.
تقدّم تقارير أداء الإعلانات مقاييس مستندة إلى مرّات الظهور للإعلانات التي تم عرضها أثناء تشغيل الفيديوهات. وتُحتسَب هذه المقاييس لكلّ مرّة ظهور للإعلان، ويمكن أن تؤدّي كلّ مرّة تشغيل فيديو إلى مرّات ظهور متعدّدة.
في ما يلي مقاييس أداء الإعلانات المستندة إلى مرّات الظهور:
بالإضافة إلى ذلك، تتيح بعض تقارير الفيديو مقاييس أداء الإعلانات المستندة إلى التشغيل التالية. ومع ذلك، لا يتم تضمين هذه المقاييس في تقارير أداء الإعلانات.
تاريخ التعديل الأخير: 2024-11-15 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2024-11-15 (حسب التوقيت العالمي المتفَّق عليه)"],[[["Content Owner Reports provide YouTube content partners with detailed metrics on channels linked to their content owner accounts, covering user activity, ad performance, and estimated revenue."],["These reports are accessible through the `reports.query` method using OAuth 2.0 authorization, and data must be filtered by dimensions like `video`, `channel`, or specific combinations of `claimedStatus` and `uploaderType`."],["Video Reports offer a variety of data, including basic user activity, geographic breakdowns by country, province, and city, and time-based activity, all supporting a wide range of metrics like `views`, `likes`, and `estimatedRevenue`."],["Playlist Reports, while deprecating the `isCurated` dimension by the end of 2024, offer metrics for both aggregated video activity and in-playlist activity, with the `views` metric behavior changing based on the presence or absence of `isCurated`."],["Several reports require you to specify exactly one of `playlist` or `group` if certain view-related metrics are requested, and there are specific reports with their own requirements, like the Top Playlists report that can be sorted by `playlistViews`, `playlistEstimatedMinutesWatched`, or `playlistStarts` with a `maxResults` limit of 200."]]],["Content owner reports, accessible via the YouTube Partner Program, offer data on linked channels' user activity, ad performance, and revenue. Reports are retrievable using `reports.query` with OAuth 2.0 tokens. Filtering data by `video`, `channel`, `isCurated`, or combinations of `claimedStatus` and `uploaderType` is essential. Key metrics include views, estimated minutes watched, and ad-related data. Reports can segment data by time, geography, playback location, traffic source, device, and operating system, plus there is support for specific reports on playlist and Ad performance.\n"]]
