إحصاءات صنّاع المحتوى في YouTube

يمكنك استخدام ميزة "إحصاءات صنّاع المحتوى" للتعرّف على صنّاع المحتوى في YouTube والحصول على إحصاءات حولهم. يمكن أن يكون ذلك مفيدًا للوكالات والمعلنين الذين يريدون العثور على صنّاع محتوى مناسبين لجمهورهم المستهدف.

تتضمّن واجهة برمجة التطبيقات أربع وظائف رئيسية:

  1. إمكانية العثور على صنّاع المحتوى: يمكنك العثور على صنّاع محتوى مناسبين لمجموعة معيّنة من المواضيع أو الخصائص الديمغرافية أو شرائح الجمهور أو سمات صنّاع المحتوى.
  2. إحصاءات حول مواضيع صنّاع المحتوى: يمكنك الحصول على إحصاءات حول صنّاع المحتوى المناسبين الذين ينشرون فيديوهات حول مواضيع محدّدة.
  3. إحصاءات حول صنّاع المحتوى: يمكنك الحصول على إحصاءات حول قنوات معيّنة على YouTube، مثل عدد المشتركين وعدد المشاهدات والتركيبة السكانية للجمهور.
  4. إحصاءات حول المؤشرات الرائجة: يمكنك الحصول على إحصاءات حول مؤشرات معيّنة رائجة استنادًا إلى شرائح جمهور أو مواضيع محدّدة.

يمكن العثور على صنّاع محتوى محليين (أي صنّاع محتوى مقيمين في بلد معيّن أو ينشرون محتوى من بلد معيّن ويشاهدهم المستخدمون في ذلك البلد) عند استخدام ميزة العثور على صنّاع محتوى استنادًا إلى المواضيع أو ميزة "الإحصاءات الرائجة" من خلال طلب بيانات تكميلية.

متطلبات الأهلية

‫GenerateCreatorInsights هي مكوّن خاص من Google Ads API يتم تقديمه مع ترخيص بيانات غير حصري وغير خاضع لحقوق الملكية. يمكن للشركاء الموقّعين استخدام مكتبات برامج العملاء في "إعلانات Google" العادية لاستكشاف صنّاع المحتوى والمحتوى على YouTube. ليكون الشركاء مؤهَّلين، عليهم استيفاء الشروط التالية:

  • أن يكون لديك أداة تخطيط أو واجهة مستخدم ستدمج Google Ads API.
  • استخدِم واجهة برمجة التطبيقات لاستكشاف المحتوى وصنّاع المحتوى على YouTube بحثًا عن فرص إعلانية محتملة.
  • أكمِل تقييم التحقّق المسبق للتأكّد من أهليتك.
  • الالتزام بمتطلبات استخدام البيانات والاستعداد للخضوع لعمليات تدقيق دورية للبيانات
  • توقيع اتفاقية ترخيص بيانات تفرض قانونيًا متطلبات استخدام البيانات
  • يجب الموافقة على بنود خدمة Google Ads API.

يُرجى التواصل مع ممثل عن Google لمزيد من المعلومات.

إنشاء إحصاءات صنّاع المحتوى

لإنشاء إحصاءات لصنّاع المحتوى، أرسِل طلبًا إلى طريقة GenerateCreatorInsights. يبلغ الحد الأقصى لهذه الطريقة 5 طلبات بحث في الثانية. تتلقّى هذه الأداة أنواعًا مختلفة من المدخلات، وذلك حسب ما إذا كنت تريد تسهيل عثور المستخدمين على صنّاع المحتوى، أو البحث عن صنّاع محتوى مناسبين حسب المواضيع، أو الحصول على إحصاءات حول صنّاع المحتوى. يجب تقديم المواقع الجغرافية للبلدان التي تريد الحصول على بيانات منها.

  1. إمكانية عثور الجمهور على صنّاع المحتوى: يمكنك تقديم قائمة بسمات الجمهور، مثل العمر والجنس واهتمامات المستخدمين (بما في ذلك شرائح الجمهور ذو الاهتمامات المشتركة وشرائح الجمهور الذي ينوي الشراء وشرائح الجمهور من الأحداث في الحياة). تعرض واجهة برمجة التطبيقات قائمة بصنّاع المحتوى الذين تتطابق شرائح جمهورهم مع هذه السمات. يمكنك أيضًا تقديم سمات لصنّاع المحتوى لتصفية النتائج حسب صنّاع المحتوى الذين يتطابق محتواهم تحديدًا مع سمات صنّاع المحتوى التي أدخلتها.

    يمكنك استرداد سمات الجمهور المتاحة باستخدام 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.

  2. إحصاءات حول مواضيع صنّاع المحتوى: قدِّم قائمة بمواضيع المحتوى باستخدام الحقل search_topics. تعرض واجهة برمجة التطبيقات صنّاع المحتوى ذوي الصلة الذين يقدّمون فيديوهات حول المواضيع المحدّدة. تستند البيانات التي يتم استرجاعها إلى البلد المحدّد في country_locations. يُرجى العِلم أنّ هذا الخيار يتيح البحث عن بلد واحد فقط.

    يجب وضع علامة على الكيانات المتوافقة في الحقل SearchTopics باستخدام إمكانية CONTENT_TRENDING_INSIGHTS أو CREATOR_TOPIC_INSIGHTS. استخدِم طريقة ListAudienceInsightsAttributes لاسترداد إمكانات الكيانات المتوافقة.

    ملاحظة: تم إيقاف الخيار search_brand نهائيًا في الإصدار 24.2 وإزالته في الإصدار 25. استخدِم search_topics بدلاً من ذلك.

  3. إحصاءات حول صنّاع المحتوى: قدِّم قائمة بمعرّفات قنوات YouTube باستخدام الحقل search_channels. تعرض واجهة برمجة التطبيقات إحصاءات حول هذه القنوات المحدّدة.

