ऑडियंस एक्सपोर्ट करने से जुड़ी बुनियादी बातें

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

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

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

Google Analytics Data API v1, ऑडियंस एक्सपोर्ट बनाने के लिए एसिंक्रोनस तरीके का इस्तेमाल करता है. सबसे पहले, उपयोगकर्ताओं की ऑडियंस एक्सपोर्ट बनाने के लिए, audienceExports.create तरीके का अनुरोध करना ज़रूरी है. इसके बाद, audienceExports.query तरीके का इस्तेमाल, ऑडियंस में शामिल उपयोगकर्ताओं को वापस पाने के लिए किया जाता है.

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

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

Data API v1 के सभी तरीकों के लिए, यूआरएल अनुरोध पाथ में 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 एडमिन एपीआई 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 फ़ील्ड में Audience Export का नाम (जैसे कि 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"
  }
}

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

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

ऑडियंस एक्सपोर्ट के बारे में बताने के लिए, audienceExports.create जवाब से मिले ऑडियंस एक्सपोर्ट के नाम (जैसे कि properties/1234567/audienceExports/123) का इस्तेमाल करें.

उदाहरण:

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.create तरीके का इस्तेमाल करके ऑडियंस एक्सपोर्ट करने के बाद, audienceExports.query तरीके का इस्तेमाल करें और ऑडियंस एक्सपोर्ट का नाम बताएं (जैसे कि properties/1234567/audienceExports/123).

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
}

ऑडियंस एक्सपोर्ट करने के लिए डेटा से जुड़ी उम्मीदें

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

डेटा फ़्रेशनेस यानी डेटा अपडेट होने की फ़्रीक्वेंसी

ऑडियंस एक्सपोर्ट से जुड़े डेटा के अपडेट होने की फ़्रीक्वेंसी का मतलब है कि Google Analytics को इवेंट इकट्ठा करने, इवेंट प्रोसेस करने, और उसके बाद ऑडियंस में उपयोगकर्ता की सदस्यता अपडेट करने में लगने वाला समय लगता है. अगर इस पूरी प्रोसेस में 24 घंटे लगते हैं, तो ऑडियंस एक्सपोर्ट डेटा अपडेट होने की अवधि 24 घंटे होगी. ज़्यादा जानने के लिए, डेटा फ़्रेशनेस देखें.

उदाहरण के लिए, अगर कोई उपयोगकर्ता पहली बार खरीदारी करता है और उसके सात घंटे बाद "खरीदार" ऑडियंस के लिए ऑडियंस एक्सपोर्ट बनाता है, तो वह उपयोगकर्ता ज़्यादातर "खरीदार" ऑडियंस एक्सपोर्ट में शामिल नहीं होगा. पहली खरीदारी के 14 से 38 घंटे में, वह उपयोगकर्ता नई ऑडियंस एक्सपोर्ट में शामिल हो जाएगा.

एक्सपोर्ट की गई ऑडियंस की रिपोर्ट

ऑडियंस एक्सपोर्ट, किसी ऑडियंस में मौजूद उपयोगकर्ताओं की सूचियां होती हैं. ये सूचियां किसी खास समय के स्नैपशॉट में मौजूद होती हैं. Google Ads रीमार्केटिंग के लिए, Google Analytics, ऑडियंस में मौजूद उपयोगकर्ताओं को अपने-आप और लगातार Google Ads में एक्सपोर्ट करता है. वहीं दूसरी ओर, Data API v1 का इस्तेमाल करके बनाए गए ऑडियंस एक्सपोर्ट के लिए, आपको उस ऑडियंस में नए उपयोगकर्ताओं को देखने के लिए एक नया ऑडियंस एक्सपोर्ट बनाने की ज़रूरत होगी.

ऑडियंस एक्सपोर्ट करने की सुविधा, उपयोगकर्ता की हाल ही की सदस्यताओं के आधार पर बनाई जाती है. हालांकि, ऑडियंस एक्सपोर्ट में डेटा अपडेट होने में 20 घंटे लग सकते हैं. इसका मतलब है कि ऑडियंस एक्सपोर्ट, मौजूदा समय से 20 घंटे पहले के सभी इवेंट के हिसाब से होगा.

सदस्यता का नया डेटा दिन में एक बार अपडेट किया जाता है. आम तौर पर, प्रॉपर्टी के टाइमज़ोन के हिसाब से यह डेटा डेलाइट के दौरान अपडेट होता है. इसका मतलब है कि सुबह 9 बजे और सुबह 11 बजे किसी ऑडियंस एक्सपोर्ट के लिए यही डेटा दिखेगा. हालांकि, किसी दिन के डेटा को शामिल करने की वजह से, दोपहर 3 बजे ऑडियंस एक्सपोर्ट करने का डेटा अलग हो सकता है.

