يمكنك استكشاف إحصاءات حول صنّاع المحتوى في YouTube والحصول عليها باستخدام ميزة "إحصاءات صنّاع المحتوى". يمكن أن يكون ذلك مفيدًا للوكالات والمعلنين الذين يريدون العثور على صنّاع محتوى مناسبين لجمهورهم المستهدف.
تتضمّن واجهة برمجة التطبيقات أربع وظائف رئيسية:
- إمكانية العثور على صنّاع المحتوى: يمكنك العثور على أبرز صنّاع المحتوى لمجموعة معيّنة من المواضيع أو الخصائص الديمغرافية أو شرائح الجمهور أو سمات صنّاع المحتوى.
- إحصاءات العلامة التجارية الخاصة بصنّاع المحتوى: يمكنك الحصول على إحصاءات حول صنّاع المحتوى المرتبطين بعلامة تجارية معيّنة.
- إحصاءات صنّاع المحتوى: يمكنك الحصول على إحصاءات حول قنوات معيّنة على YouTube، مثل عدد المشتركين وعدد المشاهدات والتركيبة السكانية للجمهور.
- إحصاءات حول المؤشرات الرائجة: يمكنك الحصول على إحصاءات حول مؤشرات معيّنة رائجة استنادًا إلى شرائح جمهور أو مواضيع محدّدة.
متطلبات الأهلية
ContentCreatorInsightsService.GenerateCreatorInsights هي مكوّن خاص من Google Ads API يتم تقديمه مع ترخيص بيانات غير حصري وغير خاضع لحقوق الملكية. يمكن للشركاء الذين وقّعوا اتفاقية استخدام
مكتبات برامج "إعلانات Google" للعملاء لاستكشاف صنّاع المحتوى والمحتوى على YouTube.
ليكون الشركاء مؤهّلين، يجب أن يستوفوا الشروط التالية:
- أن يكون لديك أداة تخطيط أو واجهة مستخدم ستدمج Google Ads API.
- استخدِم واجهة برمجة التطبيقات لاستكشاف المحتوى وصنّاع المحتوى على YouTube بحثًا عن فرص إعلانية محتملة.
- أكمِل تقييمًا مسبقًا للتأكّد من أهليتك.
- الالتزام بمتطلبات استخدام البيانات والاستعداد للخضوع لعمليات تدقيق دورية للبيانات
- توقيع اتفاقية ترخيص بيانات تفرض قانونيًا متطلبات استخدام البيانات
- يجب الموافقة على بنود خدمة Google Ads API.
يُرجى التواصل مع ممثل عن Google لمزيد من المعلومات.
إنشاء إحصاءات صنّاع المحتوى
لإنشاء إحصاءات لصنّاع المحتوى، أرسِل طلبًا إلى طريقة
ContentCreatorInsightsService.GenerateCreatorInsights. تتيح هذه الطريقة إجراء 5 طلبات بحث في الثانية كحدّ أقصى، وتتلقّى ثلاثة أنواع من الإدخالات استنادًا إلى ما إذا كنت تريد تسهيل عثور المستخدمين على صنّاع المحتوى أو الحصول على إحصاءات حول العلامات التجارية الخاصة بصنّاع المحتوى أو الحصول على إحصاءات حول صنّاع المحتوى. يجب تقديم المواقع الجغرافية للبلدان التي تريد الحصول على البيانات منها.
إمكانية عثور الجمهور على صنّاع المحتوى: يمكنك تقديم قائمة بسمات الجمهور، مثل العمر والجنس واهتمامات المستخدمين (بما في ذلك الجمهور ذو الاهتمامات المشتركة والجمهور الذي ينوي الشراء والجمهور من الأحداث في الحياة). تعرض واجهة برمجة التطبيقات قائمة بصنّاع المحتوى الذين تتطابق شرائح جمهورهم مع هذه السمات. يمكنك أيضًا تقديم سمات لصنّاع المحتوى لتصفية النتائج حسب صنّاع المحتوى الذين يتطابق محتواهم تحديدًا مع السمات التي أدخلتها.
يمكنك استرداد سمات الجمهور المتاحة باستخدام
AudienceInsightsService.ListAudienceInsightsAttributes، من خلال تقديم السمات التي تريدها، مثلKNOWLEDGE_GRAPHلمواضيع الاهتمام.اعتبارًا من الإصدار 23 من Google Ads API، يمكنك تحديد علاقات معقّدة بين سمات الجمهور باستخدام
audience_combinations. يتيح لك هذا الحقل تحديد شرائح الجمهور باستخدام منطق Boolean (و/أو) لا يمكن تطبيقه باستخدامaudience_attributes.في حين أنّ
audience_attributesمناسبة للاستهداف استنادًا إلى قائمة بالسمات الموحّدة (المدمجة مع OR) (مثل المستخدمين المهتمين بـ "الرياضة" أو "السفر" أو ...)، تتيحaudience_combinationsتحكّمًا أكثر دقة. يجمع كلInsightsAudienceAttributeGroupضمنaudience_combinationsبين السمات باستخدام عامل التشغيل المنطقي OR، ثم يتم دمج هذه المجموعات باستخدام عامل التشغيل المنطقي AND.على سبيل المثال، لاستهداف شريحة جمهور مهتمة بـ ("العناية بالبشرة" أو "العناية بالشعر") و "مستحضرات التجميل" أيضًا، عليك استخدام عنصرَين
InsightsAudienceAttributeGroupفيaudience_combinations. "العناية بالبشرة" و"العناية بالشعر" و"مستحضرات التجميل" هي مواضيع تهمّ المستخدمين، وهي ممثّلة بكيانات في "الرسم البياني المعرفي" (على سبيل المثال،/m/014trlلمستحضرات التجميل). ستحتوي المجموعة الأولى على سمات الجهات في "الرسم البياني المعرفي" الخاصة بـ "العناية بالبشرة" و"العناية بالشعر"، وستحتوي المجموعة الثانية على سمة الجهة في "الرسم البياني المعرفي" الخاصة بـ "مستحضرات التجميل".يُرجى العِلم أنّه في حال تحديد كيانات "الرسم البياني المعرفي" أو فئات المنتجات والخدمات أو اهتمامات المستخدمين في
audience_attributes، لا يمكنك استخدامaudience_combinations. في حال استخدامaudience_combinations، يجب تحديد هذه السمات ضمنaudience_combinationsوليس فيaudience_attributes، ولكن سيظلّ بإمكانك استخدامaudience_attributesلأنواع السمات الأخرى، مثل السمات الديمغرافية، بالتزامن معaudience_combinations.إحصاءات العلامة التجارية لصنّاع المحتوى: قدِّم علامة تجارية للبحث عن أبرز صنّاع المحتوى. تعرض واجهة برمجة التطبيقات إحصاءات حول القنوات المطابقة.
إحصاءات صنّاع المحتوى: قدِّم قائمة بمعرّفات قنوات على YouTube. تعرض واجهة برمجة التطبيقات إحصاءات حول هذه القنوات المحدّدة.
يعرض الإجراء generateCreatorInsights عنصر GenerateCreatorInsightsResponse. يحتوي هذا العنصر على قائمة تضمّ YouTubeCreatorInsights عنصرًا. يحتوي كل عنصر
YouTubeCreatorInsights على المعلومات التالية حول صانع محتوى:
- اسم صانع المحتوى
- قناة على YouTube
- مقاييس صنّاع المحتوى الإجمالية
- قائمة بإحصاءات قنوات على YouTube
يحتوي عنصر YouTubeMetrics على المقاييس التالية:
- عدد المشتركين
- عدد المشاهدات
- عدد الفيديو
- أن يكون صانع فيديوهات Shorts نشطًا
- فرص الشراكة (بدءًا من الإصدار 23)
لمعرفة ما إذا كان صانع المحتوى مؤهلاً لعقد شراكات بشأن المحتوى الأصلي المرتبط بعلامة تجارية،
تحقّق من
partnership_opportunities؛
يكون صانع المحتوى مؤهلاً إذا كانت القائمة تتضمّن القيمة CREATOR_PARTNERSHIPS.
يحتوي الكائن YouTubeChannelInsights على المعلومات التالية حول قناة على YouTube:
- اسم القناة
- معرّف القناة
- عنوان URL للقناة
- وصف القناة
- مقاييس القناة
سمات جمهور القناة (مثل العمر والجنس واهتمامات المستخدم)
تقسيم)
الفيديوهات الأفضل أداءً
نوع القناة
اللغات المرتبطة بمحتوى القناة
نتيجة الملاءمة (لعمليات البحث عن مؤشرات المواضيع فقط)
إنشاء إحصاءات حول المواضيع الرائجة
لإنشاء إحصاءات حول المؤشرات الرائجة، أرسِل طلبًا إلى طريقة
ContentCreatorInsightsService.GenerateTrendingInsights. تفرض هذه الطريقة حدًا أقصى يبلغ 5 طلبات بحث في الثانية، وتتلقّى نوعَين من الإدخالات استنادًا إلى ما إذا كنت تريد الحصول على مؤشرات الجمهور أو مؤشرات المواضيع.
يجب تقديم الموقع الجغرافي للبلد المحدّد الذي تريد الحصول على المؤشرات منه.
مؤشرات الجمهور: يمكنك تقديم قائمة بسمات الجمهور، مثل العمر والجنس واهتمامات المستخدمين (بما في ذلك شرائح الجمهور ذو الاهتمامات المشتركة وشرائح الجمهور الذي ينوي الشراء وشرائح جمهور الأحداث في الحياة). تعرض واجهة برمجة التطبيقات قائمة بالإحصاءات الرائجة لشرائح الجمهور هذه، بما في ذلك مقاييس مثل النسبة المئوية للتغيّر في قيمة المؤشر الرائج خلال فترة المقارنة.
يمكنك استرداد سمات الجمهور المتاحة باستخدام
AudienceInsightsService.ListAudienceInsightsAttributes، من خلال تقديم السمات التي تريدها، مثلKNOWLEDGE_GRAPHلمواضيع الاهتمام.اعتبارًا من الإصدار 23 من Google Ads API، يمكنك تحديد علاقات معقّدة بين سمات الجمهور باستخدام
audience_combinations. يتيح لك هذا الحقل تحديد شرائح الجمهور باستخدام منطق Boolean (و/أو) لا يمكن تطبيقه باستخدامaudience_attributes.في حين أنّ
audience_attributesمناسبة للاستهداف استنادًا إلى قائمة بالسمات الموحّدة (المدمجة مع OR) (مثل المستخدمين المهتمين بـ "الرياضة" أو "السفر" أو ...)، تتيحaudience_combinationsتحكّمًا أكثر دقة. يجمع كلInsightsAudienceAttributeGroupضمنaudience_combinationsبين السمات باستخدام عامل التشغيل المنطقي OR، ثم يتم دمج هذه المجموعات باستخدام عامل التشغيل المنطقي AND.على سبيل المثال، لاستهداف شريحة جمهور مهتمة بـ ("العناية بالبشرة" أو "العناية بالشعر") و "مستحضرات التجميل" أيضًا، عليك استخدام عنصرَين
InsightsAudienceAttributeGroupفيaudience_combinations. "العناية بالبشرة" و"العناية بالشعر" و"مستحضرات التجميل" هي مواضيع تهمّ المستخدمين، وهي ممثّلة بكيانات في "الرسم البياني المعرفي" (على سبيل المثال،/m/014trlلمستحضرات التجميل). ستحتوي المجموعة الأولى على سمات الجهات في "الرسم البياني المعرفي" الخاصة بـ "العناية بالبشرة" و"العناية بالشعر"، وستحتوي المجموعة الثانية على سمة الجهة في "الرسم البياني المعرفي" الخاصة بـ "مستحضرات التجميل".يُرجى العِلم أنّه في حال تحديد كيانات "الرسم البياني المعرفي" أو فئات المنتجات والخدمات أو اهتمامات المستخدمين في
audience_attributes، لا يمكنك استخدامaudience_combinations. في حال استخدامaudience_combinations، يجب تحديد هذه السمات ضمنaudience_combinationsوليس فيaudience_attributes، ولكن سيظلّ بإمكانك استخدامaudience_attributesلأنواع السمات الأخرى، مثل السمات الديمغرافية، بالتزامن معaudience_combinations.مؤشرات المواضيع: تقدّم هذه السمة قائمة بمواضيع المحتوى. تعرض واجهة برمجة التطبيقات قائمة بالإحصاءات الرائجة حول هذه المواضيع، بما في ذلك مقاييس مثل النسبة المئوية للتغيّر في قيمة المؤشر خلال فترة المقارنة.