Method: customers.generateAudienceOverlapInsights

تعرِض هذه الدالة مجموعة من سمات الجمهور إلى جانب تقديرات للتداخل بين مدى الوصول المحتمل إلى الجمهور على YouTube ومدى الوصول المحتمل إلى الجمهور لسمة إدخال معيّنة.

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

طلب HTTP

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

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المعلمات
customerId

string

مطلوب. رقم تعريف العميل.

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{
  "countryLocation": {
    object (LocationInfo)
  },
  "primaryAttribute": {
    object (AudienceInsightsAttribute)
  },
  "dimensions": [
    enum (AudienceInsightsDimension)
  ],
  "customerInsightsGroup": string
}
الحقول
countryLocation

object (LocationInfo)

مطلوب. البلد الذي يتم فيه احتساب أحجام شرائح الجمهور وتداخلاتها
primaryAttribute

object (AudienceInsightsAttribute)

مطلوب. سمة الجمهور التي يجب أن تتقاطع مع جميع الجماهير المؤهَّلة الأخرى. يجب أن يكون هذا العنصر أحد سمات UserInterest أو In-Market أو AgeRange أو Gender.
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.

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 الذين يمكن الوصول إليهم والذين يتطابقون مع السمة الأساسية وهذه السمة.