Method: customers.generateAudienceOverlapInsights

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

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

درخواست HTTP

POST https://googleads.googleapis.com/v17/customers/{customerId}:generateAudienceOverlapInsights

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

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

پارامترها
customerId

string

مورد نیاز. شناسه مشتری.

درخواست بدن

بدنه درخواست حاوی داده هایی با ساختار زیر است:

نمایندگی JSON 
{
  "countryLocation": {
    object (LocationInfo)
  },
  "primaryAttribute": {
    object (AudienceInsightsAttribute)
  },
  "dimensions": [
    enum (AudienceInsightsDimension)
  ],
  "customerInsightsGroup": string
}
فیلدها
countryLocation

object ( LocationInfo )

مورد نیاز. کشوری که در آن اندازه و همپوشانی مخاطبان محاسبه می شود.

primaryAttribute

object ( AudienceInsightsAttribute )

مورد نیاز. ویژگی مخاطبی که باید با سایر مخاطبان واجد شرایط تلاقی داشته باشد. این باید یک Affinity یا In-Market User Interest، یک AgeRange یا یک جنسیت باشد.

dimensions[]

enum ( AudienceInsightsDimension )

مورد نیاز. انواع مشخصه هایی که همپوشانی آنها با PrimaryAttribute محاسبه می شود. مقادیر باید زیر مجموعه ای از AFFINITY_USER_INTEREST، IN_MARKET_USER_INTEREST، AGE_RANGE و GENDER باشند.

customerInsightsGroup

string

نام مشتری که برای آن برنامه ریزی شده است. این یک مقدار تعریف شده توسط کاربر است.

بدن پاسخگو

پیام پاسخ برای AudienceInsightsService.GenerateAudienceOverlapInsights .

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

نمایندگی JSON 
{
  "primaryAttributeMetadata": {
    object (AudienceInsightsAttributeMetadata)
  },
  "dimensionResults": [
    {
      object (DimensionOverlapResult)
    }
  ]
}
فیلدها
primaryAttributeMetadata

object ( AudienceInsightsAttributeMetadata )

فراداده برای ویژگی اصلی، از جمله دسترسی بالقوه YouTube.

dimensionResults[]

object ( DimensionOverlapResult )

لیست ویژگی ها و همپوشانی آنها با ویژگی اصلی، یک لیست در هر بعد درخواستی.

محدوده مجوز

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

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

برای اطلاعات بیشتر، بهOAuth 2.0 Overview .

DimensionOverlapResult

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

نمایندگی JSON 
{
  "dimension": enum (AudienceInsightsDimension),
  "items": [
    {
      object (AudienceOverlapItem)
    }
  ]
}
فیلدها
dimension

enum ( AudienceInsightsDimension )

بعد تمام صفات در این بخش.

items[]

object ( AudienceOverlapItem )

صفات و همپوشانی آنها با صفت اولیه.

AudienceOverlapItem

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

نمایندگی JSON 
{
  "attributeMetadata": {
    object (AudienceInsightsAttributeMetadata)
  },
  "potentialYoutubeReachIntersection": string
}
فیلدها
attributeMetadata

object ( AudienceInsightsAttributeMetadata )

ویژگی و فراداده آن، از جمله دسترسی بالقوه YouTube.

potentialYoutubeReachIntersection

string ( int64 format)

اندازه تخمینی تقاطع این ویژگی مخاطب با ویژگی اصلی، یعنی تعداد کاربران قابل دسترسی YouTube که هم با ویژگی اصلی و هم با این یکی مطابقت دارند.