Отправка событий

SDK позволяет отправлять в Finteza любые события с серверной части вашего сайта: информацию о действиях пользователей, состоянии базы, показатели производительности и т.д.

Вызовите метод ITracker.SendEvent. Для этого получите реализацию ITracker при помощи "Внедрения зависимости". Например, через внедрение в конструктор:

class SomeClass
{
    public SomeClass(ITracker tracker)
    {
        tracker.SendEvent("{EVENT}");
    }
}

При помощи метода SendEvent вы можете не только регистрировать сами события, но и передавать дополнительную информацию в виде параметров. Например, вид приобретенного товара, сумму покупки, валюту и т.д. Поддерживаются следующие параметры:

Параметр

Тип

Описание

name *

string

Название события. Максимальная длина составляет 128 символов.

referer *

string

Адрес страницы, с которой отправляется событие. Все события привязываются к счетчикам (сайтам) на стороне Finteza по идентификатору websiteId. При этом система дополнительно проверяет, чтобы хост, с которого пришло событие, соответствовал хосту счетчика (указываются в настройках сайта в панели Finteza). Это позволяет предотвратить накрутку трафика.

backReferer

string

Адрес страницы, на которой находился посетитель до выполнения отслеживаемого действия.

userIp

string

IP-адрес посетителя, выполнившего отслеживаемое действие.

userAgent

string

User-agent посетителя, выполнившего отслеживаемое действие.

unit

string

Единицы измерения параметра. Например, USD, штуки и т.д. Максимальная длина 32 символа.

value

string

Значение параметра. Максимальная длина 64 символа.

* — обязательные параметры.

Пример:

tracker.SendEvent("Server Track Purchase", "https://www.mysite.com", "USD", "100");

Чтобы не указывать параметр referer при каждой отправке события, задайте его значение по умолчанию при инициализации. При вызове AddFintezaAnalytics укажите дополнительный параметр DefaultReferer:

services.AddFintezaAnalytics(options =>
{
    options.WebsiteId = "{WEBSITE_ID}";
    options.DefaultReferer = "{DEFAULT_REFERER}";
...
});

Важно: Если вы не используете DefaultReferer,  указывайте referer при каждом вызове SendEvent. В ином случае события не будут отправляться.

Для функции ITracker.SendEvent доступен еще один вариант:

tracker.SendEvent({CONTEXT}, "{EVENT}");

Здесь вместо явного указания referer, backReferer, userIp, userAgent задается контекст исполнения запроса, из которого указанные параметры будут получены и отправлены в Finteza.

Параметр

Тип

Описание

httpContext *

Microsoft.AspNetCore.Http.HttpContext

Контекст выполнения текущего HTTP-запроса, из которого автоматически сформируются параметры referer, backReferer, userIp и userAgent.

name *

string

Название события. Максимальная длина составляет 128 символов.

unit

string

Единицы измерения параметра. Например, USD, штуки и т.д. Максимальная длина 32 символа.

value

string

Значение параметра. Максимальная длина 64 символа.

* — обязательные параметры.

← 
 →