Packagecom.jeffdePascale.fosfr.tracking
Classpublic class Tracking
InheritanceTracking Inheritance flash.events.EventDispatcher

the Tracking class handles queueing and processing of tracking tags within a Fosfr project. Any number of tracking methods can be specified in the configuration XML file (or within the code by passing a properly formatted XMLList to the initialize() method), and each tag that is is passed via the track() method will pass through each method specified, staggered over time by the value specified in the delay property. Additional methods may be created by basing a new class off of the TrackMethodPrototype class in tracking.methods.prototype.

See also

com.jeffdePascale.fosfr.prototypes.FosfrSWFPrototype.track
com.jeffdePascale.fosfr.tracking.methods.prototype.TrackMethodPrototype


Public Properties
 PropertyDefined by
  delay : uint
Specifies the time in milliseconds to delay between tracking calls.
Tracking
  enabled : Boolean
A Boolean value specifying whether tracking tags should be accepted into the tracking queue and processed.
Tracking
  runningMethod : String
[read-only] The name of the current tracking method that is processing the tracking tag.
Tracking
  trackAllMethods : Boolean
A boolean value specifying whether to send tracking calls to all the methods instantiated.
Tracking
Public Methods
 MethodDefined by
  
Tracking(_fosfr:FosfrBaseClass, _enabled:Boolean = true)
Creates an instance of the tracking class.
Tracking
  
initialize(methodStringsList:XMLList):void
Populates the Tracking class with an XMLList containing the values and parameters for the tracking methods specified within.
Tracking
  
track(trackTag:String, forceMethod:String = null, ... args):void
Adds a new value to be tracked to the Tracking class.
Tracking
Events
 EventSummaryDefined by
   Dispatched when all the tracking tags remaining in the Tracking queue have been processed.Tracking
   Dispatched when the track method of the chose tracking method(s) is called.Tracking
Property detail
delayproperty
public var delay:uint

Specifies the time in milliseconds to delay between tracking calls. This delay prevents URL requests sent by the tracking methods from interfering with each other.

The default value is 500.

enabledproperty 
public var enabled:Boolean

A Boolean value specifying whether tracking tags should be accepted into the tracking queue and processed.

The default value is true.

runningMethodproperty 
runningMethod:String  [read-only]

The name of the current tracking method that is processing the tracking tag. This value changes at intervals defined by the delay property.

Implementation
    public function get runningMethod():String
trackAllMethodsproperty 
public var trackAllMethods:Boolean

A boolean value specifying whether to send tracking calls to all the methods instantiated. If set to false, tracking calls will only fire to the default tracking method, the first one specified. Tracking via additional methods is achieved via the second parameter of the track method, forceMethod.

The default value is true.

Constructor detail
Tracking()constructor
public function Tracking(_fosfr:FosfrBaseClass, _enabled:Boolean = true)

Creates an instance of the tracking class.

Parameters
_fosfr:FosfrBaseClass — An instance of Fosfr.
 
_enabled:Boolean (default = true) — Specifies whether tracking tags should be accepted into the tracking queue and processed. Defaults to true.

See also

Method detail
initialize()method
public function initialize(methodStringsList:XMLList):void

Populates the Tracking class with an XMLList containing the values and parameters for the tracking methods specified within.

Parameters
methodStringsList:XMLList — An XMLList object containing the names of the methods to instantiate for tracking and the parameters for that method, specified as attributes of the method's node.
track()method 
public function track(trackTag:String, forceMethod:String = null, ... args):void

Adds a new value to be tracked to the Tracking class. If the queue is not currently running, this will restart the cue and begin passing values to the method(s) specified in the Tracking instance.

Parameters
trackTag:String — The stirng value to be passed to the trackng method(s).
 
forceMethod:String (default = null) — optional arguments for the tracking call, if the chosen method(s) allow for any.
 
... args
Event detail
completeevent 
Event object type: com.jeffdePascale.fosfr.core.tracking.TrackingEvent

Dispatched when all the tracking tags remaining in the Tracking queue have been processed.

trackevent  
Event object type: com.jeffdePascale.fosfr.core.tracking.TrackingEvent

Dispatched when the track method of the chose tracking method(s) is called.