Adobe Flash का सेटअप

इस दस्तावेज़ में Adobe Flash डेवलपमेंट एनवायरमेंट के लिए Adobe Flash के लिए Google Analytics ट्रैकिंग सेट अप करने से जुड़ी सभी ज़रूरी जानकारी दी गई है.

कॉम्पोनेंट फ़ाइलें पाएं

फ़्लैश ट्रैकिंग कॉम्पोनेंट वाली फ़ाइलों को एक ZIP फ़ाइल में कंप्रेस किया जाता है. इसे http://code.google.com/p/gaforflash/downloads/list से डाउनलोड किया जा सकता है.

Flash कॉम्पोनेंट इंस्टॉल करने के लिए, readme.txt फ़ाइल में दिए गए निर्देशों का पालन करें.

1. यदि आपके पास अभी Adobe Flash CS3 खुला है, तो ऐप्लिकेशन से बाहर निकलें.
2. यहां दी गई जगहों में से किसी एक में Google डायरेक्ट्री बनाएं:
   • Windows के लिए: C:\Program Files\Adobe\ Adobe Flash CS3\language\Configuration\Components
   • Mac OS X के लिए: Macintosh HD/Applications/Adobe Flash CS3/Configuration/Components
3. उस जगह पर जाएं जहां आपने कॉम्पोनेंट ZIP फ़ाइल को अनज़िप किया था. इसके बाद, इन फ़ाइलों को पिछले चरण में बनाई गई डायरेक्ट्री में कॉपी करें:
   • lib/analytics_flash.swc — Analytics कॉम्पोनेंट
   • lib/analytics.swc — Analytics लाइब्रेरी कॉम्पोनेंट

दोनों कॉम्पोनेंट की सुविधाएं एक जैसी होती हैं. हालांकि, इन्हें अलग-अलग डेवलपमेंट स्टाइल के लिए उपलब्ध कराया जाता है.

Analytics कॉम्पोनेंट. अगर आपने Flash कॉन्टेंट बनाया है, लेकिन आपको Actions 3 के बारे में नहीं पता है, तो इस कॉम्पोनेंट का इस्तेमाल करें. Analytics कॉम्पोनेंट एक पूरा ट्रैकिंग पैकेज है. बस कॉम्पोनेंट को सीधे अपने स्टेज पर खींचें और छोड़ें, कॉम्पोनेंट इंस्पेक्टर में कुछ आसान कॉन्फ़िगरेशन करें, और अब आप Analytics ट्रैकिंग के साथ अपने कंट्रोल टैग करने के लिए तैयार हैं.

AnalyticsLibrary कॉम्पोनेंट. अगर आप Actions 3 के बारे में जानते हैं, तो आप AnalyticLibrary कॉम्पोनेंट का इस्तेमाल कर सकते हैं. घटक को अपनी Flash लाइब्रेरी में खींचें और ट्रैकिंग क्लास को सीधे अपने ActionScript कोड में आयात करें.

Analytics कॉम्पोनेंट का इस्तेमाल करना

Analytics कॉम्पोनेंट के ज़रिए ट्रैकिंग लागू करने के लिए, analytics_flash.swc का इस्तेमाल करें. कॉम्पोनेंट को सही कॉम्पोनेंट डायरेक्ट्री में रखें और यह कॉम्पोनेंट पैनल (विंडो - कॉम्पोनेंट) में दिखे.

1. कॉम्पोनेंट को स्टेज तक खींचें और छोड़ें और प्रॉपर्टी डायलॉग में उसे एक इंस्टेंस नाम दें.
2. कॉम्पोनेंट इंस्पेक्टर पैनल में कॉम्पोनेंट कॉन्फ़िगर करें (Windows - कॉम्पोनेंट इंस्पेक्टर):
   • अपना Analytics वेब प्रॉपर्टी आईडी जोड़ें.
   • ब्रिज मोड या AS3 मोड चुनें.
   • बताएं कि विज़ुअल डीबग की सुविधा चालू है या बंद.
3. अपने Actions कोड में, अभी-अभी बनाए गए घटक के इंस्टेंस में मानक GA ट्रैकिंग कॉल जोड़ें.

