Odesílání událostí

Sada SDK umožňuje odesílat jakékoli události ze serverové části vašeho webu do společnosti Finteza, včetně údajů o akci uživatele, stavu databáze, indikátorů výkonu atd.

Zavolejte metodu ITracker.SendEvent. Za tímto účelem získáte ITracker implementaci pomocí Dependency Injection. Například to lze provést pomocí následujícího vložení do konstruktoru:

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

Pomocí metody SendEvent můžete události zaregistrovat a předat další informace jako parametry, například typ zakoupeného zboží, cenu, měnu atd. Jsou podporovány následující parametry:

Parametr

Typ

Popis

name *

string

Název události. Maximální délka je 128 symbolů.

referer*

string

Adresa stránky, ze které je událost odeslána. Všechny události jsou vázány na čítače (webové stránky) na straně Finteza pomocí websiteId. Systém zajišťuje, aby hostitel, ze kterého událost dorazila, odpovídal hostiteli čítače (zadaný v nastavení webu panelu Finteza). Tím se zabrání nafouknutí provozu.

backReferer

string

Adresa webové stránky, na které se návštěvník nacházel před provedením sledované akce.

userIp

string

IP adresa návštěvníka, který provedl sledovanou akci.

userAgent

string

Uživatelský agent návštěvníka, který provedl sledovanou akci.

unit

string

Jednotky měření parametrů, například USD, položky atd. Maximální délka je 32 znaků.

value

string

Hodnota parametru. Maximální délka je 64 symbolů.

* — požadované parametry.

Příklad:

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

Není nutné specifikovat referer parametr při každém odeslání události, pokud nastavíte jeho výchozí hodnotu během inicializace. Během AddFintezaAnalytics volání zadejte další parametr DefaultReferer:

services.AddFintezaAnalytics(options =>
{
    options.WebsiteId = "{WEBSITE_ID}";
    options.DefaultReferer = "{DEFAULT_REFERER}";
...
});

Poznámka: Pokud nepoužíváte DefaultReferer, zadejte referer během každého SendEvent  volání. Jinak nebudou události odeslány.;

Pro funkci ITracker.SendEvent je k dispozici další varianta:

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

Místo explicitní specifikace referer, backReferer, userIp, userAgent, je zde specifikován kontext provádění požadavku, ze kterého budou přijaty a odeslány zadané parametry Finteze.

Parametr

Typ

Popis

httpContext *

Microsoft.AspNetCore.Http.HttpContext

Aktuální kontext provádění požadavku HTTP, ze kterého jsou parametry referer, backReferer, userIp a userAgent vytvořeny automaticky.

name *

string

Název události. Maximální délka je 128 symbolů.

unit

string

Jednotky měření parametrů, například USD, položky atd. Maximální délka je 32 znaků.

value

string

Hodnota parametru. Maximální délka je 64 symbolů.

* — požadované parametry.

← 
 →