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_YEARS, IN_MARKET_USER_फ़िक्र, 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 की खास जानकारी देखें.

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 उपयोगकर्ताओं की संख्या जो प्राइमरी एट्रिब्यूट और इस एट्रिब्यूट, दोनों से मैच करते हैं.