FintezaAnalytics.AspNet 1.0.1

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