Method: customers.generateSuggestedTargetingInsights

टारगेट की जाने वाली अहम जानकारी (जैसे, टारगेट की जा सकने वाली ऑडियंस) का ऐसा कलेक्शन दिखाता है जो अनुरोध की गई ऑडियंस के लिए काम का हो.

थ्रो की गई गड़बड़ियों की सूची: AudienceInsightsError AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError

एचटीटीपी अनुरोध

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

यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ के पैरामीटर

पैरामीटर
customerId

string

ज़रूरी है. ग्राहक का आईडी.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य हिस्से में इस तरह का डेटा शामिल होता है:

जेएसओएन के काेड में दिखाना
{
  "audience": {
    object (InsightsAudience)
  },
  "baselineAudience": {
    object (InsightsAudience)
  },
  "dataMonth": string,
  "customerInsightsGroup": string
}
फ़ील्ड
audience

object (InsightsAudience)

ज़रूरी है. दिलचस्पी वाली ऑडियंस, जिसके लिए अहम जानकारी का अनुरोध किया जा रहा है.

baselineAudience

object (InsightsAudience)

ज़रूरी नहीं. बेसलाइन ऑडियंस. अगर यह जानकारी नहीं दी गई है, तो डिफ़ॉल्ट विकल्प चुनने पर, एक ही देश में रहने वाले सभी लोग उस देश में रहने वाले दर्शकों की पसंद के दर्शक होते हैं.

dataMonth

string

ज़रूरी नहीं. अहम जानकारी के लिए इस्तेमाल किया जाने वाला, एक महीने का पुराना डेटा. यह "yyyy-mm" फ़ॉर्मैट में है. अगर यह नीति सेट नहीं है, तो आपको पिछले 30 दिनों के डेटा की अहम जानकारी मिलेगी.

customerInsightsGroup

string

ज़रूरी नहीं. जिस ग्राहक के लिए प्लान बनाया जा रहा है उसका नाम. यह मान उपयोगकर्ता तय करता है.

जवाब का मुख्य भाग

AudienceInsightsService.GenerateSuggestedTargetingInsights के लिए जवाब.

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

जेएसओएन के काेड में दिखाना
{
  "suggestions": [
    {
      object (TargetingSuggestionMetrics)
    }
  ]
}
फ़ील्ड
suggestions[]

object (TargetingSuggestionMetrics)

टारगेट की जा सकने वाली ऑडियंस के लिए सुझाई गई अहम जानकारी.

अनुमति देने के दायरे

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

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

ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.

TargetingSuggestionMetrics

टारगेट की जा सकने वाली ऐसी ऑडियंस जो अनुरोध की गई ऑडियंस के लिए काम की हो.

जेएसओएन के काेड में दिखाना
{
  "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_ हड्डी है

coverage

number

अनुरोध की गई ऑडियंस का वह अंश (0 से 1 तक सहित), जिस तक सुझाई गई टारगेटिंग का इस्तेमाल करके पहुंचा जा सकता है.

index

number

अगर यह अनुपात तय नहीं है या काम का नहीं है, तो बेसलाइन ऑडियंस के कवरेज के कवरेज का अनुपात या शून्य.

potentialYoutubeReach

string (int64 format)

इस टारगेटिंग का इस्तेमाल करके, YouTube पर जिन लोगों तक पहुंचा जा सकता है उनकी अनुमानित संख्या.