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. Unity Tracker
  6. Subject

Subject

You may have additional information about your application’s environment, current user and so on, which you want to send to Snowplow with each event.

The Subject class has a set of Set...() methods to attach extra data relating to the user to all tracked events:

Here are some examples:

Subject s1 = new Subject(); s1.SetUserId("Kevin Gleason"); s1.SetLanguage("en-gb"); s1.SetScreenResolution(1920, 1080);
Code language: JavaScript (javascript)

After that, you can add your Subject to your Tracker like so:

Tracker t1 = new Tracker(..., s1) // OR t1.SetSubject(s1);
Code language: JavaScript (javascript)

Set user ID with SetUserId

You can set the user ID to any string:

s1.SetUserId( "{{USER ID}}" )
Code language: JavaScript (javascript)

Example:

s1.SetUserId("alexd")
Code language: JavaScript (javascript)

Set screen resolution with SetScreenResolution

If your C# code has access to the device’s screen resolution, then you can pass this in to Snowplow too:

t1.SetScreenResolution( {{WIDTH}}, {{HEIGHT}} )

Both numbers should be positive integers; note the order is width followed by height. Example:

t1.SetScreenResolution(1366, 768)
Code language: CSS (css)

Set viewport dimensions with SetViewport

If your C# code has access to the viewport dimensions, then you can pass this in to Snowplow too:

s.SetViewport( {{WIDTH}}, {{HEIGHT}} )

Both numbers should be positive integers; note the order is width followed by height. Example:

s.SetViewport(300, 200)
Code language: CSS (css)

Set color depth with SetColorDepth

If your C# code has access to the bit depth of the device’s color palette for displaying images, then you can pass this in to Snowplow too:

s.SetColorDepth( {{BITS PER PIXEL}} )

The number should be a positive integer, in bits per pixel. Example:

s.SetColorDepth(32)
Code language: CSS (css)

Set timezone with SetTimezone

This method lets you pass a user’s timezone in to Snowplow:

s.SetTimezone( {{TIMEZONE}} )

The timezone should be a string:

s.SetTimezone("Europe/London")
Code language: JavaScript (javascript)

Set the language with SetLanguage

This method lets you pass a user’s language in to Snowplow:

s.SetLanguage( {{LANGUAGE}} )

The language should be a string:

s.SetLanguage('en')
Code language: JavaScript (javascript)

SetIpAddress

This method lets you pass a user’s IP Address in to Snowplow:

SetIpAddress( {{IP ADDRESS}} )

The IP address should be a string:

subj.SetIpAddress("127.0.0.1");
Code language: CSS (css)

SetUseragent

This method lets you pass a useragent in to Snowplow:

SetUseragent( {{USERAGENT}} )

The useragent should be a string:

subj.SetUseragent("Agent Smith");
Code language: JavaScript (javascript)

SetNetworkUserId

This method lets you pass a Network User ID in to Snowplow:

SetNetworkUserId( {{NUID}} )

The network user id should be a string:

subj.SetNetworkUserId("network-id");
Code language: JavaScript (javascript)

SetDomainUserId

This method lets you pass a Domain User ID in to Snowplow:

SetDomainUserId( {{DUID}} )

The domain user id should be a string:

subj.SetDomainUserId("domain-id");
Code language: JavaScript (javascript)

If you’d like to learn more about Snowplow Insights you can book a demo with our team, or if you’d prefer, you can try Snowplow technology for yourself quickly and easily.