Snowplow ActionScript 3 Tracker 0.1.0 released

23 March 2015  •  Alex Dean

We are pleased to announce the release of our new Snowplow ActionScript 3 Tracker, contributed by Snowplow customer Viewbix. This is Snowplow’s first customer-contributed tracker - an exciting milestone for us! Huge thanks to Dani, Ephraim, Mark and Nati and the rest of the team at Viewbix for making this tracker a reality.

The Snowplow ActionScript 3.0 (AS3) Tracker supports ActionScript 3.0, and lets you add analytics to your Flash Player 9+, Flash Lite 4 and AIR games, apps and widgets.

In the rest of this post we will cover:

  1. How to install the tracker
  2. How to use the tracker
  3. Getting help

Compatibility

This ActionScript event tracker has been built, tested and compiled using the Adobe Flex 3.5 SDK, but is not dependent on Flex. You can use it in pure ActionScript projects.

It is compatible with Flash Player 9.0.124 and later.

The following installation instructions assume that you are using FlashBuilder for building your Flash application.

Install using binary

The binary is available for download from our public BinTray repository. Installation steps as follows:

  1. Download the snowplow_actionscript3_tracker_0.1.0.zip file
  2. Unzip the binary (.SWC) file
  3. Include it in your project under “Properties > Build Path > Library Path > Add SWC…”

Install from source

You can also install this Flash analytics SDK from source:

  1. Download the project source code from GitHub under the 0.1.0 tag
  2. Import the source into your FlashBuilder project using “Import > Other… > Existing Projects into Workspace”
  3. Link this new project to your project using “Properties > Build Path > Library Path > Add Project…”

And that’s it! For more detailed setup instructions, check out the ActionScript 3.0 Tracker Setup Guide on the Snowplow wiki.

You’re now ready to start using the tracker.

Require the Tracker module in your ActionScript code like so:

import com.snowplowanalytics.snowplow.tracker.*;
import com.snowplowanalytics.snowplow.tracker.emitter.*;
import com.snowplowanalytics.snowplow.tracker.payload.*;

You are now ready to initialize a Tracker instance:

var t1:Tracker = new Tracker(emitter, "AF003", "cf", user1Subject, this.stage, true);

Now let’s send in a couple of events:

t1.trackPageView("www.mysite.com#page3", "Page Three", "www.me.com", contextList);
t1.trackScreenView("HUD > Save Game", "screen23", contextList, 123456);

And that’s it! Please check out the ActionScript 3.0 Tracker Technical Documentation on the Snowplow wiki for the tracker’s full API.

3. Getting help

The ActionScript Event Tracker is a young project and we will be working with Viewbix and the wider Snowplow community to enhance it over the coming weeks and months; in the meantime, do please share any user feedback, feature requests or possible bugs.

Feel free to get in touch or raise an issue in the ActionScript 3.0 Tracker’s issues on GitHub!