发送事件
SDK允许从您网站的服务器端发送任何事件到Finteza,包括用户动作数据、数据库状态、性能指标等。
调用ITracker.SendEvent方法。为此,请使用依赖注入获得ITracker实现。例如,可以通过以下向构造函数中注入来完成此操作:
class SomeClass
|
通过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 =>
|
注意:如果您没有使用DefaultReferer,请在每次SendEvent调用期间指定referer。否则,事件将不会发送。 |
另一个变量可用于ITracker.SendEvent函数:
tracker.SendEvent({CONTEXT}, "{EVENT}"); |
这里并没有明确指定referer,backReferer,userIp,userAgent,而是指定了请求执行环境,指定的参数将从中接收并发送至Finteza。
参数 |
类型 |
描述 |
---|---|---|
httpContext * |
Microsoft.AspNetCore.Http.HttpContext |
当前HTTP请求执行环境,从中自动形成参数referer,backReferer,userIp和userAgent。 |
name * |
字符串 |
事件名称。最大长度为128个字符。 |
unit |
字符串 |
参数衡量单位,例如,美元、项目等。最大长度为32个字符。 |
value |
字符串 |
参数的值。最大长度为64个字符。 |
* ― 所需的参数。