Method: customers.generateAudienceCompositionInsights

यह उन एट्रिब्यूट का कलेक्शन दिखाता है जो दिलचस्पी वाली ऑडियंस में दिखाए जाते हैं. साथ ही, इसमें ऐसी मेट्रिक भी मौजूद होती हैं जो हर एट्रिब्यूट की ऑडियंस में उसके हिस्से की तुलना बेसलाइन ऑडियंस के हिस्से से करती हैं.

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

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

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

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

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

पैरामीटर
customerId

string

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

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

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

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

object (InsightsAudience)

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

object (InsightsAudience)

ऐसी बेसलाइन ऑडियंस जिससे दिलचस्पी वाली ऑडियंस की तुलना की जा रही है.
dataMonth

string

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

enum (AudienceInsightsDimension)

ज़रूरी है. ऐसे ऑडियंस डाइमेंशन जिनके लिए कंपोज़िशन की अहम जानकारी दी जानी चाहिए.
customerInsightsGroup

string

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

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

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

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

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

object (AudienceCompositionSection)

अहम जानकारी की रिपोर्ट का कॉन्टेंट, अलग-अलग सेक्शन में व्यवस्थित होता है. हर सेक्शन, अनुरोध में मौजूद किसी एक AudienceInsightsडाइमेंशन वैल्यू से जुड़ा होता है. हर डाइमेंशन में एक से ज़्यादा सेक्शन हो सकते हैं.

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

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

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

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

AudienceCompositionSection

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

जेएसओएन के काेड में दिखाना 
{
  "dimension": enum (AudienceInsightsDimension),
  "topAttributes": [
    {
      object (AudienceCompositionAttribute)
    }
  ],
  "clusteredAttributes": [
    {
      object (AudienceCompositionAttributeCluster)
    }
  ]
}
फ़ील्ड
dimension

enum (AudienceInsightsDimension)

इस सेक्शन में एट्रिब्यूट किस तरह के हैं.
topAttributes[]

object (AudienceCompositionAttribute)

इस ऑडियंस के लिए सबसे काम के सेगमेंट. अगर डाइमेंशन GENDER, AGE_RANGE या PARENTAL_STATUS है, तो एट्रिब्यूट की यह सूची पूरी होती है.
clusteredAttributes[]

object (AudienceCompositionAttributeCluster)

इस ऑडियंस के लिए अन्य एट्रिब्यूट, जिन्हें क्लस्टर में बांटा गया है. डाइमेंशन YOUTUBE_CHANNEL होने पर ही अपने-आप भर जाता है.

AudienceCompositionAttribute

मेटाडेटा और मेट्रिक के साथ ऑडियंस एट्रिब्यूट.

जेएसओएन के काेड में दिखाना 
{
  "attributeMetadata": {
    object (AudienceInsightsAttributeMetadata)
  },
  "metrics": {
    object (AudienceCompositionMetrics)
  }
}
फ़ील्ड
attributeMetadata

object (AudienceInsightsAttributeMetadata)

एट्रिब्यूट और उसके मेटाडेटा.
metrics

object (AudienceCompositionMetrics)

एट्रिब्यूट के लिए मेट्रिक शेयर और इंडेक्स करने की सुविधा.

AudienceCompositionMetrics

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

जेएसओएन के काेड में दिखाना 
{
  "baselineAudienceShare": number,
  "audienceShare": number,
  "index": number,
  "score": number
}
फ़ील्ड
baselineAudienceShare

number

एट्रिब्यूट से मैच करने वाली बेसलाइन ऑडियंस का वह अंश (0 से 1 तक का हिस्सा).
audienceShare

number

एट्रिब्यूट से मैच करने वाली खास ऑडियंस का फ़्रैक्शन (0 से 1 तक, दोनों को शामिल करता है).
index

number

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

number

प्रासंगिकता का 0 से 1 तक का स्कोर शामिल है.

AudienceCompositionAttributeCluster

ऑडियंस कंपोज़िशन की अहम जानकारी वाली रिपोर्ट में, मेटाडेटा और मेट्रिक के साथ मिलते-जुलते एट्रिब्यूट का कलेक्शन.

जेएसओएन के काेड में दिखाना 
{
  "clusterDisplayName": string,
  "clusterMetrics": {
    object (AudienceCompositionMetrics)
  },
  "attributes": [
    {
      object (AudienceCompositionAttribute)
    }
  ]
}
फ़ील्ड
clusterDisplayName

string

एट्रिब्यूट के इस क्लस्टर का नाम
clusterMetrics

object (AudienceCompositionMetrics)

अगर इस क्लस्टर से जुड़ा डाइमेंशन YOUTUBE_CHANNEL है, तो क्लस्टरमेट्रिक्स, पूरी तरह से क्लस्टर से जुड़ी मेट्रिक होती हैं. दूसरे डाइमेंशन के लिए, यह फ़ील्ड सेट नहीं है.
attributes[]

object (AudienceCompositionAttribute)

इस क्लस्टर को बनाने वाले अलग-अलग एट्रिब्यूट, जिनमें मेटाडेटा और मेट्रिक शामिल हैं.