ऑडियंस एक्सपोर्ट बनाना

Google Analytics में ऑडियंस की मदद से, उपयोगकर्ताओं को अपने कारोबार की ज़रूरत के हिसाब से अलग-अलग सेगमेंट में बांटा जा सकता है. ऑडियंस की मदद से, शेयर किए गए एट्रिब्यूट के आधार पर अपनी साइट या ऐप्लिकेशन के उपयोगकर्ताओं को ग्रुप किया जा सकता है.

Data API का इस्तेमाल करके, अपनी ऑडियंस और उनके उपयोगकर्ताओं का स्नैपशॉट एक्सपोर्ट किया जा सकता है.

ऑडियंस एक्सपोर्ट में दिखने वाले डेटा के बारे में अहम जानकारी पाने के लिए, ऑडियंस एक्सपोर्ट के डेटा से जुड़ी उम्मीदें के बारे में गाइड देखें.

खास जानकारी

ऑडियंस एक्सपोर्ट बनाने और उससे जुड़ी क्वेरी करने के लिए, Data API के इन अनुरोधों का इस्तेमाल करें:

1. ऑडियंस एक्सपोर्ट बनाने के लिए, audienceExports.create तरीका इस्तेमाल करें.
2. ऑडियंस में मौजूद उपयोगकर्ताओं को वापस पाने के लिए, audienceExports.query कॉल करने का तरीका इस्तेमाल किया जाता है.

ज़्यादा जानकारी के लिए, किसी ऑडियंस एक्सपोर्ट के कॉन्फ़िगरेशन मेटाडेटा को पाने के लिए audienceExports.get और किसी प्रॉपर्टी के लिए अपने सभी ऑडियंस एक्सपोर्ट की सूची देखने के लिए audienceExports.list को कॉल करें.

रिपोर्टिंग इकाई चुनना

Data API के सभी तरीकों के लिए, properties/GA_PROPERTY_ID के तौर पर यूआरएल अनुरोध पाथ में Google Analytics प्रॉपर्टी आइडेंटिफ़ायर की जानकारी देना ज़रूरी है. यहां एक उदाहरण दिया गया है:

  POST  https://analyticsdata.googleapis.com/v1beta/properties/GA_PROPERTY_ID/audienceExports

यह रिपोर्ट, चुनी गई Google Analytics प्रॉपर्टी में इकट्ठा किए गए Google Analytics इवेंट डेटा के आधार पर जनरेट होती है.

अगर Data API क्लाइंट लाइब्रेरी में से किसी एक का इस्तेमाल किया जा रहा है, तो आपको अनुरोध के यूआरएल पाथ को बदलने की ज़रूरत नहीं है. ज़्यादातर एपीआई क्लाइंट, property पैरामीटर देते हैं. यह पैरामीटर, properties/GA_PROPERTY_ID के तौर पर स्ट्रिंग की उम्मीद करता है. क्लाइंट लाइब्रेरी इस्तेमाल करने के उदाहरणों के लिए, आसानी से सीखें गाइड देखें.

ऑडियंस एक्सपोर्ट बनाना

ऑडियंस एक्सपोर्ट बनाने के लिए, अपने अनुरोध में AudienceExport ऑब्जेक्ट का इस्तेमाल करके, audienceExports.create तरीके को कॉल करें. ये पैरामीटर ज़रूरी हैं:

• audience फ़ील्ड में ऑडियंस का मान्य नाम, जिसे properties/{propertyId}/audiences/{audienceId} के तौर पर फ़ॉर्मैट किया गया हो. इस वैल्यू को पाने के लिए, Google Analytics Admin API v1 के audiences.list तरीके का इस्तेमाल किया जा सकता है. audiences.list जवाब के Audience.name फ़ील्ड में ऑडियंस का नाम होता है.
• dimensions फ़ील्ड में डाइमेंशन की मान्य सूची. इस तरीके से काम करने वाले डाइमेंशन की सूची, ऑडियंस एक्सपोर्ट स्कीमा दस्तावेज़ में देखी जा सकती है. ऑडियंस एक्सपोर्ट में, सिर्फ़ इस फ़ील्ड में बताए गए डाइमेंशन का डेटा शामिल होता है.

ऑडियंस एक्सपोर्ट बनाने के लिए, अनुरोध का एक सैंपल यहां दिया गया है:

