הגדרה של Adobe Flash

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

הורדת קובצי הרכיבים

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

בצע את ההוראות שבקובץ readme.txt כדי להתקין את רכיבי ה-Flash.

  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 אך אינך מכיר את ActionScript 3, השתמש ברכיב זה. הרכיב של Analytics הוא חבילת מעקב מלאה. פשוט גוררים ומשחררים את הרכיבים ישירות על במה, קובעים כמה הגדרות פשוטות בכלי לבדיקת רכיבים ומוכנים לתייג את הפקדים במעקב של Analytics.

הרכיב AnalyticsLibrary. אם אתם מכירים את ActionScript 3, תוכלו להשתמש ברכיב AnalyticLibrary. גוררים את הרכיב לספריית ה-Flash ומייבאים את סיווגי המעקב ישירות לקוד ה-ActionScript.

שימוש ברכיב Analytics

שימוש ב-analytics_flash.swc כדי להטמיע מעקב באמצעות הרכיב של Analytics. ממקמים את הרכיב בספריית הרכיבים הנכונה, והוא מופיע בחלונית הרכיבים (חלון - רכיבים).

  1. גוררים את הרכיב לשלב ונותנים לו שם למופע בתיבת הדו-שיח מאפיינים.
  2. מגדירים את הרכיב בחלונית Component Inspector (Windows – Component Inspector):
    • מוסיפים את מזהה נכס האינטרנט של Analytics.
    • בוחרים במצב גשר או במצב AS3.
    • צריך לציין אם התכונה 'ניפוי באגים חזותי' מופעלת או מושבתת.
  3. בקוד ActionScript, הוסף את הקריאות הרגילות למעקב של Google Analytics למופע של הרכיב שיצרת.

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

דוגמה לרכיב Flash פשוט ב-Analytics

קטע הקוד הבא מראה כיצד ניתן לעקוב אחר לחצן ב-Flash כאשר מישהו לוחץ עליו. בדוגמה הזו, מופע הלחצן נקרא playGame ב-ActionScript. כאשר לוחצים על הלחצן, מתבצעת קריאה לשיטה onButtonClick, וכתוצאה מכך מפעילה את השיטה trackPageview(). הפעולה הזו מגדילה את ספירת הצפיות בדף של הדף הווירטואלי /myGame1.

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

שימוש ברכיב AnalyticsLibrary

משתמשים בקובץ analytics.swc כדי להטמיע מעקב באמצעות הרכיב AnalyticsLibrary. הרכיב הזה מאפשר ליצור אובייקט מעקב ישירות בקוד AS3. אחרי שהרכיב AnalyticsLibrary נמצא במיקום הנכון, הוא מופיע בחלונית 'רכיבים'. לאחר מכן תוכל לגרור את הרכיב מהחלונית 'רכיבים' אל הספרייה שלך, ומשם לייבא את הספריות לקוד ה-ActionScript שלך.

אתחול אובייקט המעקב

בסביבת Adobe Flash, מפעילים את אובייקט המעקב באמצעות הפרמטרים הבאים:

  • הפניה לאובייקט התצוגה הנוכחי. בדוגמה הבאה, this מפנה לאובייקט התצוגה.
  • מזהה נכס האינטרנט. מזהה נכס האינטרנט הוא המחרוזת הייחודית המשמשת למעקב אחר פעילות בתוכן ה-Flash שלך ולהעברתה לתצוגה (פרופיל) הנכונה בחשבון Analytics שלך.
  • מצב המעקב. הפרמטרים החוקיים הם Bridge או AS3.
  • מצב ניפוי באגים. יש להגדיר את debug לערך false לשימוש בסביבת הייצור ובערך true לאימות ולפתרון בעיות.

דוגמה פשוטה לספריית Analytics

בדוגמה הבאה, קטע של סרט בשם playGame נמצא על הבמה. אובייקט מעקב חדש שנקרא tracker נוצר יחד עם גורם handler של אירועים שמאזין ללחיצה על העכבר. כשלוחצים על הלחצן, מתבצעת קריאה לפונקציה 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");
}