Method: customers.generateSuggestedTargetingInsights

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

इस्तेमाल की गई गड़बड़ियों की सूची: AudienceInsightsError AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError

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

POST https://googleads.googleapis.com/v16/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_INTEREST में शामिल हैं
coverage

number

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

number

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

string (int64 format)

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