Sie können Silktide Analytics-Ereignisse von Ihrem Backend-Server aus aufzeichnen, zum Beispiel, wenn Sie Downloads erfassen möchten, die von einem Webserver bereitgestellt werden.
Im Gegensatz zum Aufzeichnen von JavaScript-Ereignissen erfordert dies etwas mehr Aufwand bei der Einrichtung.
Identifizierung Ihrer API-Details
Zuerst müssen Sie Ihre Endpoint-URL und den Property-Schlüssel identifizieren.
Endpoint-URL
Um Ihre Endpoint-URL zu finden, öffnen Sie eine Webseite, die Ihre Silktide Analytics verwendet, und öffnen Sie dann die Entwicklerkonsole in Ihrem Browser. Wenn Sie beispielsweise Chrome verwenden, wählen Sie:
Ansicht
Entwickler
Entwicklertools
Konsole
Geben Sie in der Konsole ein:
window.stConfig.endpointUrl
Ihr Browser wird mit der URL des Endpunkts antworten, zum Beispiel https://a.eu.silktide.com/v1/events. Sie sollten sich dies notieren.
Wenn Ihr Browser stattdessen einen Fehler zurückgibt, verwendet diese Seite nicht das Silktide Analytics-Skript.
Property-Schlüssel
Als nächstes müssen Sie Ihren Property-Schlüssel finden.
Geben Sie in der Konsole ein:
window.stConfig.propertyKey
Der zurückgegebene Schlüssel ist Ihr Property-Schlüssel, eine 32-stellige Zeichenfolge aus Zahlen und Buchstaben. Bewahren Sie eine Aufzeichnung davon auf, da Sie ihn für den nächsten Schritt benötigen.
Einen API-Aufruf tätigen
Sie sollten eine HTTP-POST-Anfrage an die oben identifizierte Endpoint-URL senden und den Property-Schlüssel in der Anfrage übergeben.
Ihre Anfrage muss einen Content-Type von application/json haben.
Beispiel für das Anforderungsformat:
{ "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, wie Gecko) Chrome/115.0.0.0 Safari/537.36", "events":[ { "event":"download", "url":"https://example.com/downloaded-file.pdf" } ]}propertyKey, der Property-Schlüssel, wie oben identifizierturl, die vollständige URL der aktuellen Seite. Beachten Sie, dass das Ereignis verworfen wird, wenn die URL nicht zur angegebenen Property gehört.ip, die IP-Adresse des Besuchers, der die Anfrage stellt. Dies ist erforderlich, um einen eindeutigen temporären Identifikator für den Besucher zu erstellen. Die IP-Adresse wird niemals gespeichert, wird anonymisiert, und nur ein nicht umkehrbarer, kurzfristiger Hash wird von Silktide beibehalten. Wenn die IP-Adresse blockiert ist, zum Beispiel weil sie von einem bekannten Bot stammt, wird das Ereignis verworfen.viewWidth, die Ansichtsbreite des Browserfensters des Besuchers.userAgent, der User Agent des Besuchers, der die Anfrage stellt. Dies wird verwendet, um den ungefähren Browser und das Betriebssystem des Besuchers zu identifizieren sowie zu seinem eindeutigen temporären Identifikator beizutragen. Der User Agent selbst wird niemals aufgezeichnet.events, eine Liste von Ereignissen und deren Eigenschaften. Jedes Ereignis muss eineevent-Eigenschaft enthalten, die den Namen des Ereignisses enthält, andere Eigenschaften hängen vom aufgezeichneten Ereignistyp ab.