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 प्रॉपर्टी) टाइप पर निर्भर करती हैं. साथ ही, इन्हें हर ऑडियंस एक्सपोर्ट में अलग-अलग लागू किया जाता है. लौटने वाले उपयोगकर्ता, अनुरोध की गई ऑडियंस में शामिल उपयोगकर्ता हैं. इनमें ऐसे उपयोगकर्ता शामिल होते हैं जिन्हें ऑडियंस में शामिल किया जा सकता है या नहीं भी माना जा सकता है.
सीमा किस तरह की है | प्रॉपर्टी की स्टैंडर्ड सीमाएं | Analytics 360 प्रॉपर्टी की सीमाएं |
---|---|---|
लौटने वाले ज़्यादा से ज़्यादा उपयोगकर्ता | 20 लाख | 20 करोड़ |
जिन उपयोगकर्ताओं की संख्या ज़्यादा से ज़्यादा हो सकती है | 1 करोड़ | 1 अरब |
रिपोर्टिंग आइडेंटिटी कंसिस्टेंसी
रिपोर्टिंग आइडेंटिटी से यह तय होता है कि रिपोर्ट में, उपयोगकर्ताओं की डुप्लीकेट कॉपी कैसे हटाई जाएगी. ऑडियंस एक्सपोर्ट करने की सुविधा, रिपोर्टिंग आइडेंटिटी की सेटिंग के आधार पर नहीं बदलती. ऑडियंस एक्सपोर्ट करने की सुविधा से हमेशा उपयोगकर्ताओं की पहचान उपयोगकर्ता आईडी और फिर डिवाइस आईडी से होती है.
इसका मतलब है कि ऑडियंस की रिपोर्ट में, ऑडियंस एक्सपोर्ट की तुलना में ज़्यादा उपयोगकर्ता दिख सकते हैं. उदाहरण के लिए, अगर रिपोर्टिंग आइडेंटिटी "डिवाइस पर आधारित" है और यूज़र आईडी को इकट्ठा किया गया है, तो रिपोर्ट में यूज़र आईडी के आधार पर उपयोगकर्ताओं की डुप्लीकेट डुप्लीकेट कॉपी नहीं हटाई जाएंगी, लेकिन ऑडियंस एक्सपोर्ट यूज़र आईडी के आधार पर डुप्लीकेट कॉपी को हटा देंगी.
डेटा का सही तरीके से या सही समय पर बैकफ़िल न होना
Google Analytics में कोई ऑडियंस बनाने और Google Ads की रीमार्केटिंग सुविधा को चालू करने पर, Google Analytics हाल ही में जोड़े गए सदस्यों के साथ उस ऑडियंस के डेटा को Google Ads में बैकफ़िल करता है. हालांकि, Google Analytics की रिपोर्ट और ऑडियंस एक्सपोर्ट में, उन उपयोगकर्ताओं का डेटा शामिल नहीं किया जाता जिन्हें बैकफ़िल करने से पहले ऑडियंस में जोड़ा गया था. रिपोर्ट और ऑडियंस एक्सपोर्ट के लिए ऑडियंस बनाए जाने के बाद, उपयोगकर्ता को किसी इवेंट को लॉग करना होगा, ताकि उसका डेटा उस ऑडियंस में दिख सके.
उदाहरण के लिए, अगर कोई उपयोगकर्ता 20 जून को खरीदारी का इवेंट लॉग करता है और 21 जून को "खरीदार" ऑडियंस बनाई जाती है, तो हो सकता है कि आपको उस उपयोगकर्ता को नई ऑडियंस एक्सपोर्ट में देखने के लिए 22 जून तक का इंतज़ार करना पड़े. हालांकि, वह उपयोगकर्ता ऑडियंस एक्सपोर्ट में सिर्फ़ तब शामिल होगा, जब उपयोगकर्ता ने 21 जून को कोई इवेंट लॉग किया हो.