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