راه اندازی Adobe Flex

این سند همه چیزهایی را که برای راه‌اندازی Google Analytics Tracking برای Adobe Flash برای محیط توسعه Adobe Flex باید بدانید را پوشش می‌دهد.

کتابخانه ردیابی را دریافت کنید

کد (فرمت Zip) را از http://code.google.com/p/gaforflash/downloads/list دانلود کنید. دستورالعمل های موجود در فایل readme.txt را برای نصب کامپوننت Flex دنبال کنید. برخلاف اجزای Analytics Flash، تنها یک فایل کتابخانه در دانلود وجود دارد: /lib/analytics_flex.swc .

کد را به پروژه خود اضافه کنید

قبل از اینکه بتوانید از کد رهگیری در پروژه خود استفاده کنید، باید فایل SWC را که به عنوان منبع پروژه دانلود کرده اید پیوند دهید.

1. Project->Properties را انتخاب کنید. یک کادر محاوره ای Properties برای پروژه شما ظاهر می شود.
2. روی Flex Build Path کلیک کنید و تب Library Path را انتخاب کنید.
3. روی Add SWC... در قسمت Library Path کلیک کنید. یک کادر محاوره ای افزودن SWC ظاهر می شود.
4. به مکانی که API Google Analytics را از حالت فشرده خارج کردید بروید و فایل lib/analytics.swc را انتخاب کنید و روی OK کلیک کنید.
   یا فقط فایل analytics.swc را در پوشه پروژه Flex /libs خود رها کنید.

بازگشت به بالا

مثال کامپوننت Flex MXML

مثال زیر نحوه تنظیم ردیابی یک دکمه در یک فایل MXML را نشان می دهد. برای مقداردهی اولیه کامپوننت MXML، موارد زیر را انجام دهید:

• پارامتر فضای نام XML را تنظیم کنید . پارامتر فضای نام XML شی ردیابی خود را به صورت زیر تنظیم کنید: xmlns:analytics="com.google.analytics.components.*"
• نام شی را تنظیم کنید . در مثال زیر، پارامتر id روی tracker تنظیم شده است.
• از پارامتر account برای شناسه دارایی وب استفاده کنید . شناسه ویژگی وب رشته منحصر به فردی است که برای ردیابی فعالیت در محتوای Flash شما و ارائه آن به نمای (نمایه) صحیح در حساب Analytics شما استفاده می شود.
• حالت ردیابی را با پارامتر mode تنظیم کنید . اگر در حال ایجاد یک فایل MXML هستید و می خواهید یک راه ساده برای پیاده سازی ردیابی داشته باشید، از Bridge برای پارامتر استفاده کنید. اگر با استفاده از ActionScript3 راحت هستید از 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 ActionScript 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>

بازگشت به بالا