Method: customers.generateAudienceCompositionInsights

مجموعه‌ای از ویژگی‌ها را برمی‌گرداند که در یک مخاطب مورد علاقه نشان داده شده‌اند، با معیارهایی که سهم هر ویژگی از مخاطب را با سهم آن از مخاطبان پایه مقایسه می‌کند.

فهرست خطاهای پرتاب شده: AudienceInsightsError AuthenticationError AuthorizationError FieldError HeaderError داخلی خطا QuotaError RangeError RequestError

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

مولفه های
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 )

محتوای گزارش بینش، در بخش‌هایی سازمان‌دهی شده است. هر بخش با یکی از مقادیر AudienceInsightsDimension در درخواست مرتبط است. ممکن است در هر بعد بیش از یک بخش وجود داشته باشد.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

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

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

بخش ترکیب مخاطب

مجموعه ای از ویژگی های مرتبط از یک نوع در گزارش بینش ترکیب مخاطب.

نمایندگی 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 )

ویژگی های فردی که این خوشه را با متادیتا و معیارها تشکیل می دهند.