Method: customers.generateAudienceCompositionInsights

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

قائمة بالأخطاء المعروضة: AudienceInsightsError AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError

طلب HTTP

POST https://googleads.googleapis.com/v16/customers/{customerId}:generateAudienceCompositionInsights

يستخدم عنوان URL بنية تحويل الترميز gRPC.

معلمات المسار

المَعلمات
customerId

string

مطلوبة. رقم تعريف العميل.

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{
  "audience": {
    object (InsightsAudience)
  },
  "baselineAudience": {
    object (InsightsAudience)
  },
  "dataMonth": string,
  "dimensions": [
    enum (AudienceInsightsDimension)
  ],
  "customerInsightsGroup": string
}
الحقول
audience

object (InsightsAudience)

مطلوبة. الجمهور المعني الذي يتم طلب إحصاءات عنه.
baselineAudience

object (InsightsAudience)

الجمهور الأساسي الذي تتم مقارنة الجمهور محل الاهتمام.
dataMonth

string

النطاق الزمني لشهر واحد من البيانات السابقة لاستخدامها في الإحصاءات، بالتنسيق "yyyy-mm". في حال ترك هذه السياسة بدون ضبط، سيتم عرض الإحصاءات في آخر ثلاثين يومًا من البيانات.
dimensions[]

enum (AudienceInsightsDimension)

مطلوبة. أبعاد الجمهور التي يجب عرض إحصاءات المقطوعة الموسيقية لها.
customerInsightsGroup

string

اسم العميل الذي يتم التخطيط له. هذه قيمة من تحديد المستخدم.

نص الاستجابة

رسالة الرد لـ "AudienceInsightsService.GenerateAudienceCompositionInsights".

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "sections": [
    {
      object (AudienceCompositionSection)
    }
  ]
}
الحقول
sections[]

object (AudienceCompositionSection)

محتوى تقرير الإحصاءات المنظّم في أقسام يرتبط كل قسم بإحدى قيم AudienceInsights أجهزتك في الطلب. قد يكون هناك أكثر من قسم واحد لكل سمة.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/adwords

لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.

AudienceCompositionSection

مجموعة من السمات ذات الصلة من النوع نفسه في تقرير إحصاءات تركيب الجمهور.

تمثيل JSON 
{
  "dimension": enum (AudienceInsightsDimension),
  "topAttributes": [
    {
      object (AudienceCompositionAttribute)
    }
  ],
  "clusteredAttributes": [
    {
      object (AudienceCompositionAttributeCluster)
    }
  ]
}
الحقول
dimension

enum (AudienceInsightsDimension)

نوع السمات في هذا القسم.
topAttributes[]

object (AudienceCompositionAttribute)

الشرائح الأكثر ملاءمةً لهذا الجمهور. إذا كانت السمة مثل GENDER أو AGE_RANGE أو PARENTAL_STATUS، فإن قائمة السمات هذه شاملة.
clusteredAttributes[]

object (AudienceCompositionAttributeCluster)

يشير ذلك المصطلح إلى سمات إضافية لهذا الجمهور مجمَّعة في مجموعات. تتمّ تعبئة هذه السمة فقط إذا كانت السمة YOUTUBE_CHANNEL.

AudienceCompositionAttribute

سمة جمهور مع بيانات وصفية ومقاييس.

تمثيل JSON 
{
  "attributeMetadata": {
    object (AudienceInsightsAttributeMetadata)
  },
  "metrics": {
    object (AudienceCompositionMetrics)
  }
}
الحقول
attributeMetadata

object (AudienceInsightsAttributeMetadata)

السمة مع بياناتها الوصفية.
metrics

object (AudienceCompositionMetrics)

مشاركة مقاييس السمة وفهرستها

AudienceCompositionMetrics

مقاييس المشاركة والمؤشر المرتبطة بسمة في تقرير إحصاءات تركيب الجمهور.

تمثيل JSON 
{
  "baselineAudienceShare": number,
  "audienceShare": number,
  "index": number,
  "score": number
}
الحقول
baselineAudienceShare

number

الكسر (من 0 إلى 1 شامل) للجمهور الأساسي الذي يطابق السمة.
audienceShare

number

الكسر (من 0 إلى 1 شامل) شريحة الجمهور المحدّدة التي تتطابق مع السمة.
index

number

هي نسبة "مشاركة الجمهور" إلى "مشاركة الجمهور" المرجعية، أو تكون صفرًا إذا كانت هذه النسبة غير محدّدة أو غير مفيدة.
score

number

نقاط مدى الصلة بالموضوع تتراوح من 0 إلى 1 بشكلٍ شامل.

AudienceCompositionAttributeCluster

مجموعة من السمات ذات الصلة، مع بيانات وصفية ومقاييس، في تقرير إحصاءات تركيب الجمهور.

تمثيل JSON 
{
  "clusterDisplayName": string,
  "clusterMetrics": {
    object (AudienceCompositionMetrics)
  },
  "attributes": [
    {
      object (AudienceCompositionAttribute)
    }
  ]
}
الحقول
clusterDisplayName

string

اسم مجموعة السمات هذه
clusterMetrics

object (AudienceCompositionMetrics)

إذا كانت السمة المرتبطة بهذه المجموعة هي YOUTUBE_CHANNEL، تكون مقاييس clusterMetrics هي مقاييس مرتبطة بالمجموعة ككل. بالنسبة إلى السمات الأخرى، لم يتم ضبط هذا الحقل.
attributes[]

object (AudienceCompositionAttribute)

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