הגדרת Adobe Flex

מסמך זה מפרט את כל מה שעליך לדעת כדי להגדיר מעקב של Google Analytics עבור Adobe Flash עבור סביבת הפיתוח של Adobe Flex.

הורדה של ספריית המעקב

מורידים את הקוד (בפורמט מיקוד) מהכתובת http://code.google.com/p/gaforflash/downloads/list. יש לפעול לפי ההוראות שבקובץ readme.txt כדי להתקין את רכיב ה-Flex. בשונה מרכיבי ה-Flash של Analytics, בהורדה יש רק קובץ ספרייה אחד: /lib/analytics_flex.swc.

הוספת הקוד לפרויקט

לפני שתוכלו להתחיל להשתמש בקוד המעקב בפרויקט, עליכם לקשר את הקובץ SWC שהורדתם כמשאב של הפרויקט.

1. בוחרים Project->Properties. מופיעה תיבת דו-שיח 'מאפיינים' עבור הפרויקט שלכם.
2. לוחצים על Flex Build Path ובוחרים בכרטיסייה Library Path.
3. לוחצים על Add SWC... בחלונית נתיב הספרייה. מופיעה תיבת הדו-שיח הוספת SWC.
4. עוברים למיקום שבו חילצתם את ה-API של Google Analytics, בוחרים את הקובץ lib/analytics.swc ולוחצים על אישור.
   לחלופין, משחררים את הקובץ analytics.swc בספרייה /libs של פרויקט ה-Flex.

חזרה למעלה

דוגמה לרכיב Flex MXML

הדוגמה הבאה מראה איך להגדיר מעקב ללחצן בתוך קובץ MXML. כדי לאתחל את רכיב ה-MXML, יש לבצע את הפעולות הבאות:

• מגדירים את פרמטר מרחב השמות של XML. מגדירים את פרמטר מרחב השמות של XML של אובייקט המעקב באופן הבא: xmlns:analytics="com.google.analytics.components.*"
• מגדירים את שם האובייקט. בדוגמה הבאה הפרמטר id מוגדר ל-tracker.
• משתמשים בפרמטר account עבור מזהה נכס האינטרנט. מזהה נכס האינטרנט הוא המחרוזת הייחודית המשמשת למעקב אחר פעילות בתוכן ה-Flash שלך ולהעברתה לתצוגה (פרופיל) הנכונה בחשבון Analytics שלך.
• מגדירים את מצב המעקב עם הפרמטר mode. אם אתם יוצרים קובץ MXML ורוצים להטמיע מעקב באופן פשוט, השתמשו ב-Bridge. השתמש ב-AS3 אם אתה מתמצא בתכנות באמצעות ActionScript3. מצב AS3 מאפשר לייבא את כל סיווגי המעקב של Google Analytics, שמהם תוכל ליצור ולהגדיר אובייקטים משלך למעקב.
• מגדירים את מצב ניפוי הבאגים עם הפרמטר 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, שמייצר את אובייקט המעקב. ארבעת הפרמטרים הנדרשים כדי ליצור אובייקט GAMonitor הם:

• הפניה לאובייקט התצוגה הנוכחי. בדוגמה הבאה, 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>

חזרה למעלה