Method: customers.generateAudienceCompositionInsights

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

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

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

POST https://googleads.googleapis.com/v16/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)

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