Adobe Flash के लिए Google Analytics ट्रैकिंग

Adobe Flash कॉम्पोनेंट के लिए Google Analytics ट्रैकिंग, आपके लिए, Flash-आधारित कॉन्टेंट में Google Analytics को आसानी से लागू कर सकती है. Adobe Systems, Inc. के बनाए गए इस कॉम्पोनेंट में, Google Analytics के JavaScript कोड की सभी सुविधाएं शामिल हैं. फ़्लैश ट्रैकिंग कॉम्पोनेंट, एक कंपाइलर ट्रैकिंग ऑब्जेक्ट है, जो Actions 3 का है. इसकी वजह से, Analytics को Flash और Flex के डेवलपमेंट एनवायरमेंट में आसानी से लागू किया जा सकता है.

फ़्लैश ट्रैकिंग का इस्तेमाल क्यों करें?

Adobe Flash कॉम्पोनेंट के लिए Google Analytics ट्रैकिंग के बिना, Google Analytics के साथ Adobe Flash कॉन्टेंट को ट्रैक करने में कई तकनीकी रुकावटें आती हैं. सबसे पहले आपको ga.js के लिए एक कस्टम इंटरफ़ेस डेवलप करना होगा, ताकि आपका Flash ऐप्लिकेशन Analytics का सही तरीका, जैसे कि trackPageview() या trackEvent() चला सके. इसके अलावा, आपको यह भी अनुमान लगाना होगा कि आपकी Flash सामग्री को ब्राउज़र के दस्तावेज़ ऑब्जेक्ट मॉडल (DOM) तक ऐक्सेस मिलेगा या नहीं, क्योंकि उन ऑब्जेक्ट की ट्रैकिंग नहीं हो पाती है जहां DOM को ऐक्सेस नहीं किया जाता. आम तौर पर, जब आपकी सामग्री तीसरे पक्ष की साइटों पर मौजूद होती है. इसमें यह समझना शामिल है कि ब्राउज़र DOM को ऐक्सेस करने के लिए ActionScript 3 में ExternalInterface कॉल का इस्तेमाल कैसे करें और ऐक्सेस अस्वीकार किए जाने पर डिग्रेड कैसे करें.

Adobe Flash के लिए Google Analytics घटक आपकी Flash सामग्री को ट्रैक करने की प्रक्रिया को सरल बना देता है तथा DOM पहुंच को आसानी से प्रबंधित कर लेता है. यह Flash में कई सामान्य ट्रैकिंग उद्देश्यों के लिए उपयोगी है, जैसे: :

किसी HTML पृष्ठ पर एक एम्बेड किया गया Flash विजेट
कोई Flex एप्लिकेशन या किसी HTML पृष्ठ पर होस्ट की गई केवल-Flash साइट
कोई वितरित Flex/Flash खेल या प्रोग्राम, जहां डेवलपर का इस पर नियंत्रण नहीं होता कि विजेट कहां रखा जाएगा

ध्यान रखें कि Flash में ट्रैकिंग ऐप्लिकेशन में वेबसाइट के पेजों को ट्रैक करने के तरीके में कुछ अंतर होते हैं. इस प्लग-इन के काम करने के तरीके को समझने के लिए, आपको Analytics ट्रैकिंग की जानकारी होना ज़रूरी है. इस कॉम्पोनेंट के लिए Analytics ट्रैकिंग मॉडल को कैसे पोर्ट किया गया है, इस बारे में ज़्यादा जानकारी के लिए इस प्रोजेक्ट का डिज़ाइन दस्तावेज़ भी देखा जा सकता है.

ध्यान दें: फ़िलहाल, फ़्लैश ट्रैकिंग की सुविधा किसी वेब पेज में एम्बेड किए गए किसी भी Flash कॉन्टेंट के लिए उपलब्ध है. फ़िलहाल, Adobe Air, Shockwave या Flash IDE के ज़रिए (उदाहरण के लिए, टेस्ट मूवी का इस्तेमाल करके) भेजे गए डेटा को ट्रैक करने की सुविधा उपलब्ध नहीं है.

साथ काम करने वाले डेवलपमेंट एनवायरमेंट

