2.0.0

Breaking Changes Alert

Fix:

• Fixed the issue that identify call right after sdk init reports incorrect user info #21
• Update the SDK to follow .net/c# standard naming conventions (see a list of breaking changes below) #26

Feature:

• Added Page call for server use case #32
• Enhanced ContextPlugin to capture os and platform info #32
• Smart defaults on storage data path #25
  • Now you don’t have to explicitly provide a persistDataPath anymore, the SDK recognizes the platform and defaults it for you.
• Customizable storage strategy #23
  • By default SDK stores data to disk
  • User now can config analytics to be completely in-memory (stateless) by providing an InMemoryStorageProvider
  • User can customize their own storage strategy by implementing IStorage and IStorageProvider

Breaking changes:

• Analytics

  • Timeline capitalized
  • UserIdAsync removed, use UserId instead
  • AnonymousIdAsync removed, use AnonymousId instead
  • TraitsAsync removed, use Traits instead

• Configuration

  • WriteKey capitalized
  • FlushAt capitalized
  • FlushInterval capitalized
  • AutoAddSegmentDestination capitalized
  • ApiHost capitalized
  • CdnHost capitalized
  • DefaultSettings capitalized
  • UseSynchronizeDispatcher capitalized
  • ExceptionHandler capitalized
  • persistentDataPath removed
  • Configuration() parameters changes - removed persistentDataPath removed, storageProvider added

• Plugin

  • Type capitalized
  • Analytics capitalized

• DestinationPlugin

  • Type capitalized
  • Key capitalized

• ContextPlugin

  • Type capitalized

• SegmentDestination

  • Key capitalized

• Settings

  • Integrations capitalized
  • Plan capitalized
  • EdgeFunctions capitalized

• UserInfo

  • IsNull capitalized

• RawEvent

  • Type capitalized
  • AnonymousId capitalized
  • MessageId capitalized
  • UserId capitalized
  • Timestamp capitalized
  • Context capitalized
  • Integrations capitalized
  • Metrics capitalized

• TrackEvent

  • All changes from RawEvent
  • Type capitalized
  • Event capitalized
  • Properties capitalized

• IdentifyEvent

  • All changes from RawEvent
  • Type capitalized
  • Traits capitalized

• ScreenEvent

  • All changes from RawEvent
  • Type capitalized
  • Name capitalized
  • Category capitalized
  • Properties capitalized

• GroupEvent:

  • All changes from RawEvent
  • Type capitalized
  • GroupId capitalized
  • Traits capitalized

• AliasEvent

  • All changes from RawEvent
  • Type capitalized
  • PreviousId capitalized

• StorageConstants

  • Value capitalized

2.0.0-alpha.3

What's Changed

• Prepare release 2.0.0 alpha.2 by @wenxi-zeng in #30

Full Changelog: 2.0.0-alpha.2...2.0.0-alpha.3

2.0.0-alpha.2

Release of version 2.0.0-alpha.2

What's Changed

• add xamarin sample by @wenxi-zeng in #6
• fix ci permission issue by @wenxi-zeng in #7
• update documentations by @wenxi-zeng in #8
• add coroutine excpetion handler by @wenxi-zeng in #9
• fix event not sent issue on unity mobile devices by @wenxi-zeng in #10
• release 1.0.2 by @wenxi-zeng in #11
• add upm release script by @wenxi-zeng in #12
• datetime format fix by @wenxi-zeng in #14
• Modifying upm_release.sh to drop Newtonsoft binaries by @MichaelGHSeg in #16
• Release/1.0.3 by @MichaelGHSeg in #17
• Adding supported platform list to README.md by @MichaelGHSeg in #18
• fix identify right after init no effect by @wenxi-zeng in #19
• prepare release 1.0.4 by @wenxi-zeng in #20
• Refactor to guarantee user info correctness by @MichaelGHSeg in #21
• add option to config analytics completely stateless by @wenxi-zeng in #23
• Adding some smarter defaults for persistence of data by @MichaelGHSeg in #25
• Adding .editorconfig and applying naming conventions by @MichaelGHSeg in #26
• bump up the versions of coroutine, serialization, and sovran by @wenxi-zeng in #27
• Prepare release 2.0.0 alpha.1 by @wenxi-zeng in #29

