Du kan registrere Silktide Analytics-begivenheder fra din backend-server, for eksempel hvis du ønsker at registrere downloads leveret af en webserver.
I modsætning til registrering af JavaScript-begivenheder, kræver dette lidt mere arbejde at sætte op.
Identificering af dine API-detaljer
Først skal du identificere din Endpoint URL og Property key.
Endpoint URL
For at finde din Endpoint URL, åbne en webside, der bruger din Silktide Analytics, og derefter åbne udviklerkonsollen i din browser. For eksempel, hvis du bruger Chrome, vælg:
Vis
Udvikler
Udviklerværktøjer
Konsol
I konsollen, indtast:
window.stConfig.endpointUrl
Din browser vil svare med URL'en til endpointet, for eksempel https://a.eu.silktide.com/v1/events. Du bør notere dette.
Hvis din browser i stedet returnerer en fejl, bruger denne side ikke Silktide Analytics-scriptet.
Property key
Dernæst skal du finde din Property Key.
I konsollen, indtast:
window.stConfig.propertyKey
Nøglen, der returneres, er din Property Key, en 32-tegns streng af tal og bogstaver. Hold en registrering af dette, da du vil have brug for det til næste trin.
Foretagelse af et API-kald
Du bør foretage en HTTP POST-anmodning til den Endpoint URL, du identificerede ovenfor, og sende Property Key i anmodningen.
Din anmodning skal have en Content-Type af application/json.
Eksempel på anmodningsformat:
{ "propertyKey":"8bce2be8c07a84a70e7104634b42878b", "url":"https://silktide.com/", "ip":"84.14.132.114", "viewWidth":979, "userAgent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/115.0.0.0 Safari/537.36", "events":[ { "event":"download", "url":"https://example.com/downloaded-file.pdf" } ]}propertyKey, Property Key, som identificeret ovenforurl, den fulde URL til den aktuelle side. Bemærk, at hvis URL'en ikke tilhører den angivne Property, vil begivenheden blive kasseret.ip, IP-adressen på den besøgende, der foretager anmodningen. Dette er nødvendigt for at skabe en unik midlertidig identifikator for den besøgende. IP-adressen gemmes aldrig, vil blive anonymiseret, og kun en ikke-reversibel, kortvarig hash bevares af Silktide. Hvis IP-adressen er blokeret, for eksempel fordi den kommer fra en kendt bot, vil begivenheden blive kasseret.viewWidth, den besøgendes browser vinduesvisningsbredde.userAgent, den User Agent af den besøgende, der foretager anmodningen. Dette bruges til at identificere den omtrentlige browser og OS for den besøgende, samt til at bidrage til deres unikke midlertidige identifikator. User Agent'en selv bliver aldrig registreret.events, en liste over Begivenheder og deres egenskaber. Hver begivenhed skal have eneventegenskab, der indeholder navnet på begivenheden, andre egenskaber afhænger af den begivenhedstype, der registreres.