Flash के लिए Analytics ट्रैकिंग को Adobe Flash या Adobe Flex एनवायरमेंट में डेवलप किया जा सकता है. हर एनवायरमेंट के लिए एक अलग कॉम्पोनेंट की ज़रूरत होती है, जिसे http://code.google.com/p/gaforflash/ से डाउनलोड किया जा सकता है. ये कॉम्पोनेंट ActionScript 3 पर आधारित हैं और इन्हें हर एनवायरमेंट के लिए दो में से किसी एक तरीके से सेट अप किया जा सकता है:

Adobe Flash में

कॉम्पोनेंट इंस्पेक्टर में कोई सामान्य कॉम्पोनेंट जोड़ें और कॉन्फ़िगर करें. इसके बाद, उसे खींचकर स्टेज तक छोड़ें.
फ़्लैश ट्रैकिंग लाइब्रेरी को सीधे अपनी लाइब्रेरी में इंपोर्ट करें और कोडिंग शुरू करें.

Adobe Flex पर

वह MXML कॉम्पोनेंट शामिल करें जिसे आपने AM MXML फ़ाइल से कॉन्फ़िगर किया है.
अपने स्क्रिप्ट टैग/AS3 फ़ाइलों में Flash ट्रैकिंग लाइब्रेरी इंपोर्ट करें.

वापस सबसे ऊपर जाएं

यह कॉम्पोनेंट कैसे काम करता है?

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

वेब प्रॉपर्टी आईडी—इसे आपके ट्रैकिंग कोड का UA नंबर भी कहा जाता है. यह UA-xxxxx-yy जैसा दिखता है. इसमें x और y को उस ऑब्जेक्ट की नंबर और व्यू (प्रोफ़ाइल) जानकारी से बदल दिया जाता है जिसे आप ट्रैक कर रहे हैं. ज़्यादा जानकारी के लिए वेब प्रॉपर्टी देखें.
ट्रैकिंग मोड—ब्रिज मोड या AS3 मोड चुनें. यह मोड तय करता है कि आपकी ट्रैकिंग, Analytics सर्वर से कैसे संपर्क करेगी. इसके बारे में नीचे ज़्यादा जानकारी दी गई है.
डीबग मोड—चाहे आप किसी भी एनवायरमेंट या ट्रैकिंग मोड का इस्तेमाल करें, अपनी ट्रैकिंग की पुष्टि करने और उसकी जांच करने के लिए, डीबग करने की सुविधा चालू की जा सकती है.

ट्रैकिंग मोड

आपके Flash सामग्री को किस तरह से डिस्ट्रिब्यूट किया जाता है, इसके आधार पर 'फ़्लैश के लिए Analytics' कॉम्पोनेंट, Analytics सर्वर को डेटा इकट्ठा करता है. ऐसा, किसी मौजूदा Analytics ट्रैकिंग इंस्टॉलेशन पर, Flash कॉन्टेंट के बीच कम्यूनिकेशन को जोड़कर किया जाता है. इसके अलावा, सीधे Analytics सर्वर से संपर्क करके भी ऐसा किया जा सकता है. इन दो मोड को क्रम से ब्रिज मोड और AS3 मोड कहा जाता है. दोनों मोड में एक ही Analytics ट्रैकिंग सुविधा का इस्तेमाल होता है. साथ ही, फ़्लैश ऐप्लिकेशन को एक से दूसरे मोड में स्विच करना आसान है. Analytics ट्रैकिंग के लिए कम्यूनिकेशन मोड चुनने के अलावा, ट्रैकिंग से जुड़ी समस्या हल करने या उसकी पुष्टि करने के लिए भी डीबग मोड का इस्तेमाल किया जा सकता है.

कैंपेन ट्रैकिंग काम कर सके, इसके लिए दोनों ही मोड में allowscriptaccess की वैल्यू always होनी चाहिए. यह पैरामीटर पेज के यूआरएल को पढ़ने का ऐक्सेस और Flash ट्रैकिंग कोड के लिए ज़रूरी रेफ़रर जानकारी को चालू करता है. allowscriptaccess के बिना, Analytics ट्रैकिंग कोड ग्रेसफ़ुल तरीके से डिग्रेड हो जाता है. इससे अब भी ज़्यादातर उपयोगकर्ता गतिविधि का डेटा मिलता है, लेकिन Google Analytics कैंपेन के एट्रिब्यूशन मॉडल की पुष्टि नहीं की जाएगी.

