Method: customers.generateAudienceOverlapInsights

यह फ़ंक्शन, ऑडियंस एट्रिब्यूट का कलेक्शन दिखाता है. साथ ही, यह भी बताता है कि YouTube पर आपकी संभावित पहुंच और किसी इनपुट एट्रिब्यूट की पहुंच में कितना ओवरलैप है.

दिखने वाली गड़बड़ियों की सूची: AudienceInsightsError AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError

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

POST https://googleads.googleapis.com/v17/customers/{customerId}:generateAudienceOverlapInsights

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

पाथ पैरामीटर

पैरामीटर
customerId

string

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

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

अनुरोध के मुख्य भाग में नीचे दिए गए स्ट्रक्चर वाला डेटा होता है:

JSON के काेड में दिखाना 
{
  "countryLocation": {
    object (LocationInfo)
  },
  "primaryAttribute": {
    object (AudienceInsightsAttribute)
  },
  "dimensions": [
    enum (AudienceInsightsDimension)
  ],
  "customerInsightsGroup": string
}
फ़ील्ड
countryLocation

object (LocationInfo)

ज़रूरी है. वह देश जहां ऑडियंस के साइज़ और ओवरलैप का हिसाब लगाना है.
primaryAttribute

object (AudienceInsightsAttribute)

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

enum (AudienceInsightsDimension)

ज़रूरी है. ऐसे एट्रिब्यूट के टाइप जिनके लिए primaryAttribute के साथ ओवरलैप का हिसाब लगाना है. वैल्यू, AFFINITY_USER_INTEREST, IN_MARKET_USER_INTEREST, AGE_RANGE, और GENDER का सबसेट होनी चाहिए.
customerInsightsGroup

string

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

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

AudienceInsightsService.GenerateAudienceOverlapInsights के लिए जवाब का मैसेज.

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

JSON के काेड में दिखाना 
{
  "primaryAttributeMetadata": {
    object (AudienceInsightsAttributeMetadata)
  },
  "dimensionResults": [
    {
      object (DimensionOverlapResult)
    }
  ]
}
फ़ील्ड
primaryAttributeMetadata

object (AudienceInsightsAttributeMetadata)

प्राइमरी एट्रिब्यूट का मेटाडेटा. इसमें YouTube पर संभावित पहुंच की जानकारी भी शामिल होती है.
dimensionResults[]

object (DimensionOverlapResult)

एट्रिब्यूट की सूचियां और प्राइमरी एट्रिब्यूट के साथ उनका ओवरलैप. अनुरोध किए गए हर डाइमेंशन के लिए एक सूची.

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

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

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

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

DimensionOverlapResult

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

JSON के काेड में दिखाना 
{
  "dimension": enum (AudienceInsightsDimension),
  "items": [
    {
      object (AudienceOverlapItem)
    }
  ]
}
फ़ील्ड
dimension

enum (AudienceInsightsDimension)

इस सेक्शन में मौजूद सभी एट्रिब्यूट का डाइमेंशन.
items[]

object (AudienceOverlapItem)

एट्रिब्यूट और प्राइमरी एट्रिब्यूट के साथ उनका ओवरलैप.

AudienceOverlapItem

ऑडियंस एट्रिब्यूट, जिसमें मेटाडेटा शामिल होता है. इसमें इस एट्रिब्यूट की संभावित YouTube पहुंच और प्राइमरी एट्रिब्यूट की पहुंच के बीच ओवरलैप शामिल होता है.

JSON के काेड में दिखाना 
{
  "attributeMetadata": {
    object (AudienceInsightsAttributeMetadata)
  },
  "potentialYoutubeReachIntersection": string
}
फ़ील्ड
attributeMetadata

object (AudienceInsightsAttributeMetadata)

एट्रिब्यूट और उसका मेटाडेटा. इसमें YouTube पर संभावित रीच भी शामिल है.
potentialYoutubeReachIntersection

string (int64 format)

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