يمكنك الاطّلاع على إحصاءات عن صنّاع المحتوى في YouTube من خلال ميزة "إحصاءات صنّاع المحتوى". يمكن أن يكون ذلك مفيدًا للوكالات والمعلنين الذين يريدون العثور على صنّاع محتوى مناسبين لجمهورهم المستهدَف.
تتضمّن واجهة برمجة التطبيقات أربع وظائف رئيسية:
- إمكانية العثور على صنّاع المحتوى: يمكنك العثور على أبرز صنّاع المحتوى ضمن مجموعة معيّنة من المواضيع أو الخصائص الديمغرافية أو شرائح الجمهور أو سمات صنّاع المحتوى.
- إحصاءات العلامات التجارية لصنّاع المحتوى: يمكنك الحصول على إحصاءات عن صنّاع المحتوى المرتبطين بعلامة تجارية معيّنة.
- إحصاءات صنّاع المحتوى: يمكنك الحصول على إحصاءات عن قنوات معيّنة على YouTube، مثل عدد المشتركين فيها وعدد المشاهدات وخصائص جمهورها الديمغرافية.
- إحصاءات المؤشرات الرائجة: يمكنك الحصول على إحصاءات عن مؤشرات رائجة معيّنة استنادًا إلى شرائح جمهور أو مواضيع معيّنة.
متطلبات الأهلية
ContentCreatorInsightsService.GenerateCreatorInsights
هو مكوّن خاص لواجهة برمجة التطبيقات Google Ads API يتم تقديمه مع ترخيص data غير حصري وبدون عائدات. يمكن للشركاء الموقّعين استخدام مكتبات عملاء "إعلانات Google" العادية لاستكشاف صنّاع المحتوى على YouTube والمحتوى الذي ينشرونه. لكي يكون الشريك مؤهلاً، يجب أن يستوفي الشروط التالية:
- توفُّر أداة تخطيط أو واجهة مستخدم ستدمج واجهة برمجة التطبيقات
- استخدِم واجهة برمجة التطبيقات لاستكشاف محتوى YouTube وصنّاع المحتوى للاطّلاع على اقتراحات مثمرة لإعلاناتك.
- إكمال تقييم فحص ما قبل التقديم لضمان الأهلية
- اتّباع متطلبات استخدام البيانات والاستعداد للخضوع لعمليات تدقيق البيانات الدورية
- توقيع اتفاقية ترخيص بيانات تفرض بشكل قانوني متطلبات استخدام البيانات
- الموافقة على بنود خدمة Google Ads API
تواصَل مع ممثل عن Google للحصول على مزيد من المعلومات.
إنشاء إحصاءات صنّاع المحتوى
لإنشاء إحصاءات صنّاع المحتوى، أرسِل طلبًا إلى الأسلوب
ContentCreatorInsightsService.GenerateCreatorInsights
. يمكن إجراء 5 طلبات بحث في الثانية (QPS) كحد أقصى باستخدام هذه الطريقة، وهي تتعامل مع ثلاثة
أنواع من الإدخالات استنادًا إلى ما إذا كنت تريد معرفة مدى إمكانية العثور على قنوات صنّاع المحتوى أو إحصاءات علاماتهم التجارية أو إحصاءات صنّاع المحتوى. يجب تقديم المواقع الجغرافية للبلدان التي تريد الحصول على البيانات منها.
- إمكانية العثور على القنوات: يمكنك تقديم قائمة بسمات الجمهور، مثل العمر والجنس والاهتمامات. تعرض واجهة برمجة التطبيقات قائمة بصنّاع المحتوى الذين تتوافق قاعداتهم الجماهيرية مع هذه السمات. يمكنك أيضًا تقديم سمات صنّاع المحتوى لتحديد صنّاع المحتوى الذين يتطابق محتوى قناتهم مع سمات صنّاع المحتوى التي أدخلتها.
- إحصاءات العلامات التجارية لصنّاع المحتوى: أدخِل علامة تجارية للبحث عن أبرز صنّاع المحتوى. يعرض واجهة برمجة التطبيقات إحصاءات عن القنوات المطابقة.
- إحصاءات صنّاع المحتوى: قدِّم قائمة بمعرّفات قنوات YouTube. تعرض واجهة برمجة التطبيقات تحليلات عن هذه القنوات المحدّدة.
تُعرِض الطريقة generateCreatorInsights
عنصر GenerateCreatorInsightsResponse
. يحتوي هذا الكائن على قائمة بعناصر YouTubeCreatorInsights
. يحتوي كل عنصر
YouTubeCreatorInsights
على المعلومات التالية حول
صانع المحتوى:
- اسم صانع المحتوى
- قناة على YouTube
- إجمالي مقاييس صنّاع المحتوى
- قائمة بإحصاءات قنوات YouTube
يحتوي عنصر YouTubeMetrics
على المقاييس التالية:
- عدد المشتركين
- عدد مرّات المشاهدة
- عدد الفيديو
- أن يكون صانع فيديوهات Shorts نشطًا
يحتوي عنصر YouTubeChannelInsights
على المعلومات التالية حول قناة
على YouTube:
- اسم القناة
- معرّف القناة
- عنوان URL للقناة
- وصف القناة
- مقاييس القناة
- سمات جمهور القناة (مثل العمر والجنس وتفاصيل اهتمامات المستخدمين)
- أهم الفيديوهات
- نوع القناة
إنشاء إحصاءات حول المواضيع الرائجة
لإنشاء إحصاءات عن المؤشرات الرائجة، أرسِل طلبًا إلى الأسلوب
ContentCreatorInsightsService.GenerateTrendingInsights
. تبلغ الحدود القصوى لهذه الطريقة 5 طلبات بحث في الثانية (QPS)، وتستخدِم نوعين
من الإدخالات استنادًا إلى ما إذا كنت تريد الحصول على مؤشرات الجمهور أو مؤشرات المواضيع.
يجب تقديم الموقع الجغرافي المحدد للبلد الذي تريد الحصول على المؤشرات منه.
- مؤشرات الجمهور: يمكنك تقديم قائمة بسمات الجمهور، مثل العمر والجنس والاهتمامات. تعرض واجهة برمجة التطبيقات قائمة بالاطّلاعات المتعلّقة بالمحتوى الرائج لهذه شرائح الجمهور.
- مؤشرات المواضيع: قدِّم قائمة بمواضيع المحتوى. تعرض واجهة برمجة التطبيقات قائمة باطلاعات المواضيع الرائجة لهذه المواضيع.