イベントの送信
SDKでは、ユーザーアクションデータ、データベースステータス、パフォーマンスインジケータなど、Webサイトのサーバー部分からFintezaにイベントを送信できます。Finteza.Tracker.SendEventメソッドはそのために提供されています。
Finteza.Tracker.SendEvent("{EVENT}", "REFERER"); |
このメソッドを使用して、イベントを登録し、購入した商品の種類、価格、通貨などの追加情報をパラメータとして渡すことができます。次のパラメータがサポートされています。
パラメータ |
タイプ |
詳細 |
---|---|---|
name * |
string |
イベント名。最大長は128シンボルです。 |
referer* |
string |
イベント送信元のページのアドレス。すべてのイベントは、websiteIdを使用してFinteza側のカウンタ(Webサイト)にバインドされます。システムは、イベントが到着したホストがカウンタホストに対応することを確認します(FintezaパネルのWebサイト設定で指定されます)。これより、トラフィックの増大を防ぎます。 |
backReferer |
string |
追跡されたアクションを実行する前に訪問者が配置されたWebページのアドレス。 |
userIp |
string |
追跡されたアクションを実行した訪問者のIPアドレス。 |
userAgent |
string |
追跡されたアクションを実行した訪問者のユーザーエージェント。 |
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関数には後1つのバリアントがあります。
Finteza.Tracker.SendEvent({CONTEXT}, "{EVENT}"); |
referer、backReferer、userIp、userAgentの明示的な指定の代わりに、ここではリクエスト実行コンテキストが指定され、そこから指定されたパラメータが受信されてFintezaに送信されます。
パラメータ |
タイプ |
詳細 |
---|---|---|
httpContext * |
System.Web.HttpContextBase or System.Web.HttpContext |
現在のHTTPリクエスト実行コンテキスト。パラメータreferer、backReferer、userIp、userAgentは自動的に形成されます。 |
name * |
string |
イベント名。最大長は128シンボルです。 |
unit |
string |
パラメータ測定単位、たとえば、USD、アイテムなど。最大長は32文字です。 |
value |
string |
パラメータの値。最大長は64シンボルです。 |
* —必須パラメータ。