מעקב ב-Google Analytics עבור Adobe Flash

רכיב המעקב של Google Analytics עבור Adobe Flash מאפשר לך להטמיע בקלות את Google Analytics בתוכן המבוסס על Flash. הרכיב הזה, שפותח על ידי Adobe Systems, Inc., מכיל את כל הפונקציונליות של קוד JavaScript של Google Analytics. הרכיב 'מעקב אחר Flash' הוא אובייקט מעקב שעבר הידור ומקורו ב-ActionScript 3, ולכן ההטמעה של Analytics תהיה אינטואיטיבית בסביבות הפיתוח של Flash ו-Flex.

מדוע להשתמש במעקב אחר Flash?

ללא המעקב של Google Analytics עבור רכיב Adobe Flash, המעקב אחר תוכן של Adobe Flash באמצעות Google Analytics כרוך במספר קשיים טכניים. תחילה עליך לפתח ממשק מותאם אישית ל-ga.js כדי שאפליקציית ה-Flash תוכל להפעיל את שיטת Analytics המתאימה, כגון trackPageview() או trackEvent(). בנוסף, עליך לצפות אם לתוכן ה-Flash שלך תהיה גישה ל-Document Object Model (DOM) של הדפדפן, מכיוון שהמעקב נכשל באובייקטים שבהם הגישה ל-DOM נדחית (בדרך כלל כאשר התוכן נמצא באתרים של צד שלישי). נדרשת הבנה כיצד להשתמש בקריאה ExternalInterface ב-ActionScript 3 כדי לגשת ל-DOM של הדפדפן ולפגוע כאשר הגישה חסומה.

הרכיב Google Analytics עבור Adobe Flash מפשט את המעקב אחר תוכן ה-Flash שלך ומטפל בגישת DOM חלקה. הקובץ שימושי לכמה מטרות מעקב נפוצות ב-Flash, כמו: :

ווידג'ט Flash מוטמע בדף HTML
אפליקציה עצמאית גמישה או אתר Flash בלבד שמתארח בדף HTML
משחק או תוכנית Flex/Flash מבוזרים שבהם למפתח אין שליטה על המיקום של הווידג'ט

חשוב לזכור שלאפליקציות מעקב ב-Flash יש שינויים מבניים שונים של מעקב אחר דפי אתרים. היכרות עם המעקב ב-Analytics חיונית להבנת אופן הפעולה של הפלאגין הזה. אפשר גם להציג את מסמכי התיעוד של הפרויקט כדי לקבל מידע מפורט על ההעברה של מודל המעקב של Analytics לרכיב הזה.

הערה: בשלב זה מעקב אחר Flash זמין לכל תוכן Flash שמוטמע בדף אינטרנט. בשלב זה אין תמיכה במעקב אחר נתונים שנשלחו מ-Adobe Air, Shockwave או דרך סביבת הפיתוח המשולבת Flash (למשל, שימוש בסרט הבדיקה).

סביבות פיתוח נתמכות

אפשר לפתח מעקב של Analytics ל-Flash בסביבות של Adobe Flash או Adobe Flex. לכל סביבה נדרש רכיב אחר, שאותו ניתן להוריד מהכתובת http://code.google.com/p/gaforflash/. הרכיבים האלו מבוססים על ActionScript 3 וניתן להגדיר אותם באחת משתי דרכים עבור כל סביבה:

ב-Adobe Flash

מוסיפים ומגדירים רכיב פשוט בבודק הרכיבים וגוררים אותו לשלב.
ייבא את ספריות מעקב ה-Flash ישירות לספרייה שלך והתחל בקידוד.

ב-Adobe Flex

יש לכלול רכיב MXML שהגדרת מקובץ am MXML.
ייבא את ספריות מעקב Flash אל תגי הסקריפט/קובצי AS3 שלך.

חזרה למעלה

כיצד פועל הרכיב?

כדי להשתמש ברכיב המעקב של Flash בסביבה שלך, עליך להשתמש בכלים החזותיים של Flash או להגדיר את אובייקט המעקב ישירות בקוד שלך. בין אם אתם מגדירים את הרכיב באופן חזותי או באמצעות קוד, אתם מספקים את הרכיבים הבאים:

מזהה נכס האינטרנט - זהו גם מספר UA של קוד המעקב שלך, והוא נראה כך: UA-xxxxx-yy, כאשר ה-x וה-y מוחלפים במספרים התואמים לפרטי החשבון והתצוגה (הפרופיל) של האובייקט שאחריו אתה עוקב. למידע נוסף, אפשר לעיין בנכס אינטרנט.
מצב המעקב – בוחרים במצב גשר או במצב AS3. מצב זה קובע את אופן התקשורת של המעקב עם שרתי Analytics, ומתואר בפירוט בהמשך.
מצב ניפוי הבאגים – לא משנה באיזו סביבה או מצב מעקב אתם משתמשים, אתם יכולים להפעיל ניפוי באגים כדי לאמת ולבדוק את המעקב.

מצבי מעקב

בהתאם לאופן שבו אתם מפיצים את תוכן ה-Flash שלכם, הרכיב 'Analytics עבור Flash' מתקשר לשרתי Analytics על ידי גישור על התקשורת בין תוכן ה-Flash בהתקנת מעקב קיימת של Analytics, או על ידי תקשורת ישירות לשרתי Analytics. שני המצבים האלה נקראים מצב גשר ומצב AS3, בהתאמה. שני המצבים משתמשים באותה פונקציונליות מעקב של Analytics, וקל להעביר את אפליקציית ה-Flash ממצב אחד למצב השני. בנוסף לבחירת מצב תקשורת לצורך מעקב ב-Analytics, אפשר להשתמש במצב ניפוי באגים כדי לפתור בעיות או לאמת את המעקב.

