إحصاءات الجمهور

ملاحظة مهمة: لا تتوفّر هذه الميزة إلا للحسابات المُدرَجة في القائمة المسموح بها. يُرجى التواصل مع ممثل عن Google إذا كنت بحاجة إلى الوصول إلى هذه الميزة.

تخضع جميع الطلبات إلى AudienceInsightsService لمعدّل محدود. يُسمح بعدد أقل من الطلبات يوميًا لكل من generateAudienceCompositionInsights وgenerateSuggestedTargetingInsights مقارنةً بطرق "إحصاءات الجمهور" الأخرى. لمزيد من التفاصيل، يمكنك الاطّلاع على حصص واجهة برمجة التطبيقات.

يتيح لك AudienceInsightsService دمج بيانات إحصاءات الجمهور من Google في أدوات التخطيط. تساعد هذه البيانات الوكالات الإعلامية ومنسّقي وسائط الإعلان في فهم جمهورهم المستهدف بشكل أعمق، بما في ذلك الخصائص الديمغرافية والاهتمامات والسلوك على الإنترنت.

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

تتيح واجهة برمجة التطبيقات ثلاث حالات استخدام أساسية:

• تحسين شرائح الجمهور واستكشافها: يمكنك فهم اهتمامات المستهلكين وسلوكياتهم الفريدة لتحديد شرائح جمهور جديدة لعلامة تجارية معيّنة، وتطوير شخصيات الجمهور، وتحسين استراتيجيات تقسيم الجمهور.
• توجيه عملية تخطيط الحملات: يمكنك تحويل مخرجات البيانات إلى شرائح جمهور مستهدَفة على YouTube للتخطيط لها، وتقدير مدى الوصول المحتمل إلى شرائح الجمهور المستهدَفة، وقياس التداخل بين شرائح الجمهور لزيادة مدى وصول الحملات إلى أقصى حدّ.
• صياغة رسائل المواد الإبداعية: يمكنك تخصيص رسائل المواد الإبداعية لجمهورك المستهدف استنادًا إلى المواضيع والاهتمامات التي يتفاعل معها أكثر من غيرها.

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

لكي يكون الشركاء مؤهّلين لاستخدام AudienceInsightsService، يجب أن يستوفوا الشروط التالية:

• أن يكون بإمكانك الوصول إلى أداة Insights Finder أو أن تكون مؤهلاً للوصول إليها
• أن يكون لديك أداة تخطيط أو واجهة مستخدم تدمج واجهة برمجة التطبيقات
• استخدِم واجهة برمجة التطبيقات لأغراض التخطيط الإعلامي أو حالات الاستخدام الأخرى ذات الصلة.
• إكمال تقييم الفحص المسبق
• اتّباع متطلبات استخدام البيانات والخضوع لعمليات تدقيق دورية للبيانات
• قبول بنود خدمة Google Ads API وسياسة استخدام البيانات المرتبطة بها

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

عرض التواريخ المؤهَّلة للإحصاءات

يبدأ سير العمل المعتاد بالتحقّق من الأشهر التقويمية والنطاقات الزمنية المتاحة للتحليل. تعرض الطريقة listInsightsEligibleDates السمة ListInsightsEligibleDatesResponse، التي يسرد حقلها data_months الأشهر (بتنسيق YYYY-MM) التي تتوفّر فيها بيانات إحصاءات الجمهور.

يحتوي الحقل last_thirty_days في الاستجابة على النطاق الزمني الدقيق الذي تستخدمه generateAudienceCompositionInsights عندما لا يتم ضبط data_month في الطلب.

عرض سمات إحصاءات الجمهور

قبل طلب مقاييس تركيبة الجمهور أو التداخل، ابحث عن معرّفات السمات الصالحة باستخدام listAudienceInsightsAttributes. تعرض هذه الطريقة ListAudienceInsightsAttributesResponse يحتوي على السمات المتاحة للسمات المطلوبة.

على سبيل المثال، إذا تم اختيار AFFINITY_USER_INTEREST كسمة في الطلب، ستعرض الطريقة شرائح الجمهور ذي الاهتمامات المشتركة المتوافقة، مثل "مشجّعو الرياضة" أو "محبو الموسيقى". تشمل سمات اهتمامات المستخدمين الأخرى المتوافقة IN_MARKET_USER_INTEREST وLIFE_EVENT_USER_INTEREST. يمكنك ضبط سمات متعددة في طلب واحد. للحصول على قائمة كاملة بالسمات المتوافقة، يُرجى الاطّلاع على مرجع حقول dimensions.

عند البحث عن كيانات (مواضيع) "الرسم البياني المعرفي" باستخدام السمة KNOWLEDGE_GRAPH، يجب تقديم طلب بحث نصي في الحقل query_text (على سبيل المثال، "football and the World Cup").

يمكنك اختياريًا تضمين knowledge_graph_entity_search_options لتخصيص البحث عن المواضيع:

• الفلترة حسب الإمكانات: استخدِم search_filter لحصر الكيانات التي تم استردادها على تلك التي تتيح إمكانات معيّنة فقط. على سبيل المثال، يمكنك فلترة المواضيع المتاحة كسمات لصنّاع المحتوى من خلال إدخال CREATOR_ATTRIBUTE في الحقل entity_capability_filters. يمكن توفير إمكانات متعددة ودمجها مع منطق OR.
• استرداد جميع سمات صنّاع المحتوى: اضبط get_all_creator_attributes على true لاسترداد جميع كيانات "الرسم البياني المعرفي" المتاحة والمصنّفة كسمات صنّاع المحتوى. عند استخدام هذا الخيار، يجب اختيار السمة KNOWLEDGE_GRAPH، ويجب أن يكون query_text فارغًا، ولا يمكنك دمج هذا الخيار مع search_filter.

