Method: customers.generateAudienceCompositionInsights

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

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

درخواست HTTP

POST https://googleads.googleapis.com/v14/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 مراجعه کنید.

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 )

ویژگی های موقعیت جغرافیایی زیرکشور در صورت وجود، هر یک از اینها باید در یکی از کشورهای این مخاطبین موجود باشد. در صورت عدم حضور، مخاطبان از نظر جغرافیایی در کشور مکان ها هستند و نه بیشتر.

gender

object ( GenderInfo )

جنسیت برای مخاطب در صورت عدم حضور، مخاطب بر اساس جنسیت محدودیت ایجاد نمی کند.

ageRanges[]

object ( AgeRangeInfo )

محدوده سنی برای مخاطب در صورت عدم حضور، مخاطب نماینده همه افراد بالای 18 سال است که با سایر ویژگی ها مطابقت دارند.

parentalStatus

object ( ParentalStatusInfo )

وضعیت والدین برای مخاطب در صورت عدم حضور، مخاطب با وضعیت والدین محدود نمی شود.

incomeRanges[]

object ( IncomeRangeInfo )

محدوده صدک درآمد خانوار برای مخاطبان. در صورت عدم وجود، مخاطب بر اساس محدوده درآمد خانوار محدود نمی شود.

dynamicLineups[]

object ( AudienceInsightsDynamicLineup )

صف بندی های پویا که نشان دهنده محتوای YouTube مشاهده شده توسط مخاطبان است.

topicAudienceCombinations[]

object ( InsightsAudienceAttributeGroup )

ترکیبی از ویژگی های موجودیت، دسته و علاقه کاربر که مخاطب را تعریف می کند. این ترکیب دارای ساختار منطقی AND-of-ORs است: ویژگی‌های درون هر InsightsAudienceAttributeGroup با OR ترکیب می‌شوند و خود ترکیب‌ها با AND ترکیب می‌شوند. برای مثال، عبارت (Entity OR Affinity) AND (In-Market OR Category) را می توان با استفاده از دو InsightsAudienceAttributeGroups با دو ویژگی تشکیل داد.

InsightsAudienceAttributeGroup

فهرستی از AudienceInsightsAttributes.

نمایندگی JSON
{
  "attributes": [
    {
      object (AudienceInsightsAttribute)
    }
  ]
}
زمینه های
attributes[]

object ( AudienceInsightsAttribute )

ضروری. مجموعه ای از ویژگی های مخاطب که باید با OR منطقی ترکیب شوند. لازم نیست همه صفات یک بعد باشند. فقط موجودیت‌های نمودار دانش، دسته‌های محصول و خدمات، و مخاطبان وابسته و درون بازار در این زمینه پشتیبانی می‌شوند.

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

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

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

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