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

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 की उस प्रॉपर्टी में इकट्ठा किए गए इवेंट डेटा के आधार पर जनरेट होती है जिसे आपने चुना है.

अगर 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
}