בכל אחד מהמצבים, allowscriptaccess חייב להיות שווה ל-always כדי שהמעקב אחר הקמפיינים יפעל. פרמטר זה מפעיל גישת קריאה לכתובת האתר ולפרטי הגורם המפנה של הדף, הנדרשים על ידי קוד המעקב של Flash. ללא allowscriptaccess, האיכות של קוד המעקב של Analytics נחלשת. עדיין מוצגים רוב הנתונים על פעילות המשתמשים, אבל הוא לא יאשר את מודל השיוך (Attribution) בקמפיין ב-Google Analytics.

מצב גשר

השתמש במצב זה אם אתה שולט גם בדף ה-HTML וגם בתוכן ה-Flash. מצב זה מתאים במיוחד אם כבר הטמעת מעקב של Google Analytics (ga.js) באתר שלך וברצונך להוסיף מעקב לתוכן Flash מוטמע. מצב הגשר מפשט את התקשורת בין Flash ל-JavaScript, בכך שהוא מספק ממשק ActionScript 3 מאוחד לקוד ga.js. כדי שהמעקב יפעל, הוא מספק את החיבור מקריאות ActionScript 3 ל-JavaScript של Analytics.

ניתן להגדיר את החיבור לקוד המעקב של Google Analytics באמצעות פרמטר מזהה נכס האינטרנט באחת משתי דרכים:

השיטה הנפוצה ביותר. האובייקט 'קוד מעקב של Google Analytics' כבר קיים בדף עם שם משלו, כמו pageTracker. במקרה כזה, עליכם לספק את ההפניה המלאה ל-DOM לאובייקט המעקב. לדוגמה, אם האובייקט נקרא pageTracker, צריך להפנות לאובייקט הזה בקוד בתור window.pageTracker. לדוגמה, קטע הקוד הבא מדגים איך זה צריך להיות מוגדר באמצעות סביבת Adobe Flex עם ActionScript 3:
```
tracker = new GATracker( this, "window.pageTracker", "Bridge", false );
```
שיטה חלופית. אם לא יצרתם אובייקט מעקב אחר דף בדף, תוכלו פשוט להעביר את מזהה נכס האינטרנט. המערכת תיצור עבורכם אובייקט של קוד מעקב של JavaScript. בשיטה הזו, עדיין נדרשת בדף ה-HTML הפניה לקובץ המקור של JavaScript הבסיסי ga.js. קטע הקוד הבא מדגים איך זה צריך להיות מוגדר באמצעות סביבת Adobe Flex עם ActionScript 3:
```
tracker = new GATracker( this, "UA-12345-22", "Bridge", false );
```

כדי שמצב ברידג' יפעל כראוי, יש להגדיר את ExternalInterface.available כ-True בקוד ActionScript 3. משמעות הדבר היא גם שיש להגדיר את allowScriptAccess לערך always בדף ה-HTML שבו מוטמע תוכן ה-Flash. הדוגמה הבאה ממחישה קוד HTML שהוגדר למצב ברידג':

<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 שלך. לדוגמה, אם אתם מפתחים תוכן Flash להפצה באתרים רבים, עליכם להשתמש במצב AS3. מצב AS3 אינו תלוי לחלוטין בקוד המעקב ga.js ומכיל את כל פונקציונליות המעקב של Analytics. במצב הזה אין צורך בהתקנה נפרדת של מעקב אחר ga.js. בנוסף, מצב AS3 משתמש במנגנון אחסון Flash כדי לעקוב אחר פרטי הפעילות של המשתמש.

לגבי פרמטרים מסוימים של DOM, כמו שפה, רכיב ה-AS3 מנסה לאחזר את הערכים מהדפדפן. אם לא נמצאו ערכים, הרכיב ישתמש בערך המקביל מסוג Flash או שברירת המחדל שלו תהיה no.

פתרון בעיות ואימות

רכיב המעקב של Google Analytics עבור Adobe Flash מספק מצב ניפוי באגים כדי לפשט את האימות ופתרון בעיות. כשהאפשרות הזו מופעלת, כל נתוני המעקב מושמטים ומופנים למסך בתיבת טקסט במקום לשרתי Analytics. במצב הזה אפשר לראות בזמן אמת את הנתונים שאחרת היו נאספים על ידי השרת. התכונה הזו גם עוזרת לשמור את נתוני הבדיקה מחוץ לנתוני הייצור. כדי להפעיל את תכונת פתרון הבעיות, יש להגדיר את האפשרות visualDebug לערך true בכלי לבדיקת הרכיבים.

דוגמאות

לדוגמאות מפורטות של יישום מעקב בסביבות פיתוח שונות, ראו:

Flash

Flex

ניהול גרסאות

ניתן למצוא את הגרסה העדכנית ביותר של רכיבי המעקב כקובץ ZIP בכתובת http://code.google.com/p/gaforflash/downloads/list. כל הורדה מכילה את כל רכיבי המעקב יחד עם תיעוד קשור. שם הקובץ של הקובץ להורדה יציג את מספר הגרסה של הקוד שהוא מכיל.

ניתן גם להשתמש בהצהרות הבאות בקוד שלך כדי להדפיס את מספר הגרסה הנוכחי של הרכיב במסוף הפלט.

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

חזרה למעלה