Senden von Ereignissen

Das SDK ermöglicht das Senden von Ereignissen aus dem Serverbereich Ihrer Website an Finteza, einschließlich Nutzeraktionsdaten, Datenbankstatus, Leistungsindikatoren usw.

Rufen Sie die Methode ITracker.SendEvent auf. Zu diesem Zweck erhalten Sie die Implementation von ITracker, welches Dependency Injection verwendet. Dies kann zum Beispiel durch folgenden Eintrag in den Konstruktor geschehen:

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

Mit der Methode SendEvent können Sie die Ereignisse registrieren und zusätzliche Informationen als Parameter übergeben, z.B. die Art einer gekauften Ware, Preis, Währung usw. Die folgenden Parameter werden unterstützt:

Parameter	Typ	Beschreibung
name *	string	Ereignisname. Die maximale Länge beträgt 128 Symbole.
referer *	string	Die Adresse der Seite, von der das Ereignis gesendet wird. Alle Ereignisse werden an Zähler (Websites) auf der Finteza-Seite gebunden, indem man die WebsiteId benutzt. Das System stellt sicher, dass ein Host, von dem ein Ereignis eingetroffen ist, dem Zählerhost entspricht (angegeben in den Website-Einstellungen des Finteza-Panels). Dies verhindert, dass sich der Traffic aufbläht.
backReferer	string	Die Adresse einer Webseite, auf der sich ein Besucher befand, bevor er eine verfolgte Aktion durchführte.
userIp	string	Die IP-Adresse des Besuchers, der eine verfolgte Aktion durchgeführt hat.
userAgent	string	Der Nutzer-Agent des Nutzers, der eine verfolgte Aktion durchgeführt hat.
unit	string	Parameter-Maßeinheiten, z.B. USD, Positionen, etc. Die maximale Länge beträgt 32 Buchstaben.
value	string	Der Parameterwert Die maximale Länge beträgt 64 Symbole.

* – erforderliche Parameter.

Beispiel:

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

Es ist nicht notwendig, den Parameter referer bei jedem Senden des Ereignisses anzugeben, wenn Sie seinen Standardwert im Zuge der Initialisierung setzen. Wenn Sie beim Aufruf von AddFintezaAnalytics den zusätzlichen Parameter DefaultReferer angeben:

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

Hinweis: Wenn Sie DefaultReferer nicht verwenden, geben Sie Referer bei jedem Aufruf von SendEvent an. Andernfalls werden die Ereignisse nicht gesendet.

Für die Funktion ITracker.SendEvent steht eine weitere Variante zur Verfügung:

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

Anstelle der expliziten Angabe von referer, backReferer, userIp, userAgent wird hier der Ausführungskontext der Anfrage angegeben, von dem die angegebenen Parameter empfangen und an Finteza gesendet werden.

Parameter	Typ	Beschreibung
httpContext *	Microsoft.AspNetCore.Http.HttpContext	Aktueller Ausführungskontext der HTTP-Anforderung, aus dem automatisch die Parameter referer, backReferer, userIp und userAgent gebildet werden.
name *	string	Ereignisname. Die maximale Länge beträgt 128 Symbole.
unit	string	Parameter-Maßeinheiten, z.B. USD, Positionen, etc. Die maximale Länge beträgt 32 Buchstaben.
value	string	Der Parameterwert Die maximale Länge beträgt 64 Symbole.

* – erforderliche Parameter.