Full Changelog: https://github.com/segmentio/Analytics-CSharp/commits/2.0.0-alpha.2

2.0.0-alpha.1

Release of version 2.0.0-alpha.1

What's Changed

• Refactor to guarantee user info correctness by @MichaelGHSeg in #21
• add option to config analytics completely stateless by @wenxi-zeng in #23
• Adding some smarter defaults for persistence of data by @MichaelGHSeg in #25
• Adding .editorconfig and applying naming conventions by @MichaelGHSeg in #26
• bump up the versions of coroutine, serialization, and sovran by @wenxi-zeng in #27

Full Changelog: https://github.com/segmentio/Analytics-CSharp/commits/2.0.0-alpha.1

1.0.4

Release of version 1.0.4

What's Changed

• add xamarin sample by @wenxi-zeng in #6
• fix ci permission issue by @wenxi-zeng in #7
• update documentations by @wenxi-zeng in #8
• add coroutine excpetion handler by @wenxi-zeng in #9
• fix event not sent issue on unity mobile devices by @wenxi-zeng in #10
• release 1.0.2 by @wenxi-zeng in #11
• add upm release script by @wenxi-zeng in #12
• datetime format fix by @wenxi-zeng in #14
• Modifying upm_release.sh to drop Newtonsoft binaries by @MichaelGHSeg in #16
• Release/1.0.3 by @MichaelGHSeg in #17
• Adding supported platform list to README.md by @MichaelGHSeg in #18
• fix identify right after init no effect by @wenxi-zeng in #19

Full Changelog: https://github.com/segmentio/Analytics-CSharp/commits/1.0.4

1.0.3

Release of version 1.0.3

What's Changed

• add xamarin sample by @wenxi-zeng in #6
• fix ci permission issue by @wenxi-zeng in #7
• update documentations by @wenxi-zeng in #8
• add coroutine excpetion handler by @wenxi-zeng in #9
• fix event not sent issue on unity mobile devices by @wenxi-zeng in #10
• release 1.0.2 by @wenxi-zeng in #11
• add upm release script by @wenxi-zeng in #12
• datetime format fix by @wenxi-zeng in #14
• Modifying upm_release.sh to drop Newtonsoft binaries by @MichaelGHSeg in #16

Full Changelog: https://github.com/segmentio/Analytics-CSharp/commits/1.0.3

1.0.2

What's Changed

• fix event not sent issue on unity mobile devices by @wenxi-zeng in #10

Full Changelog: https://github.com/segmentio/Analytics-CSharp/commits/1.0.2

1.0.0 (Pilot Release)

Analytics-CSharp v1.0.0

We are announcing the pilot of Analytics CSharp! Analytics CSharp is a library that provide a simple, modern instrumentation experience for mobile apps.

Why did we launch Analytics CSharp?

The Android ecosystem has evolved rapidly, and has introduced new frameworks and best practices for building and managing mobile apps. To align with some significant advancements in these ecosystems over the last few years, we are introducing Analytics CSharp library.

What do you need to know about Analytics CSharp?

Analytics CSharp library improves performance, data observability, and the overall developer experience. Additionally, the improved app performance unlocks insights into app funnel and business metrics with a modern developer experience. The library opens opportunities to instrument app tracking across platforms.

Are there any known limitations to Analytics CSharp?

Analytics CSharp does not support mobile device-mode destinations. Destinations may only be configured in cloud mode during pilot.

Should these library be used in production?

During the pilot phase, we strongly discourage production use cases. This library is prone to change and we may introduce breaking changes. This library is governed under our First-Access & Beta terms.