ब्रिज मोड

अगर आपके पास एचटीएमएल पेज और फ़्लैश कॉन्टेंट, दोनों को कंट्रोल करने का विकल्प है, तो इस मोड का इस्तेमाल करें. अगर आपने अपनी वेबसाइट पर पहले ही Google Analytics (ga.js) ट्रैकिंग लागू कर ली है और एम्बेड किए गए Flash कॉन्टेंट में ट्रैकिंग जोड़नी है, तो यह मोड सबसे अच्छा रहेगा. ब्रिज मोड, ga.js कोड के लिए यूनिफ़ाइड ActionScript 3 इंटरफ़ेस उपलब्ध करवाकर, फ़्लैश-टू-JavaScript कम्यूनिकेशन को आसान बनाता है. ट्रैकिंग को सही तरीके से काम करने के लिए, यह ActionScript 3 कॉल से Analytics JavaScript को कनेक्शन उपलब्ध कराता है.

वेब प्रॉपर्टी आईडी पैरामीटर से Google Analytics ट्रैकिंग कोड से कनेक्शन को इन दो में से किसी एक तरीके से कॉन्फ़िगर किया जा सकता है:

सबसे ज़्यादा इस्तेमाल किया जाने वाला तरीका. Google Analytics ट्रैकिंग कोड ऑब्जेक्ट, आपके पेज पर पहले से ही अपने नाम के साथ मौजूद है, जैसे कि pageTracker. इस मामले में, आप ट्रैकिंग ऑब्जेक्ट का पूरा DOM रेफ़रंस देते हैं. उदाहरण के लिए, अगर आपके ऑब्जेक्ट को pageTracker कहा जाता है, तो आपको अपने कोड में उस ऑब्जेक्ट को window.pageTracker के रूप में बताना होगा. उदाहरण के लिए, नीचे दिया गया कोड स्निपेट दिखाता है कि इसे ActionScript 3 के साथ Adobe Flex एनवायरमेंट का इस्तेमाल करके कॉन्फ़िगर किया जाएगा:
```
tracker = new GATracker( this, "window.pageTracker", "Bridge", false );
```
कोई दूसरा तरीका. अगर आपने अपने पेज पर कोई पेज ट्रैकिंग ऑब्जेक्ट नहीं बनाया है, तो बस अपनी वेब प्रॉपर्टी आईडी पास करें. इसके बाद, आपके लिए एक JavaScript ट्रैकिंग कोड ऑब्जेक्ट बनाया जाएगा. इस तरीके का इस्तेमाल करने के बाद, आपके एचटीएमएल पेज पर बेस ga.js JavaScript सोर्स फ़ाइल का रेफ़रंस देना ज़रूरी है. नीचे दिया गया कोड स्निपेट दिखाता है कि इसे Actions 3 के साथ Adobe Flex एनवायरमेंट का इस्तेमाल करके कैसे कॉन्फ़िगर किया जाएगा:
```
tracker = new GATracker( this, "UA-12345-22", "Bridge", false );
```

ब्रिज मोड के ठीक से काम करने के लिए, आपके ActionScript 3 कोड में ExternalInterface.available को सही पर सेट होना चाहिए. इसका मतलब यह भी है कि allowScriptAccess को उस एचटीएमएल पेज में always पर सेट किया जाना चाहिए जिस पर Flash कॉन्टेंट एम्बेड किया गया है. नीचे दिए गए उदाहरण में, ब्रिज मोड के लिए कॉन्फ़िगर किए गए एचटीएमएल कोड को दिखाया गया है:

<object classid="clsid:D27CDB6E-AE6D-11cf-96B8-444553540000"
     id="flex_component" width="800" height="600"
     codebase="http://fpdownload.macromedia.com/get/flashplayer/current/swflash.cab">
     <param name="movie" value="flex_component.swf" />
     <param name="quality" value="high" />
     <param name="bgcolor" value="#869ca7" />
     <param name="allowScriptAccess" value="always" />
     <embed src="flex_component.swf" quality="high" bgcolor="#869ca7"
         width="800" height="600" name="flex_component" align="middle"
         play="true"
         loop="false"
         quality="high"
         allowScriptAccess="always"
         type="application/x-shockwave-flash"
         pluginspage="http://www.adobe.com/go/getflashplayer">
      </embed>