ऑडियंस एक्सपोर्ट करने की समयसीमा खत्म हो गई

ऑडियंस एक्सपोर्ट करने की समयसीमा 72 घंटे बाद खत्म हो जाती है. नए उपयोगकर्ता, हर दिन ऑडियंस में शामिल हो सकते हैं और बाहर निकल सकते हैं. उपयोगकर्ताओं का सबसे नया स्नैपशॉट पाने के लिए, आपको हर दिन के लिए नए ऑडियंस एक्सपोर्ट बनाने होंगे.

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

जब किसी ऑडियंस या प्रॉपर्टी का साइज़ उपयोगकर्ता की सीमा से ज़्यादा हो जाता है, तो ऑडियंस एक्सपोर्ट, ऑडियंस के सैंपल दिखाता है. ये सीमाएं आपकी प्रॉपर्टी (जैसे, स्टैंडर्ड या 360 प्रॉपर्टी) टाइप पर निर्भर करती हैं. साथ ही, इन्हें हर ऑडियंस एक्सपोर्ट में अलग-अलग लागू किया जाता है. लौटने वाले उपयोगकर्ता, अनुरोध की गई ऑडियंस में शामिल उपयोगकर्ता हैं. इनमें ऐसे उपयोगकर्ता शामिल होते हैं जिन्हें ऑडियंस में शामिल किया जा सकता है या नहीं भी माना जा सकता है.

रिपोर्टिंग आइडेंटिटी कंसिस्टेंसी

रिपोर्टिंग आइडेंटिटी से यह तय होता है कि रिपोर्ट में, उपयोगकर्ताओं की डुप्लीकेट कॉपी कैसे हटाई जाएगी. ऑडियंस एक्सपोर्ट करने की सुविधा, रिपोर्टिंग आइडेंटिटी की सेटिंग के आधार पर नहीं बदलती. ऑडियंस एक्सपोर्ट करने की सुविधा से हमेशा उपयोगकर्ताओं की पहचान उपयोगकर्ता आईडी और फिर डिवाइस आईडी से होती है.

इसका मतलब है कि ऑडियंस की रिपोर्ट में, ऑडियंस एक्सपोर्ट की तुलना में ज़्यादा उपयोगकर्ता दिख सकते हैं. उदाहरण के लिए, अगर रिपोर्टिंग आइडेंटिटी "डिवाइस पर आधारित" है और यूज़र आईडी को इकट्ठा किया गया है, तो रिपोर्ट में यूज़र आईडी के आधार पर उपयोगकर्ताओं की डुप्लीकेट डुप्लीकेट कॉपी नहीं हटाई जाएंगी, लेकिन ऑडियंस एक्सपोर्ट यूज़र आईडी के आधार पर डुप्लीकेट कॉपी को हटा देंगी.

डेटा का सही तरीके से या सही समय पर बैकफ़िल न होना

Google Analytics में कोई ऑडियंस बनाने और Google Ads की रीमार्केटिंग सुविधा को चालू करने पर, Google Analytics हाल ही में जोड़े गए सदस्यों के साथ उस ऑडियंस के डेटा को Google Ads में बैकफ़िल करता है. हालांकि, Google Analytics की रिपोर्ट और ऑडियंस एक्सपोर्ट में, उन उपयोगकर्ताओं का डेटा शामिल नहीं किया जाता जिन्हें बैकफ़िल करने से पहले ऑडियंस में जोड़ा गया था. रिपोर्ट और ऑडियंस एक्सपोर्ट के लिए ऑडियंस बनाए जाने के बाद, उपयोगकर्ता को किसी इवेंट को लॉग करना होगा, ताकि उसका डेटा उस ऑडियंस में दिख सके.

उदाहरण के लिए, अगर कोई उपयोगकर्ता 20 जून को खरीदारी का इवेंट लॉग करता है और 21 जून को "खरीदार" ऑडियंस बनाई जाती है, तो हो सकता है कि आपको उस उपयोगकर्ता को नई ऑडियंस एक्सपोर्ट में देखने के लिए 22 जून तक का इंतज़ार करना पड़े. हालांकि, वह उपयोगकर्ता ऑडियंस एक्सपोर्ट में सिर्फ़ तब शामिल होगा, जब उपयोगकर्ता ने 21 जून को कोई इवेंट लॉग किया हो.