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 استفاده می کند.

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

پارامترها
customer Id

string

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

درخواست بدن

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

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

object ( LocationInfo )

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

primary Attribute

object ( AudienceInsightsAttribute )

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

dimensions[]

enum ( AudienceInsightsDimension )

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

customer Insights Group

string

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

بدن پاسخگو

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

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

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

object ( AudienceInsightsAttributeMetadata )

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

dimension Results[]

object ( DimensionOverlapResult )

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

محدوده مجوز

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

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

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

DimensionOverlapResult

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

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

enum ( AudienceInsightsDimension )

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

items[]

object ( AudienceOverlapItem )

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

AudienceOverlapItem

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

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

object ( AudienceInsightsAttributeMetadata )

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

potential Youtube Reach Intersection

string ( int64 format)

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