ملاحظة: "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 API نطاقات التفويض التالية:
الاطّلاع على تقارير "إحصاءات YouTube" للمحتوى الخاص بك في YouTube يوفّر هذا النطاق إمكانية الوصول إلى مقاييس نشاط المستخدم، مثل عدد المشاهدات وأعداد التقييمات.
عرض تقارير "إحصاءات 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,liveOrOnDemand
dimensions=month,subscribedStatus,youtubeProduct
dimensions=month,youtubeProduct
مع ذلك، فإنّ قيمة المَعلمة day,month غير صالحة لأنّها تستخدِم سمتَين يستندتَين إلى الوقت،
ولكن يمكن أن يستخدم الطلب 0 أو 1. في هذه الحالة، تعرض قيمة المعلَمة
subscribedStatus,youtubeProduct تقريرًا، ولكن لا يتم
تجميع المقاييس حسب اليوم أو الأسبوع أو الشهر أو غير ذلك (يتم توثيق هذا التقرير بشكل منفصل في المستندات).
مصطلحات جدول التقارير
تستخدم الجداول المصطلحات التالية لتوضيح ما إذا كانت السمات مطلوبة أو اختيارية:
تشير هذه المصطلحات إلى أنّ القيمة مطلوبة:
مطلوب: يجب تضمين القيمة.
استخدِم القيمة 1 بالضبط: عليك تضمين قيمة واحدة من المجموعة.
استخدام 1 أو أكثر: يمكنك تضمين أي من القيم أو جميعها من المجموعة، ولكن يجب تضمين قيمة واحدة على الأقل.
وتعني هذه المصطلحات أنّ القيمة اختيارية:
اختياري: يتوفّر لك خيار تضمين القيمة.
استخدام 0 أو 1: يتوفّر لك خيار تضمين قيمة واحدة من المجموعة.
استخدام 0 أو أكثر: يمكنك تضمين أيٍّ من القيم من المجموعة أو جميعها.
ملاحظة مهمة: يجب أن تتم فلترة البيانات في جميع طلبات البيانات من واجهة برمجة التطبيقات لاسترداد تقارير الفيديوهات الخاصة بمالك المحتوى باستخدام سمة الفيديو أو سمة القناة أو سمة المجموعة أو مجموعة متوافقة من السمتَين claimedStatus وuploaderType. (بعض التقارير لا تتيح كل هذه الخيارات). في ما يلي التركيبات المتوافقة والتي يتم إدراجها أيضًا في تعريف السمة uploaderType:
uploaderType==self
claimedStatus==claimed
claimedStatus==claimed;uploaderType==self
claimedStatus==claimed;uploaderType==thirdParty
تقارير الفيديوهات
الإحصاءات الأساسية
إحصاءات أساسية (بما في ذلك أعداد المشتركين)
يقدم هذا التقرير إحصاءات متعلقة بإجراءات المستخدمين على كل قنوات مالك المحتوى. يمكنك فلترة التقرير بحيث يعرض البيانات الخاصة بفيديو معيّن أو بلد معيّن فقط. ويمكن أيضًا استخدام هذه البيانات لاسترداد إحصاءات المحتوى المُطالَب بملكيته فقط، بما في ذلك المحتوى المُطالَب بملكيته والذي حمّله مالك المحتوى أو جهات خارجية أو كليهما.
يقدم هذا التقرير إحصاءات لإحدى الولايات الأمريكية أو مقاطعة كولومبيا. تجدر الإشارة إلى أنّ هذا التقرير يتيح فقط مجموعة فرعية من المقاييس المتوفرة في التقرير الخاص بالبلد والموضّح أعلاه.
يقدم هذا التقرير إحصاءات مرتبطة بإجراءات المستخدم على كل قنوات مالك المحتوى لفترات زمنية محددة. يمكنك فلترة التقرير بحيث يعرض البيانات الخاصة بفيديو معيّن أو بلد معيّن فقط.
نشاط المستخدم في الولايات الأمريكية لفترات زمنية محدّدة
يقدم هذا التقرير إحصاءات لإحدى الولايات الأمريكية أو مقاطعة كولومبيا. تجدر الإشارة إلى أنّ هذا التقرير يتيح فقط مجموعة فرعية من المقاييس المتوفرة في التقرير الخاص بالبلد والموضّح أعلاه.
يقدّم هذا التقرير إحصاءات ذات صلة بنشاط المستخدم على أساس كل بلد على حدة لجميع قنوات مالكي المحتوى. يمكنك فلترة التقرير لعرض بيانات حول فيديو معيّن أو قناة معيّنة فقط.
ملاحظة: يتطلب منك هذا التقرير ضبط المعلمة maxResults على قيمة عدد صحيح تبلغ 250 أو أقل. على عكس معظم التقارير الأخرى، يتطلب منك هذا التقرير أيضًا تحديد قيمة لمَعلمة طلب sort.
يقدم هذا التقرير إحصاءات نشاط المستخدم حسب المدينة.
تقدّم تقارير التشغيل التفصيلية إحصاءات تتعلّق بسمات العرض التالية:
هل تمت مشاهدة بث فيديو مباشر أم فيديو مسجّل؟
هل كان المشاهد مشتركًا في القناة التي تملك الفيديو؟
على أي منتج من منتجات YouTube تمت المشاهدة؟
من الناحية الفنية، تكون جميع أبعاد تفاصيل التشغيل التي تتيحها هذه التقارير اختيارية. في حال عدم تضمين سمات تفاصيل التشغيل في طلبك، سيكون التقرير المعروض مشابهًا لأحد تقارير الإحصاءات الأساسية أو تقارير المستندة إلى الوقت أو تقارير الموقع الجغرافي للمستخدم.
يوفّر هذا التقرير مقاييس نشاط المستخدم للمشاهدين المشتركين وغير المشتركين في القناة. يمكن تجميع الإحصاءات حسب الفترة الزمنية (اليوم أو الشهر)، ويمكن أيضًا فلترة التقرير حسب البلد أو القارة أو subContinent.
يوفّر هذا التقرير مقاييس نشاط المستخدم للمشاهدين المشتركين وغير المشتركين في الولايات الأمريكية أو مقاطعة كولومبيا. يعرض هذا التقرير مقاييس أقل من التقرير السابق.
تُعدّ سمة الوقت، وهي اليوم أو الشهر، اختيارية لهذه التقارير، لأنّه عليك استخدام مَعلمتَي الطلب startDate وendDate لتحديد النطاق الزمني الذي سيغطّيه التقرير. تشير السمة، إن توفّرت، إلى أنّك تريد تجميع البيانات في التقرير حسب اليوم أو الشهر أو غير ذلك.
تفاصيل التشغيل مع سمة زمنية اختيارية وإحصاءات liveOrOnDemand
يقدّم هذا التقرير إحصاءات مفصّلة للتشغيل لفترات زمنية محدّدة. تتيح هذه الصفحة استخدام السمة liveOrOnDemand (والفلتر).
ملاحظة: يتطلب منك هذا التقرير ضبط المعلمة maxResults على قيمة عدد صحيح تبلغ 25 أو أقل. على عكس معظم التقارير الأخرى، يتطلب منك هذا التقرير أيضًا تحديد قيمة لمَعلمة طلب sort.
يحدّد هذا التقرير مشغّلات الفيديو المضمّنة التي أدّت إلى أكبر عدد من المشاهدات أو وقت المشاهدة لمحتوى مالك المحتوى. عند استرداد هذا التقرير، يجب ضبط الفلتر insightPlaybackLocationType على EMBEDDED.
يجمع هذا التقرير إحصاءات المشاهدة استنادًا إلى الطريقة التي وصل بها المشاهدون إلى محتوى الفيديو الخاص بك. على سبيل المثال، يحدّد عدد المشاهدات الناتجة من بحث على Google أو من رابط يؤدي إلى فيديو ذي صلة.
ملاحظة: يتطلب منك هذا التقرير ضبط المعلمة maxResults على قيمة عدد صحيح تبلغ 25 أو أقل. على عكس معظم التقارير الأخرى، يتطلب منك هذا التقرير أيضًا تحديد قيمة لمَعلمة طلب sort.
يجمّع هذا التقرير إحصاءات المشاهدة استنادًا إلى المُحيلين الذين حقّقوا أكبر عدد من المشاهدات لمحتوى مالك المحتوى. ويتم تصنيف المُحيلين حسب نوع مصدر الزيارات، في حين يُحدِّد تعريف السمة insightTrafficSourceDetail مصادر الزيارات التي يتوفّر لها التقرير. على سبيل المثال، في حال ضبط فلتر insightTrafficSourceType على ADVERTISING، سيعرِض التقرير أنواع الإعلانات التي أدّت إلى أكبر عدد من المشاهدات أو وقت المشاهدة للمحتوى الخاص بمالك المحتوى.
ملاحظة: لا يتوفّر هذا التقرير إلّا لمصادر زيارات محدَّدة. على سبيل المثال، لا يحتوي مصدر الزيارات NO_LINK_EMBEDDED على تفاصيل إضافية، وبالتالي لا يتيح استخدام هذا التقرير. يُرجى الاطّلاع على تعريف insightTrafficSourceType لمعرفة تفاصيل عن مصادر الزيارات التي تتوافق مع هذا التقرير.
نوع الجهاز ونظام التشغيل
نوع الجهاز
يجمّع هذا التقرير إحصاءات المشاهدة استنادًا إلى نوع الجهاز الذي استخدمه المشاهدون عند مشاهدة المحتوى الخاص بك. على سبيل المثال، يتم تحديد عدد مرات المشاهدة على الأجهزة اللوحية أو وحدات تحكم الألعاب.
يجمّع هذا التقرير إحصاءات المشاهدة استنادًا إلى أنظمة التشغيل وأنواع الأجهزة التي يستخدمها المشاهدون. على سبيل المثال، يحدد هذا المقياس عدد مرات المشاهدة التي حدثت على أجهزة Android اللوحية أو أجهزة سطح المكتب التي تعمل بنظام Windows.
يقيس هذا التقرير قدرة الفيديو على الاحتفاظ بجمهوره. تقيس السمة elapsedVideoTimeRatio المدة المنقضية من الفيديو بالنسبة إلى قيم المقياس المقابلة. يوفّر المقياسان audienceWatchRatio وrelativeRetentionPerformance قياسَين يوضّحان مدى احتفاظ الفيديو بالجمهور. تمثّل القيمة الأولى قيمة مطلقة، بينما تعرض الثانية مستوى أداء الفيديو مقارنةً بالفيديوهات الأخرى ذات المدة المشابهة على YouTube.
ملاحظة: لا تتيح تقارير الاحتفاظ بالجمهور إمكانية تحديد قائمة قيم مفصولة بفواصل لفلتر video. يجب أن تحدّد القيمة معرّف فيديو واحدًا.
ملاحظة: تتطلب منك هذه التقارير ضبط المعلمة maxResults على قيمة عدد صحيح تبلغ 200 أو أقل. تتوفّر بيانات أبرز 10 فيديوهات فقط قبل 1 كانون الثاني (يناير) 2013. وعلى عكس معظم التقارير الأخرى، تتطلّب منك هذه التقارير أيضًا تحديد قيمة لمَعلمة طلب sort.
الفيديوهات الأفضل أداءً بشكل عام، حسب البلد أو حسب القارة أو شبه القارة (<= 200 نتيجة)
يعرض هذا التقرير الفيديوهات الأفضل أداءً لمالك المحتوى استنادًا إلى معايير الفلترة والترتيب المحدّدة.
الفيديوهات الأفضل أداءً بشكل عام حسب الولاية في الولايات المتحدة (<= 200 نتيجة)
يعرض هذا التقرير الفيديوهات الأفضل أداءً لمالك المحتوى في ولاية أمريكية معيَّنة أو مقاطعة كولومبيا. تجدر الإشارة إلى أنّ هذا التقرير يتيح فقط مجموعة فرعية من المقاييس المتوفرة في التقرير الخاص بالبلد والموضّح أعلاه.
أبرز الفيديوهات للمشاهدين المشتركين أو غير المشتركين(<= 200 نتيجة)
يعرض هذا التقرير الفيديوهات الأفضل أداءً للمشاهدين المشتركين وغير المشتركين في القناة. يمكن فلترة التقرير لعرض أبرز الفيديوهات حسب البلد أو القارة أو subContinent. يتيح لك التقرير السابق الاطّلاع على أبرز الفيديوهات في ولاية أمريكية معيّنة للمشاهدين المشتركين أو غير المشتركين في قناتك، ولكنّه يوفّر مقاييس أقل من تلك الواردة في هذا التقرير.
الفيديوهات الأفضل أداءً حسب منتج YouTube (<= 200 نتيجة)
يعرض هذا التقرير أبرز الفيديوهات ويتضمّن تفاصيل التشغيل والفلاتر الجغرافية. هذا التقرير مشابه للتقرير السابق، ولكنّه يتيح استخدام مقاييس أقلّ ويضيف إمكانية استخدام فلتر youtubeProduct.
أهم الفيديوهات التي تم فيها تطبيق فلاتر لتفاصيل التشغيل (<= 200 نتيجة)
يسرد هذا التقرير الفيديوهات الأفضل أداءً لمالك المحتوى، مع فلترتها حسب سمة واحدة أو أكثر من تفاصيل التشغيل: liveOrOnDemand وsubscribedStatus وyoutubeProduct. يتيح التقرير أيضًا الفلترة حسب المنطقة.
تحتوي تقارير قوائم التشغيل على مقاييس مرتبطة بنشاط المستخدم ذي الصلة بالفيديوهات في قوائم التشغيل
الخاصة بمالك القناة. يتوفّر إصداران من هذه التقارير، وتحتوي الأقسام التالية على وصف لكل نسخة لكل تقرير متاح:
تصف علامة التبويب مقترَحة في كل قسم التنسيق المفضّل لطلب البيانات من واجهة برمجة التطبيقات
لاسترداد التقرير ذي الصلة. تتيح التقارير المقترَحة استخدام مجموعة موسّعة من المقاييس التي تتضمّن مقاييس الفيديوهات المجمّعة والمقاييس المضمّنة في قائمة التشغيل. ولا يستخدم تنسيق الطلب هذا السمة isCurated.
تصف علامة التبويب استخدام isCurated في كل قسم تنسيقًا قديمًا لطلب البيانات من واجهة برمجة التطبيقات يجب استخدام السمة isCurated. تتيح هذه التقارير استخدام
المقاييس المضمّنة في قائمة التشغيل فقط. يُرجى العلم أنّه تم إيقاف السمة
isCurated نهائيًا في جميع التقارير. وتوضّح ملاحظة التحذير أدناه الجدول الزمني للإيقاف النهائي.
توضِّح الملاحظة التحذيرية التالية التغييرات بين النسختَين من التقرير بمزيد من التفصيل.
مقاييس الفيديو المجمَّعة
تعرض هذه المقاييس مقاييس نشاط المستخدم ومرات الظهور المجمّعة لكل الفيديوهات المضمّنة في قائمة التشغيل والمملوكة أيضًا للقناة التي تملكها. ولا يتم احتساب مقاييس الفيديوهات
التي تملكها قنوات أخرى عند التجميع. نتيجةً لذلك، إذا أنشأت قناة
قائمة تشغيل تتضمّن فقط فيديوهات تملكها قنوات أخرى، لن تقدّم التقارير حول قوائم التشغيل هذه
قيمًا لهذه المقاييس.
وتعكس هذه المقاييس نشاط المستخدم وتفاعله في سياق صفحة قائمة التشغيل. وتشمل هذه
المقاييس عدد مشاهدات كل الفيديوهات في قائمة التشغيل بغض النظر عن القناة التي تملكها، ولكنّها
تُحتسب فقط عدد المشاهدات التي حدثت في سياق قائمة التشغيل.
يقدّم هذا التقرير إحصاءات مرتبطة بتفاعلات المستخدمين مع الفيديوهات في قوائم التشغيل
لقنوات مالك المحتوى خلال فترات زمنية محدّدة. يمكنك فلترة التقرير لعرض
بيانات لقائمة تشغيل أو قناة معيّنة فقط.
يقدّم هذا التقرير إحصاءات حول نشاط قوائم التشغيل في الولايات الأمريكية ومقاطعة كولومبيا. بالنسبة إلى هذا التقرير، عليك تضمين country==US في قيمة المَعلمة filters.
ملاحظة: يتطلب منك هذا التقرير ضبط المعلمة maxResults على قيمة عدد صحيح تبلغ 25 أو أقل. على عكس معظم التقارير الأخرى، يتطلب منك هذا التقرير أيضًا تحديد قيمة لمَعلمة طلب sort.
يحدّد هذا التقرير مشغّلات الفيديو المضمّنة التي أدّت إلى أكبر عدد من المشاهدات أو وقت المشاهدة لقوائم التشغيل التابعة لمالك المحتوى.
يعرض هذا التقرير إحصاءات المشاهدة استنادًا إلى الطريقة التي وصل بها المشاهدون إلى محتوى قائمة التشغيل. على سبيل المثال، يحدّد عدد المشاهدات الصادرة عن بحث Google أو صفحة قناة.
ملاحظة: يتطلب منك هذا التقرير ضبط المعلمة maxResults على قيمة عدد صحيح تبلغ 25 أو أقل. على عكس معظم التقارير الأخرى، يتطلب منك هذا التقرير أيضًا تحديد قيمة لمَعلمة طلب sort.
يجمّع هذا التقرير إحصاءات المشاهدة استنادًا إلى المُحيلين الذين حقّقوا أكبر عدد من المشاهدات لقوائم التشغيل التابعة لمالك المحتوى. ويتم تصنيف المُحيلين حسب نوع مصدر الزيارات، في حين يُحدِّد تعريف السمة insightTrafficSourceDetail مصادر الزيارات التي يتوفّر لها التقرير. على سبيل المثال، في حال ضبط الفلتر insightTrafficSourceType على ADVERTISING، سيسرد التقرير أنواع الإعلانات التي أدّت إلى أكبر عدد من المشاهدات أو وقت المشاهدة لقوائم التشغيل التي يملكها مالك المحتوى.
ملاحظة: لا يتوفّر هذا التقرير إلّا لمصادر زيارات محدَّدة. على سبيل المثال، لا يحتوي مصدر الزيارات NO_LINK_EMBEDDED على تفاصيل إضافية، وبالتالي لا يتيح استخدام هذا التقرير. يُرجى الاطّلاع على تعريف insightTrafficSourceType لمعرفة تفاصيل عن مصادر الزيارات التي تتوافق مع هذا التقرير.
نوع الجهاز ونظام التشغيل
نوع الجهاز لقوائم التشغيل
يجمّع هذا التقرير إحصاءات المشاهدة استنادًا إلى نوع الجهاز الذي استخدمه المشاهدون لمشاهدة محتوى قائمة التشغيل. على سبيل المثال، يحدِّد عدد المشاهدات على الأجهزة الجوّالة أو وحدات تحكّم الألعاب.
يجمع هذا التقرير إحصاءات المشاهدة استنادًا إلى أنظمة تشغيل المشاهدين. على سبيل المثال، يمكنه تحديد عدد مشاهدات قائمة التشغيل على أجهزة Android أو PlayStation.
يجمّع هذا التقرير إحصاءات المشاهدة استنادًا إلى أنظمة التشغيل وأنواع الأجهزة التي يستخدمها المشاهدون. على سبيل المثال، يحدد هذا العمود عدد مشاهدات قائمة التشغيل على أجهزة Android اللوحية أو أجهزة كمبيوتر Windows المكتبية.
على سبيل المثال، يعرض تقرير يستخدم السمة subscribedStatus بيانات viewerPercentage مع إضافة ما يصل إلى 100 في المئة لبيانات المشاهدات المشتركين والنسبة المئوية لمشاهدات نسبة مشاهدين غير مشتركين.viewerPercentage (تبلغ القيمة الإجمالية لجميع حقول viewerPercentage في التقرير 200 في المئة.)
يمكنك استخدام الفلاتر للتأكد من أنّ التقرير لا يحتوي إلا على بيانات viewerPercentage لقيمة واحدة (أو مجموعة من القيم) لأبعاد تفاصيل التشغيل.
أهم قوائم التشغيل
ملاحظة: تتطلب منك هذه التقارير ضبط المعلمة maxResults على قيمة عدد صحيح تبلغ 200 أو أقل. تتوفّر بيانات أهم 10 قوائم تشغيل فقط قبل 1 كانون الثاني (يناير) 2013. وعلى عكس معظم التقارير الأخرى، تتطلّب منك هذه التقارير أيضًا تحديد قيمة لمَعلمة طلب sort.
يعرض هذا التقرير أهم قوائم التشغيل لدى مالك المحتوى استنادًا إلى معايير الفلترة والترتيب المحدّدة.
ملاحظة: تتطلب تقارير أداء الإعلان رمزًا مميزًا للتفويض يمنح إمكانية الوصول إلى نطاق https://www.googleapis.com/auth/yt-analytics-monetary.readonly.
تقدّم تقارير أداء الإعلانات مقاييس مستندة إلى مرات الظهور للإعلانات التي تم عرضها أثناء تشغيل الفيديوهات. تأخذ هذه المقاييس في الحسبان كل مرة ظهور للإعلان، ويمكن أن تؤدي كل عملية تشغيل لفيديو إلى مرات ظهور متعددة.
في ما يلي مقاييس أداء الإعلانات المستندة إلى مرات الظهور:
بالإضافة إلى ذلك، تتيح بعض تقارير الفيديوهات مقاييس أداء الإعلانات التالية المستندة إلى التشغيل. ومع ذلك، لا يتم تضمين هذه المقاييس في تقارير أداء الإعلانات.