البيانات التكميلية وصنّاع المحتوى المحليون

يتم عرض بيانات الإحصاءات الأساسية فقط بشكل تلقائي. يمكنك طلب ميزات اختيارية وبيانات إضافية في ردّك عن طريق ضبط الحقل المتكرّر supplemental_data.

على سبيل المثال، يمكنك طلب بيانات صنّاع المحتوى المحليين من خلال إضافة قيمة التعداد LOCAL_CREATOR_DATA إلى الحقل supplemental_data. إذا كنت تبحث عن صنّاع محتوى باستخدام search_topics (والموضوع هو عنصر في "مخطط المعلومات" تمّت الإشارة إليه باستخدام إمكانية CREATOR_TOPIC_INSIGHTS)، ستملأ واجهة برمجة التطبيقات الحقل local_creator_insights في الردّ بصنّاع محتوى محليين وافقوا على مشاركة بيانات الموقع الجغرافي.

يُرجى ملاحظة المواصفات التالية لاكتشاف صنّاع المحتوى المحليين:

  • التعريف: "صنّاع المحتوى المحليون" هم صنّاع محتوى يقيمون في البلد المحدّد أو ينشرون محتوى منه، ويشاهدهم المستخدمون في ذلك البلد.
  • قيد: لا تتوفّر ميزة العثور على صنّاع المحتوى المحليين عندما يتم ضبط sub_country_locations في الطلب.
  • الإمكانات: يمكنك استرداد قائمة بكيانات "الرسم البياني المعرفي" المتوافقة وإمكاناتها باستخدام ListAudienceInsightsAttributes.

يعرض الإجراء generateCreatorInsights عنصر GenerateCreatorInsightsResponse. يحتوي هذا العنصر على الحقول التالية:

  • creator_insights: قائمة بعناصر YouTubeCreatorInsights تطابق معاييرك الأساسية.
  • local_creator_insights: قائمة بعناصر YouTubeCreatorInsights لصنّاع المحتوى المحليين. لا تتم تعبئة هذا الحقل إلا إذا تم طلب LOCAL_CREATOR_DATA وكان المعيار المستخدَم هو search_topics.

يحتوي كل عنصر YouTubeCreatorInsights على المعلومات التالية حول صانع محتوى:

  • اسم صانع المحتوى
  • قناة على YouTube
  • إجمالي مقاييس صنّاع المحتوى
  • قائمة بإحصاءات قنوات على YouTube

يحتوي العنصر YouTubeMetrics على المقاييس التالية:

  • عدد المشتركين
  • عدد المشاهدات
  • عدد الفيديو
  • أن يكون صانع فيديوهات Shorts نشطًا
  • فرص الشراكة (بدءًا من الإصدار 23)

لمعرفة ما إذا كان صانع المحتوى مؤهلاً لعقد شراكات بشأن المحتوى المرتبط بعلامة تجارية الأصلي، تحقّق من partnership_opportunities، فيكون صانع المحتوى مؤهلاً إذا كانت القائمة تتضمّن القيمة CREATOR_PARTNERSHIPS.

