इस दस्तावेज़ में Adobe Flex के डेवलपमेंट एनवायरमेंट के लिए, Adobe Flash के लिए Google Analytics ट्रैकिंग सेट अप करने से जुड़ी ज़रूरी जानकारी दी गई है.
ट्रैकिंग लाइब्रेरी पाएं
http://code.google.com/p/gaforflash/downloads/list से कोड (ZIP फ़ॉर्मैट) डाउनलोड करें. Flex कॉम्पोनेंट इंस्टॉल करने के लिए, readme.txt
फ़ाइल में दिए गए निर्देशों का पालन करें. Analytics Flash कॉम्पोनेंट के उलट, डाउनलोड में सिर्फ़ एक लाइब्रेरी फ़ाइल मौजूद है: /lib/analytics_flex.swc
.
अपने प्रोजेक्ट में कोड जोड़ें
अपने प्रोजेक्ट में ट्रैकिंग कोड का इस्तेमाल शुरू करने से पहले, आपको प्रोजेक्ट संसाधन के तौर पर डाउनलोड की गई SWC
फ़ाइल लिंक करनी होगी.
- प्रोजेक्ट->प्रॉपर्टी चुनें. आपके प्रोजेक्ट के लिए एक प्रॉपर्टी डायलॉग बॉक्स दिखता है.
- Flex बिल्ड पाथ पर क्लिक करें और लाइब्रेरी पाथ टैब चुनें.
- लाइब्रेरी पाथ पैनल में, SWC जोड़ें... पर क्लिक करें. आपको एसडब्ल्यूसी जोड़ें डायलॉग बॉक्स दिखेगा.
- उस जगह पर जाएं जहां आपने Google Analytics API को अनज़िप किया था. इसके बाद,
lib/analytics.swc
फ़ाइल चुनकर ठीक है पर क्लिक करें.
इसके अलावा,analytics.swc
फ़ाइल को अपने Flex प्रोजेक्ट/libs
डायरेक्ट्री में छोड़ें.
फ़्लेक्स एमएक्सएमएल कॉम्पोनेंट का उदाहरण
नीचे दिए गए उदाहरण में, MXML फ़ाइल के अंदर मौजूद बटन के लिए ट्रैकिंग सेट अप करने का तरीका बताया गया है. MXML कॉम्पोनेंट को शुरू करने के लिए, ये काम करें:
- एक्सएमएल नेमस्पेस पैरामीटर सेट करें. अपने ट्रैकिंग ऑब्जेक्ट का एक्सएमएल नेमस्पेस पैरामीटर इस तरह सेट करें:
xmlns:analytics="com.google.analytics.components.*"
- ऑब्जेक्ट का नाम सेट करें. यहां दिए गए उदाहरण में,
id
पैरामीटर कोtracker
पर सेट किया गया है. - वेब प्रॉपर्टी आईडी के लिए
account
पैरामीटर का इस्तेमाल करें. वेब प्रॉपर्टी आईडी एक अनन्य स्ट्रिंग होती है, जिसका उपयोग आपके Flash कॉन्टेंट से जुड़ी गतिविधि ट्रैक करने के साथ-साथ उसे आपके Analytics खाते में सही व्यू (प्रोफ़ाइल) पर दिखाने के लिए किया जाता है. mode
पैरामीटर के साथ ट्रैकिंग मोड सेट करें. अगर एक MXML फ़ाइल बनाई जा रही है और आपको ट्रैकिंग को आसान तरीके से लागू करना है, तो पैरामीटर के लिएBridge
का इस्तेमाल करें. अगर आप Actions3 का इस्तेमाल करके कोडिंग करना आसान बनाते हैं, तोAS3
का इस्तेमाल करें. AS3 मोड की मदद से, सभी GA ट्रैकिंग क्लास को इंपोर्ट किया जा सकता है. इनकी मदद से, अपने ट्रैकिंग ऑब्जेक्ट बनाए और कॉन्फ़िगर किए जा सकते हैं.visualDebug
पैरामीटर का इस्तेमाल करके डीबग मोड सेट करें. अपने प्रोग्राम के लिए डीबग और पुष्टि करने की सुविधा चालू करने के लिए,true
का इस्तेमाल करें. अगर ऐसा नहीं है, तो प्रोडक्शन में इस्तेमाल के लिए इसेfalse
पर सेट करें.
उदाहरण में, स्टेज में mybutton
बटन जोड़ा गया है. Flex ट्रैकिंग कॉम्पोनेंट को tracker
नाम के साथ इंस्टैंशिएट किया जाता है और इसके पैरामीटर के साथ कॉन्फ़िगर किया जाता है. आखिर में, क्लिक इवेंट onButtonClick
को mybutton
में जोड़ा गया. जब बटन पर क्लिक किया जाता है, तो वर्चुअल पेज व्यू /hello world
की संख्या एक सिंगल के साथ बढ़ जाती है.
<?xml version="1.0" encoding="utf-8"?> <mx:Application xmlns:mx="http://www.adobe.com/2006/mxml" layout="absolute" width="800" height="600" > <mx:Script> public function onButtonClick():void { tracker.trackPageview( "/hello world" ); } </mx:Script> <analytics:FlexTracker xmlns:analytics="com.google.analytics.components.*" id="tracker" account="UA-111-222" mode="AS3" visualDebug="false" /> <mx:Button id="mybutton" label="hello world" click="onButtonClick()" /> </mx:Application>
Flex Actions 3 का उदाहरण
ज़्यादा जटिल परिस्थितियों में, हो सकता है कि आप मूल ActionScript 3 ट्रैकिंग क्लास को सीधे अपनी ActionScript संसाधन फ़ाइलों से कॉल करना चाहें. हालांकि, यह उदाहरण एक MXML फ़ाइल भी है, लेकिन सभी ट्रैकिंग इंस्टैंशिएट, <MX:script>
टैग में ही की जाती हैं. इसी प्रक्रिया का इस्तेमाल अन्य ActionScript 3 प्रोजेक्ट में ट्रैकिंग जोड़ने के लिए किया जा सकता है.
इस उदाहरण में, स्टेज में mybutton
बटन जोड़ा गया है. स्क्रिप्ट टैग में, दो लाइब्रेरी इंपोर्ट की जाती हैं:
com.google.analytics.GATracker; //this is the actual tracking class com.google.analytics.AnalyticsTracker; //this is an interface that the GATracker class implements
लाइब्रेरी इंपोर्ट होने के बाद, ट्रैकिंग वैरिएबल tracker
बनाया जाता है. ऐप्लिकेशन को स्टेज में जोड़ने के बाद, onComplete
को कॉल किया जाता है, जो ट्रैकिंग ऑब्जेक्ट को इंस्टैंशिएट करता है. GATracker ऑब्जेक्ट को इंस्टैंशिएट करने के लिए, आपको इन चार पैरामीटर की ज़रूरत होगी:
- मौजूदा डिसप्ले ऑब्जेक्ट का रेफ़रंस दें. नीचे दिए गए उदाहरण में,
this
, डिसप्ले ऑब्जेक्ट का रेफ़रंस देता है. - वेब प्रॉपर्टी आईडी. वेब प्रॉपर्टी आईडी एक अनन्य स्ट्रिंग होती है, जिसका उपयोग आपके Flash कॉन्टेंट से जुड़ी गतिविधि ट्रैक करने के साथ-साथ उसे आपके Analytics खाते में सही व्यू (प्रोफ़ाइल) पर दिखाने के लिए किया जाता है.
- ट्रैकिंग मोड. मान्य पैरामीटर
Bridge
याAS3
हैं. - डीबग मोड. प्रोडक्शन में इस्तेमाल के लिए,
debug
कोfalse
पर और पुष्टि और समस्या हल करने के लिए, कोtrue
पर सेट करें.
आखिर में, myButton
क्लिक तरीके में onButtonClick
फ़ंक्शन, हमारे ट्रैकिंग ऑब्जेक्ट पर वर्चुअल पेज व्यू को ट्रैक करता है.
इस ऐप्लिकेशन के चलने पर, जब भी कोई उपयोगकर्ता इस बटन पर क्लिक करता है, तब Google Analytics ट्रैकिंग सर्वर को "नमस्ते दुनिया" का वर्चुअल पेज व्यू भेजा जाता है.
<?xml version="1.0" encoding="utf-8"?> <mx:Application xmlns:mx="http://www.adobe.com/2006/mxml" layout="absolute" width="800" height="600" addedToStage="onComplete()" > <mx:Script> <![CDATA[ import com.google.analytics.GATracker; import com.google.analytics.AnalyticsTracker; public var tracker:AnalyticsTracker; private function onComplete():void { tracker = new GATracker( this, "UA-111-222", "AS3", false ); } public function onButtonClick():void { tracker.trackPageview( "/hello/world" ); } ]]> </mx:Script> <mx:Button id="mybutton" label="hello world" click="onButtonClick()" /> </mx:Application>