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