يحتوي الكائن YouTubeChannelInsights على المعلومات التالية حول قناة على YouTube:

  • اسم القناة
  • معرّف القناة
  • عنوان URL للقناة
  • وصف القناة
  • مقاييس القناة
  • سمات جمهور القناة (مثل العمر والجنس وتصنيف اهتمامات المستخدمين)
  • الفيديوهات الأفضل أداءً
  • نوع القناة
  • اللغات المرتبطة بمحتوى القناة
  • نتيجة الصلة بالموضوع (لعمليات البحث عن مؤشرات المواضيع فقط)
  • تُستخدَم لتحديد ما إذا كان صانع المحتوى قد وافق على مشاركة المقاييس غير العلنية

لإنشاء إحصاءات حول المؤشرات الرائجة، أرسِل طلبًا إلى طريقة GenerateTrendingInsights. يبلغ الحد الأقصى لهذه الطريقة 5 طلبات بحث في الثانية. تتلقّى هذه الأداة نوعَين من البيانات، وذلك حسب ما إذا كنت تريد الحصول على مؤشرات الجمهور أو مؤشرات المواضيع. يجب تقديم الموقع الجغرافي للبلد الذي تريد الحصول على المؤشرات منه.

  1. مؤشرات الجمهور: يمكنك تقديم قائمة بسمات الجمهور، مثل العمر والجنس واهتمامات المستخدمين (بما في ذلك الجمهور ذو الاهتمامات المشتركة والجمهور الذي ينوي الشراء وجمهور الأحداث في الحياة). تعرض واجهة برمجة التطبيقات قائمة بالإحصاءات الرائجة لهؤلاء الجمهور، بما في ذلك مقاييس مثل نسبة التغيّر في قيمة المؤشر خلال فترة المقارنة.

    يمكنك استرداد سمات الجمهور المتاحة باستخدام 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.

    ستتضمّن سمات KNOWLEDGE_GRAPH علامة واحدة أو أكثر من علامات InsightsKnowledgeGraphEntityCapabilities. ستتضمّن البيانات الوصفية للردود علامات ذات صلة بالسمات المتوافقة مع "الإحصاءات الرائجة".

    يُرجى العِلم أنّ المطوّرين الذين لديهم إذن الوصول إلى ContentCreatorInsightsService سيحصلون أيضًا على إذن الوصول تلقائيًا إلى AudienceInsightsService.ListAudienceInsightsAttributes. تتطلّب نقاط النهاية الأخرى في AudienceInsightsService عملية قائمة سماح مستقلة.

    يمكنك الاطّلاع على مستندات إضافية حول ListAudienceInsightsAttributes في دليل "إحصاءات الجمهور".

  2. مؤشرات المواضيع: تقدّم هذه السمة قائمة بمواضيع المحتوى. تعرض واجهة برمجة التطبيقات قائمة بالمعلومات المفصّلة الرائجة حول هذه المواضيع، بما في ذلك مقاييس مثل النسبة المئوية للتغيّر في قيمة المؤشر خلال فترة المقارنة.

على غرار إنشاء إحصاءات لصنّاع المحتوى، يمكنك طلب ميزات اختيارية في الإحصاءات الرائجة من خلال ضبط الحقل المتكرّر supplemental_data على LOCAL_CREATOR_DATA.

إذا كان طلبك الرائج يستخدم search_topics، سيتم ملء الحقل related_local_creators في عناصر TrendInsight التي تم إرجاعها بصنّاع محتوى محليين مرتبطين بالموضوع المطلوب ووافقوا على مشاركة بيانات الموقع الجغرافي. يخضع اكتشاف صنّاع المحتوى المحليين للتعريف والقيود نفسها (مثل عدم التوافق مع sub_country_locations).

يعرض الإجراء GenerateTrendingInsights قائمة بعناصر TrendInsight، يحتوي كل منها على ما يلي:

  • trend_attribute: AudienceInsightsAttributeMetadata الأساسي للمؤشر.
  • trend_metrics: مقاييس المؤشر، مثل النسبة المئوية للتغيير خلال فترة المقارنة
  • trend_data_points: نقاط البيانات السابقة للرسم البياني. تتم تعبئة هذا الحقل فقط للمؤشرات التي تستخدم search_topics.
  • related_videos: قائمة بعناصر AudienceInsightsAttributeMetadata للفيديوهات الرائجة المرتبطة بموضوع المحتوى الرائج. تتم تعبئة هذا الحقل فقط للبيانات الرائجة التي تستخدم search_topics. بالنسبة إلى هذه السمات، يتم ملء YouTubeVideoAttributeMetadata المتداخل، والذي يحتوي على بيانات وصفية على مستوى الفيديو (مثل عنوان URL للفيديو وعنوان URL للصورة المصغّرة وعدد المشاهدات أو الإعجابات) وبيانات وصفية على مستوى القناة (مثل معرّف القناة واسمها وعنوان URL الخاص بها).
السابق
إحصاءات الجمهور