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

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

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

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

खास जानकारी

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

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

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

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

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

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

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

अगर किसी Data API क्लाइंट लाइब्रेरी का इस्तेमाल किया जा रहा है, तो आपको अनुरोध किए गए यूआरएल पाथ को बदलने की ज़रूरत नहीं है. ज़्यादातर एपीआई क्लाइंट, property पैरामीटर देते हैं, जो properties/GA4_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
}