Gebeurtenissen verzenden

Met de SDK kunnen gebeurtenissen van het servergedeelte van uw website naar Finteza worden verzonden, inclusief actiegegevens van gebruikers, databasestatus, prestatie-indicatoren, enz.

Roep de ITracker.SendEvent methode hiervoor aan. Verkrijg hiervoor de ITracker implementatie met behulp van Dependency Injection. Dit kan bijvoorbeeld worden gedaan met behulp van de volgende injectie in de constructor:

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

Met behulp van de SendEvent methode kunt u de gebeurtenissen registreren en aanvullende informatie als parameters doorgeven, bijvoorbeeld een type gekocht goed, prijs, valuta, enz. De volgende parameters worden ondersteund:

Parameter	Type	Omschrijving
name *	string	Evenement naam. De maximale lengte is 128 symbolen.
referer	string	Het adres van de pagina van waaruit de gebeurtenis wordt verzonden. Alle evenementen zijn gebonden aan counters (websites) aan de kant van Finteza met behulp van de websiteId. Het systeem zorgt ervoor dat een host van wie een evenement is aangekomen overeenkomt met de counter van de host (gespecificeerd in de website-instellingen van het Finteza paneel). Dit voorkomt afwijkingen in het verkeer.
backReferer	string	Het adres van een webpagina waarop een bezoeker zich bevond voordat een bijgehouden actie werd uitgevoerd.
userIp	string	Het IP-adres van de bezoeker die een bijgehouden actie heeft uitgevoerd.
userAgent	string	De user-agent van de bezoeker die een bijgehouden actie heeft uitgevoerd.
unit	string	Parametermeeteenheden, bijvoorbeeld USD, artikelen, enz. De maximale lengte is 32 tekens.
value	string	De waarde van de parameter. De maximale lengte is 64 symbolen.

* – vereiste parameters.

Voorbeeld:

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

Het is niet nodig om de verwijzer elke keer op te geven wanneer de gebeurtenis wordt verzonden, als u een standaardwaarde instelt tijdens de initialisatie. Geef tijdens de aanroep van AddFintezaAnalytics de aanvullende parameter StandaardVerwijzer op:

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

Opmerking: Als u de StandaardVerwijzer niet gebruikt, specificeer dan wel een verwijzer gedurende elke SendEvent aanroep. Anders worden de evenementen niet verzonden.

Een andere variant is beschikbaar voor de ITracker.SendEvent functie:

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

In plaats van de expliciete specificatie van een verwijzer, terugVerwijzer, gebruikersIp, userAgent, wordt hier de verzoekuitvoercontext gespecificeerd, van waaruit de gespecificeerde parameters worden ontvangen en naar Finteza worden verzonden.

Parameter	Type	Omschrijving
httpContext *	Microsoft.AspNetCore.Http.HttpContext	Huidige uitvoeringscontext voor HTTP-verzoeken, van waaruit verwijzer, terugVerwijzer, gebryuikersIp en de userAgent automatisch worden gevormd.
name *	string	Evenement naam. De maximale lengte is 128 symbolen.
unit	string	De waarde van de parameter. De maximale lengte is 64 symbolen.
value	string	De waarde van de parameter. De maximale lengte is 64 symbolen.

* – vereiste parameters.