Method: customers.generateAudienceCompositionInsights

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

قائمة الأخطاء التي تظهر: AudienceInsightsError AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError

طلب HTTP

POST https://googleads.googleapis.com/v14/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)

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

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

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

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

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

InsightsAudience

مجموعة من المستخدِمين، يتم تحديدها حسب سمات مختلفة، ويمكن طلب إحصاءات عنها في AudienceInsightsService.

تمثيل JSON 
{
  "countryLocations": [
    {
      object (LocationInfo)
    }
  ],
  "subCountryLocations": [
    {
      object (LocationInfo)
    }
  ],
  "gender": {
    object (GenderInfo)
  },
  "ageRanges": [
    {
      object (AgeRangeInfo)
    }
  ],
  "parentalStatus": {
    object (ParentalStatusInfo)
  },
  "incomeRanges": [
    {
      object (IncomeRangeInfo)
    }
  ],
  "dynamicLineups": [
    {
      object (AudienceInsightsDynamicLineup)
    }
  ],
  "topicAudienceCombinations": [
    {
      object (InsightsAudienceAttributeGroup)
    }
  ]
}
الحقول
countryLocations[]

object (LocationInfo)

مطلوبة. البلدان المخصّصة للجمهور
subCountryLocations[]

object (LocationInfo)

سمات الموقع الجغرافي لمناطق فرعية من البلد وفي حال توفّر كل منها، يجب أن تكون مدرَجة في أحد البلدان المُدرَجة في هذا الجمهور. في حال غيابه، يكون الجمهور جغرافيًا في countryLocations وليس بعد ذلك.
gender

object (GenderInfo)

الجنس للجمهور. في حالة عدم وجوده، لا يقيد الجمهور حسب الجنس.
ageRanges[]

object (AgeRangeInfo)

الفئات العمرية للجمهور. في حال عدم توفّر هذه السمة، يمثّل الجمهور جميع الأشخاص الذين تزيد أعمارهم عن 18 عامًا والذين يتطابقون مع السمات الأخرى.
parentalStatus

object (ParentalStatusInfo)

الحالة الأبوية للجمهور. في حال عدم وجوده، لا يتم تقييد الجمهور بالحالة الأبوية.
incomeRanges[]

object (IncomeRangeInfo)

الفئات المئوية لدخل الأسرة للجمهور. وفي حال عدم توفّر هذه الشريحة، لن يتمّ تقييد الجمهور حسب نطاق دخل الأسرة.
dynamicLineups[]

object (AudienceInsightsDynamicLineup)

القوائم الديناميكية التي تمثّل محتوى YouTube الذي شاهده الجمهور.
topicAudienceCombinations[]

object (InsightsAudienceAttributeGroup)

يشير ذلك المصطلح إلى مجموعة من سمات اهتمامات المستخدِم والكيان والفئة التي تحدّد شريحة الجمهور. تحتوي التركيبة على بنية منطقية "و"/أو من أو: يتم دمج السمات ضمن كل InsightsPublicAttributeGroup باستخدام OR، ويتم دمج التركيبات نفسها مع AND. على سبيل المثال، يمكن تشكيل التعبير (الكيان أو التقارب) و (في السوق أو الفئة) باستخدام اثنتين من InsightsPublicAttributeGroups مع سمتين لكل منهما.

InsightsAudienceAttributeGroup

قائمة AudienceInsightsAttributes

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

object (AudienceInsightsAttribute)

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

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، تكون مقاييس المجموعة عبارة عن مقاييس مرتبطة بالمجموعة ككل. وبالنسبة إلى السمات الأخرى، لن يتم ضبط هذا الحقل.
attributes[]

object (AudienceCompositionAttribute)

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