يمكنك استكشاف إحصاءات حول صنّاع المحتوى في 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 نشطًا
- فرص الشراكة (بدءًا من الإصدار 23_2)
يحتوي الكائن YouTubeChannelInsights على المعلومات التالية حول قناة على YouTube:
- اسم القناة
- معرّف القناة
- عنوان URL للقناة
- وصف القناة
- مقاييس القناة
- سمات جمهور القناة (مثل العمر والجنس وتفاصيل اهتمامات المستخدمين)
- أهم الفيديوهات
- نوع القناة
- اللغات المرتبطة بمحتوى القناة
- نتيجة الصلة بالموضوع (لعمليات البحث عن مؤشرات المواضيع فقط)
إنشاء إحصاءات حول المواضيع الرائجة
لإنشاء إحصاءات حول المحتوى الرائج، أرسِل طلبًا إلى طريقة
ContentCreatorInsightsService.GenerateTrendingInsights. تفرض هذه الطريقة حدًا أقصى يبلغ 5 طلبات بحث في الثانية، وتتلقّى نوعَين من الإدخالات حسب ما إذا كنت تريد الحصول على مؤشرات الجمهور أو مؤشرات المواضيع.
يجب تقديم الموقع الجغرافي للبلد المحدّد الذي تريد الحصول على المؤشرات منه.
- مؤشرات الجمهور: يمكنك تقديم قائمة بسمات الجمهور، مثل العمر والجنس والاهتمامات (بما في ذلك الجمهور ذو الاهتمامات المشتركة والجمهور في السوق وجمهور الأحداث في الحياة). تعرض واجهة برمجة التطبيقات قائمة بالإحصاءات الرائجة لشرائح الجمهور هذه، بما في ذلك مقاييس مثل النسبة المئوية للتغيّر في قيمة المؤشر خلال فترة المقارنة.
- مواضيع رائجة: تقدّم هذه السمة قائمة بمواضيع المحتوى. تعرض واجهة برمجة التطبيقات قائمة بالإحصاءات الرائجة حول هذه المواضيع، بما في ذلك مقاييس مثل النسبة المئوية للتغيّر في قيمة المؤشر خلال فترة المقارنة.