Skip to content

Commit 9037069

Browse files
committed
edits
1 parent 3935caa commit 9037069

File tree

4 files changed

+298
-102
lines changed

4 files changed

+298
-102
lines changed

src/_data/sidenav/strat.yml

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -207,7 +207,7 @@ sections:
207207
- slug: csharp
208208
section_title: Analytics-CSharp Documentation
209209
section:
210-
- path:
211-
title:
212-
- path:
213-
title:
210+
- path: /connections/sources/catalog/libraries/server/csharp/
211+
title: Analytics-CSharp
212+
- path: /connections/sources/catalog/libraries/server/csharp/migration-guide/
213+
title: Analytics-CSharp Migration Guide

src/connections/sources/catalog/libraries/server/c-sharp/migration-guide.md

Lines changed: 0 additions & 80 deletions
This file was deleted.

src/connections/sources/catalog/libraries/server/c-sharp/index.md renamed to src/connections/sources/catalog/libraries/server/csharp/index.md

Lines changed: 19 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,6 @@
11
---
22
title: Analytics for CSharp (C#)
3+
strat: csharp
34
id:
45
---
56

@@ -8,7 +9,7 @@ With Analytics-CSharp, you can add Segment analytics to your .Net app which incl
89
> info ""
910
> This library is currently in beta and is governed by Segment’s [First Access and Beta terms](https://www.twilio.com/legal/tos){:target="_blank"}.
1011
11-
### Support platforms
12+
### Supported platforms
1213
These platforms support Analytics-CSharp:
1314
* .Net/.Net core/.Net framework
1415
* Mono
@@ -33,7 +34,7 @@ To get started with the Analytics-CSharp library:
3334
```git
3435
dotnet add package Segment.Analytics.CSharp --version <LATEST_VERSION>
3536
```
36-
**Note:** Analytics-CSharp is distributed through NuGet. Check out other installation options [here](https://www.nuget.org/packages/Segment.Analytics.CSharp/){:target="_blank"}.
37+
<br>**Note:** Analytics-CSharp is distributed through NuGet. Check out other installation options [here](https://www.nuget.org/packages/Segment.Analytics.CSharp/){:target="_blank"}.
3738
3839
3. Initialize and configure the client.
3940
@@ -51,13 +52,13 @@ To get started with the Analytics-CSharp library:
5152
Option Name | Description
5253
----------- | -----------
5354
`writeKey` *required* | This is your Segment write key.
54-
`apiHost` | Default set to `api.segment.io/v1`. <br> This sets a default API Host to which Segment sends events.
55-
`autoAddSegmentDestination` | Default set to `true`. <br> This automatically adds the Segment Destination plugin. You can set this to `false` if you want to manually add the Segment Destination plugin.
56-
`defaultSettings` | Default set to `{}`. <br> The settings object used as fallback in case of network failure.
57-
`flushAt` | Default set to `20`. <br> The count of events at which Segment flushes events.
58-
`flushInterval` | Default set to `30` (seconds). <br> The interval in seconds at which Segment flushes events.
59-
`exceptionHandler` | Set a an exception handler to handle errors happened in async methods within the analytics scope
60-
`storageProvider` | Set how you want your data to be stored. <br> `DefaultStorageProvider` is used by default which stores data to local storage. `InMemoryStorageProvider` is also provided in the library. You can also write your own storage solution by implementing `IStorageProvider` and `IStorage`
55+
`apiHost` | The default is set to `api.segment.io/v1`. <br> This sets a default API Host to which Segment sends events.
56+
`autoAddSegmentDestination` | The default is set to `true`. <br> This automatically adds the Segment Destination plugin. You can set this to `false` if you want to manually add the Segment Destination plugin.
57+
`defaultSettings` | The default is set to `{}`. <br> The settings object used as fallback in case of network failure.
58+
`flushAt` | The default is set to `20`. <br> The count of events at which Segment flushes events.
59+
`flushInterval` | The default is set to `30` seconds. <br> The interval in seconds at which Segment flushes events.
60+
`exceptionHandler` | Use to set an exception handler to handle errors happened in async methods within the analytics scope.
61+
`storageProvider` | Use to set how you want your data to be stored. <br> `DefaultStorageProvider` is used by default which stores data to local storage. `InMemoryStorageProvider` is also provided in the library. You can also write your own storage solution by implementing `IStorageProvider` and `IStorage`.
6162
6263
## Tracking Methods
6364
@@ -97,7 +98,7 @@ The [Screen](/docs/connections/spec/screen/) method lets you record whenever a u
9798

9899
You'll want to record a screen event whenever the user opens a screen in your app. This could be a view, fragment, dialog or activity depending on your app.
99100

100-
Not all integrations support screen, so when it's not supported explicitly, the screen method tracks as an event with the same parameters.
101+
Not all integrations support screen. When it's not supported explicitly, the screen method tracks as an event with the same parameters.
101102

102103
```c#
103104
analytics.Screen("ScreenName", new JsonObject {
@@ -106,11 +107,11 @@ analytics.Screen("ScreenName", new JsonObject {
106107
```
107108

108109
### Page
109-
The [Page](/docs/connections/spec/page/) method lets you record whenever a user sees a page in your web app, along with optional extra information about the page being viewed.
110+
The [Page](/docs/connections/spec/page/) method lets you record whenever a user sees a page in your web app, along with optional extra information about the page.
110111

111112
You'll want to record a page event whenever the user opens a page in your app. This could be a webpage, view, fragment, dialog or activity depending on your app.
112113

113-
Not all integrations support page, so when it's not supported explicitly, the page method tracks as an event with the same parameters.
114+
Not all integrations support page. When it's not supported explicitly, the page method tracks as an event with the same parameters.
114115

115116
```c#
116117
analytics.Page("PageName", new JsonObject {
@@ -119,7 +120,7 @@ analytics.Page("PageName", new JsonObject {
119120
```
120121

121122
### Group
122-
The [Group](/docs/connections/spec/group/) method lets you associate an individual user with a group— whether it's a company, organization, account, project, or team. This includes a unique group identifier and any additional group traits you may have, like company name, industry, number of employees. You can include any information you want to associate with the group in the traits option. When using any of the reserved group traits, be sure the information reflects the name of the trait. For example, email should always be a string of the user's email address.
123+
The [Group](/docs/connections/spec/group/) method lets you associate an individual user with a group — whether it's a company, organization, account, project, or team. This includes a unique group identifier and any additional group traits you may have, like company name, industry, number of employees. You can include any information you want to associate with the group in the traits option. When using any of the reserved group traits, be sure the information reflects the name of the trait. For example, email should always be a string of the user's email address.
123124

124125
```c#
125126
analytics.Group("user-123", new JsonObject {
@@ -213,9 +214,9 @@ class AmplitudePlugin : DestinationPlugin
213214

214215
### Advanced concepts
215216

216-
- `configure(Analytics)`: Use this function to setup your plugin. This implicitly calls once the plugin registers.
217+
- `configure(Analytics)`: Use this function to set up your plugin. This implicitly calls once the plugin registers.
217218
- `update(Settings)`: Use this function to react to any settings updates. This implicitly calls when settings update. You can force a settings update by calling `analytics.checkSettings()`.
218-
- `DestinationPlugin` timeline: The destination plugin contains an internal timeline that follows the same process as the analytics timeline, enabling you to modify/augment how events reach the particular destination. For example if you only wanted to add a context key when sending an event to `Amplitude`:
219+
- `DestinationPlugin` timeline: The destination plugin contains an internal timeline that follows the same process as the analytics timeline, enabling you to modify/augment how events reach the particular destination. For example, if you only wanted to add a context key when sending an event to `Amplitude`:
219220

220221
```c#
221222
class AmplitudeEnrichment : Plugin
@@ -259,7 +260,7 @@ analytics.Add(yourPlugin)
259260
```
260261

261262
### Example projects using Analytics-CSharp
262-
See how different platforms and languages use Analytics-CSharp in different [example projects](https://github.com/segmentio/Analytics-CSharp/tree/main/Samples).
263+
See how other platforms and languages use Analytics-CSharp in different [example projects](https://github.com/segmentio/Analytics-CSharp/tree/main/Samples){:target="_blank"}.
263264
264265
## Utility Methods
265266
The Analytics-CSharp utility methods help you work with plugins from the analytics timeline. They include:
@@ -316,9 +317,9 @@ analytics.Reset()
316317
```
317318

318319
## Compatibility
319-
This library targets `.NET Standard 2.0`. Checkout [here](https://docs.microsoft.com/en-us/dotnet/standard/net-standard?tabs=net-standard-2-0) for compatible platforms.
320+
This library targets `.NET Standard 2.0`. See the [list of compatible platforms](https://docs.microsoft.com/en-us/dotnet/standard/net-standard?tabs=net-standard-2-0){:target="_blank"}.
320321
321322
## Changelog
322-
[View the Analytics-CSharp changelog on GitHub](https://github.com/segmentio/analytics-csharp/releases).
323+
[View the Analytics-CSharp changelog on GitHub](https://github.com/segmentio/analytics-csharp/releases){:target="_blank"}.
323324
324325

0 commit comments

Comments
 (0)