Collecting data with Trackers and Webhooks

  1. Home
  2. Docs
  3. Collecting data with Trackers and Webhooks
  4. Trackers – collecting data from your own applications
  5. .NET tracker
  6. Tracker

Tracker

The Tracker object is responsible for co-ordinating the saving and sending of events as well as managing the optional Session object.

Constructor

Using Snowplow.Tracker (.NET Standard) or Snowplow.Tracker.PlatformExtensions (PCL)

Argument NameDescriptionRequired?Default
emitterThe Emitter object you createYesNull
subjectThe Subject that defines a userNoNull
clientSessionThe Session object you createNoNull
trackerNamespaceThe name of the tracker instanceNoNull
appIdThe application IDNoNull
base64EncodedIf we base 64 encode json valuesNoTrue
synchronousIf loading into storage is done in syncNoTrue
desktopContextDelegateFunction to get the desktop contextNoNull
mobileContextDelegateFunction to get the mobile contextNoNull
geoLocationContextDelegateFunction to get the geo-location contextNoNull
loggerThe logger to use within the applicationNoNull

A full Tracker construction should look like the following:

var logger = new ConsoleLogger(); var endpoint = new SnowplowHttpCollectorEndpoint(emitterUri, method: method, port: port, protocol: protocol, l: logger); var storage = new LiteDBStorage("events.db"); var queue = new PersistentBlockingQueue(storage, new PayloadToJsonString()); var emitter = new AsyncEmitter(endpoint, queue, l: logger); var subject = new Subject().SetPlatform(Platform.Mob).SetLang("EN"); var session = new ClientSession("client_session.dict", l: logger); Tracker.Tracker.Instance.Start(emitter: emitter, subject: subject, clientSession: session, trackerNamespace: "some namespace", appId: "some appid", encodeBase64: true, l: logger);

The Tracker.Start(...) and Tracker.Stop() methods take full responsibility for starting and stopping the threads required for processing everything asynchronously. Do not use any other Start and Stop functions other than the ones directly for the Tracker to prevent unknown behaviours.

WARNING: The LiteDBStorage object must be disposed of manually after stopping the Tracker so you will need to maintain a reference to this object.

NOTE: The Subject variables can all be altered directly from the Tracker via replicated setter methods.

Functions

The Tracker contains several critical functions that must be used to start Tracking.

Start(...)

Using Snowplow.Tracker (.NET Standard) or Snowplow.Tracker.PlatformExtensions (PCL)

This function must be called before any events will start being stored or sent. This is due to the fact that we do not want to start any background processing from the constructors so it is left up to the developer to choose when to start everything up.

If you attempt to access the Tracker singleton before Starting it an exception will be thrown.

This function:

  • Starts the background emitter thread
  • Starts the background session check timer (Optional)

Once this is run everything should be in place for asynchronous event tracking.

Stop()

Using Snowplow.Tracker (.NET Standard) or Snowplow.Tracker.PlatformExtensions (PCL)

If you need to halt the Tracker from tracking events you can run this function. This will bring all event processing, sending and collection to a halt and nothing will be started again until Start(...) is fired again.

WARNING: If you are using Client Sessionization stopping and then restarting the Tracker will result in the session index incrementing.

Track(IEvent)

Using Snowplow.Tracker (.NET Standard) or Snowplow.Tracker.PlatformExtensions (PCL)

This is the function used for Tracking all events.

Tracker.Tracker.Instance.Track(IEvent newEvent);