يمكنك اكتشاف الإحصاءات عن صنّاع المحتوى في YouTube واستردادها باستخدام ميزة "إحصاءات صنّاع المحتوى". قد يكون ذلك مفيدًا للوكالات والمُعلِنين الذين يريدون العثور على صنّاع محتوى ذوي صلة بجمهورهم المستهدَف.
تتضمّن واجهة برمجة التطبيقات أربع وظائف رئيسية:
- إمكانية اكتشاف صنّاع المحتوى: يمكنك العثور على أبرز صنّاع المحتوى لمجموعة معيّنة من المواضيع أو الخصائص الديمغرافية أو شرائح الجمهور أو سمات صنّاع المحتوى.
- إحصاءات العلامات التجارية لصنّاع المحتوى: يمكنك استرداد إحصاءات عن صنّاع المحتوى ذات صلة بعلامة تجارية معيّنة.
- إحصاءات صنّاع المحتوى: يمكنك استرداد إحصاءات عن قنوات معيّنة على YouTube، مثل عدد المشتركين وعدد المشاهدات والخصائص الديمغرافية للجمهور.
- الإحصاءات الرائجة: يمكنك استرداد إحصاءات عن مؤشرات معيّنة، استنادًا إلى شرائح جمهور أو مواضيع معيّنة.
متطلبات الأهلية
ContentCreatorInsightsService.GenerateCreatorInsights
هو مكوّن خاص من Google Ads API يتم تقديمه بترخيص بيانات غير حصري وغير خاضع لحقوق الملكية. يمكن للشركاء الذين وقّعوا على الاتفاقية استخدام مكتبات العملاء العادية في
"إعلانات Google" لاستكشاف صنّاع المحتوى والمحتوى على YouTube.
للتأهّل، يجب أن يستوفي الشركاء الشروط التالية:
- أن يكون لديهم أداة تخطيط أو واجهة مستخدم ستدمج Google Ads API.
- استخدام واجهة برمجة التطبيقات لاستكشاف المحتوى وصنّاع المحتوى على YouTube بحثًا عن فرص إعلانية محتملة.
- إكمال تقييم التحقّق المسبق لضمان الأهلية.
- اتّباع متطلبات استخدام البيانات والاستعداد للخضوع لعمليات تدقيق دورية للبيانات.
- توقيع اتفاقية ترخيص بيانات تفرض قانونًا متطلبات استخدام البيانات.
- الموافقة على بنود خدمة Google Ads API بنود الخدمة.
يُرجى التواصل مع ممثل عن Google لمزيد من المعلومات.
إنشاء إحصاءات صنّاع المحتوى
لإنشاء إحصاءات صنّاع المحتوى، أرسِل طلبًا إلى طريقة
ContentCreatorInsightsService.GenerateCreatorInsights. تتضمّن هذه الطريقة حدًا أقصى يبلغ 5 طلبات بحث في الثانية، وتأخذ ثلاثة أنواع من الإدخالات استنادًا إلى ما إذا كنت تريد إمكانية اكتشاف صنّاع المحتوى أو إحصاءات العلامات التجارية لصنّاع المحتوى أو الحصول على إحصاءات صنّاع المحتوى. عليك تقديم المواقع الجغرافية للبلدان التي تريد الحصول على البيانات منها.
إدخالات GenerateCreatorInsights: يمكنك استرداد السمات المتاحة باستخدام
AudienceInsightsService.ListAudienceInsightsAttributes، من خلال تقديم الأبعاد التي تريد الحصول على سمات لها، مثلKNOWLEDGE_GRAPHللمواضيع التي تهمّك.ستتضمّن سمات
KNOWLEDGE_GRAPHعلامة واحدة أو أكثر من علاماتInsightsKnowledgeGraphEntityCapabilities. ستتضمّن السمات المتوافقة مع "إحصاءات صنّاع المحتوى" علامات ذات صلة في بيانات الاستجابة الوصفية.يُرجى العِلم أنّ المطوّرين الذين يمكنهم الوصول إلى
ContentCreatorInsightsServiceسيتمكّنون أيضًا من الوصول تلقائيًا إلىAudienceInsightsService.ListAudienceInsightsAttributes. تتطلّب نقاط النهاية الأخرى فيAudienceInsightsServiceعملية قائمة سماح مستقلة.يمكنك الاطّلاع على مستندات إضافية عن
ListAudienceInsightsAttributesفي دليل "إحصاءات الجمهور".إمكانية اكتشاف صنّاع المحتوى: يمكنك تقديم قائمة بسمات الجمهور، مثل العمر والجنس واهتمامات المستخدمين (بما في ذلك شرائح الجمهور ذات الاهتمامات المشتركة والجمهور في السوق والجمهور من الأحداث في الحياة). تعرض واجهة برمجة التطبيقات قائمة بصنّاع المحتوى الذين تتطابق شرائح جمهورهم مع هذه السمات. يمكنك أيضًا تقديم سمات صنّاع المحتوى لفلترة صنّاع المحتوى الذين يتطابق محتواهم تحديدًا مع سمات صنّاع المحتوى التي أدخلتها.
اعتبارًا من Google Ads API v23، يمكنك تحديد علاقات سمات الجمهور المعقّدة باستخدام
audience_combinations. يتيح لك هذا الحقل تحديد شرائح جمهور باستخدام منطق منطقي (AND/OR) لا يمكن استخدامه مع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 طلبات بحث في الثانية، وتأخذ نوعَين من الإدخالات استنادًا إلى ما إذا كنت تريد الحصول على المؤشرات الرائجة للجمهور أو المؤشرات الرائجة للمواضيع.
عليك تقديم الموقع الجغرافي للبلد المحدّد الذي تريد الحصول على المؤشرات الرائجة منه.
إدخالات GenerateTrendingInsights: يمكنك استرداد السمات المتاحة باستخدام
AudienceInsightsService.ListAudienceInsightsAttributes، من خلال تقديم الأبعاد التي تريد الحصول على سمات لها، مثلKNOWLEDGE_GRAPHللمواضيع التي تهمّك.ستتضمّن سمات
KNOWLEDGE_GRAPHعلامة واحدة أو أكثر من علاماتInsightsKnowledgeGraphEntityCapabilities. ستتضمّن السمات المتوافقة مع "الإحصاءات الرائجة" علامات ذات صلة في بيانات الاستجابة الوصفية.يُرجى العِلم أنّ المطوّرين الذين يمكنهم الوصول إلى
ContentCreatorInsightsServiceسيتمكّنون أيضًا من الوصول تلقائيًا إلىAudienceInsightsService.ListAudienceInsightsAttributes. تتطلّب نقاط النهاية الأخرى فيAudienceInsightsServiceعملية قائمة سماح مستقلة.يمكنك الاطّلاع على مستندات إضافية عن
ListAudienceInsightsAttributesفي دليل "إحصاءات الجمهور".المؤشرات الرائجة للجمهور: يمكنك تقديم قائمة بسمات الجمهور، مثل العمر والجنس واهتمامات المستخدمين (بما في ذلك شرائح الجمهور ذات الاهتمامات المشتركة والجمهور في السوق والجمهور من الأحداث في الحياة). تعرض واجهة برمجة التطبيقات قائمة بالإحصاءات الرائجة لهذه الشرائح من الجمهور، بما في ذلك مقاييس مثل النسبة المئوية للتغيّر في قيمة المؤشر الرائج خلال فترة المقارنة.
اعتبارًا من Google Ads API v23، يمكنك تحديد علاقات سمات الجمهور المعقّدة باستخدام
audience_combinations. يتيح لك هذا الحقل تحديد شرائح جمهور باستخدام منطق منطقي (AND/OR) لا يمكن استخدامه مع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.المؤشرات الرائجة للمواضيع: يمكنك تقديم قائمة بمواضيع المحتوى. تعرض واجهة برمجة التطبيقات قائمة بالإحصاءات الرائجة لهذه المواضيع، بما في ذلك مقاييس مثل النسبة المئوية للتغيّر في قيمة المؤشر الرائج خلال فترة المقارنة.