Skip to main content

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 number of Set...() methods to attach extra data relating to the user of the tracked events.

Here are some examples:

Subject s1 = new Subject();
s1.SetUserId("Kevin Gleason");
s1.SetLang("en-gb");
s1.SetScreenResolution(1920, 1080);

SetUserId​

You can set the user ID to any string:

s1.SetUserId( "{{USER ID}}" )

Example:

s1.SetUserId("alexd")

SetScreenResolution​

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

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

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

s1.SetScreenResolution(1366, 768)

SetViewport​

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

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

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

s1.SetViewport(300, 200)

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)

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")

SetLang​

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

s.SetLang( {{LANGUAGE}} )

The language should be a string:

s.SetLang('en')

SetIpAddress​

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

s.SetIpAddress( {{IP ADDRESS}} )

The IP address should be a string:

s.SetIpAddress("127.0.0.1");

SetUseragent​

This method lets you pass a useragent in to Snowplow:

s.SetUseragent( {{USERAGENT}} )

The useragent should be a string:

s.SetUseragent("Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:108.0) Gecko/20100101 Firefox/108.0");

SetNetworkUserId​

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

s.SetNetworkUserId( {{NUID}} )

The network user id should be a string, typically a UUID:

s.SetNetworkUserId("a57c0cac-4aab-49c5-8e70-790f415080b0");

SetDomainUserId​

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

s.SetDomainUserId( {{DUID}} )

The domain user id should be a string, typically a UUID:

s.SetDomainUserId("be0999db-8e4e-4f0c-9f3e-fe5e5de1669a");

SetDomainSessionId​

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

s.SetDomainSessionId( {{SID}} )

The domain session id should be a string, typically a UUID:

s.SetDomainSessionId("8b107139-5b38-45cc-a0eb-be2550e32904");

SetDomainSessionIndex​

This method lets you pass a Domain Session Index in to Snowplow:

s.SetDomainSessionIndex( {{VID}} )

The domain user id should be an int:

s.SetDomainSessionIndex(1);

SetPlatform​

This method lets you set the Platform that the Tracker is running on:

s.SetPlatform( Platform.{{ option }} )

The Platform should be an enum:

s.SetPlatform(Platform.Mob);

Available platforms:

  • Web
  • Mob
  • Pc
  • Srv
  • App
  • Tv
  • Cnsl
  • Iot
Was this page helpful?