इस माइग्रेशन गाइड में, SDK टूल के वर्शन 2 में नया क्या है. साथ ही, इसमें डेवलपर को v1.x को लागू करने की सुविधा से माइग्रेट करने के बारे में सलाह दी गई है. जिन डेवलपर को v1.x लागू करने की प्रक्रिया से माइग्रेट करने की ज़रूरत नहीं है वे अब वर्शन 2 से शुरू कर सकते हैं.
शुरुआती जानकारी
Google Analytics ने हाल ही में Android के लिए अपडेट किया गया Google Analytics SDK टूल रिलीज़ किया है. SDK टूल के दूसरे वर्शन में, नई सुविधाओं के साथ-साथ ऐप्लिकेशन डेवलपर के लिए खास तौर पर डिज़ाइन किया गया नया रिपोर्टिंग इंटरफ़ेस शामिल है.
हमारा सुझाव है कि नई सुविधाओं और रिपोर्ट का फ़ायदा पाने के लिए, सभी मौजूदा Google Analytics डेवलपर Android के लिए Google Analytics SDK के वर्शन 2 पर माइग्रेट करें.
वर्शन 2 में नया क्या है
Android के लिए Google Analytics SDK के वर्शन 2 में ऐप्लिकेशन डेवलपर के लिए डिज़ाइन किया गया नया रिपोर्टिंग अनुभव, असरदार नए डाइमेंशन और मेट्रिक, और भी बहुत कुछ पेश किया गया है. यहां बताया गया है कि वर्शन 2 में डेवलपर को क्या मिलता है:
- ऐप्लिकेशन डेवलपर के लिए ज़्यादा असरदार रिपोर्ट
- स्टैंडर्ड रिपोर्ट को ऐप्लिकेशन डेवलपर के लिए फिर से डिज़ाइन किया गया है. इनमें यूज़र ऐक्टिविटी फ़्लो और Google Play के सोर्स जैसी नई रिपोर्ट जोड़ी गई हैं. इनसे डेवलपर को उपयोगकर्ता हासिल करने और उसके अनुभव के बारे में नई अहम जानकारी पाने में मदद मिलेगी. वर्शन 2 के लिए, अपनी प्रॉपर्टी को सबसे सही तरीके से कॉन्फ़िगर करने के बारे में ज़्यादा जानने के लिए, खाते को कॉन्फ़िगर करने के सबसे सही तरीके लेख पढ़ें.
- ऐप्लिकेशन के नए डाइमेंशन और मेट्रिक
- SDK टूल के वर्शन 2 में, ऐप्लिकेशन के हिसाब से नए डाइमेंशन और मेट्रिक लॉन्च की गई हैं. इनमें स्क्रीन का नाम और स्क्रीन व्यू, ऐप्लिकेशन का नाम, ऐप्लिकेशन का वर्शन वगैरह शामिल है.
- क्रैश और अपवादों को मेज़र करना
- Android के लिए Google Analytics SDK टूल में, अपवाद के तौर पर मेज़रमेंट और अपवाद वाले हिट टाइप की सुविधा दी गई है. अपवाद मेज़रमेंट का इस्तेमाल करके, क्रैश की संख्या और टाइप और नुकसान न पहुंचाने वाले अपवादों को मेज़र किया जा सकता है. अपवाद के मेज़रमेंट को लागू करने का तरीका जानने के लिए, अपवादों के लिए उपलब्ध डेवलपर गाइड देखें.
- कस्टम डाइमेंशन और मेट्रिक
- नए तरीकों से अपने डेटा को सेगमेंट में बांटने के लिए कस्टम डाइमेंशन बनाएं. कस्टम डाइमेंशन और मेट्रिक के बारे में ज़्यादा जानें.
- सोशल मीडिया पर होने वाले इंटरैक्शन का आकलन करना
- एम्बेड किए गए सोशल प्लगिन और विजेट की मदद से उपयोगकर्ता इंटरैक्शन का आकलन करके, अपने ऐप्लिकेशन में सोशल मीडिया के महत्व के बारे में नई जानकारी पाएं. सोशल इंटरैक्शन को मेज़र करने के बारे में ज़्यादा जानें.
आरंभ करने से पहले
सभी डेवलपर को माइग्रेशन शुरू करने से पहले, ये दो चरण पूरे करने होंगे:
- Android v2 के लिए Google Analytics SDK टूल डाउनलोड करें
- एक ऐप्लिकेशन व्यू (प्रोफ़ाइल) बनाएं, जिसका इस्तेमाल करके, अपने ऐप्लिकेशन की नई रिपोर्ट और डेटा ऐक्सेस किया जा सके.
ऊपर दिए गए चरणों को पूरा करने के बाद, अपने माइग्रेशन पाथ के लिए नीचे दिया गया तरीका अपनाएं.
EasyTracker से माइग्रेट करना
अपने ऐप्लिकेशन को EasyTracker लाइब्रेरी के v1 से v2 में माइग्रेट करने के लिए, आपको ये तीन चरण पूरे करने होंगे:
- अपनी GoogleAnalytics.xml की संसाधन फ़ाइल में पैरामीटर अपडेट करना
- विकल्पों के नाम अपडेट करना
- अपने ब्रॉडकास्ट रिसीवर को अपडेट करना (Google Play कैंपेन ट्रैकिंग)
1. GoogleAnalytics.xml में पैरामीटर अपडेट करें
वर्शन 2 पर माइग्रेट करते समय, अपनी GoogleAnalytics.xml की संसाधन फ़ाइल में मौजूद पैरामीटर को अपडेट करें. ऐसा इसलिए, क्योंकि इनमें से कुछ v1.x के बाद से बदल गए हैं और वर्शन 2 में नए पैरामीटर जोड़े गए हैं.
नीचे दी गई टेबल में, वर्शन 2 में अपडेट किए गए पैरामीटर दिखाए गए हैं:
| v1.x पैरामीटर का नाम | v2.x पैरामीटर का नाम |
|---|---|
| ga_api_key | ga_trackingId |
| ga_auto_activity_tracking | ga_autoActivityTracking |
| ga_dryRun | बंद किया गया |
ज़्यादा जानने के लिए, नए और अपडेट किए गए EasyTracker पैरामीटर देखें.
2. तरीकों के नाम अपडेट करना
हालांकि, EasyTracker के वर्शन 2 में सिंटैक्स का ज़्यादातर हिस्सा एक जैसा ही रहता है, लेकिन तरीकों के नाम और सिंटैक्स में कुछ बड़े अंतर हैं. इनके लिए, आपको लागू करने की प्रोसेस को अपडेट करना होगा:
- वर्शन 2 में
trackPageView()की वैल्यूsendView()है. ज़्यादा जानकारी के लिए, स्क्रीन ट्रैकिंग डेवलपर गाइड देखें - ई-कॉमर्स लागू करने को आसान बना दिया गया है. वर्शन 2 में ई-कॉमर्स मेज़रमेंट लागू करने का तरीका जानें.
- कस्टम वैरिएबल की जगह कस्टम डाइमेंशन और मेट्रिक ने ले ली है. नई
सुविधा का फ़ायदा पाने के लिए,
setCustomVar()पर किए जाने वाले किसी भी कॉल को अपडेट करें. कस्टम डाइमेंशन और मेट्रिक को लागू करने का तरीका जानें.
3. ब्रॉडकास्ट पाने वाले को अपडेट करें (Google Play कैंपेन ट्रैकिंग)
जिन डेवलपर ने v1.x का इस्तेमाल करके Google Play कैंपेन ट्रैकिंग की सुविधा लागू की है उन्हें ध्यान देना चाहिए कि ऐप्लिकेशन पाने वाले का क्लास पाथ बदल गया है. ज़्यादा जानकारी के लिए, Google Play कैंपेन को ट्रैक करने से जुड़ी गाइड देखें.
कस्टम इंप्लीमेंटेशन से माइग्रेट करना
अगर आप Android के लिए Analytics SDK के v1.x में EasyTracker लाइब्रेरी का इस्तेमाल नहीं कर रहे थे, तो हमारा सुझाव है कि आप वर्शन 2 में EasyTracker का इस्तेमाल शुरू कर दें.
EasyTracker लाइब्रेरी को अब SDK टूल के साथ शामिल कर लिया गया है और सभी डेवलपर को इसका सुझाव दिया जाता है. Google Analytics SDK v2 में EasyTracker का इस्तेमाल शुरू करें.
अगर आपको डेटा कलेक्शन की बेहतर ज़रूरतें हैं, जैसे कि एक ही बार में कई प्रॉपर्टी आईडी इस्तेमाल करना, तो SDK टूल के v2.x की बेहतर सुविधाओं का इस्तेमाल करने के बारे में ज़्यादा जानने के लिए, बेहतर कॉन्फ़िगरेशन गाइड पढ़ें.