Method: accountTypes.accounts.insights.retrieve

यह कुकी, किसी उपयोगकर्ता सूची के लिए मार्केटिंग डेटा की अहम जानकारी को वापस पाने का काम करती है.

यह सुविधा सिर्फ़ डेटा पार्टनर के लिए उपलब्ध है.

अनुमति देने वाले हेडर:

यह तरीका, इन वैकल्पिक हेडर के साथ काम करता है. इनसे यह तय किया जाता है कि एपीआई, अनुरोध के लिए ऐक्सेस की अनुमति कैसे देता है:

  • login-account: (ज़रूरी नहीं) यह उस खाते के संसाधन का नाम है जहां क्रेडेंशियल का Google खाता, उपयोगकर्ता है. अगर यह सेट नहीं किया गया है, तो डिफ़ॉल्ट रूप से अनुरोध करने वाले खाते पर लागू होता है. फ़ॉर्मैट: accountTypes/{loginAccountType}/accounts/{loginAccountId}
  • linked-account: (ज़रूरी नहीं) उस खाते के संसाधन का नाम जिससे login-account का प्रॉडक्ट लिंक पहले से मौजूद है. फ़ॉर्मैट: accountTypes/{linkedAccountType}/accounts/{linkedAccountId}

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

POST https://datamanager.googleapis.com/v1/{parent=accountTypes/*/accounts/*}/insights:retrieve

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

पाथ पैरामीटर

पैरामीटर
parent

string

ज़रूरी है. उपयोगकर्ता सूची का मालिकाना हक रखने वाला पैरंट खाता. फ़ॉर्मैट: accountTypes/{accountType}/accounts/{account}

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

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

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

object (Baseline)

ज़रूरी है. अनुरोध की गई अहम जानकारी के लिए बेसलाइन.
userListId

string

ज़रूरी है. उस उपयोगकर्ता सूची का आईडी जिसके लिए अहम जानकारी का अनुरोध किया गया है.

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

DM API MarketingDataInsightsService.RetrieveInsights के लिए जवाब का मैसेज

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

JSON फ़ॉर्मैट में दिखाया गया है 
{
  "marketingDataInsights": [
    {
      object (MarketingDataInsight)
    }
  ]
}
फ़ील्ड
marketingDataInsights[]

object (MarketingDataInsight)

इस कुकी में मार्केटिंग डेटा के लिए अहम जानकारी होती है.

अनुमति पाने के लिंक

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

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

बेसलाइन

बेसलान मानदंड, जिससे तुलना करके अहम जानकारी हासिल की जाती है.

JSON के काेड में दिखाना 
{

  // Union field baseline can be only one of the following:
  "baselineLocation": {
    object (Location)
  },
  "locationAutoDetectionEnabled": boolean
  // End of list of possible types for union field baseline.
}
फ़ील्ड
यूनियन फ़ील्ड baseline. वह जगह जहां से तुलना की जाती है. baseline इनमें से सिर्फ़ एक हो सकता है:
baselineLocation

object (Location)

अनुरोध की बेसलाइन लोकेशन. बेसलाइन लोकेशन, अनुरोध किए गए क्षेत्रों की OR-लिस्ट होती है.
locationAutoDetectionEnabled

boolean

अगर इसे 'चालू है' पर सेट किया जाता है, तो सेवा, अहम जानकारी के लिए बेसलाइन जगह की जानकारी का अपने-आप पता लगाने की कोशिश करेगी.

जगह

अनुरोध की बेसलाइन लोकेशन. बेसलाइन लोकेशन, अनुरोध किए गए क्षेत्रों के ISO 3166-1 alpha-2 क्षेत्र कोड की OR-सूची में है.

JSON के काेड में दिखाना 
{
  "regionCodes": [
    string
  ]
}
फ़ील्ड
regionCodes[]

string

ISO 3166-1 ऐल्फ़ा-2 क्षेत्र के कोड की सूची.

MarketingDataInsight

मार्केटिंग डेटा के लिए अहम जानकारी.

यह सुविधा सिर्फ़ डेटा पार्टनर के लिए उपलब्ध है.

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

enum (AudienceInsightsDimension)

वह डाइमेंशन जिससे यह अहम जानकारी जुड़ी है.
attributes[]

object (MarketingDataInsightsAttribute)

किसी दिए गए डाइमेंशन की वैल्यू के लिए अहम जानकारी.

AudienceInsightsDimension

इनसाइट जनरेट करने के लिए इस्तेमाल किए जा सकने वाले डाइमेंशन.

Enums
AUDIENCE_INSIGHTS_DIMENSION_UNSPECIFIED जानकारी नहीं दी गई है.
AUDIENCE_INSIGHTS_DIMENSION_UNKNOWN इस वर्शन में वैल्यू की जानकारी नहीं है.
AFFINITY_USER_INTEREST यह एक अफ़िनिटी UserInterest है.
IN_MARKET_USER_INTEREST यह एक इन-मार्केट UserInterest है.
AGE_RANGE उम्र सीमा.
GENDER लिंग.

MarketingDataInsightsAttribute

एक ही डाइमेंशन के मिलते-जुलते एट्रिब्यूट के कलेक्शन के लिए अहम जानकारी.

JSON के काेड में दिखाना 
{
  "userInterestId": string,
  "lift": number,
  "ageRange": enum (AgeRange),
  "gender": enum (Gender)
}
फ़ील्ड
userInterestId

string (int64 format)

उपयोगकर्ता की दिलचस्पी का आईडी.
lift

number

यह मेज़रमेंट, एट्रिब्यूट वैल्यू के लिए ऑडियंस की लिफ़्ट को दिखाता है. इसकी तुलना बेसलाइन से की जाती है. रेंज [0-1].
ageRange

enum (AgeRange)

उस ऑडियंस की उम्र सीमा जिसके लिए लिफ़्ट उपलब्ध कराई गई है.
gender

enum (Gender)

उस ऑडियंस का लिंग जिसके लिए लिफ़्ट की जानकारी दी गई है.

AgeRange

उम्र के हिसाब से डेमोग्राफ़िक

Enums
AGE_RANGE_UNSPECIFIED जानकारी नहीं दी गई है.
AGE_RANGE_UNKNOWN अज्ञात.
AGE_RANGE_18_24 उम्र 18 से 24 साल के बीच हो.
AGE_RANGE_25_34 उम्र 25 से 34 साल के बीच हो.
AGE_RANGE_35_44 उम्र 35 से 44 साल के बीच हो.
AGE_RANGE_45_54 उम्र 45 से 54 साल के बीच हो.
AGE_RANGE_55_64 उम्र 55 से 64 साल के बीच हो.
AGE_RANGE_65_UP 65 साल और इससे ज़्यादा उम्र के लोग.

लिंग

डेमोग्राफ़िक जेंडर का टाइप (उदाहरण के लिए, महिला).

Enums
GENDER_UNSPECIFIED जानकारी नहीं दी गई है.
GENDER_UNKNOWN अज्ञात.
GENDER_MALE पुरुष.
GENDER_FEMALE महिला.