Method: customers.generateSuggestedTargetingInsights

يتم عرض مجموعة من إحصاءات الاستهداف (مثل الجماهير القابلة للاستهداف) ذات الصلة بالجمهور المطلوب.

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

طلب HTTP

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

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

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

المَعلمات
customerId

string

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

نص الطلب

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

تمثيل JSON 
{
  "audience": {
    object (InsightsAudience)
  },
  "baselineAudience": {
    object (InsightsAudience)
  },
  "dataMonth": string,
  "customerInsightsGroup": string
}
الحقول
audience

object (InsightsAudience)

مطلوبة. الجمهور محل الاهتمام المطلوب طلب الإحصاءات له.
baselineAudience

object (InsightsAudience)

اختياريّ. الجمهور الأساسي. ويكون الخيار التلقائي، إذا لم يتم تحديده، هو جميع الأشخاص في البلد نفسه الذي يقيم فيه الجمهور المعنيّ.
dataMonth

string

اختياريّ. النطاق لمدة شهر واحد من البيانات السابقة لاستخدامها في الإحصاءات، بالتنسيق "yyyy-mm". في حال ترك هذه السياسة بدون ضبط، سيتم عرض الإحصاءات الخاصة بالبيانات المتعلّقة بآخر ثلاثين يومًا.
customerInsightsGroup

string

اختياريّ. اسم العميل الذي يتم التخطيط له. وهذه قيمة من تحديد المستخدم.

نص الاستجابة

رسالة الرد على AudienceInsightsService.GenerateSuggestedTargetingInsights.

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "suggestions": [
    {
      object (TargetingSuggestionMetrics)
    }
  ]
}
الحقول
suggestions[]

object (TargetingSuggestionMetrics)

إحصاءات مقترَحة للجماهير القابلة للاستهداف

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

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

لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.

TargetingSuggestionMetrics

جمهور مقترح يمكن استهدافه وثيق الصلة بالجمهور المطلوب.

تمثيل JSON 
{
  "locations": [
    {
      object (AudienceInsightsAttributeMetadata)
    }
  ],
  "ageRanges": [
    {
      object (AgeRangeInfo)
    }
  ],
  "gender": {
    object (GenderInfo)
  },
  "userInterests": [
    {
      object (AudienceInsightsAttributeMetadata)
    }
  ],
  "coverage": number,
  "index": number,
  "potentialYoutubeReach": string
}
الحقول
locations[]

object (AudienceInsightsAttributeMetadata)

الاستهداف المقترَح حسب الموقع الجغرافي. تحتوي جميع هذه السمات على سمة GEO_TARGET_COUNTRY أو SUB_COUNTRY_LOCATION
ageRanges[]

object (AgeRangeInfo)

استهداف الفئة العمرية المقترحة: قد يكون هذا الحقل فارغًا للإشارة إلى عدم استهداف العمر.
gender

object (GenderInfo)

استهداف الجنس المقترَح. وتشمل هذه السمة السمة GENDER في حال توفّرها.
userInterests[]

object (AudienceInsightsAttributeMetadata)

شرائح الجمهور المُقترَحة لاستهدافها. تحتوي جميع هذه السمات على بُعد AFFINITY_USER_INTEREST أو IN_MARKET_USER_INTEREST
coverage

number

الكسر (من 0 إلى 1 شامل) الجمهور المطلوب الذي يمكن الوصول إليه باستخدام الاستهداف المقترَح.
index

number

تمثّل هذه السمة نسبة التغطية إلى التغطية للجمهور الأساسي، أو تكون صفرًا إذا كانت هذه النسبة غير محدّدة أو غير مفيدة.
potentialYoutubeReach

string (int64 format)

العدد التقريبي التقريبي للأشخاص الذين يمكن الوصول إليهم على YouTube باستخدام هذا الاستهداف.