ИнтеграцииОтправка событий

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

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

Finteza.Tracker.SendEvent("{EVENT}");

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

Параметр

Тип

Описание

name *

string

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

referer

string

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

backReferer

string

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

userIp

string

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

userAgent

string

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

unit

string

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

value

string

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

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

Пример:

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

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

Finteza.RegisterAnalytics(websiteId: "{WEBSITE_ID}", defaultReferer: "{DEFAULT_REFERER}");

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


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

Finteza.Tracker.SendEvent({CONTEXT}"{EVENT}");

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

Параметр

Тип

Описание

httpContext *

System.Web.HttpContextBase или System.Web.HttpContext

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

name *

string

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

unit

string

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

value

string

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

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