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

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 के रूप में स्ट्रिंग की उम्मीद करता है. यहां जाएं: उदाहरण के लिए, आसानी से सिखाने वाली गाइड, क्लाइंट लाइब्रेरी पर लागू होती है.

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

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

• audience में ऑडियंस का मान्य नाम फ़ील्ड में, properties/{propertyId}/audiences/{audienceId} फ़ॉर्मैट में डाला गया है. आप का इस्तेमाल करें audiences.list Google Analytics एडमिन एपीआई v1 का इस्तेमाल करें. कॉन्टेंट बनाने Audience.name audiences.list जवाब के फ़ील्ड में ऑडियंस का नाम डालें.
• 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
}