Method: customers.generateAudienceCompositionInsights

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

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

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

POST https://googleads.googleapis.com/v14/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 की खास जानकारी देखें.

InsightsAudience

अलग-अलग विशेषताओं के हिसाब से तय किया गया उपयोगकर्ताओं का एक सेट, जिसकी अहम जानकारी के लिए AudienceInsightsService में अनुरोध किया जा सकता है.

जेएसओएन के काेड में दिखाना 
{
  "countryLocations": [
    {
      object (LocationInfo)
    }
  ],
  "subCountryLocations": [
    {
      object (LocationInfo)
    }
  ],
  "gender": {
    object (GenderInfo)
  },
  "ageRanges": [
    {
      object (AgeRangeInfo)
    }
  ],
  "parentalStatus": {
    object (ParentalStatusInfo)
  },
  "incomeRanges": [
    {
      object (IncomeRangeInfo)
    }
  ],
  "dynamicLineups": [
    {
      object (AudienceInsightsDynamicLineup)
    }
  ],
  "topicAudienceCombinations": [
    {
      object (InsightsAudienceAttributeGroup)
    }
  ]
}
फ़ील्ड
countryLocations[]

object (LocationInfo)

ज़रूरी है. दर्शकों के लिए देश.
subCountryLocations[]

object (LocationInfo)

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

object (GenderInfo)

दर्शकों के लिए लिंग की जानकारी. वीडियो न दिखने पर, दर्शकों पर लिंग के आधार पर कोई पाबंदी नहीं लगाई जाती है.
ageRanges[]

object (AgeRangeInfo)

दर्शकों के लिए उम्र की सीमा. जवाब न देने पर, ऑडियंस में 18 साल से ज़्यादा उम्र के उन सभी लोगों को शामिल किया जाता है जो दूसरे एट्रिब्यूट से मेल खाते हैं.
parentalStatus

object (ParentalStatusInfo)

ऑडियंस के लिए माता-पिता हैं या नहीं. जवाब न देने पर, ऑडियंस पर 'माता-पिता हैं या नहीं' के हिसाब से पाबंदी नहीं लगाई जाती है.
incomeRanges[]

object (IncomeRangeInfo)

ऑडियंस के लिए, पारिवारिक आमदनी के पर्सेंटाइल रेंज हैं. जवाब न देने पर, ऑडियंस पर पारिवारिक आमदनी के हिसाब से पाबंदी नहीं लगाई जाती है.
dynamicLineups[]

object (AudienceInsightsDynamicLineup)

डाइनैमिक लाइनअप, जो उस YouTube कॉन्टेंट को दिखाते हैं जिसे ऑडियंस ने देखा.
topicAudienceCombinations[]

object (InsightsAudienceAttributeGroup)

ऑडियंस को तय करने वाली इकाई, कैटगरी, और उपयोगकर्ता की दिलचस्पी के एट्रिब्यूट का कॉम्बिनेशन. कॉम्बिनेशन का AND-of-ORs लॉजिकल स्ट्रक्चर होता है: हर Insights AudienceAttributeGroup के एट्रिब्यूट को OR के साथ जोड़ा जाता है और कॉम्बिनेशन, AND के साथ जोड़े जाते हैं. उदाहरण के लिए, एक्सप्रेशन (इकाई या अफ़िनिटी ऑडियंस) AND (इन-मार्केट OR कैटगरी) को दो Insights AudienceAttributeGroups का इस्तेमाल करके बनाया जा सकता है. इसमें हर एट्रिब्यूट के लिए दो एट्रिब्यूट होने चाहिए.

InsightsAudienceAttributeGroup

AudienceInsightsAttributes की सूची.

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

object (AudienceInsightsAttribute)

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

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)

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