يمكن استخدام السمات التي تعرضها طريقة قابلية الاكتشاف هذه كمدخلات لطرق AudienceInsightsService الأخرى.

يوفّر كل عنصر AudienceInsightsAttributeMetadata في ListAudienceInsightsAttributesResponse تمثيلاً منظّمًا لسمة الجمهور إلى جانب السمات الوصفية ومقاييس التفاعل. وتشمل التعريف الأساسي للسمة والاسم المعروض ونوع السمة ونسبة الوصول إلى الجمهور المقدَّرة. يمكنك الاطّلاع على مرجع AudienceInsightsAttributeMetadata لمعرفة تعريفات الحقول.

إنشاء تعريف الجمهور

تترجم طريقة generateAudienceDefinition وصفًا نصيًا حرًا لجمهور إلى اقتراحات منظَّمة لسمات الجمهور يمكنك تمريرها إلى طرق الإحصاءات اللاحقة.

إنشاء إحصاءات مقترَحة حول الاستهداف

تعرض طريقة generateSuggestedTargetingInsights مجموعة من إحصاءات الاستهداف (مثل شرائح الجمهور القابلة للاستهداف) ذات الصلة بالجمهور المطلوب.

يمكنك تحديد الجمهور المطلوب إما كسمة منظَّمة InsightsAudienceDefinition أو كوصف نصي في InsightsAudienceDescription.

في حين أنّ generateAudienceCompositionInsights تعرض إحصاءات لشرائح سمات فردية، تعرض generateSuggestedTargetingInsights اقتراحات مجمّعة لشرائح جمهور "إعلانات Google" التي يمكن استهدافها. تساعد هذه الطريقة في الإجابة عن أسئلة مثل "أريد اقتراحات لشرائح جمهور يمكن استهدافها، مثل الآباء في الثلاثينيات من عمرهم الذين يستمتعون بالصيد".

إنشاء مقاييس لاقتراحات الاستهداف

تعرض طريقة generateTargetingSuggestionMetrics GenerateTargetingSuggestionMetricsResponse، الذي يحتوي على جمهور YouTube المحتمل الذي يمكن الوصول إليه لكل تعريف شريحة جمهور مطلوب في GenerateTargetingSuggestionMetricsRequest.

تساعد هذه الطريقة في الإجابة عن أسئلة مثل "كم عدد الرجال الذين تزيد أعمارهم عن 18 عامًا والمهتمين بالتخييم في الولايات المتحدة ويمكن الوصول إليهم على YouTube؟"

إنشاء إحصاءات حول تركيبة الجمهور

تعرض الطريقة generateAudienceCompositionInsights GenerateAudienceCompositionInsightsResponse، الذي يحتوي على قائمة بالسمات التي تمثّل الجمهور المطلوب الذي يهمّك، بالإضافة إلى مقاييس المؤشر والمشاركة التي تقارن حصة كل سمة من الجمهور مع مجموعة أساسية من السكان.

يجب تقديم بلد مستهدف للجمهور. يتم توثيق قائمة السمات المتاحة لاسترداد إحصاءات التركيبة في الحقل dimensions من GenerateAudienceCompositionInsightsRequest.

تساعد هذه الطريقة في الإجابة عن أسئلة مثل "ما هي أهم الاهتمامات المشتركة التي يهتم بها جمهوري المستهدف مقارنةً بالمجتمع الإحصائي العام، وما مدى احتمال تفاعله مع هذه الاهتمامات المشتركة؟"

إنشاء إحصاءات حول تداخل الجمهور

تعرض الطريقة generateAudienceOverlapInsights السمة GenerateAudienceOverlapInsightsResponse التي تحتوي على قائمة بسمات الجمهور مع تقديرات للتداخل بين مدى وصولها المحتمل إلى الجمهور على YouTube ومدى وصول السمة الأساسية.

يجب تقديم بلد مستهدف وسمة أساسية. تتوفّر الفئة العمرية والجنس وشرائح الجمهور ذات الاهتمامات المشتركة وشرائح الجمهور التي تنوي الشراء كسمات للجمهور.

تساعد هذه الطريقة في الإجابة عن أسئلة مثل "ما هو حجم الجمهور المتزايد عند استهداف كل من عشاق الرياضة ومحبي الموسيقى في الولايات المتحدة؟"

إنشاء تقرير Insights Finder

تنشئ طريقة generateInsightsFinderReport تقريرًا محفوظًا في Insights Finder استنادًا إلى الإدخالات المحدّدة في GenerateInsightsFinderReportRequest وتُعرِض GenerateInsightsFinderReportResponse يحتوي على رابط يمكن الوصول إليه خارجيًا لفتح هذا التقرير في واجهة مستخدم Insights Finder.

Google Issue Tracker

يمكنك استخدام Issue Tracker من Google لطرح أسئلة حول الدعم أو الإبلاغ عن الأخطاء أو إرسال طلبات الميزات. تتتبّع Google طلباتك وتحدّد أولوياتها وتنشر آخر المعلومات عنها مباشرةً في Issue Tracker. لمزيد من المعلومات، يُرجى الاطّلاع على إنشاء مشكلة في Google Issue Tracker.

أنشئ مشكلة باستخدام أحد نماذج Issue Tracker التالية:

• طرح سؤال عام حول الدعم أو إرسال ملاحظات بشأن المستندات
• الإبلاغ عن خطأ فني
• إرسال طلب ميزة في واجهة برمجة التطبيقات

املأ جميع الحقول في النموذج بمعلومات تفصيلية حتى تتمكّن Google من إعادة إنشاء طلبك وتحديد أولويته. قد تغلق Google البلاغات غير المكتملة وتطلب منك إرسال بلاغ جديد يتضمّن التفاصيل الناقصة.