POST https://analyticsdata.googleapis.com/v1beta/properties/1234567/audienceExports
{
  "audience": "properties/1234567/audiences/12345",
  "dimensions": [
    {
      "dimensionName": "deviceId"
    }
  ]
}

audienceExports.create तरीके के जवाब में, name फ़ील्ड में ऑडियंस एक्सपोर्ट का नाम होता है. उदाहरण के लिए, properties/1234567/audienceExports/123. जवाब का एक सैंपल यहां दिया गया है:

{
  "response": {
    "@type": "type.googleapis.com/google.analytics.data.v1alpha.AudienceExport",
    "name": "properties/1234567/audienceExports/123",
    "audience": "properties/1234567/audiences/12345",
    "audienceDisplayName": "Purchasers",
    "dimensions": [
      {
        "dimensionName": "deviceId"
      }
    ],
    "state": "CREATING",
    "beginCreatingTime": "2023-06-22T23:35:28.787910949Z"
  }
}

ऑडियंस एक्सपोर्ट से उपयोगकर्ताओं की क्वेरी करने के लिए, name का इस्तेमाल किया जा सकता है.

ऑडियंस एक्सपोर्ट की तैयारी की स्थिति के बारे में क्वेरी करना

audienceExports.create कॉल के बाद, ऑडियंस एक्सपोर्ट जनरेट होने में कुछ मिनट लग सकते हैं.

audienceExports.get तरीके को कॉल करके, ऑडियंस एक्सपोर्ट की तैयारी की स्थिति देखी जा सकती है.

अपने अनुरोध में ऑडियंस एक्सपोर्ट की जानकारी देने के लिए, audienceExports.create जवाब में ऑडियंस एक्सपोर्ट के नाम का इस्तेमाल करें.

अनुरोध का सैंपल यहां दिया गया है:

GET https://analyticsdata.googleapis.com/v1beta/properties/1234567/audienceExports/123

ऑडियंस एक्सपोर्ट के लिए, तैयार होने की स्थिति, जवाब के state फ़ील्ड में दिखती है. ऑडियंस एक्सपोर्ट जनरेट होने के बाद, उसका स्टेटस CREATING से ACTIVE में बदल जाता है.

जवाब का एक सैंपल यहां दिया गया है:

{
  "name": "properties/1234567/audienceExports/123",
  "audience": "properties/1234567/audiences/12345",
  "audienceDisplayName": "Purchasers",
  "dimensions": [
    {
      "dimensionName": "deviceId"
    }
  ],
  "state": "CREATING",
  "beginCreatingTime": "2023-06-22T23:35:28.787910949Z"
}

audienceExports.list तरीका इस्तेमाल करके, सभी ऑडियंस एक्सपोर्ट की स्थिति देखी जा सकती है.

ऑडियंस एक्सपोर्ट से उपयोगकर्ताओं को वापस लाना

ऑडियंस एक्सपोर्ट जनरेट होने के बाद, audienceExports.query मेथड को कॉल करें और अनुरोध में ऑडियंस एक्सपोर्ट का name बताएं.

अनुरोध का सैंपल यहां दिया गया है:

POST https://analyticsdata.googleapis.com/v1beta/properties/1234567/audienceExports/123:query

अगर ऑडियंस एक्सपोर्ट तैयार है, तो यह कॉल ऑडियंस में उपयोगकर्ताओं की सूची दिखाता है.

जवाब का एक सैंपल यहां दिया गया है:

{
  "audienceExport": {
    "name": "properties/1234567/audienceExports/123",
    "audience": "properties/1234567/audiences/12345",
    "audienceDisplayName": "Purchasers",
    "dimensions": [
      {
        "dimensionName": "deviceId"
      }
    ],
    "state": "ACTIVE",
    "beginCreatingTime": "2023-06-22T23:35:28.787910949Z"
  },
  "audienceRows": [
    {
      "dimensionValues": [
        {
          "value": "1000276123.1681742376"
        }
      ]
    },
    {
      "dimensionValues": [
        {
          "value": "1000374452.1668627377"
        }
      ]
    },
    {
      "dimensionValues": [
        {
          "value": "1000391956.1652750758"
        }
      ]
    },
    {
      "dimensionValues": [
        {
          "value": "1000410539.1682018694"
        }
      ]
    },
    {
      "dimensionValues": [
        {
          "value": "1000703969.1666725875"
        }
      ]
    }
  ],
  "rowCount": 5
}