Method: customers.generateSuggestedTargetingInsights

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

قائمة بالأخطاء المعروضة: AudienceInsightsError AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError

طلب HTTP

POST https://googleads.googleapis.com/v16/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 باستخدام هذا الاستهداف.