CodeArt.MatomoTracking
1.0.1
See the version list below for details.
dotnet add package CodeArt.MatomoTracking --version 1.0.1
NuGet\Install-Package CodeArt.MatomoTracking -Version 1.0.1
<PackageReference Include="CodeArt.MatomoTracking" Version="1.0.1" />
paket add CodeArt.MatomoTracking --version 1.0.1
#r "nuget: CodeArt.MatomoTracking, 1.0.1"
// Install CodeArt.MatomoTracking as a Cake Addin #addin nuget:?package=CodeArt.MatomoTracking&version=1.0.1 // Install CodeArt.MatomoTracking as a Cake Tool #tool nuget:?package=CodeArt.MatomoTracking&version=1.0.1
CodeArt.MatomoTracking
Opensource Matomo Tracking API for .NET. This library is based on the official Matomo Tracking API documentation: https://developer.matomo.org/api-reference/tracking-api and wraps the API calls in a simple to use .NET library. Initial version made by Allan Thraen for CodeArt.
Installation
Register the Matomo Tracking as a service in Dependency Injection.
var services = new ServiceCollection();
//Needs IConfiguration - but this might already be registered in your project
services.AddScoped<IConfiguration>(_ => configuration);
services.AddMatomoTracking(options =>
{
options.MatomoUrl = "https://[My matomo url]/";
options.SiteId = "[My site id]";
});
var serviceProvider = services.BuildServiceProvider();
Configuration
If you have a configuration file, you can also set the configuration directly there under the "Matomo" node.
{
"Matomo": {
"MatomoUrl": "https://[My matomo url]/",
"SiteId": "[My site id]"
}
}
Usage
You can track many different things, for example:
- Pageviews using PageViewTrackingItems
- Events using EventTrackingItems
- Ecommerce using EcommerceTrackingItems
- Content using ContentTrackingItems
For the official documentation of what to track - and when, refer to the (official documentation)[https://developer.matomo.org/api-reference/tracking-api]
Tracking a page view
await tracker.Track(new PageViewTrackingItem()
{
Url = "app://myapp/page1",
UserID = "test@test.com",
NewVisit = true,
ActionName = "Page 1",
PageViewID = pvid
});
Tracking in bulk
You can also track multiple items in the same call like this:
await tracker.Track(new PageViewTrackingItem()
{
Url = "app://myapp/page1",
UserID = "test@test.com",
NewVisit = true,
ActionName = "Page 1",
PageViewID = pvid
},
new EventTrackingItem()
{
Url = "app://myapp/page1",
UserID = "test",
NewVisit = false,
ActionName = "Form submit",
PageViewID = pvid,
EventCategory = "Form",
EventAction = "Submit",
EventName = "Newsletter form"
});
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
.NET Core | netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
.NET Standard | netstandard2.1 is compatible. |
MonoAndroid | monoandroid was computed. |
MonoMac | monomac was computed. |
MonoTouch | monotouch was computed. |
Tizen | tizen60 was computed. |
Xamarin.iOS | xamarinios was computed. |
Xamarin.Mac | xamarinmac was computed. |
Xamarin.TVOS | xamarintvos was computed. |
Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETStandard 2.1
- Microsoft.Extensions.Configuration.Abstractions (>= 6.0.0)
- Microsoft.Extensions.Configuration.Binder (>= 6.0.0)
- Microsoft.Extensions.Http (>= 6.0.0)
- Microsoft.Extensions.Logging.Abstractions (>= 6.0.3)
- Microsoft.Extensions.Options (>= 6.0.0)
- System.Text.Json (>= 6.0.0)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated |
---|---|---|
1.0.5 | 9,509 | 5/3/2023 |
1.0.4 | 784 | 4/5/2023 |
1.0.3 | 303 | 2/20/2023 |
1.0.2 | 1,750 | 2/8/2023 |
1.0.1 | 376 | 1/28/2023 |
1.0.0 | 285 | 1/26/2023 |
1.0.0-preview3 | 162 | 1/26/2023 |
1.0.0-preview2 | 156 | 1/25/2023 |
1.0.0-preview1 | 133 | 1/25/2023 |