Flash के विज़ुअल कॉम्पोनेंट के साथ काम करने के तरीके की वजह से, आम तौर पर अपने Flash ऐप्लिकेशन के दूसरे फ़्रेम से ट्रैक करना सबसे अच्छा होता है. अगर आपको पहले फ़्रेम में ट्रैकिंग शुरू करनी है, तो ट्रैकिंग कॉल को इवेंट हैंडलर के अंदर रखें, ताकि यह पक्का हो सके कि कॉम्पोनेंट फ़्लैश कॉन्टेंट में पूरी तरह से शुरू किया गया है.

Analytics के फ़्लैश कॉम्पोनेंट का एक सामान्य उदाहरण

नीचे दिया गया कोड स्निपेट दिखाता है कि जब कोई व्यक्ति किसी बटन पर क्लिक करता है, तो Flash में मौजूद बटन को कैसे ट्रैक किया जा सकता है. इस उदाहरण में, आपके ActionScript में बटन इंस्टेंस का नाम playGame है. जब बटन पर क्लिक किया जाता है, तो onButtonClick तरीके को कॉल किया जाता है. इससे trackPageview() तरीके को शुरू किया जाता है. इससे वर्चुअल पेज /myGame1 के लिए पेज व्यू की संख्या बढ़ जाती है.

playGame.addEventListener( MouseEvent.CLICK, onButtonClick );
function onButtonClick( event:Event ):void
{
  tracker.trackPageview( "/myGame1");
} 

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

AnalyticsLibrary कॉम्पोनेंट का इस्तेमाल करना

AnalyticsLibrary कॉम्पोनेंट के ज़रिए ट्रैकिंग लागू करने के लिए, analytics.swc फ़ाइल का इस्तेमाल करें. इस कॉम्पोनेंट की मदद से, ट्रैकिंग ऑब्जेक्ट को सीधे अपने AS3 कोड में इंस्टैंशिएट किया जा सकता है. AnalyticsLibrary कॉम्पोनेंट के सही जगह पर होने पर, वह कॉम्पोनेंट पैनल में दिखने लगता है. इसके बाद आप घटक पैनल से घटक को अपनी लाइब्रेरी में खींच सकते हैं और वहां से लाइब्रेरी को अपने ActionScript कोड में आयात कर सकते हैं.

ट्रैकिंग ऑब्जेक्ट को शुरू करें

Adobe Flash एनवायरमेंट का इस्तेमाल करके, ट्रैकिंग ऑब्जेक्ट को नीचे दिए गए पैरामीटर के साथ शुरू करें:

• मौजूदा डिसप्ले ऑब्जेक्ट का रेफ़रंस दें. नीचे दिए गए उदाहरण में, this, डिसप्ले ऑब्जेक्ट का रेफ़रंस देता है.
• वेब प्रॉपर्टी आईडी. वेब प्रॉपर्टी आईडी एक अनन्य स्ट्रिंग होती है, जिसका उपयोग आपके Flash कॉन्टेंट से जुड़ी गतिविधि ट्रैक करने के साथ-साथ उसे आपके Analytics खाते में सही व्यू (प्रोफ़ाइल) पर दिखाने के लिए किया जाता है.
• ट्रैकिंग मोड. मान्य पैरामीटर Bridge या AS3 हैं.
• डीबग मोड. प्रोडक्शन में इस्तेमाल के लिए, debug को false पर और पुष्टि और समस्या हल करने के लिए, को true पर सेट करें.

Analytics की लाइब्रेरी का आसान उदाहरण

नीचे दिए गए उदाहरण में, playGame नाम की एक मूवी क्लिप स्टेज पर मौजूद है. इवेंट हैंडलर के साथ tracker नाम का एक नया ट्रैकिंग ऑब्जेक्ट बनाया जाता है, जो माउस क्लिक की जानकारी देता है. जब बटन पर क्लिक किया जाता है, तो onButtonClick फ़ंक्शन कॉल किया जाता है. हर क्लिक के लिए, trackPageview() तरीका वर्चुअल पेज /myGame1 के पेज व्यू की संख्या को बढ़ा देता है.

import com.google.analytics.AnalyticsTracker;
import com.google.analytics.GATracker;
var tracker:AnalyticsTracker = new GATracker( this, "UA-111-222", "AS3", true );
playGame.addEventListener( MouseEvent.CLICK, onButtonClick );
function onButtonClick ( event:Event ):void
{
   tracker.trackPageview("/myGame1");
} 

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