</object>

वापस सबसे ऊपर जाएं

AS3 मोड

अगर आपके पास Adobe Flash ActionScript 3 कोड है, लेकिन आपके पास अपने Adobe Flash ऐप्लिकेशन के होस्टिंग एनवायरमेंट को कंट्रोल नहीं है, तो इस मोड का इस्तेमाल करें. उदाहरण के लिए, अगर कई साइटों में डिस्ट्रिब्यूशन के लिए फ़्लैश कॉन्टेंट डेवलप किया जा रहा है, तो आपको AS3 मोड का इस्तेमाल करना होगा. AS3 मोड, ga.js ट्रैकिंग कोड से पूरी तरह अलग है और इसमें Analytics की सभी ट्रैकिंग से जुड़ी सुविधाएं शामिल हैं. इस मोड का इस्तेमाल करने पर, अलग से ga.js ट्रैकिंग इंस्टॉल करने की ज़रूरत नहीं है. इसके अलावा, AS3 मोड उपयोगकर्ता की सेशन जानकारी ट्रैक करने के लिए फ़्लैश स्टोरेज मैकेनिज़्म का इस्तेमाल करता है.

भाषा जैसे कुछ डीओएम पैरामीटर के लिए, AS3 कॉम्पोनेंट ब्राउज़र से वैल्यू पाने की कोशिश करता है. अगर वैल्यू मौजूद नहीं हैं, तो कॉम्पोनेंट फ़्लैश के बराबर वैल्यू का इस्तेमाल करता है या डिफ़ॉल्ट रूप से no का इस्तेमाल करता है.

समस्या का हल और पुष्टि करना

Adobe Flash कॉम्पोनेंट के लिए Google Analytics ट्रैकिंग, डीबग मोड उपलब्ध कराती है. इसकी मदद से, पुष्टि करना और समस्या हल करना आसान हो जाता है. इस सेटिंग के चालू होने पर, पूरा ट्रैकिंग डेटा रोक दिया जाता है और उसे Analytics के सर्वर के बजाय, टेक्स्ट बॉक्स में मौजूद स्क्रीन पर भेज दिया जाता है. इस मोड में, आपको रीयल-टाइम में डेटा देखने का विकल्प मिलेगा. ऐसा न होने पर, सर्वर की मदद से इकट्ठा किया जाने वाला डेटा इकट्ठा किया जा सकेगा. इस सुविधा की मदद से, टेस्ट डेटा को प्रोडक्शन डेटा के बाहर रखा जा सकता है. कॉम्पोनेंट की जांच करने वाले टूल में, visualDebug विकल्प को true पर सेट करके, समस्या हल करने की सुविधा चालू की जा सकती है.

उदाहरण

अलग-अलग डेवलपमेंट एनवायरमेंट में ट्रैकिंग लागू करने से जुड़े ज़्यादा उदाहरणों के लिए, यहां दी गई जानकारी देखें:

फ़्लैश

Flex

वर्शन

ट्रैकिंग कॉम्पोनेंट के सबसे नए वर्शन को ZIP फ़ाइल के तौर पर, http://code.google.com/p/gaforflash/downloads/list पर जाकर देखा जा सकता है. हर डाउनलोड में सभी ट्रैकिंग कॉम्पोनेंट के साथ-साथ उनसे जुड़े दस्तावेज़ शामिल होते हैं. डाउनलोड की गई फ़ाइल के नाम में, उसमें शामिल कोड का वर्शन नंबर दिखेगा.

कॉम्पोनेंट की मौजूदा वर्शन संख्या को आउटपुट कंसोल में प्रिंट करने के लिए, अपने कोड में यहां दिए गए स्टेटमेंट का भी इस्तेमाल किया जा सकता है.

import com.google.analytics.API;
trace(API.version);

वापस सबसे ऊपर जाएं