מסמך זה מפרט את כל מה שעליך לדעת כדי להגדיר מעקב של Google Analytics עבור Adobe Flash עבור סביבת הפיתוח של Adobe Flex.
הורדה של ספריית המעקב
מורידים את הקוד (בפורמט מיקוד) מהכתובת http://code.google.com/p/gaforflash/downloads/list. יש לפעול לפי ההוראות שבקובץ readme.txt
כדי להתקין את רכיב ה-Flex. בשונה מרכיבי ה-Flash של Analytics, בהורדה יש רק קובץ ספרייה אחד: /lib/analytics_flex.swc
.
הוספת הקוד לפרויקט
לפני שתוכלו להתחיל להשתמש בקוד המעקב בפרויקט, עליכם לקשר את הקובץ SWC
שהורדתם כמשאב של הפרויקט.
- בוחרים Project->Properties. מופיעה תיבת דו-שיח 'מאפיינים' עבור הפרויקט שלכם.
- לוחצים על Flex Build Path ובוחרים בכרטיסייה Library Path.
- לוחצים על Add SWC... בחלונית נתיב הספרייה. מופיעה תיבת הדו-שיח הוספת SWC.
- עוברים למיקום שבו חילצתם את ה-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>