发送事件

SDK允许从您网站的服务器端发送任何事件到Finteza,包括用户动作数据、数据库状态、性能指标等。

调用ITracker.SendEvent方法。为此,请使用依赖注入获得ITracker实现。例如,可以通过以下向构造函数中注入来完成此操作:

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

通过SendEvent方法,您可以注册事件并将其他信息作为参数传递,例如,所购买商品的类型、价格、货币等。支持以下参数:

参数

类型

描述

name *

字符串

事件名称。最大长度为128个字符。

referer*

字符串

发送事件的页面地址。所有事件使用websiteId与Finteza端上的计数器(网站)绑定。系统确保事件到达的主机与计数器主机相对应(Finteza面板网站设置中指定)。这可以防止流量膨胀。

backReferer

字符串

在执行追踪操作之前,访问者所处的网页地址。

userIp

字符串

执行追踪操作的访问者的IP地址。

userAgent

字符串

执行追踪操作的访问者的用户代理。

unit

字符串

参数衡量单位,例如,美元、项目等。最大长度为32个字符。

value

字符串

参数的值。最大长度为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,请在每次SendEvent调用期间指定referer。否则,事件将不会发送。


另一个变量可用于ITracker.SendEvent函数:

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

这里并没有明确指定refererbackRefereruserIpuserAgent,而是指定了请求执行环境,指定的参数将从中接收并发送至Finteza。

参数

类型

描述

httpContext *

Microsoft.AspNetCore.Http.HttpContext

当前HTTP请求执行环境,从中自动形成参数refererbackRefereruserIpuserAgent

name *

字符串

事件名称。最大长度为128个字符。

unit

字符串

参数衡量单位,例如,美元、项目等。最大长度为32个字符。

value

字符串

参数的值。最大长度为64个字符。

* ― 所需的参数。