IntegrationFinteza SDKASP.NET Core WebserverSenden von Ereignissen

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.

Steigern Sie die Einnahmen Ihrer Website mit:

Registrieren Sie sich jetzt und Sie erhalten für 30 Tage einen kostenlosen Zugang.

Mit der Registrierung akzeptieren Sie die Bedingungen des Servicevertrags
Gratulation! Ihr Konto wurde erstellt.
  • Besuchen Sie
    finteza.com
  • Erstellen
    des Kontos
  • Bestätigen
    der E-Mail
  • Installieren
    des Codes

Wir haben eine E-Mail an {email} geschickt. Bitte lesen Sie sie und aktivieren Sie Ihr Konto.

Danach müssen Sie sich nur noch einloggen und den Tracking-Code auf Ihrer Website installieren. Es ist einfach: