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

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

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

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

खास जानकारी

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

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

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

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

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

  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
}