FintezaAnalytics.AspNet
1.0.0
See the version list below for details.
dotnet add package FintezaAnalytics.AspNet --version 1.0.0
NuGet\Install-Package FintezaAnalytics.AspNet -Version 1.0.0
<PackageReference Include="FintezaAnalytics.AspNet" Version="1.0.0" />
paket add FintezaAnalytics.AspNet --version 1.0.0
#r "nuget: FintezaAnalytics.AspNet, 1.0.0"
// Install FintezaAnalytics.AspNet as a Cake Addin #addin nuget:?package=FintezaAnalytics.AspNet&version=1.0.0 // Install FintezaAnalytics.AspNet as a Cake Tool #tool nuget:?package=FintezaAnalytics.AspNet&version=1.0.0
Using
using FintezaAnalytics;
...
// call the SDK methods
Initialization
The SDK is initialized in the global application class in the Global.asax file. Call the Finteza.RegisterAnalytics
method inside the Application_Start
method of the application:
Finteza.RegisterAnalytics(websiteId: "{WEBSITE_ID}");
Specify the following parameters:
websiteId
* - Website ID. It can be obtained in the website settings (ID field) of the Finteza panel.url
- Finteza server address. In most cases, it should not be changed.logger
- Microsoft.Extensions.Logging.ILogger interface implementation.
After that, add the following call in the Application_End
method of the application:
Finteza.UnregisterAnalytics();
It releases the resources used by Finteza SDK.
Proxying requests
To enable proxying, set its parameters in addition to the main parameters in the Finteza.RegisterAnalytics
initialization method:
Finteza.RegisterAnalytics(websiteId: "{WEBSITE_ID}", token: "{TOKEN}", path: "{PATH}");
token
* - Token for signing the X-Forwarded-For header. You can get this value in the website settings of the Finteza panel: open the Counter section, enable the "Proxying the script and requests" option and copy the value from the "Proxy token" field.path
- Beginning of the path for requests to be proxied. If the parameter is not specified, the default/fz
value will be used.
Then, add the following line in the Web.config file, under the system.webServer/modules
section:
<add name="FintezaAnalyticsProxyModule" type="FintezaAnalytics.ProxyModule" />
Sending events
Call the Finteza.Tracker.SendEvent
method:
Finteza.Tracker.SendEvent(name: "{EVENT}", referer: "REFERER");
Using this method, you can register the events and pass additional information as parameters, for example, a type of a purchased good, price, currency, etc. The following parameters are supported:
name
* - Event name. The maximum length is 128 symbols.referer
* - The host on which the SDK runs.backReferer
- The address of a web page a visitor was located at before performing a tracked action.userIp
- The IP address of the visitor who performed a tracked action.userAgent
- The user-agent of the visitor who performed a tracked action.unit
- Parameter measurement units, for example, USD, items, etc. The maximum length is 32 characters.value
- The value of the parameter. The maximum length is 64 symbols.
* - required parameters
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET Framework | net472 is compatible. net48 was computed. net481 was computed. |
-
.NETFramework 4.7.2
- Microsoft.Extensions.Logging.Abstractions (>= 2.2.0)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.