发送事件
SDK允许从您网站的服务器端发送任何事件到Finteza,包括用户动作数据、数据库状态、性能指标等。为此,提供了Finteza.Tracker.SendEvent方法。
Finteza.Tracker.SendEvent("{EVENT}", "REFERER"); |
使用该方法,您可以注册事件并将其他信息作为参数传递,例如,所购买商品的类型、价格、货币等。支持以下参数:
参数 |
类型 |
描述 |
---|---|---|
name * |
字符串 |
事件名称。最大长度为128个字符。 |
referer* |
字符串 |
发送事件的页面地址。所有事件使用websiteId与Finteza端上的计数器(网站)绑定。系统确保事件到达的主机与计数器主机相对应(Finteza面板网站设置中指定)。这可以防止流量膨胀。 |
backReferer |
字符串 |
在执行追踪操作之前,访问者所处的网页地址。 |
userIp |
字符串 |
执行追踪操作的访问者的IP地址。 |
userAgent |
字符串 |
执行追踪操作的访问者的用户代理。 |
unit |
字符串 |
参数衡量单位,例如,美元、项目等。最大长度为32个字符。 |
value |
字符串 |
参数的值。最大长度为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,请在每次SendEvent调用期间指定referer。否则,事件将不会发送。 |
另一个变量可用于Finteza.Tracker.SendEvent函数:
Finteza.Tracker.SendEvent({CONTEXT}, "{EVENT}"); |
这里并没有明确指定referer,backReferer,userIp,userAgent,而是指定了请求执行环境,指定的参数将从中接收并发送至Finteza。
参数 |
类型 |
描述 |
---|---|---|
httpContext * |
System.Web.HttpContextBase or System.Web.HttpContext |
当前HTTP请求执行环境,从中自动形成参数referer,backReferer,userIp和userAgent。 |
name * |
字符串 |
事件名称。最大长度为128个字符。 |
unit |
字符串 |
参数衡量单位,例如,美元、项目等。最大长度为32个字符。 |
value |
字符串 |
参数的值。最大长度为64个字符。 |
* ― 所需的参数。